dbColorShapeQuery

dbColorShapeQuery( 
d_cellViewId
l_layerPurposePair
l_bBox
[ x_startLevel ]
[ x_stopLevel ]
[ n_filterSize ]
[ l_transform ]
)
=> l_shapeColorPairs / nil

Description

Returns a list of all shapes and their effective color, where the bounding boxes of the shapes overlap the region specified by l_bBox.

The effective color of a shape is the color after applying any hierarchical shifting that may be specified at different levels of the design hierarchy. This effective color may not be the color assigned to the shape.

Query of objects is based on the open hierarchy level. Only cellviews that are currently open will be searched. To ensure that all shapes are returned in a query list, dbOpenHier can be used to load all required cellviews.

Arguments

d_cellviewId	Specifies the cellview ID
l_layerPurposePair	Specifies the layer-purpose pair
l_bBox	Specifies the region that should overlap bounding boxes of all returned shapes
x_startLevel	Specifies the level of the design hierarchy in which to start the querying process. If the startLevel argument is not specified, the start level defaults to 0.
x_stopLevel	Specifies the level of the design hierarchy in which to stop the querying process. If the stopLevel argument is not specified, the stop level defaults to maximum hierarchy depth. The query will stop prior to x_stopLevel if it encounters a cellview which is not currently loaded.
n_filterSize	Specifies the shapes filter size. The query produces only shapes with a size larger than the filterSize. If no filterSize argument is specified, the blockage filter size defaults to 0.
l_transform	Describes the initial transformation to be used during the region querying process, such as offset, rotation, and/or magnification. If no transform argument is specified, the initial formation defaults to offset (0,0),and orientation R0.

Value Returned

l_shapeColorPairs	Returns a list of pairs (shape ID, shape color)
`nil`	Returns `nil` if an error occurs during execution

Example

dbColorShapeQuery( cvId '("M1" "drawing") '((0 0) (100 100)) )

=> ((sh1Id "mask1Color") (sh2Id "grayColor"))

Return to top

Virtuoso Studio Design Environment SKILL ReferenceProduct Version IC23.1, November 2023