schCreateInst
schCreateInst(
d_cvId
d_masterId
t_instanceName
l_origin
t_orient
[ n_magnification ]
)
=> d_inst / nil
Description
Creates an instance of the given master cellview in the specified cellview at the given location with the given orientation. You can specify the magnification to set for the instance. Although not fully supported, you can use this property to scale the appearance of an instance.
Arguments
|
d_cvId
|
Cellview ID of the editable schematic cellview in which to create the instance.
|
|
d_masterId
|
ID of the instance master cellview. You can access the master ID using several different methods; for example, an explicit call to dbOpenCellViewByType.
|
|
t_instanceName
|
Instance name to give the instance; must be enclosed in quotation marks. This argument can be nil, a simple name, or a name with a vector expression. When the argument is nil, a unique instance name will be generated automatically. When the argument is a simple name or a name with a vector expression, the name must be unique among existing instances in the cellview. If the name has a vector expression—for example, "<0:3>" —the expression is used to create an iterated instance.
|
|
l_origin
|
Location to place the instance. The origin of the instance master is used as the reference point.
|
|
t_orient
|
Orientation to give the instance placement; must be enclosed in quotation marks.
Valid Values: R0, R90, R180, R270, MX, MXR90, MY, MYR90
|
|
n_magnification
|
Database magnification value to set on the instance.
Default: 1.0
|
Value Returned
|
d_inst
|
The ID of the instance.
|
|
nil
|
Instance creation was unsuccessful.
|
Examples
Creates an instance of the inverter symbol from the sample library in the specified cvId. The instance name is I23 and the name is placed at 0,0 with an R0 orientation.
symbolId = dbOpenCellViewByType( "sample" "inv" "symbol" "" 'r )
instId = schCreateInst( cvId symbolId "I23" 0:0 "R0" )
Creates an iterated instance of the same inverter. The instance rotates 90 degrees before being placed.
intId = schCreateInst( cvId symbolId "I24<0:1>" 0:1 "R90" )
Return to top
