get, getcell

Usage:

getcell cellname [orientation]

getcell cellname [child child_refpoint] [parent parent_refpoint]

where orientation may be one of the following:

90

Load rotated by 90 degrees clockwise

180

Load rotated by 180 degrees

270

Load rotated by 90 degrees counterclockwise

v

Load flipped top to bottom

h

Load flipped left to right

90v

Load rotated 90 degrees clockwise and flipped top to bottom

90h

Load rotated 90 degrees clockwise and flipped left to right

180v

Load rotated 180 degrees and flipped top to bottom

180h

Load rotated 180 degrees and flipped left to right

270v

Load rotated 90 degrees counterclockwise and flipped top to bottom

270h

Load rotated 90 degrees counterclockwise and flipped left to right

and child_refpoint and parent_refpoint may be x y coordinate pairs, or one of the four keywords ll, lr, ul, or ur, indicating one of the four box corners. For the child, coordinate pairs are in the coordinate system of the child, and corners indicate cell bounding box corners. For the parent, coordinate pairs are in the coordinate system of the parent, and corners indicate corners of the cursor box.

Summary:

The getcell command creates subcell instances within the current edit cell. By default, with only the cellname given, an orientation of zero is assumed, and the cell is placed such that the lower-left corner of the cell's bounding box is placed at the lower-left corner of the cursor box in the parent cell.

Implementation Notes:

getcell is implemented as a built-in command in magic.

get is an alias for the command getcell (allowed abbreviation where otherwise use would be ambiguous).

Scripts will find it more convenient to place cells according to the cell origin, with the usage "getcell cellname child 0 0".

See Also:

dump

Return to command index

Last updated: March 7, 2020 at 1:06pm