home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / pd_share / utilities / zap / !Zap / Docs / E-Vars < prev    next >
Encoding:
Text File  |  1994-03-16  |  6.2 KB  |  159 lines
  1. *************************************************************************
  2. * >E-Vars    Documents the variable numbers used by Zap_ReadVar    *
  3. *************************************************************************
  4.  
  5. This documents the variable numbers used by the Zap_ReadVar and Zap_WriteVar
  6. calls. Please note that the variables with names beginning 'opt_' are stored
  7. in the !Config file and thus saved when the user clicks 'Options.Save'.
  8.  
  9. The options for a given mode are also stored in the !Config file. See below.
  10.  
  11. Number:    Variable name:    Contents:
  12.  
  13. 0    scn_xos        Screen horizontal size (in os coords)
  14. 1    scn_yos        Screen vertical size (in os coords)
  15. 2    opt_flags    Config file flags word  (see E-Flags)
  16. 3    opt_format    Config file format word (see E-Format)
  17. 4    wimp_task    Zaps task handle
  18. 5    car_cursor    Cursor caret block pointer (see E-Cursors)
  19. 6    car_input    Input caret block pointer (see E-Cursors)
  20. 7    car_selection    Selection caret block pointer (see E-Cursors)
  21. 8    wind_num    Number of window blocks (see E-Windows)
  22. 9    file_num    Number of file blocks (see E-File)
  23. 10    car_mode    Current cursor editing mode (see E-Cursors)
  24. 11    wimp_version    Version number Zaps logged on as (200/300)
  25. 12    key_default    Default key map number
  26. 13    key_basemap    Basemap number
  27. 14    key_last    Zap key code of last key processed
  28. 15    key_lastcom    Address of last key command executed
  29. 16    mini_ptr    Address of minibuffer
  30. 17    mini_bufl    Size of minibuffer
  31. 18    mini_len    Size of data in minibuffer
  32. 19    mini_off    Offset of cursor in minibuffer
  33. 20    mini_mark    Offset of mark in minibuffer (see Zap_MiniWrite)
  34. 21    yank_ptr    Address of kill ring buffer
  35. 22    yank_len    Size of data in kill ring buffer
  36. 23    key_current    Current keymap number
  37. 24    opt_chars    Character set used for control characters (0-3)
  38. 25    opt_tab        Default column tab for windows.
  39. 26    opt_addr    Default address of first byte of file.
  40. 27    opt_stline    Default number of first line of file.
  41. 28    opt_linesp    Default line spacing in 1/8ths char.
  42. 29    env_start    Bottom of Zaps stack (&8000 except in test modes)
  43. 30    env_top        Start of free memory.
  44. 31    wimp_iconbar    Handle of iconbar icon.
  45. 32    wimp_timeformat    Standard time format string.
  46. 33    wimp_dateformat    Standard date format string.
  47.  
  48. Setting & Reading default mode options
  49. --------------------------------------
  50.  
  51. Each mode has a word of workspace in a window block called w_moden (see
  52. E-Windows). When a window is created, the default settings (stored in the
  53. !Config file) for that mode is used. These default settings are stored in
  54. memory, and saved when the user clicks on the 'save options' menu entry.
  55. The variable number &100+n accesses the default mode word for mode numbered
  56. n. Ie,
  57.  
  58. &100    opt_mode0    Text mode word
  59. &101    opt_mode1    Byte mode word
  60. &102    opt_mode2    Word mode word
  61. ... etc ...
  62.  
  63. If there was no information about the mode in the !Config file then the mode
  64. word is set to 0. In this case, the mode should note this on startup (see
  65. e_init with R1=2) and write some sensible default values to it. If the mode
  66. has b10 set in it's e_mode word, then the mode word points to a block of
  67. data, the first word in the block giving the total length of the block. The
  68. mode can resize this block at any time using the standard heap calls. If the
  69. mode word was 0 then the mode should claim a block at startup and set it up
  70. with default values (and save the address of it's block in the mode word via
  71. Zap_WriteVar).
  72.  
  73. If your mode word is zero when you start up then you should also define
  74. sensible colours for your mode using Zap_ModeColours and a sensible width etc
  75. using Zap_ModeData.
  76.  
  77. !Config file format
  78. -------------------
  79.  
  80. The first word must be the bytes for the letters "Conf". Then the !Config
  81. file consists of a list of blocks, terminated by a zero word. Each block has
  82. the following format:
  83.  
  84.  #0    Block type:    0    End of list.
  85.              1    Zap global options storage block.
  86.              2    Mode dependant storage block.
  87.              3+    Undefined.
  88.  #4    Total block length (offset from start of block to next block).
  89.  #8 ...    Block data
  90.  
  91. Block type 1 is version dependent (see below).
  92.  
  93. If the block type is 2 then the block data has the following format
  94.  
  95.     #0    Mode name, zero terminated then align to next word.
  96.         Length of Zap handled data for this mode (see below)
  97.         Zap handled data for this mode (version dependant)
  98.         Length of Mode handled data for this mode (0 if none).
  99.         Mode handled data for the mode (mode dependant).
  100.  
  101. (NB If b10 of e_mode is set then the last two entries are written into a heap
  102. block whose address is stored in opt_moden where n is the mode number which
  103. is assigned to the mode. If not, the the first word of the data is put
  104. in opt_moden)
  105.  
  106. Version 1.10
  107. ------------
  108.  
  109. The format of the Zap handled bits for version 1.1 is:
  110.  
  111. Block type 1 data: (total block length 8+&54=&5C)
  112.  
  113.         #&00    Reserved (set to 0)
  114.                 #&04    Reserved
  115.                 #&08    Reserved
  116.                 #&0C    Reserved
  117.                 #&10    Reserved
  118.                 #&14    character set to use for control characters (0-3)
  119.         #&18    column tab width
  120.         #&1C    opt_flags value (see E-Flags)
  121.         #&20    opt_format value (see E-Flags)
  122.         #&24    address of first byte of file (for line numbers)
  123.         #&28    line number of first line of file
  124.         #&2C    line spaceing
  125.         #&30    margin width
  126.         #&34    cursor types byte0=normal cursor byte1=split1 cursor
  127.             byte2=split2 cursor byte3=mark position cursor.
  128.             0=block 1=square 2=underscore 3=bar 4=none 5+=undefined
  129.         #&38    Code of end of line x4 (eg &0a0a0a0a)
  130.         #&3C    Code of tab character x4 (eg &09090909)
  131.         #&40    Wordwrap width
  132.         #&44    Minibuffer colours byte0=background wimp col
  133.             byte1=foreground wimp colour
  134.         #&48    Switches flags word:
  135.             b0 set for flashing cursor
  136.             b1 must be 0
  137.             b2 set for date checking on file saving
  138.             b3 set for clear search window automatically
  139.             b4 must be 0
  140.             b5 must be 0
  141.             b6 set for confine cursor to window
  142.             b7 must be 0
  143.             b8-b31 reserved - must be 0
  144.         #&4C    Reserved
  145.         #&50    Reserved
  146.         
  147. Block type 2 data:
  148.  
  149. The Zap handled bit of it is 12 bytes long and documented below. The format
  150. may change with future versions and should be read via Zap calls
  151. Zap_ModeColour and Zap_ModeData if you are a Zap extension mode.
  152.  
  153.     #0    Mode data variable 0 - see Zap_ModeData call.
  154.     #4     The current palette for this mode. The 16 nibbles give
  155.         the wimp colours of the 16 colours with nibble0=background
  156.         colour 1, nibble1=background colour 2 etc.
  157.         See Zap_ModeColour.
  158.  
  159.