11 Display Resource File

The display resource file defines the packets that the Cadence^® design software use to display the layers in your design. It also defines the different display devices, such as monitors and plotters, that you use.

This chapter described the sections in the display.drf file in the following topics:

drDefineDisplay

drDefineDisplay(
(t_displayName)
…

Description

Lists the display devices for which display resources are defined in the display resource file.

The following table lists commonly used display devices.

Device Name	Type
display	Color monitor
hp6	Hewlett-Packard 6-carousel pen plotters
hp8	Hewlett-Packard 8-carousel pen plotters
psb	PostScript black-and-white plotters
versatecb	Versatec and CalComp black-and-white plotters
versatecc	Versatec and CalComp color plotters
XBlackWhite	Black-and-white X Window System monitors
X4PlaneColor	4-plane color X Window System monitors

For more information about setting up plotters, see Plotter Configuration User Guide.

Arguments

t_displayName

The name of the display device.
Valid values: Any unique string

Example

drDefineDisplay(
;( DisplayName )
 ( display )
 ( psb )
)

Defines display devices display and psb.

drDefineColor

drDefineColor(
(t_displayName t_colorName x_red x_green x_blue [g_blink])
…

Description

Defines the colors for a display device.

Arguments

t_displayName	The name of the display device. Valid values: A display device listed in `drDefineDisplay`
t_colorName	The name of the color. Valid values: Any unique string
x_red	The red index for the color. Valid values: An integer from `0` through `255`, inclusive
x_green	The green index for the color. Valid values: An integer from `0` through `255`, inclusive
x_blue	The blue index for the color. Valid values: An integer from `0` through `255`, inclusive
g_blink	Indicates that the color is blinking. Valid values: `t`, `nil`Default: `nil`

When you define a blinking and non-blinking version of the same color, we recommend that you append the character B to the name of the non-blinking color to name the blinking color, such as white and whiteB.

Example

drDefineColor(
;( DisplayName    ColorName    Red    Green    Blue   Blink )
 ( display        white             255    255      255          )
 ( display        whiteB       255    255      255    t     )
 ( display        yellow       255    255      0            )
 ( display        silver       217    230      255          )
 ( display        cream        255    255      204          )
 ( display        pink         255    191      242          )
 ( display        magenta      255    0        255          )
 ( display        lime         0      255      0            )
 ( display        tan          255    230      191          )
 ( display        cyan         0      255      255          )
 ( display        cadetBlue    57     191      25           )
 ( display        orange       255    128      0            )
 ( display        red          255    0        0            )
 ( display        purple       153    0        230          )
 ( display        green        0      204      102          )
 ( display        brown        191    64       38           )
 ( display        blue         0      0        255          )
 ( display        blueB        0      0        255    t     )
)

Defines colors for the display device display.

drDefineStipple

drDefineStipple(
(t_displayName t_stippleName l_stipplePattern)
…

Description

Defines the stipple patterns for the display devices.

Arguments

t_displayName

The name of the display device.
Valid values: A display device defined in drDefineDisplay

t_stippleName

The name of the stipple pattern.
Valid values: Any unique string

l_stipplePattern

A list of lists indicating the pattern of the stipple. The list has the following syntax:

( l_pattern … )

where, l_pattern is a pattern list defining the pattern of a portion of the stipple. Use 1 or t to indicate where the pattern is solid and 0 or nil to indicate where the pattern is blank.

Sample Stipple Patterns

The following illustrate a checker stipple pattern and a grid stipple pattern:

checker

((1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0)
 (1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0)
 (1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0)
 (1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0)
 (1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0)
 (1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0)
 (1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0)
 (1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0)
 (0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1)
 (0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1)
 (0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1)
 (0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1)
 (0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1)
 (0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1)
 (0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1)
 (0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1)
)

grid

((0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
 (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
 (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
 (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
 (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
 (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
 (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
 (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
 (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
 (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
 (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
 (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
 (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
 (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
 (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
 (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
)

Example

drDefineStipple(
;( DisplayName    StippleName
;  StipplePattern )
 ( display        solid   
  (
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
   (1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1)
  )
 )

 ( display        dots   
  (
   (0 1 0 0 0 1 0 0 0 1 0 0 0 1 0 0)
   (0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0)
   (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
   (0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0)
   (0 1 0 0 0 1 0 0 0 1 0 0 0 1 0 0)
   (0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0)
   (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
   (0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0)
   (0 1 0 0 0 1 0 0 0 1 0 0 0 1 0 0)
   (0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0)
   (0 0 0 1 0 0 0 1 0 0 0 1 0 0 0 1)
  )
 )
) ;drDefineStipple

Defines a solid stipple pattern and a stipple pattern with dots for the display device display.

drDefineLineStyle

drDefineLineStyle(
(t_displayName t_lineStyle x_size l_pattern)
…

Description

Defines the line styles for the display devices.

Arguments

t_displayName	The name of the display device. Valid values: A display device defined in `drDefineDisplay`
t_lineStyleName	The line style name. Valid values: Any string
x_size	The thickness of the line pattern, specified in pixels.
l_pattern	A list of binary values indicating the pattern of the line. Specify `1` or `t` to indicate where the line is solid and `0` or `nil` to indicate where the line breaks.

Sample Line Styles

The following illustrate a dashed line style, a line style made of dots, and a line style that is a combination of dashes and dots:

dashed	`list(1 1 1 1 0 0)`
dots	`list(1 0 0)`
dashDot	`list(1 1 1 0 0 1 0 0)`

Example

drDefineLineStyle(
;( DisplayName       LineStyle     Size      Pattern               )
 ( display           solid          1        (1 1 1)               )
 ( display           dashed         1        (1 1 1 1 0 0)         )
 ( display           dots           1        (1 0 0)               )
 ( display           dashDot        1        (1 1 1 0 0 1 0 0)     )
 ( display           shortDash      1        (1 1 0 0)             )
 ( display           doubleDash     1        (1 1 1 1 0 0 1 1 0 0) )
 ( display           hidden         1        (1 0 0 0)             )
 ( display           thickLine      3        (1 1 1)               )
) ;drDefineLineStyle

Defines a number of line styles for the display device display.

drDefinePacket

drDefinePacket(
(t_displayName t_packetName t_stippleName
 t_lineStyleName t_fillColor t_outlineColor
 [t_fillStyle]
)
…

Description

Defines packets of display information. Packets are used in the technology file to define how layers look.

Arguments

t_displayName	The name of the display device. Valid values: A display device defined in `drDefineDisplay`
t_packetName	The name of the display packet. Valid values: Any string; the packet name must be unique for a display device See Guidelines for Naming Display Packets for more information.
t_stippleName	The name of the stipple pattern. Valid values: A stipple defined in `drDefineStipple`
t_lineStyleName	The name of the line style. Valid values: A line style defined in `drDefineLineStyle`
t_fillColor	The name of the fill color. Valid values: A fill color defined in `drDefineColor`
t_outlineColor	The name of the outline color. Valid values: An outline color defined in `drDefineColor`
t_fillStyle	The name of the fill style. If specified, this value overrides stipple and line styles. Valid values: `outline`, `solid`, `x`, `stipple`, `outline stipple`See Fill Styles for more information.

Guidelines for Naming Display Packets

We recommend that you adhere to the guidelines outlined in this section while naming a display packet.

A display packet name must have the following structure:

color[stipple][line][_[S][L][N][B]]

where,

color	Specifies the fill and outline colors in the following format: `[ fill ] [ outline ]` At least one color name must be specified. Specify colors according to the following rules: When the fill and outline colors are different, specify the fill color followed by the outline color. When the fill and outline colors are the same, specify that one color. When the fill and outline colors are the same, but the outline color is blinking, append `B` to the color name when specifying the outline color; for example, `white` and `whiteB`. If the outline color name is constructed in any other way (for example, `white2`), specify both colors (`whitewhite2`).
stipple	Specifies a stipple pattern name. This field is optional; if a value is not specified, it indicates the default stipple pattern, `blank`.
line	Specifies a line style name. Default (when the packet name does not contain `N` in the extension): `solid` Default (when the packet name contains `N` in the extension: `none`
`_SLNB` extension	`S` indicates that the stipple pattern name is specified and the line style is the default (`solid`). `SN` indicates that the stipple pattern name is specified and the line style specified is `none`. `L` indicates that the line style name is specified and the stipple pattern is the default (`blank`). `N` indicates that the line style specified is `none`. `B` indicates that the outline color is a blinking color. Only the outline color can be a blinking color; the fill color must be non-blinking. See drDefineColor for information about defining colors.

The packet name must not contain spaces and the underscore character (_) must precede the SLNB extension.

The following table shows sample combinations of color, stipple, and line resources and the packet names correctly built according to the packet naming convention.

Fill Color	Outline Color	Stipple Pattern	Line Style	Packet Name
blue	blue	blank	solid	`blue`
blue	blue	blank	dashed	`bluedashed_L`
blue	blue	solid	solid	`bluesolid_S`
blue	blue	metal1S	solid	`bluemetal1S_S`
blue	blue	metal1S	none	`bluemetal1S_SN`
cream	white	contp	solid	`creamwhitecontp_S`
green	green	brick	mLine	`greenbrickmLine`
red	red	X	thickLine	`redXthickLine`
red	Blinking red named redB	x	solid	`redx_SB`
red	Blinking red named red2	solid	none	`redred2solid_SNB`

Fill Styles

The table below defines the fill styles.

A fill style overrides stipple and line styles.

Fill Style	Result
`outline`
`solid`
`X`
`stipple`	(The specified stipple pattern determines the fill.)
`outline stipple`	(The specified stipple pattern determines the fill.)

Customizing Display Packets for Plotting

You can set up your display resource file so that a display packet appears differently on different display devices. For example, if your plotter uses only seven colors and you display your design using 12 colors, you can modify the display packets used by the layers in your design specifically for the plotting device.

You can also define a display packet with the same name, but with different content for each display device, as shown in the following example:

Example

drDefinePacket(
;(Display  PacketName           Stipple  LineStyl  Fill    Outline   fillSt)
 ( psb     red                  blank    solid     red     red       X     )
 ( psb     red_B                blank    solid     red     redB            )
 ( psb     redredblnk_B         blank    solid     red     redblnk   solid )
 ( psb     white                blank    solid     red     white           )
 ( psb     whitedots_L          blank    dots      red     white           )
 ( psb     redhash_SN           hash     none      red     white           )
 ( psb     blueyellowslash_S    slash    solid     blue    yellow          )
 ( psb     blueyellowslash_SN   slash    none      blue    yellow    solid )
 ( psb     whitered_N           blank    none      white   red             )
 ( psb     greenblackBdot1_SB   dot1     solid     green   blackB          )
)

Defines display packets for the display device psb.

drDefinePacketAlias

drDefinePacketAlias(
(t_displayName t_packetAlias t_packetName)
…

Description

Defines an alias for the specified packet. As a result, you can use the display packet name as well as the alias to access the display packet. This allows flexibility in assigning display packets to display devices. You can alias an existing display packet name to another display packet name to change the display packet in use for a given display device.

Arguments

t_displayName	The name of the display device. Valid values: A display device defined in `drDefineDisplay`
t_packetAlias	The alias for the display packet name. Valid values: A display device defined in `drDefineStipple`
t_packetName	The name of the display packet for which the alias needs to be defined. Valid values: A packet defined in `drDefinePacket`

Example

drDefinePacketAlias(
    ("display" "redSolid1" "redSolid")
)

Defines redSolid1 as an alias for the display packet redSolid when used with the display device display.

Return to top

Virtuoso Technology Data ASCII Files ReferenceProduct Version IC23.1, June 2023

11

Display Resource File

drDefineDisplay

Description

Arguments

Example

drDefineColor

Description

Arguments

Example

drDefineStipple

Description

Arguments

Sample Stipple Patterns

Example

drDefineLineStyle

Description

Arguments

Sample Line Styles

Example

drDefinePacket

Description

Arguments

Guidelines for Naming Display Packets

Fill Styles

Customizing Display Packets for Plotting

Example

drDefinePacketAlias

Description

Arguments

Example

Virtuoso Technology Data ASCII Files Reference
Product Version IC23.1, June 2023