Product Documentation
Virtuoso Technology Data User Guide
Product Version IC23.1, June 2023

6


Editing, Reusing, and Merging Display Resources

This chapter discusses the following topics:

Using Display Resource Manager

Display Resource Manager lets you manipulate display resources available in virtual memory during a design session.

Opening Display Resources Tool Box

From the CIW menu bar, choose Tools – Display Resource Manager to open the Display Resources Tool Box form.

SKILL Function

techManagerOpenDisplayToolBox() 

Using Display Resources Tool Box

The Display Resources Tool Box form provides access to the following two commands:

Editing Display Resources

During a design session, you can edit display resources loaded in virtual memory, load an existing display resource file into virtual memory, or create a new display resource file from the data currently loaded in virtual memory.

To edit the display resources currently loaded in virtual memory, you can use the following methods:

You can save to a new display resource file on disk either all the display resource data currently loaded in virtual memory or only the display resource data that you modified during a design session. For more information, see Saving Display Resource Data to a File.

To reuse an existing display resource file to create a new one, create a copy of the existing file and edit it in a text editor. The sequence in which this new file is loaded and used depends on where you store it. For more information, see How Cadence Design Software Handles Multiple Display Resource Files.

For information about creating a new display resource file from scratch, see Display Resource File Development.

Merging Display Resource Files

While working on a design, you can merge multiple display resource files into one file, and, if required, load this file into virtual memory. During the merge operation, if a resource is defined in more than one display resource file, its definition in the last merged file overrides any other definitions. Therefore, to obtain the results that you want, you must be aware of the resources defined in the various display resource files that you want to merge and the order in which these files should be merged.

The following example illustrates how the merge operation overwrites display resource definitions that are defined differently in the display resource files being merged:

Merging Multiple Display Resource Files

To merge multiple display resource files:

  1. In the Display Resources Tool Box form, click Merge.
  2. Click OK to close the message box that is displayed.
    The Merge Display Resource Files form is displayed.
  3. Identify the files that you want to merge and the order in which you want to merge them.
    The order of selection is important. If a display resource is defined in more than one file, its definition in the last merged file overwrites any other definition.
  4. To select the files to merge, do one of the following for each file, starting with the file that you want to be merged last:
    • In the From Library list box, select a library name. The name of the display resource file stored in that library appears in the Merge DRF files in sequence list box, along with the location where it is stored.
    • In the From File field, specify a filename (you can click Browse to select the required file) and click Add. The filename appears in the Merge DRF files in sequence box.
      When you add a file, it is added to the bottom of the list in the Merge DRF files in sequence list box. The listed files are merged from the bottom up. Consequently, the file you add first is merged last and the file you add last is merged first.
  5. In the Destination DRF field, specify the path and the name of the new file.
    The file must be named display.drf, and if you want to automatically load this file when you run the software, it must be saved to a location where the DFII initialization process can read it. You must also take into account any other display.drf files loaded at the time of initialization. For more information, see How Cadence Design Software Handles Multiple Display Resource Files.
  6. Ensure that the Load Merged DRF check box is selected (the default) if you want the file to be automatically loaded into virtual memory after the merge operation is complete.
    If you do not want to immediately view the results of the merge operation, you can load the file later from the Display Resource Editor.
  7. Click OK or Apply.

Using Display Resource Editor

Display Resource Editor (DRE) lets you edit the display resource data loaded in virtual memory. Depending on your system setup, this data may be a combination of multiple display resource files. For more information, see How Cadence Design Software Handles Multiple Display Resource Files.

In the Display Resources Tool Box form, click Edit to open the Display Resource Editor form.

The Display Resource Editor form is displayed.

The options shown in the figure below determine the view mode:

When the view mode is set to All Packets or Active Palette Filtered LPPs, the name of the active technology library can be determined from the message that appears on the status bar, as shown below.

Accessing Display Resource Data through Display Resource Editor

