dbSetOccShapeColorLocked

dbSetOccShapeColorLocked( 
l_occShape
g_setLocked
)
=> t / nil

Description

Changes the color state of the specified occurrence shape. You can set the color state for occurrence shapes with types Path, PathSeg, Polygon, and Rect.

Arguments

l_occShape

list(l_hierPath d_shapeId) where, l_hierPath is list((d_refId | l_mosaicElem)…) where, d_refId The database ID of the non-mosaic instance or via. l_mosaicElem is list(d_mosaicId x_row x_col) Represents a mosaic element in the hierarchy path. where, d_mosaicId The database ID of the mosaic instance. x_row Row in which d_shapeId occurs inside this mosaic instance. x_col Column in which d_shapeId occurs inside this mosaic instance. d_shapeId The database ID of the shape. Supported shapes: Path, PathSeg, Polygon, Rect

g_setLocked

t|nil t The occurrence shape will be locked. nil The occurrence shape will be unlocked.

Value Returned

t	Color state of the specified occurrence shape is set.
nil	Returned in case of an error. An error occurs when an attempt is made to: Set the color state of a non-colorable shape. Set the color state of an occurrence shape that has color set to "grayColor". Set the color state for an occurrence shape with a type other than Path, PathSeg, Polygon, or Rect.

Examples

Creates a one-level occurrence shape rect0, then sets it color to mask1Color and locks the color.

cv = dbOpenCellViewByType("tech" "design" "layout" "maskLayout" "w")
top = dbOpenCellViewByType("tech" "top" "layout" "maskLayout" "w")
inst = dbCreateInst(top cv "InstInTop" '(0 0) "R0")
rect0 = dbCreateRect(cv '("metal2" "drawing") '((1 8.6) (5.3 6.6)))
path = list(list(inst) rect0)
dbSetOccShapeColor(path "mask1Color")
dbSetOccShapeColorLocked(path t) 

Creates a via, then sets the color of a randomly picked shape from the via master to mask2Color and locks the color.

viaDef_M2_M1 = techFindViaDefByName(tf "M2_M1")
via1t_m2_m1 = dbCreateVia(cv viaDef_M2_M1 10:10 "R0")
path = list(list(via1t_m2_m1) nth(1 via1t_m2_m1~>viaHeader~>master~>shapes))
dbSetOccShapeColor(path "mask2Color")
dbSetOccShapeColorLocked(path t)+Creates a via, then sets the color of a randomly picked shape from the via master to mask2Color and locks the color.

Return to top