IN_PlaceVectorObject

$image\bltlrgsq_shg.gif$ Editions $image\bltlrgsq_shg.gif$ Related Functions

The IN_PlaceVectorObject function places a vector object on the specified edit layer. Depending on your edition of Imagenation, you can place arcs, lines, polylines, polygons, ellipses, annotations, text, and groups of objects with this function. Other functions allow you to place text objects, hotspots, and symbols specifically.

Syntax

int IN_PlaceVectorObject( layerID, pObjectDesc, DescSize )

Parameters	Meaning
IN_LAYER layerID	identifier of the edit layer on which to place the vector object
STDPTR pObjectDesc	pointer to the structure of the vector object data
USHORT DescSize	size of the object data structure

Vector object structures for pObjectDesc

$image\bltlrgsq_shg.gif$ annotation

$image\bltlrgsq_shg.gif$ arc

$image\bltlrgsq_shg.gif$ ellipse or circle

$image\bltlrgsq_shg.gif$ line

$image\bltlrgsq_shg.gif$ polygon, box, box-shaped highlight area, box-shaped erase area

$image\bltlrgsq_shg.gif$ polyline, sketch, highlighted sketch, rubout sketch

$image\bltlrgsq_shg.gif$ text (V1)

$image\bltlrgsq_shg.gif$ text (V2)

$image\bltlrgsq_shg.gif$ groups of objects

Remarks

For the vector objects to be visible, you must redraw the display by using the IN_Refresh function, or the View, Refresh command in the interface.

With this function, you cannot specify that the default attribute values that are defined through IN_SetSystemToolAttribute are to be used as part of pObjectDesc. You must instead list specific values.

Release information

Added to Imagenation for Windows in Release 4.20.

This function has not been tested in Imagenation for UNIX, so it should not be used in UNIX integrations.

See also

Placing vector objects