With Display Resource Editor, You can edit most, but not all, of the display resource data loaded in virtual memory. The following is a list of search and editing functions that you can perform with Display Resource Editor:

The following is a list of functions that you cannot perform with Display Resource Editor:

To perform these functions, you must edit the display.drf file in a text editor or edit the display resource data in virtual memory by using SKILL functions.

After you have edited the display resource data, you can perform the following functions by using Display Resource Editor:

Finding a Display Packet or a Layer-Purpose Pair by Name

To find a display packet with a specific name, type the name in the Search text box. As you type each character, the list below is automatically updated to display the packets or layer-purpose pairs that match the search string. Click the Clear button to cancel the filter.

Adding a Display Packet Definition

To add a new display packet definition:

  1. In the Display Resource Editor form, select the required view mode as All Packets.
  2. Select an existing display packet, and, in the right pane, select the Fill Color, Outline Color, Stipple, and Line Style attributes that you want to set for the new display packet.
  3. In the text box to the left of the Create New Packet button, type a name for the new packet and click Create New Packet.
    The Create New Packet button is enabled when you type a name in the text box.
    The new display packet is created and listed in the Packet Name list in the left pane. It is also added to the display resource data loaded in virtual memory.

To save your changes to disk, use the Save As form. For more information, see Saving Display Resource Data to a File.

Editing a Display Packet Definition

Display packets control how layers are displayed and plotted in designs. A display packet can be common to many layers. When you change the definition of a display packet, all layers that use that display packet are automatically updated.

To change a display packet definition loaded in virtual memory, do the following:

  1. In the Display Resource Editor form, select the required view mode as All Packets.
  2. Scroll down the list of packets or use the Search field to locate the required display packet.
    The Fill Color, Outline Color, Stipple, and Line Style attributes currently set for the selected packet are highlighted in the right pane.
    You can also set the view mode to All LPPs, All Valid LPPs, or Active Palette Filtered LPPs to select an LPP, if required. This displays in the right pane the attributes of the display packet used by the selected LPP. Several LPPs can share the same display packet. Therefore, when you change the display packet definition for one LPP, the appearance of all other LPPs that use the display packet is updated. To view a list of LPPs that use the same display packet, click the Associations tab.
  3. Select the required Fill Color, Outline Color, Stipple, and Line Style attributes for the display packet.
  4. Click Modify Current Packet.
    The display packet definition loaded in virtual memory is updated. The icon for the display packet in the Display Resource Editor is also updated with the newly set attributes. If a cellview is open, it is automatically updated.
    To save your changes to disk, use the Save As form. For more information, see Saving Display Resource Data to a File.

Adding Color

To add a new color to the color set, do the following:

  1. In the Display Resource Editor form, click Custom in the Fill Color or Outline Color column.
    The Color Editor form is displayed, with the current color loaded in the swatch area.
    If a color does not appear in the swatch area, see Virtuoso Studio Design Environment User Guide for information about mapping colors.
  2. In the text box to the left of the Create New button, type a name for the new color and click Create New. The new color is listed in the Color list above.
    The Create New button is enabled when you type a name in the text box.
  3. Drag the slider up or down, or type in the Red, Green, and Blue fields the required values, to create a new color.
    The color corresponding to the specified values is displayed in the Modified swatch area.
  4. Select the Blink check box to make the color a blinking color.
  5. Click Apply or Ok.
    The new color is listed in the Display Resource Editor form. It is also added to the display resource data loaded in virtual memory.

To save your changes to disk, use the Save As form. For more information, see Saving Display Resource Data to a File.

Editing Color

