dbProduceOverlap

dbProduceOverlap( 
d_cellView 
l_bBox 
[ lx_level 
[ l_layerPurposePair ] ] 
) 
=> ld_shape / nil 

Description

Returns a list of all the shapes in a cellview whose bounding boxes overlap the area specified by l_bBox. This function interface is simpler than dbGetOverlaps if you are only interested in finding the overlapping shapes.

Arguments

d_cellView	The cellview.
l_bBox	Searching box.
lx_level	Search level. It can be two integers (start and stop level for the search), or a single integer (stop level, start level is zero). If no level argument is specified, the start and stop levels are both zero, so that only the top-level shapes are returned.
l_layerPurposePair
	Layer purpose pair. Defaults to all if not specified.

Value Returned

ld_shape	A list identifying all the overlapping shapes.
nil	An error occurred.

Examples

shapeList finds all the shapes on the top level.

shapeList = dbProduceOverlap(cv cv~>bBox)

shapeList finds all the shapes from level 1 to level 5.

shapeList = dbProduceOverlap(cv cv~>bBox 1:5)

shapeList finds all the shapes from the top level to level 4.

shapeList = dbProduceOverlap(cv cv~>bBox 4)

shapeList finds all the shapes on device layer with drawing purpose from the top level to level 4.

shapeList = dbProduceOverlap(cv cv~>bBox 4 "device")

Related Topics

Figure Creation and Retrieval Functions

Return to top