CGCOLORFILL
Provides a device-independent and color-model-independent way to fill a polygon
with a particular color. This is a wrapper to the PolyFill command in IDL.
Categories
Graphics
Params
x: in, required, type=number
A vector argument providing the X coordinates of the points to be connected.
The vector must contain at least three elements. If only one argument is
specified, X must be an array of either two or three vectors (i.e., (2,*)
or (3,*)). In this special case, the vector X[0,*] specifies the X values,
X[1,*] specifies Y, and X[2,*] contain the Z values.
y: in, required, type=number
A vector argument providing the Y coordinates of the points to be connected.
Y must contain at least three elements.
z: in, optional, type=number
An optional vector argument providing the Z coordinates of the points to be
connected. Z must contain at least three elements.
Keywords
color: in, optional, type=string/integer/long, default='rose'
The name of the fill color. Color names are those used with cgColor.
This value can also be a long integer or an index into the current color
table.
device: in, optional, type=boolean, default=0
Set to indicate the polygon vertices are in device coordinates.
normal: in, optional, type=boolean, default=0
Set to indicate the polygon vertices are in normalized coordinates.
window: in, optional, type=boolean, default=0
Set this keyword to add the command to the current cgWindow application.
_ref_extra: in, optional, type=appropriate
Any other keywords to the IDL POLYFILL command may be used.
Examples
Used like the IDL Polyfill command::
IDL> cgColorFill, [0.25, 0.25, 0.75, 0.75, 0.25], [0.25, 0.75, 0.75, 0.25, 0.25], $
/NORMAL, COLOR='blue'
Author
FANNING SOFTWARE CONSULTING::
David W. Fanning
1645 Sheely Drive
Fort Collins, CO 80526 USA
Phone: 970-221-0438
E-mail: david@idlcoyote.com
Coyote's Guide to IDL Programming: http://www.idlcoyote.com
History
Change History::
Written, 24 December 2010. DWF.
In some cases, I was turning BYTE values to strings without converting to
INTEGERS first. 30 Dec 2010. DWF.
Moved setting to decomposed color before color selection process to avoid PostScript
background problems when passed 24-bit color integers. 12 Jan 2011. DWF.
Added WINDOW keyword. 24 Jan 2011. DWF.
Modified error handler to restore the entry decomposition state if there is an error. 17 March 2011. DWF
Modified to use cgDefaultColor for default color selection. 24 Dec 2011. DWF.
Copyright
Copyright (c) 2010, Fanning Software Consulting, Inc.