Fill and outline colors come from the same set of colors. To edit an existing color, do the following:

  1. In the Display Resource Editor form, select the required color and click Custom in the Fill Color or Outline Color column.
    The Color Editor form is displayed, with the selected color loaded in the swatch area. If a color does not appear in the swatch area, see Virtuoso Studio Design Environment User Guide for information about mapping colors.
  2. Drag the sliders up or down, or type in the Red, Green, and Blue fields the required values, to edit the color. The color corresponding to the specified values is displayed in the Modified swatch area.
  3. Select the Blink check box to make the color a blinking color.
  4. Click Apply or Ok.
    The new color is listed in the Display Resource Editor form. It is also added to the display resource data loaded in virtual memory.

If a cellview is open, the layer information in the Palette is automatically updated. To update the cellview, choose View – Redraw. To save your changes to disk, use the Save As form. For more information, see Saving Display Resource Data to a File.

Adding a Stipple Pattern

To add a new stipple, do the following:

  1. In the Display Resource Editor form, click Custom in the Stipple column.
    The Stipple Editor form is displayed.
  2. In the text box to the left of the Create New button, type a name for the new stipple and click Create New. The new stipple is listed in the Stipple list above.
    The Create New button is enabled when you type a name in the text box.
  3. From the grid resolutions listed under Size, select the required value.
  4. Click the pixels in the grid until the Modified swatch area shows the required stipple pattern.
    • To clear all the pixels in the grid, click Clear.
    • To invert the pixel selection, click Invert.
  5. Click Apply or Ok.
    The new stipple is listed in the Display Resource Editor form. It is also added to the display resource data loaded in virtual memory.

To save your changes to disk, use the Save As form. For more information, see Saving Display Resource Data to a File.

Editing a Stipple Pattern

To edit a stipple, do the following:

  1. In the Display Resource Editor form, select the required stipple and click Custom in the Stipple column.
    The Stipple Editor form is displayed, with the selected stipple loaded in the swatch area.
    You cannot modify a reserved stipple.
  2. Select a grid resolution from those listed under Size, if required, and click the pixels in the grid until the Modified swatch area shows the required stipple pattern.
    • To clear all pixels in the grid, click Clear.
    • To invert the pixel selection, click Invert.
    • To start again with the original pattern, click the stipple name in the Stipple list. You can also select another stipple to edit, if required.
  3. Click Apply or Ok.
    The new stipple pattern is listed in the Display Resource Editor form. It is also added to the display resource data loaded in virtual memory.

If a cellview is open, the layer information in the Palette is automatically updated. To update the cellview, choose View – Redraw. To save your changes to disk, use the Save As form. For more information, see Saving Display Resource Data to a File.

Adding a Line Style

To add a new line style, do the following:

  1. In the Display Resource Editor form, click Custom in the Line Style column.
    The Line Style Editor form is displayed.
  2. In the text box to the left of the Create New button, type a name for the new line style and click Create New. The new line style is listed in the Line Style list above.
    The Create New button is enabled when you type a name in the text box.
  3. In the Size field, specify the required grid resolution.
  4. In the Thickness field, specify the required line thickness.
  5. Click the pixels in the grid until the Modified swatch area shows the required line style pattern.
    • To clear all the pixels in the grid, click Clear.
    • To invert the pixel selection, click Invert.
  6. Click Apply or Ok.
    The new line style is listed in the Display Resource Editor form. It is also added to the display resource data loaded in virtual memory.

To save your changes to disk, use the Save As form. For more information, see Saving Display Resource Data to a File.

Editing a Line Style

To edit a line style, do the following:

  1. In the Display Resource Editor form, select the required line style and click Custom in the Line Style column.
    The Line Style Editor form is displayed, with the selected line style loaded in the swatch area.
    You cannot modify a reserved line style.
  2. In the Size field, specify a grid resolution, and in the Thickness field, specify the line thickness, if required, and click the pixels in the grid until the Modified swatch area shows the required line style pattern.
    • To clear all pixels in the grid, click Clear.
    • To invert the pixel selection, click Invert.
    • To start again with the original pattern, click the line style name in the Line Style list. You can also select another line style to edit, if required.
  3. Click Apply or Ok.
    The new line style is listed in the Display Resource Editor form. It is also added to the display resource data loaded in virtual memory.

