Display List Draw Functions

This topic provides a list of Cadence^® SKILL functions associated with Display list Draw. These dlDraw functions are only used within a SkillObject procedure. They render shapes to the screen. The display list processing functions transform the coordinates of your SkillObject to the box you specified when you added it to the display list. Therefore, the coordinates you specify when calling a dlDraw function are specified such that 0:0 is coincident with the lower-left corner of the SKILL object.

For example,

dlAddSkillObject( dlist 4 100:100 200:200
       "mySkillObject" "10")
dlAddSkillObject( dlist 4 300:300 400:400
       "mySkillObject" "20")

The display list functions call your procedure:

mySkillObject( 100:100 200:200 10)
mySkillObject( 300:300 400:400 20)

If you want to draw a circle and have the radius passed to you, define your SkillObject as:

procedure( mySkillObject( ll ur radius)
prog( ( )
dlDrawCircle( 50:50 radius)
return(t)
) ; end prog
) ; end procedure

There is a dlDraw function for all shapes the dlAddObject functions provide, except for dlAddSkillObject. The arguments to the dlDraw functions are the same as the dlAddObject functions, except for the w_dlist and x_penNumber arguments (which are not necessary, since the values from the SKILL object are used).

The dlDraw functions returns t when the object is drawn, and nil if the dlDraw function is called outside a SkillObject procedure.

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.

• dlDrawArc
• dlDrawBox
• dlDrawCircle
• dlDrawDonut
• dlDrawPath
• dlDrawPoint
• dlDrawPolygon
• dlDrawRasterText
• dlDrawSegment
• dlDrawStrokeText

Return to top