Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


IPOLYGON

IPOLYGON

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 [[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 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



© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us