If a cellview is open, the layer information in the Palette is automatically updated. To update the cellview, choose View – Redraw. To save your changes to disk, use the Save As form. For more information, see Saving Display Resource Data to a File.

Adding a Display Device

A display device is a piece of hardware, such as a monitor or a plotter, which you use to display, plot, or print designs. You can define a display packet to appear differently on different display devices. The table below lists commonly used display devices.

For information about setting up plotters, refer to the Plotter Configuration User Guide.

Device Name Type

display

Color monitors

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

To add a display device, do the following:

  1. From the Device list, choose Add New.
  2. In the text box that is displayed, type the new device name.
  3. Press Enter.
    The new display device is added to the Device list and set as the active device.

To save your changes to disk, use the Save As form. For more information, see Saving Display Resource Data to a File.

Deleting Display Resources

You must always exercise caution while deleting display resources because the display resource that you delete could be in use in multiple technology libraries and designs.

Deleting Colors, Stipples, Line Styles, and Devices

Before you delete a display resource such as a color, stipple, or line style, consider the following:

You can create display resource files in your home directory for personal use. If the data in these files overwrites the default data, you may need to delete these personal display resource files and reinitialize the display resource data.

Finding Display Packets Affected by Deleting a Display Resource

To determine which display packets are affected by deleting a display resource, do the following:

  1. Save all the display resource data currently loaded in virtual memory. For more information, see Saving Display Resource Data to a File.
  2. In a text editor, open the file that you just created and search for the name of the display resource that you want to delete.
    Line styles and stipples can have the same name.
    The following figures show samples of display resource definitions:
    • A color definition
    • A stipple definition
    • A line style definition
  3. Search for the display resource name again to locate a display packet definition that uses the display resource.
    A display packet definition
  4. Note down the name of the display packet.
  5. Repeat steps 6, 7, and 8 until you have located all the display resource definitions that use the display resources that you want to delete.
  6. Exit the text editor.

Deleting a Display Resource from a Display Resource File

Do the following for each source display resource file that you want to edit.

If you make a change to a local display resource file or to a display resource file in your design management system, you need to inform the designers who use that design hierarchy.
  1. In a text editor, open the display resource file.
  2. Search for the name of the display resource to delete.
  3. Delete the definition of the display resource.
    For example, to delete the wide line style, delete the definition starting from the opening parenthesis through the closing parenthesis.
  4. For each display packet that uses the display resource just deleted, replace the deleted display resource with an existing display resource.
    For example, you may want to replace the wide line style with the solid line style, as shown below:
    For information about locating all such display packet names, see Finding Display Packets Affected by Deleting a Display Resource.
  5. Save the file and exit the text editor.
  6. Repeat this procedure for all display resource files from which you want to delete a display resource.
  7. Broadcast your changes to all users of your design hierarchy.
    The following is a sample broadcast message:
You can also use SKILL functions to delete display resources in virtual memory. For more information, see Editing Display Resource Data with SKILL Functions.

Deleting a Display Packet

Technology files reference display packet names. Therefore, before you delete a display packet, ensure that your technology files do not reference that display packet. As a precaution, consider leaving unused display packets in your display resource file for later use.

You can also use SKILL functions to delete display resources in virtual memory. For more information, see Editing Display Resource Data with SKILL Functions.

Loading a Display Resource File in Virtual Memory

When you load a display resource file, the data in the file is merged with the data that is already loaded in virtual memory. To merge additional display resource data with the display resource data in virtual memory, perform the following steps:

  1. In the Display Resource Editor form, choose File – Load.
    The Open form is displayed.
  2. Select a file to load.
  3. In the Mode group box, choose Merge.
    To replace the display resource data in virtual memory, choose Replace.
  4. Click Open.
    The selected file is loaded into virtual memory and Display Resource Editor is updated with the display resource data from the selected file. If a cellview is open, choose View – Redraw to update the cellview.
    However, if you have any unsaved changes, you are prompted to save your changes first. For more information about how to save the changes made to the display resource data in virtual memory, see Saving Display Resource Data to a File.

