Examples

---

In the following example, we draw a polygon around a feature in the iImage iTool. Since we draw the polygon in the data space, the polygon resizes smoothly with the image.

; Opening the data file        

file = FILEPATH('mineral.png', $        

   SUBDIRECTORY = ['examples', 'data'])        

data = READ_PNG(file)        

; Create an iTool with the image data        

IIMAGE, data, TITLE = 'Electron Image of Mineral Deposits', $        

   IDENTIFIER = iToolID        

; A polygon surrounding a crystal, in data space coordinates        

coords = [[160, 198], [98, 111], $        

   [114, 78], [173, 175]]        

; Write the polygon to the iTool's data space         

IPOLYGON, coords, /DATA, VISUALIZATION = iToolIDpolygonID = IGETID('polygon')        

; Make the polygon boundary more visible, and interior transparent        

ISETPROPERTY, polygonID, THICK=3, COLOR=[240,0,0], $        

   FILL_BACKGROUND=0

Syntax

---

IPOLYGON, Points [, /DATA | , /DEVICE | , /NORMAL] [, IDENTIFIER=Variable] [, PROPERTY=Value] [, TARGET_IDENTIFIER=iToolID] [, TOOL=iToolID] [, /VISUALIZATION]

Arguments

---

Points

The vertices of the polygon. Points is either a vector of two-element vectors [[x₁, y₁], [x₂, y₂] ...] a 2-D array of points, or a 3-D array of points. Unless a 3-D array is specified, a 2-D polygon is created. Locations are specified in normalized coordinates unless the DATA or DEVICE keyword is set.

Keywords

---

Any property of a polygon 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.

DATA

Set this keyword if the input arguments are specified in data coordinates.

DEVICE

Set this keyword if the input arguments are specified in device coordinates (pixels).

IDENTIFIER

Set this keyword to a named variable that will contain the full identifier of the newly-created object.

NORMAL

Set this keyword if the input arguments are specified in normalized [0, 1] coordinates (the default).

TARGET_IDENTIFIER

Set this keyword to the iTools identifier of an object that is contained in the data space into which the polygon object should be placed. If a value is not supplied, the first data space in the current view is used.

TOOL

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.

VISUALIZATION

Set this keyword to add the object to the data space. The default behavior is to add the annotation to the annotation layer.

Version History

---

7.1	Introduced

See Also

---

IPOLYLINE, IELLIPSE, ICONVERTCOORD, ITEXT