The main features of graphics ports are:
Compatible with LispWorks 6.0 and earlier versions
Introduced in LispWorks 6.1, allowing high quality drawing
:compatible, strings and images are not scaled or rotated at all, and ellipses are not rotated correctly. Other shapes are transformed "at the front", that is they are drawn as if the drawing function was called with transformed coordinates. The target of copy-pixels is also transformed "at the front", that is the rectangle can be translated, but not scaled or rotated.
:quality, all drawings are fully transformed correctly. Shapes are transformed "at the back", that is they are drawn and then the result of the drawing is transformed. Note that clear-rectangle and pixblt are not drawing functions in this sense, and do not take transforms into account.
Another difference is that
:quality supports anti-aliasing on Windows, and on GTK+ it adds control over anti-aliasing. See
on the page for graphics-state.
value in the graphics-state is not supported and is ignored. This is because operations do not combine sensibly with anti-aliasing and colors with alpha components. Instead, there is now
. For more information see the page for graphics-state.
of all graphics ports is
:quality by default, except when a graphics port is made in association with another graphics ports (for example, by create-pixmap-port), in which case the
is inherited from the "parent" graphics port.
All the interfaces that create graphics ports, or modify a graphics port to draw to another place, take keyword argument
:drawing-mode. Its value
nil which is interpreted as use the default (either inherited or the global default
:quality). These interfaces are listed in Creating instances.
CAPI User Guide and Reference Manual (Macintosh version) - 3 Aug 2017