Saving Display Resource Data to a File

You can save the display resource data loaded in virtual memory to a text file that you can use in future sessions. Additionally, you can save either all the display resource data or only the changes that you made during a design session. To use the new display resource file in a design session in future, you can place the file in your home directory or in the directory from which you run the software. By placing the customized display resource data in your home directory, you have control over how your designs appear on screen and in plots.

If you save all the display resource data available in virtual memory, the saved file contains all the display resource data loaded at the start of the software session plus the changes made during the session. In this case, you may want to edit the saved file to include only the data you need before you place the file in your home directory. For more information, see Editing a Display Resource File.

To save to a file the display resource data currently loaded in virtual memory, do the following:

  1. In the Display Resource Editor form, choose File – Save.
    The Save As form is displayed.
  2. Select the directory to which you want to save the file, and in the File name text box, specify a name for the file.
  3. Ensure that the Save Change check box is deselected if you want to save all the display resource data currently loaded in virtual memory. To save only the display resource data modified during the current design session, select the Save Change check box.
  4. Click Save.
    A display resource file with the specified name is created.

You can now do one of the following:

If you did not save your changes while exiting Display Resource Editor (or if you made changes using SKILL functions), the Save Display Information form, shown below, is displayed when you exit Virtuoso. Type a filename in the File Name field and click OK to save your changes, or click Cancel to discard your changes.

If you do not want this form to be displayed when you exit Virtuoso, set the drmSuppressSaveDialogBox to t in the CIW, as shown below. As a result, any changes that you have made are automatically discarded.

