Product Documentation
Virtuoso Schematic Editor SKILL Functions Reference
Product Version IC23.1, November 2023

schHiCreateBlockInst

schHiCreateBlockInst( 
[ ?libraryName t_libraryName ]
[ ?cellName t_cellName ]
[ ?viewName t_viewName ]
[ ?blockSampleName t_blockSampleName ] 
[ ?instanceName t_instanceName ]
[ ?pinNameSeed t_pinNameSeed ] 
)
=> t

Description

Creates a block and places an instance of a block in a schematic. Usable only when editing schematics. If you do not type a library, cell, view, and instance name as arguments, the options form appears and prompts you for these values. The block choices are defined by the schBlockTemplate variable in the schConfig.il file. If you type freeform, the schematic editor prompts you to type a rectangular shape by clicking on two points of the rectangle.

Arguments

?libraryName t_libraryName

An existing library in which you want to create your block; must be enclosed in quotation marks.

?cellName t_cellName

Cell name of the block you want to create; must be enclosed in quotation marks.

?viewName t_viewName

View you want to create; must be enclosed in quotation marks.

?blockSampleName t_blockSampleName

Name of a block sample that represents the boundary of the block; must be enclosed in quotation marks.
Valid Values: small, medium, large, 2 by 1, 1 by 2, alu, mux4, mux8

?instanceName t_instanceName

Unique name to assign to your instance; must be enclosed in quotation marks.

?pinNameSeed t_pinNameSeed

Seed name that the schematic editor uses when generating names of new pins created on this block; must be enclosed in quotation marks.

Value Returned

Always returns t.

Examples

Creates a new block with the specified fields. Prompts you to type a rectangular shape that specifies the shape of the symbol as well as the origin of the instance of the new block. t_pinNameSeed is set to pin and t_instanceName is assigned a unique value.

schHiCreateBlockInst( ?libraryName "ASIC_LIB" ?cellName "BLOCK1" ?viewName "SYMBOL_NEG" )
Creates two blocks named BLOCK1 and BLOCK2. Both blocks are created in the ASIC_LIB library and the view name is SYMBOL_NEG. The instance names are I1 and I2. The boundary of the blocks is a fixed size based on the pointlist in the blockSample map that relates the large blockSampleName. The schematic editor drags the first block and prompts you for a location to place the instance. It then drags the second block and prompts you for a location.
schHiCreateBlockInst( ?libraryName "ASIC_LIB" ?cellName "BLOCK1 BLOCK2" ?viewName "SYMBOL_NEG" ?blockSampleName "large" ?instanceName "I1 I2" ?pinNameSeed "PIN" )

Return to top
 ⠀
X