chiark - git - mdw - ssr/blob - StraySrc/Libraries/Sapphire/sh/draw

   1 ;
   2 ; draw.sh
   3 ;
   4 ; Renders DrawFiles
   5 ;
   6 ; © 1994-1998 Straylight
   7 ;
   8
   9 ;----- Licensing note -------------------------------------------------------
  10 ;
  11 ; This file is part of Straylight's Sapphire library.
  12 ;
  13 ; Sapphire is free software; you can redistribute it and/or modify
  14 ; it under the terms of the GNU General Public License as published by
  15 ; the Free Software Foundation; either version 2, or (at your option)
  16 ; any later version.
  17 ;
  18 ; Sapphire is distributed in the hope that it will be useful,
  19 ; but WITHOUT ANY WARRANTY; without even the implied warranty of
  20 ; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21 ; GNU General Public License for more details.
  22 ;
  23 ; You should have received a copy of the GNU General Public License
  24 ; along with Sapphire.  If not, write to the Free Software Foundation,
  25 ; 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  26
  27 ;----- Overview -------------------------------------------------------------
  28 ;
  29 ; Functions provided:
  30 ;
  31 ;  draw_render
  32 ;  draw_checkValid
  33
  34                 [       :LNOT::DEF:draw__dfn
  35                 GBLL    draw__dfn
  36
  37 ; --- draw_render ---
  38 ;
  39 ; On entry:     R0 == scale to plot drawfile (16.16 form)
  40 ;               R1 == pointer to a redraw block
  41 ;               R2 == pointer to drawfile in memory
  42 ;               R3 == size of drawfile block
  43 ;
  44 ; On exit:      --
  45 ;
  46 ; Use:          Renders a DrawFile in a window.  Objects which aren't
  47 ;               recognised are not rendered.  The objects which are handled
  48 ;               are as follows:
  49 ;
  50 ;               * Font table objects
  51 ;               * Text objects (in fonts, or in system font)
  52 ;               * Draw path objects, filled and unfilled, including
  53 ;                 dotted outlines
  54 ;               * Group objects
  55 ;               * Tagged objects
  56 ;               * Sprite objects, rendered as well as we can make it
  57 ;               * Transformed text, only on RISC OS 3
  58 ;               * Transformed sprite, only on RISC OS 3
  59
  60                 IMPORT  draw_render
  61
  62 ; --- draw_checkValid ---
  63 ;
  64 ; On entry:     R0 == pointer to start of drawfile
  65 ;
  66 ; On exit:      May return an error
  67 ;
  68 ; Use:          Checks whether a drawfile is basically sound.  This checking
  69 ;               isn't compulsory, and just checks the initial word and the
  70 ;               format version number -- nothing very exciting.
  71
  72                 IMPORT  draw_checkValid
  73
  74                 ]
  75
  76 ;----- That's all, folks ----------------------------------------------------
  77
  78                 END