Whatever message this page gives is out now! Go check it out!

ImageDrawRect

Last update:
May 18, 2026

Description

Draws a rectangle.

Returns

Nothing.

Category

Function syntax

ImageDrawRect(name, x, y, width, height [, filled])

See also

History

ColdFusion 8: Added this function.

Parameters

Parameter
Description
name
Required. The ColdFusion image on which this operation is performed.
x
Required. The x coordinate of the rectangle.
y
Required. The y coordinate of the rectangle.
width
Required. The width of the rectangle.
height
Required. The height of the rectangle.
filled
Optional. Specify whether the rectangle is filled:
  • yes: The rectangle is filled with the specified drawing color.
  • no: Only the outline of the rectangle is drawn (default).

Usage

The left and right edges of the rectangle are at x and x plus width, respectively. The upper and lower edges are at y and y plus height, respectively.Set the filled parameter to yes to fill the rectangle with the current drawing color.Use the ImageSetDrawingColor and ImageSetDrawingStroke functions to format the color and lines of the rectangle. Use the ImageSetAntialiasing function to improve the quality of the rendered image.

Example

<!--- This example shows how to draw a rectangle. ---> 
<!--- Use the ImageNew function to create a ColdFusion image that is 150 pixels wide and 200 pixels high. ---> 
<cfset myImage=ImageNew("",150,200)> 
<!--- Set the drawing color for the image to yellow. ---> 
<cfset ImageSetDrawingColor(myImage,"yellow")> 
<!--- Turn on antialiasing to improve image quality. ---> 
<cfset ImageSetAntialiasing(myImage,"on")> 
<!--- Draw a filled yellow rectangle on the image. ---> 
<cfset ImageDrawRect(myImage,25,45,100,20,"yes")> 
<!--- Display the image in a browser. ---> 
<cfimage source="#myImage#" action="writeToBrowser">

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page