#

## get, getcell

Import a cell as a subcell of the current edit cell.

### Usage:

> getcell cellname [orientation]
> getcell cellname [orientation] [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, or the name of a label in the parent or child cell. 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. If child or parent options are not provided, then the default behavior is the same as "child ll" and "parent ll", respectively. If a label name is given, then the position (anchor point) of the label will be used as the reference point.

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