Add Objects to the Display List

This topic provides a list of Cadence^® SKILL functions associated with adding objects to the display list.

Objects are added to the display list in the following manner:

dlAddObject(w_dlist x_penNumber...... [s_tagSymbol]) 
=> t | nil

The first two arguments are always the same. w_dlist is the display list the object should be added to, and x_penNumber is the number of the pen the object will use when it is drawn.

Pens are collected into a group called a pen table. If you use the default pen table, then there are 64 pens available to you. The pen numbers start at 0; therefore, if you use the default pen table, you can use numbers ranging from 0 to 63. The s_tagSymbol is an optional symbol given so you can refer to this shape again. It is always the final argument to a dlAdd function. If you define your own pen table, then you can use fewer or more pens; the more pens you create, the more memory is required.

The coordinates are specified using integer numbers and can be any range you choose. All coordinates specified assume 0:0 to be the lower-left corner of the display list object. The display list is automatically scaled to fit into a given area, much like a geFull function does with a database object. You should, however, try to choose your coordinate space so it isn’t too small. This can avoid integer round-off when converting from display list coordinates to screen coordinates.

All dlAddObject functions return t on success, and nil on failure. Conditions for failure are either an invalid dlist argument, or a pen number outside a valid range.

Only the functions listed here are supported for public use. All other functions, regardless of their name or prefix, and undocumented aspects of the functions described below, are private and are subject to change at any time.

• dlAddArc
• dlAddBox
• dlAddCircle
• dlAddDonut
• dlAddEventObject
• dlAddPath
• dlAddPoint
• dlAddPolygon
• dlAddRasterText
• dlAddSegment
• dlAddSkillObject
• dlAddStrokeText
• dlMakeDisplayList
• dlSetClearOnDraw

Return to top