New image rotated anti-clockwise by the indicated number of degrees. The
result is again a horizontal/vertical rectangle, so for non-multiples of
90 degrees it is larger than the original; the new area is cleared to
the background (for
pixmap) or to white (for bitmap). The image<-hot_spot
is updated automatically.
For rotated text and other rotated graphicals, prefer a
figure with a transform instead of
pre-rendering into an image: the figure rotates its children on the fly
via cairo, so the text stays glyph-accurate at every angle and the
receiver remains interactive (hit-tested, repainted on demand, ...).
Example:
draw_vertical(Dev, X, Y, String, Font) :-
new(F, figure),
send(F, display, text(String, left, Font)),
send(F, rotate, 90),
send(Dev, display, F, point(X, Y)).