envSetVal("layout" "drmSuppressSaveDialogBox" 'boolean t)

The default value of this environment variable is nil. You can also include it in the .cdsenv file in your home directory or in the .cdsinit file.

Reloading Source Display Resource Files

If you modified the display resource data in your current design session and now want to reload the data you started with, do the following:

  1. In the Display Resource Editor, choose File – Reinitialize.
  2. In the dialog box that is displayed, click OK.
    The source display resource files on disk are loaded into virtual memory in sequence. For more information, see How Cadence Design Software Handles Multiple Display Resource Files.

Setting Selection Display Colors and Dynamic Highlights

You can specify different colors to distinguish between selected and unselected objects on the same layer. You can also choose to specify the dynamicHilight display packet to dynamically highlight objects in the design.

Setting Selection Display Colors

If the useSelectDeviceForSelectionDisplay environment variable is set to t, the select and hierSelect devices, if defined, determine the display attributes of the selected objects. The hierSelect device lets you use different display packets for hierarchical objects such as instances and vias. The default value of this environment variable is nil.

envSetVal("graphic" "useSelectDeviceForSelectionDisplay" 'boolean t)

If the environment variable is set to t, but the select and hierSelect devices are not found, the default display device is used. You can add the select and hierSelect devices either by using the Display Resource Editor form or by including them in the drDefineDisplay section of the display.drf file.

Setting Dynamic Highlights

If you set the useDynamicHilightPacket environment variable to t, a packet named dynamicHilight, which determines how dynamic highlights around objects appear, is automatically created when you first dynamically highlight an object. However, this packet is not saved automatically in display.drf.

envSetVal("graphic" "useDynamicHilightPacket" 'boolean t)

If you save this packet, it is available in Display Resource Editor even when the environment variable is set to nil.

The useDynamicHilightPacket environment variable is also defined in the "layout" partition. As a result, the appearance of the dynamic highlights in layout windows can be different from that in other graphic applications.

envSetVal("layout" "useDynamicHilightPacket" 'boolean t)

The default value of this environment variable is nil.

Editing Display Resource Data with SKILL Functions

The following table lists the SKILL functions that return information and operate on display resource data:

SKILL Function Description

drDeleteDisplay

Deletes the specified display device from virtual memory.

drDeleteColor

Deletes the definition of the specified color for the specified display device from virtual memory.

drDeleteLineStyle

Deletes the specified line style from virtual memory.

drDeletePacket

Deletes the definition of the specified display packet for the specified display device from virtual memory.

drDeleteStipple

Deletes the definition of the specified stipple for the specified display device from virtual memory.

drDumpDrf

Dumps to a file either all the display resource data in virtual memory or only the changes made in virtual memory.

drFindPacket

Reads virtual memory and returns a list of attributes of the specified display packet for the specified display device.

drGetColor

Reads virtual memory and returns the display device, the color name, and the red, green, blue, and blink values for the specified color.

drGetDisplay

Reads virtual memory and returns the display device identifier of the specified display device name.

drGetDisplayIdList

Reads virtual memory and returns a complete list of display device identifiers.

drGetDisplayName

Reads virtual memory and returns the display device name of the specified display device identifier.

drGetDisplayNameList

Reads virtual memory and returns a complete list of display device names.

drGetLineStyle

Reads virtual memory and returns the display device name and the line style name, thickness, and pattern for the specified line style.

drGetLineStyleIndexByName

Reads virtual memory and returns the line style index number for the specified line style for the specified display device.

drGetPacket

Reads virtual memory and returns the definition of the specified display packet for the specified display device.

drGetPacketList

Reads virtual memory and returns a list of display packets defined for the specified display device.

drGetPacketAlias

Reads virtual memory and returns a list of display packets aliased to the specified display packet.

drGetPacketFillStyle

Reads virtual memory and returns the fill style number of the specified display packet for the specified display device.

drGetStipple

Reads virtual memory and returns the display device name and the stipple name, width, height, and pattern for the specified stipple.

drGetStippleIndexByName

Reads virtual memory and returns the stipple index number for the specified stipple name.

drLoadDrf

Loads the display resource file (usually named display.drf) from any location.

drSetPacket

Updates in virtual memory the value of the specified display packet for the specified display device.

For more information about these SKILL functions, see Virtuoso Technology Data SKILL Reference.

Editing a Display Resource File

You can edit in a text editor a display resource file, which you had saved earlier, to retain only the customized display resources. For this, do the following:

  1. Create a backup copy of the file.
  2. In a text editor, open the original copy of the file.
  3. Insert comments in the file to keep a record of the reason for customization and the details of the customized data, as shown below:
    ; Created 1/24/15 for Emerald project.
    ; Changed red color to look tan.
  4. Delete all lines except those defining the display resources that you had customized. You can choose to preserve the original display device, color, stipple, line style, and display packet definitions as comments.
    • Customizing a display device
    • Customizing a color
    • Customizing a stipple
    • Customizing a line style
    • Customizing a display packet
  5. Save the changes and exit the text editor.
  6. Test the customized resource data file. For more information, see Testing a Display Resource File.
  7. After verifying that the customized display resource definitions work as expected, do one of the following:
    As a result, your changes are automatically loaded every time you run the software.

Testing a Display Resource File

To test a display resource data file, do the following:

  1. In the Display Resource Editor form, choose File – Reinitialize.
  2. In the dialog box that is displayed, click OK.
    The source display resource files on disk are reloaded into virtual memory in sequence. For more information, see How Cadence Design Software Handles Multiple Display Resource Files.
  3. Choose File – Load.
    The Open form is displayed.
  4. In the File name field, type the name of the file that you edited.
  5. Click Open.
    If there are errors in your file, messages are displayed in CIW and in the techManager.log file.
  6. Open a cellview and look for objects that use the customized display resources.

Return to top
 ⠀
X