home *** CD-ROM | disk | FTP | other *** search
/ Really Useful CD 1 / ReallyUsefulCD1.iso / extras / progutils / baslib / baslibdoc / screenlib < prev    next >
Encoding:
Text File  |  1989-03-15  |  4.1 KB  |  129 lines
  1. Routine   : PROCcompressed_screen_init           
  2. Library   : ScreenLib
  3. Purpose   : assembles the machine code required by 
  4.             PROCcompressed_screen_load and 
  5.             PROCcompressed_screen_save
  6. Source    : RISC User April 1988 Page 28
  7. Author    : Mark Davis
  8. Parameters: 
  9.    None
  10. Dependant Routines: 
  11.    None
  12. Global Variables: 
  13.    block,final,block2,code,sbl,compact,no, 
  14.    shift,max,total,fin,scaddr,sclen,decompact
  15. Notes: 
  16.    This procedure must only be called once in the 
  17.    main program. Note that 160k is reserved as 
  18.    workspace by the routine. Be sure to avoid 
  19.    conflicts of variable names in the main program
  20. Routine   : PROCcompressed_screen_save(filename$)
  21. Library   : ScreenLib
  22. Purpose   : Saves a graphics screen in a compacted 
  23.             format and also much more quickly than 
  24.             the OS *SCREENSAVE command. As an 
  25.             example a Mode 15 Mandelbrot screen 
  26.             can be compressed to 40k, less than a 
  27.             third of the original disk space 
  28.             required.
  29. Source    : RISC User April 1988 Page 28
  30. Author    : Mark Davis
  31. Parameters:
  32.    filename$  = a legal filename for the saved 
  33.                 file.
  34. Dependant Routines:
  35.    PROCcompressed_screen_init
  36. Global Variables: 
  37.    block,compact,sbl,max,shift,total,fin, 
  38.    scaddr,sclen
  39. Notes: 
  40.    The saved screen may only be reloaded using 
  41.    PROCcompressed_screen_load(). No validity 
  42.    checking is performed on the file name. The 
  43.    screen must be non-scrolled and it is possible 
  44.    in some cases that no compression is possible 
  45.    in which case the screen will still be saved at 
  46.    high speed.
  47. Routine   : PROCcompressed_screen_load(filename$)
  48. Library   : ScreenLib
  49. Purpose   : Loads a graphics screen saved by 
  50.             PROCcompressed_screen_save() in 
  51.             compact format and more quickly than 
  52.             the OS *SCREENLOAD command.
  53. Source    : RISC User April 1988 Page 28
  54. Author    : Mark Davis
  55. Parameters:
  56.    filename$  = a legal filename for the file to 
  57.                 load.
  58. Dependant Routines:
  59.    PROCcompressed_screen_init
  60. Global Variables: 
  61.    no,sbl,block,shift,max,total,fin,scaddr, 
  62.    sclen,decompact
  63. Notes: 
  64.    The routine will fail if the saved screen has 
  65.    not been created by 
  66.    PROCcompressed_screen_save(). No validity 
  67.    checking is performed on the file name and no 
  68.    checks are made to ensure the file exists or is 
  69.    in the correct format. The screen mode is set 
  70.    to the mode in which the screen was created 
  71.    which of course clears the screen.
  72. Routine   : PROCmode7_screen_save(filename$)
  73. Library   : ScreenLib
  74. Purpose   : Saves a mode 7 screen in only 1k of 
  75.             disk space instead of the usual 80k 
  76.             that it takes in memory.
  77. Source    : Archive November 1987 Page 44
  78. Author    : Not Known
  79. Parameters:
  80.    filename$  = a legal filename for the file to 
  81.                 save.
  82. Dependant Routines:
  83.    None
  84. Global Variables:
  85.    None 
  86. Notes: 
  87.    No validity checking is performed on the file 
  88.    name, whether it already exists, or if the 
  89.    current mode is 7.
  90. Routine   : PROCmode7_screen_load(filename$)
  91. Library   : ScreenLib
  92. Purpose   : Loads a mode 7 screen save using 1k of 
  93.             disk space by PROCmode7_screen_save().
  94. Source    : Archive November 1987 Page 44
  95. Author    : Not Known
  96. Parameters:
  97.    filename$  = a legal filename for the file to 
  98.                 load.
  99. Dependant Routines:
  100.    None
  101. Global Variables:
  102.    None 
  103. Notes: 
  104.    No validity checking is performed on the file 
  105.    name, whether it already exists, or if the 
  106.    current mode is 7. A CLS is performed, however. 
  107.    The file must have been created by 
  108.    PROCmode7_screen_save().
  109. Routine   : PROCscreenman 
  110. Library   : ScreenLib
  111. Purpose   : A collection of routines to allow 
  112.             palettes to be adjusted, displayed, 
  113.             loaded and saved. Also mouse pointer 
  114.             coordinates are shown.
  115. Source    : RISC User April 1988 Page 11
  116. Author    : Lee Calcraft
  117. Parameters:
  118.    None
  119. Dependant Routines:
  120.    None
  121. Global Variables:
  122.    None 
  123. Notes: 
  124.    The routine only works in 80 column modes, but 
  125.    not in mode 15. All 'internal' PROCs and FNs 
  126.    are prefixed by 'ce'.
  127.   
  128.  
  129.