home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / misc / gloss_it / gemlib.asc < prev    next >
Text File  |  1987-04-21  |  3KB  |  104 lines
  1. - appl_init
  2.  
  3. = Initialise the AES. This call must precede any use of VDI or AES.
  4. > Opcode 10
  5.  
  6.  GEM, AES, AES Application Functions
  7.  
  8.  C call : id = appl_init()
  9.  
  10.  long id           This is >=0 if the call worked, and represents the
  11.                    application's id number.
  12.  
  13. - graf_handle
  14.  
  15. = Return the VDI handle used by the AES
  16. > Opcode 77
  17.  
  18.  GEM, AES, AES Graphics Library.
  19.  
  20.  C call : handle = graf_handle(&cw, &ch, &bw, &bh);
  21.  
  22.  word cw,ch        Width and height of the system font character cell
  23.  word bw,bh        Width and height of a box large enough to hold a
  24.                    system font character
  25.  long handle       The VDI handle which can be used in subsequent calls
  26.                    to the VDI library.
  27.  
  28.  
  29. - v_opnvwk
  30.  
  31. = Open virtual workstation
  32. > Opcode 100
  33.  
  34.  GEM, VDI, VDI Control Functions
  35.  
  36.  C call :  v_opnvwk(work_in, &handle, work_out);
  37.  
  38.  word work_in[11]   Input array specifying options
  39.  word handle        Pointer to handle returned from AES
  40.  word work_out[57]  Output array
  41.  
  42.  Input values in work_in are as follows
  43.  
  44.  work_in[0]      Device id (1 for the screen)
  45.  work_in[1]      Default line type (1 for solid)
  46.  work_in[2]      Polyline colour (1 for black)
  47.  work_in[3]      Marker type (1)
  48.  work_in[4]      Polymarker colour (1 for black)
  49.  work_in[5]      Text font (1)
  50.  work_in[6]      Text colour (1 for black)
  51.  work_in[7]      Fill interior style (1)
  52.  work_in[8]      Fill style (1)
  53.  work_in[9]      Fill colour (1 for black)
  54.  work_in[10]     Coordinate type (0 for normalised, 2 for raster)
  55.  
  56.  Various values are placed in work_out. Some of the more interesting
  57.  are detailed below. Note that values are filled in to work_out up to
  58.  work_out[56].
  59.  
  60.  work_out[0]     Max x coordinate
  61.  work_out[1]     Max y coordinate
  62.  work_out[13]    Max number of colours available
  63.  work_out[45]    Min character width
  64.  work_out[46]    Min character height
  65.  work_out[47]    Max character width
  66.  work_out[48]    Max character height
  67.  
  68.  
  69. - form_alert
  70.  
  71. = Display an alert message on the screen
  72. > Opcode 52
  73.  
  74.  GEM, AES, AES Form Library.
  75.  
  76.  C call : button = form_alert(defbutton, text);
  77.  
  78.  long defbutton    The default exit button for the form. This is 0 for
  79.                    no exit button, 1 for the first and so on.
  80.  byte *text        The text to be displayed
  81.  long button       The exit button selected by the user (as above).
  82.  
  83. - v_clsvwk
  84.  
  85. = Close virtual workstation
  86. > Opcode 101
  87.  
  88.  GEM, VDI, VDI Control Functions
  89.  
  90.  C call :  v_clsvwk(handle);
  91.  
  92.  word handle       Handle returned by v_opnvwk
  93.  
  94. - appl_exit
  95.  
  96. = Close down the application library
  97. > Opcode 19
  98.  
  99.  GEM, AES, AES Application Functions
  100.  
  101.  C call : rc = appl_exit()
  102.  
  103.  long rc           Returns >0 if no error.
  104.