Module interface:gfx - Graphics infrastructure interface

Index

• Channel type CT.GFXCANVAS - Graphics canvas channel-type
  
  • Variable ctl? - Control messages for graphics canvas (not for applications typically)
  • Variable in? - Commands sent to the graphics canvas
  • Variable out! - Responses from graphics canvas
• Channel type CT.GFXPROTO - Graphics protocol channel-type
  
  • Variable e.out! - Events from graphics core
  • Variable in? - Requests to graphics core
  • Variable out! - Responses from graphics core
• Channel type CT.GFXUPDATE - Graphics update channel-type
  
  • Variable in? - Update notifications
• Data type GFX.APAIR - General angle pair, arranged as [t0, t1]
• Data type GFX.ARGB - ARGB pixel data type, arranged as (a << 24) \/ (r << 16) \/ (g << 8) \/ b
• Record GFX.CANVAS - Graphics canvas descriptor
  
  • Variable bpp - Canvas bits-per-pixel
  • Variable capabilities - Canvas flags (see )
  • Variable id - Canvas ID
  • Variable size - Canvas size
• Constant GFX.CANVAS.DEFAULT.ID - Default canvas ID (however that is interpreted by devices)
• Data type GFX.CID - Canvas identifier type (hardware buffer ID where relevant)
• Data type GFX.CR - Clipping rectangle, as array of [x, y, width, height]
• Data type GFX.DIM - General dimension, arranged as [width, height]
• Data type GFX.POINT - Single point, arranged as [x, y]
• Data type GFX.POINTPAIR - Pair of points, arranged as [x1, y1, x2, y2]
• Data type GFX.RECT - General rectangle, arranged as [x, y, width, height]
• Data type GFX.UPD - Graphics canvas update type, arranged as [canvas-ID, dst-x, dst-y, width, height]
• Data type GFX.XY2R - General point and two radii, arranged as [x, y, x-radius, y-radius]
• Data type GFX.XYR - General point and radius, arranged as [x, y, radius]
• Protocol P.GFXCANVAS.CTL - Graphics canvas control protocol
  
  • Tag get.winmgr - Request window-management connection (provides events, window control, etc.), responds with (winmgr |~| error)
  • Tag update.grab - Re-direct canvas updates to here
  • Tag update.ungrab - Stop re-directing canvas updates
• Protocol P.GFXCANVAS.IN - Graphics canvas input protocol
  
  • Tag circle - Draw a filled circle on the canvas
  • Tag clear - Clear canvas
  • Tag disconnect - Disconnect/destroy canvas, responds with (ok |~| error)
  • Tag ellipse - Draw a filled ellipse on the canvas
  • Tag hold.update - Control hold of graphics updates
  • Tag line - Draw a line on the canvas
  • Tag linestop - Draw a line on the canvas until a particular coloured pixel is encountered, responds with linestop
  • Tag query - Query canvas, responds with query
  • Tag rectangle - Draw a filled rectangle on the canvas
  • Tag render.getbuf - Get render buffer, responds with render.buf
  • Tag render.return - Return render better
  • Tag set.bitmap - Draw a bitmap on the canvas
  • Tag text - Draw some text on the canvas
• Protocol P.GFXCANVAS.OUT - Graphics canvas output protocol
  
  • Tag error - Generic error where required
  • Tag linestop - Returned position where linestop stopped
  • Tag ok - Generic ok where required
  • Tag query - Response to query message
  • Tag render.buf - Returned render buffer from render.getbuf
  • Tag winmgr - Returned handle for window manager control (see )
• Protocol P.GFXPROTO.EVENTS - Graphics event protocol
  
  • Tag expose - Window area exposed, provides affected rectangle
  • Tag pointer.click - Button click in window, provides position and button
  • Tag pointer.enter - Pointer entering window, provides position
  • Tag pointer.leave - Pointer leaving window, provides last position
  • Tag pointer.unclick - Button unclick in window, provides position and button
• Protocol P.GFXPROTO.IN - Graphics input protocol
  
  • Tag blit - Copies bits from one canvas to another
  • Tag new.canvas - Create a new canvas, responds with (canvas |~| error)
  • Tag set.pointer - Set pointer position
• Protocol P.GFXPROTO.OUT - Graphics output protocol
  
  • Tag canvas - Returned canvas
• Protocol P.GFXUPDATE.IN - Graphics update input protocol
  
  • Tag disconnect - Disconnecting canvas (shut-down update handler)
  • Tag update - IDs of buffers/canvasses that want to redraw

Declarations