db_get_dg_attribute()

Returns an attribute of the data group, given a handle to the data group and an attribute key.
A DG or Data Group is a primitive (non-hierarchical) shape or text string. A polygon, polyline, rectangle, etc., is a data group.

Retrieving the DG_TYPE returns an integer code for the kind of data group the record represents. If DG_TYPE is a polygon, polyline, wire, or circle, DG_DATA is a handle to a segment list. If DG_TYPE is a path, DG_DATA is a handle to a path record; if text, to a text record; if a wire, to a wire record. Use the corresponding get_attribute functions for retrieving additional attributes unique to these data types. DG_DATA is null if type is rectangle (all coordinates are described in the dg's bounding box).

Syntax:

db_get_dg_attribute(dgHandle, dgAttribute);

where

dgHandle is the handle to data group, as returned from db_first_dg().

dgAttribute is the attribute code, where:

• DG_SELECT is the select flag
• DG_TYPE is the DG type; returns one of the following:
  • POLYGON_DG_TYPE
  • POLYLINE_DG_TYPE
  • PATH_DG_TYPE
  • WIRE_DG_TYPE
  • CIRCLE_DG_TYPE
  • TEXT_DG_TYPE
  • CONSTRUCTION_LINE_DG_TYPE
  • ARC_DG_TYPE
  • RECTANGLE_DG_TYPE
• DG_SEG_SELECTED is a flag, any dg segment selected; an integer.
• DG_PNT_SELECTED is a flag, any dg point selected; an integer.
• DG_NUM_HOLES is the number of holes in dg; an integer.
• DG_HIGHLIGHT is a flag, dg highlighted; an integer.
• DG_NO_PLOT is a flag; dg to be plotted; an integer.
• DG_DATA is the data handle; depends on DG_TYPE.
• DG_BBOX is the bounding box handle; 4 coordinates.
• DG_PROPERTY is the head of property list.

Example:

decl selected, dgHandle, maskH;
dgHandle = db_first_dg(maskH);
selected = db_get_dg_attribute(dgHandle, DG_SELECT);

Download Example File:

The following link(s) lead to the Agilent EEsof EDA Knowledge center website. You will need to register at this site with a valid support contract to download an example file.

Get Path Info
Modify Circle Resolution
Polylines to Polygons

Where Used:

Schematic, Layout