Desk

Ask an agent to

• Draw a circle with radius 100 in the middle of the sheet
• Measure the distance between my two marks
• Draw an arrow from the box to the triangle

15 tools

• compass

  Draw a circle or arc. Degrees: 0 right, 90 down, clockwise. Omit start and end for a full circle; give both for an arc (span within -360..360).

  center: object, radius: number, start: number?, end: number?, label: string, group: string?, pen: object?

• construct

  The main way to draw: up to 40 instrument steps in one call, in order. Each step names its tool (pick_pen, draw, ruler, compass, stencil, path, edit, erase, undo, timeline, or recipe with name and args) and carries…

  steps: array, verify: boolean?

• draw

  Freehand on the 1200x800 sheet (origin top-left). Give points for one stroke, or strokes for several pen-down paths that form one mark (a letter, a word, a sketch). Each point may carry pressure p 0..1. Sparse points…

  points: array?, strokes: array?, label: string, group: string?, pen: object?

• edit

  Change existing marks without redrawing, or animate them. Select by ids, group and/or region, then any of: pen (restyle), dx/dy (move), scale (about a point, default the mark's center), rotate (degrees clockwise)…

  ids: array?, group: string?, region: object?, pen: object?, dx: number?, dy: number?, scale: number?, rotate: number?, … (list cut; the site may define more)

• erase

  Rub out marks selected by ids, group and/or every mark touching a rectangular region. This removes the person's marks too, so look first.

  ids: array?, group: string?, region: object?

• guideread-only

  Read one desk skill by topic: core, geometry, lettering, vectors, illustration, animation, recipes, collaboration, layers. core (the desk and its loop) comes with the first look; read geometry before a construction…

  topic: string?

• lookread-only

  Look at the sheet: every mark (id, label, group, author human|agent, kind, pen, bounding box), what changed since your last look, the pen in hand, and a 48x32 map of where ink is. The first look also returns the…

  region: object?, detail: boolean?, wait: boolean?, offset: number?, limit: number?, at: number?

• make

  Make your own tool for this session. kind motion: a named animation preset (keys with relative times, wiggle, boil) applied to any marks with edit preset. kind brush: a named pen you design (kind, color, width…

  kind: string, name: string, description: string?, pen: object?, params: array?, steps: string?, motion: string?

• measureread-only

  Exact geometry without ink. Give from and to for distance and angle between points; of for one mark's length, midpoint, center, radius or vertices; a and b for the exact crossing points of two marks (lines, arcs…

  from: object?, to: object?, of: string?, a: string?, b: string?

• path

  The pen tool: a vector path from SVG path data (M L H V C S Q T Z, absolute or relative) in paper units, e.g. 'M 300 400 C 350 300 450 300 500 400 Z'. Give the pen a fillColor for a solid shape. Paths transform…

  d: string, label: string, group: string?, pen: object?

• pick_pen

  Set the default pen for later marks: pencil, fineliner, marker, brush or highlighter, with color (ink, accent, blue, green, ochre or hex), width, opacity and dash. Any mark can also carry its own inline pen instead.

  kind: string, brush: string?, color: string?, width: number?, opacity: number?, dash: boolean?, texture: string?, taper: boolean?, … (list cut; the site may define more)

• ruler

  Draw one straight line from one point to another. arrow: true adds an arrowhead at 'to'. Returns length and angle.

  from: object, to: object, arrow: boolean?, label: string, group: string?, pen: object?

• stencil

  Trace a shape stencil: rectangle, triangle (apex up) or regular polygon (sides 3..12). x,y is the center; w,h the size; rotation in degrees clockwise.

  shape: string, x: number, y: number, w: number, h: number, rotation: number?, sides: number?, label: string, … (list cut; the site may define more)

• timeline

  The sheet's clock. action play, pause, seek (at), set (duration, fps, loop, onion), or clear (a fresh sheet: blank, grid or lined, which erases everything including the person's marks, so ask first). Returns the…

  action: string?, duration: number?, fps: number?, loop: boolean?, onion: boolean?, paper: string?, at: number?

• undo

  Lift your own last mark off the paper. Only removes marks the agent made.