Product Documentation
Virtuoso Studio Design Environment SKILL Reference
Product Version IC23.1, November 2023

dbInstSetLayerShifts2

dbInstSetLayerShifts2(
d_instId
l_layerShifts
)
=> t / nil

Description

Sets the given l_layerShifts on the specified instance.

All layer shift settings can be applied to layers with three masks. Only noShift and shift1Shift can be applied to layers with two masks.

Layer shifting cannot be run in the following conditions:

You must initialize the layer shift information for a cellview before setting them on the instances. To do this, run dbCellViewUpdateLayerShifts(cv) where cv is the cellview ID. Otherwise, when you run dbInstSetLayerShifts2 on these instances, nil is returned and layer shifts are not set.

Arguments

d_instId

Specifies the instance ID

l_layerShifts

Lists the layer-shift pairs to be set on the specified instance. Each layer-shift pair is represented as list(g_layer t_shift) where, g_layer is the layer name or layer number and t_shift is one of the following:

  • noShift: There is no color shifting on this layer.
  • shift1Shift: Shifts colors by one (mask1Color to mask2Color, mask2Color to mask3Color, mask3Color to mask1Color).
  • shift2Shift: Shifts colors by two (mask1Color to mask3Color, mask2Color to mask1Color, mask3Color to mask2Color).
  • fixedMask1Shift: Shapes with mask1Color are not changed; shifts mask2Color to mask3Color, and mask3Color to mask2Color.
  • fixedMask2Shift: Shapes with mask2Color are not changed; shifts mask1Color to mask3Color, and mask3Color to mask1Color.
  • fixedMask3Shift: Shapes with mask3Color are not changed; shifts mask1Color to mask2Color, and mask2Color to mask1Color.

Value Returned

t

Returns t if the master layer shifting information is successfully set

nil

Returns nil if an error occurs while setting the master layer shifting information

Example

Sets the layer-shift pairs for instance inst on layer number 30, layer number 31, and Metal3 to noShift, fixedMask2Shift, and shift1Shift, respectively.

shiftVals = list(list(30 "noShift") list(31 "fixedMask2Shift") list("Metal3" "shift1Shift"))
dbInstSetLayerShifts2(inst shiftVals)

Return to top
 ⠀
X