- figure ->initialise:
- Create an empty figure. In addition to device
->initialise,
it assigns figure<-background
to @nil, graphical<-pen
to 0 and figure<-status
to all_active.
- figure ->compute:
- Recompute the figure: lay out the children, refresh figure
<-local_area,
update the bounding box and propagate figure<-transform
into the parent-coordinate area. Triggered automatically after slot
changes; rarely called directly.
- figure ->display: graphical,
[point]
- Similar to device
->display,
but if figure<-status
not is all_active and the graphical has not the same name, the graphical
is added to the figure with graphical<-displayed: @off.
- figure ->next_status:
- Advance figure
<-status
to the name of the next graphical in
device<-graphicals
(wrapping at the end). No-op when figure<-status
is
all_active. Convenient for cycling through alternative
representations.
- figure ->clip_area: area*
- Restrict the children's drawing and event-area to the indicated
rectangle in the figure's coordinate system. @nil
disables clipping (children draw and receive events on their full
extent).
- figure ->shadow: 0..
- Backward-compatible shortcut that attaches a shadow elevation
object of the given height. 0 removes the elevation. Equivalent to
creating an explicit
elevation(kind := shadow, height := N)
and assigning it via figure->elevation.
- figure ->translate: dx=num,
dy=num
- Post-compose
translate(dx, dy) into figure<-transform.
Creates the transform on demand (starting from identity).
- figure ->scale: sx=num,
sy=[num]
- Post-compose
scale(sx, sy) into figure<-transform.
When sy is omitted the same factor is applied to both axes.
- figure ->rotate: degrees=num
- Post-compose
rotate(degrees) into figure<-transform.
Composition follows cairo's convention: the operation is applied to the
input first, then the existing transform on top.
- figure ->shear: kx=num,
ky=num
- Post-compose
shear(kx, ky) into figure<-transform.
- figure ->convert_old_slot: slot=name,
value=any
- Backward-compatibility hook used when loading older saved figures:
translates the obsolete
shadow slot into an
elevation.
