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

ImageDrawBeveledRect

Last update:
May 18, 2026

Description

Draws a rectangle with beveled edges.

Returns

Nothing.

Category

Function syntax

ImageDrawBeveledRect(name, x, y, width, height, raised [, 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.
raised
Required. Specify whether the rectangle appears raised above the surface or sunk into the surface:
  • yes: The rectangle is raised.
  • no: The rectangle is sunk (default).
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 edges of the rectangle are highlighted so that they appear beveled and lit from the upper-left corner. The colors used for the highlighting effect are determined by the current drawing color.If the filled parameter is set to yes, the cuboid area is filled with the current drawing color.Use the ImageSetDrawingColor and ImageSetDrawingStroke functions to specify the color and line attributes of the rectangle. Use the ImageSetAntialiasing function to improve the quality of the rendered image.

Example

<!--- This example shows how to create a bevel-edged rectangle. ---> 
<!--- Use the ImageNew function to create a 200x200-pixel image. ---> 
<cfset myImage=ImageNew("",200,200)> 
<!--- Turn on antialiasing to improve image quality. ---> 
<cfset ImageSetAntialiasing(myImage,"on")> 
<!--- Set the drawing color for the image to light gray. ---> 
<cfset ImageSetDrawingColor(myImage,"lightgray")> 
<!--- Draw a 3D gray, filled, raised rectangle. ---> 
<cfset ImageDrawBeveledRect(myImage,50,50,100,75,"yes","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