db_get_map_attribute()

Returns an attribute of a transformation mapping, as retrieved by db_get_map() . Values are returned in database units, angle in 0.001 degrees, scale as a real number, and mirror flag as an integer 1 or 0.

Note that a mirror about the Y axis is stored in the transformation mapping as a combination of a mirror about the X axis followed by a 180 degree rotation, so query for the DB_MAP_MIR_Y attribute always returns 0. If a mirror about the Y axis was part of the transformation mapping, query for DB_MAP_MIR_X returns 1, and query for DB_MAP_ANG returns 180000 (or 180 degrees). If a rotation was involved as well as mirror, then query for the DB_MIR_ANG includes the rotation angle also.

Syntax:

db_get_map_attribute( mapAttribute [, map] );

where

mapAttribute is the attribute code for the map, where:

• DB_MAP_X = Horizontal translation value
• DB_MAP_Y = Vertical translation value
• DB_MAP_ANG = Rotation angle
• DB_MAP_SCL_X = Horizontal scale factor
• DB_MAP_SCL_Y = Vertical scale factor
• DB_MAP_MIR_X = Flag for mirror about X axis
• DB_MAP_MIR_Y = Flag for mirror about Y axis (always 0)

map is optional; the handle of transformation mapping. If omitted, assumes current mapping as set by db_set_map(), db_setup_transformation(), or db_setup_map().

Example:

decl x;
x = db_get_map_attribute( DB_MAP_X );

Where Used:

Schematic, Layout