Description
Draws a sequence of connected lines defined by arrays of x and y coordinates.
Returns
Nothing.
ImageDrawLines(name, xcoords, ycoords [, isPolygon, filled])
See also
ImageDrawBeveledRect, ImageDrawCubicCurve, ImageDrawLine, ImageDrawRect, ImageDrawRoundRect, ImageSetAntialiasing,
ImageSetDrawingColor, ImageSetDrawingStroke, IsImageFile
History
ColdFusion 8: Added this function.
Parameters
Parameter |
Description |
|---|---|
name |
Required. The ColdFusion image on which this operation is performed. |
xcoords |
Required. A CFML array of x coordinates. |
ycoords |
Required. A CFML array of y coordinates. |
isPolygon |
Optional. Specify whether the lines form a polygon:
|
filled |
Optional. Specify whether the polygon is filled:
|
Usage
Each pair of (x,y) coordinates defines a point.To draw a polygon, set isPolygon to yes. The start point cannot be the same value as the end point. If isPolygon is yes, a line joining start point and the end point is drawn to complete a polygon. If isPolygon is no, line completing the polygon is not drawn.Set the isPolygon and filled parameters to yes to draw a polygon filled with the current drawing color.Use the ImageSetDrawingColor and ImageSetDrawingStroke functions to control the color and line attributes. Use the ImageSetAntialiasing function to improve the quality of the rendered image.
Example
<!--- This example shows how to draw a zigzag line. --->
<!--- Use the ImageNew function to create a 250x250-pixel image. --->
<cfset myImage=ImageNew("",250,250)>
<!--- Set the drawing color to cyan. --->
<cfset ImageSetDrawingColor(myImage,"cyan")>
<!--- Turn on antialiasing to improve image quality. --->
<cfset ImageSetAntialiasing(myImage,"on")>
<!--- Create arrays for the x and y coordinates. --->
<cfset x = ArrayNew(1)>
<cfset y = ArrayNew(1)>
<!--- Set the values for the x and y coordinates for three connected line segments: the first segment begins at (100,50) and ends at (50,100). The second segment begins at (50, 100) and ends at (200,100). The third segment begins at (200,100) and ends at (100,200). --->
<cfset x[1] = "100">
<cfset x[2] = "50">
<cfset x[3] = "200">
<cfset x[4] = "100">
<cfset y[1] = "50">
<cfset y[2] = "100">
<cfset y[3] = "100">
<cfset y[4] = "200">
<!--- Draw the lines on the image. --->
<cfset ImageDrawLines(myImage,x,y)>
<!--- Display the image in a browser. --->
<cfimage source=#myImage# action="writeToBrowser">
Twitter™ and Facebook posts are not covered under the terms of Creative Commons.