← SPL reference

graphics (lib/graphics.py)

Turtle-style drawing backed by Python’s turtle module. Import with use graphics;, create a pen with graphics.icon, then call methods on your variable — same names as turtle (forward, right, penup, …). Statements still end with ;.

Requires a graphical display and tkinter for your Python build. Headless CI / Pyodide will not run the window.

Quick start

use graphics;

artist.setVar(graphics.icon);
#comment: or: artist <- graphics.icon;

artist.speed(5);
artist.forward(100);
artist.right(90);
artist.forward(100);
artist.done();

Factory & module helpers

• graphics.icon — create a new pen (SPLArtist handle).
• graphics.done() — block until the turtle window is closed.
• type.isArtist(x) — 1 for a graphics pen.

Instance methods (turtle API)

Call on your variable: artist.method(...); Supports standard turtle names and short aliases:

• Move: forward / fd, backward / bk, goto, setpos, home
• Turn: right / rt, left / lt, setheading / seth
• Pen: penup / pu, pendown / pd, pensize, color, fillcolor
• Shape: circle, dot, begin_fill, end_fill
• State: clear, reset, hideturtle / ht, showturtle / st, speed, write
• Query: position, xcor, ycor, heading, isdown
• Window: done, title, bgcolor, screensize

Any other method name is forwarded to the underlying turtle.Turtle if it exists.

Example: examples/graphics_demo.spl