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

ImageDrawPoint

Last update:
May 18, 2026

Description

Draws a point at the specified (x,y) coordinate.

Returns

Nothing.

Category

Function syntax

ImageDrawPoint(name, x, y)

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 point.
y
Required. The y coordinate of the point.

Usage

Use the ImageSetDrawingStroke and ImageSetDrawingColor functions to control the appearance of the drawing point. For example, set the width attribute of the ImageSetDrawingStroke function to 10 pixels to draw a 20-pixel-square centered at (x,y). Use the ImageSetAntialiasing function to improve the quality of the rendered image.

Example

<!--- This example shows how to draw a large square in the middle of an image. ---> 
<!--- Use the ImageNew function to create a 200x200-pixel image. ---> 
<cfset myImage=ImageNew("",200,200)> 
<!---Set the drawing color to orange. ---> 
<cfset ImageSetDrawingColor(myImage,"orange")> 
<!--- Turn on antialiasing to improve image quality. ---> 
<cfset ImageSetAntialiasing(myImage,"on")> 
<!--- Set the drawing area to 10 pixels. ---> 
<cfset attr = StructNew()> 
<cfset attr.width = 10> 
<cfset ImageSetDrawingStroke(myImage,attr)> 
<!--- Draw the point at (100,100). ---> 
<cfset ImageDrawPoint(myImage,100,100)> 
<!--- 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