schCopy
schCopy(
d_fig
d_destCV
l_transform
)
=> d_object / nil
Description
Copies the given object to the given destination cellview. The object location and orientation can be specified before it is placed at the destination location by the given transformation argument. The copied figure is first rotated and reflected about the origin as specified by the orientation of the transform, then translated by the offset of the transform.
The destination cellview must be editable. This function copies figures between schematic or symbol cellviews only.
Arguments
|
d_fig
|
Figure to copy.
|
|
d_destCV
|
Cellview in which to place the copied object. This argument must be a schematic or symbol cellview.
|
|
l_transform
|
Specifies the relative location, orientation, and optionally magnification of the moved figure, specified as a list of the form:
( l_offset t_orient [ n_magnification ] )
Where:
l_offset is the offset from the original position expressed as a list of two floats, the first specifying the distance to move in the x direction and the second the distance in the y direction; for example (10.0:5.0).
t_orient specifies the orientation of the moved object and is one of R0, R90, R180, R270, MX, MXR90, MY, MYR90. The value must be enclosed in double quotes.
n_magnification specifies the relative size of the moved object. The default is 1.0 (i.e. the same size as before the move).
|
Value Returned
|
d_object
|
The ID of the new figure.
|
|
nil
|
Copying the object was unsuccessful.
|
Examples
Creates a copy of fig1 in the cellview specified by cv2. The new figure has the same rotation as fig1 and is translated by offset 10.0, 5.0, with an R0 orientation.
objId = schCopy( fig1 cv2 list(10.0:5.0 "R0") )
Return to top
