Note: IPOLYLINE creates an annotation object with an identifier of LINE. This identifier must be used when manipulating the object with routines like ISETPROPERTY.
IPOLYLINE, Points [, ARROW_SIZE =Value] [, ARROW_STYLE =Value] [, /DATA | , /DEVICE | , /NORMAL ] [, IDENTIFIER =Variable] [, PROPERTY=Value] [, TOOL =iToolID] [, TARGET_IDENTIFIER =iToolID] [, /VISUALIZATION ]
The vertices of the polyline. Points is either a vector of two-element vectors [[x1, y1], [x2, y2] ...], a 2-D array of points, or a 3-D array of points. Unless a 3-D array is specified, a 2-D polyline is created. Locations are specified in normalized coordinates unless the DATA or DEVICE keyword is set.
Any property of a polyline annotation can be set using this routine. To set the value of a property, specify the property name as a keyword set equal to the appropriate property value. See ISETPROPERTY for details.
Set this keyword to the size (in normalized units) of the displayed arrowhead(s). This keyword has no effect if ARROW_STYLE is not set.
Set this keyword to the style of arrow used to decorate the line.
Set this keyword if the input arguments are specified in data coordinates.
Set this keyword if the input arguments are specified in device coordinates (pixels).
Set this keyword to a named variable that will contain the full identifier of the newly-created object.
Set this keyword if the input arguments are specified in normalized [0, 1] coordinates (the default).
Set this keyword to the iTools identifier of an object that is contained in the data space into which the polyline object should be placed. If a value is not supplied, the first data space in the current view is used.
Set this keyword to the iTools identifier of the iTool in which TARGET_IDENTIFIER is found. If a value is not supplied, the current iTool is used.
Set this keyword to add the object to the data space. The default behavior is to add the object to the annotation layer.
See the example for ITEXT.
7.1 |
Introduced |