home *** CD-ROM | disk | FTP | other *** search
/ Falcon 030 Power 2 / F030_POWER2.iso / ST_STE / MAGS / ICTARI10.ARJ / ictari.10 / GFA / COLSCROL.BCC / SCROLLER.TXT < prev   
Text File  |  1994-04-17  |  7KB  |  144 lines
  1.            Subject: The -Color-Scroller-
  2.                 By: James Collett (Professor)
  3.        A Member Of: VIRTUAL INFINITY
  4.               Date: April `94
  5.            Address: Park View Farm, Carlton, Nr Nuneaton, Warks, CV13 ODA
  6.           Internet: s6005146@brookes.ac.uk
  7.       Mono Account: bcc
  8.  
  9.  
  10.     This Screen Is Public Domain
  11.     ============================
  12.         This means it may be freely copied and distributed *providing*  the 
  13.     following four files remain TOGETHER and UNALTERED:
  14.  
  15.                scroller.txt        - this file
  16.                scroller.gfa        - main screen
  17.                tables\st_pal.gfa   - palette generator for 8MHz
  18.                tables\falc_pal.gfa - palette generator for 16MHz
  19.  
  20.  
  21.     Also On Disk
  22.     ============
  23.         The following two files should also be with the screen:
  24.  
  25.                tables\st_pal.dat   - palette data file for 8MHz
  26.                tables\falc_pal.dat - palette data file for 16MHz
  27.  
  28.         However,  if  either of these two files are missing,  don`t  panic! 
  29.     Programs  are included to allow palettes to be created  and  customised 
  30.     (discussed shortly).
  31.  
  32.  
  33.     Running The -Color-Scroller-
  34.     ============================
  35.         The  first thing that`s needed is a copy of GFA Basic  3.   If  you 
  36.     don`t  have  it,  WHY NOT?!?   Assuming you have  GFA  3,  the  -color-
  37.     -scroller- only runs in ST low res compatible (320 * 200 * 16 color).
  38.  
  39.         The  main program,   scroller.gfa,  has (hopefully)  been specially 
  40.     written to run on both 8MHz machines (e.g. ST) and 16MHz machines (e.g. 
  41.     FALCON).   As explained when the screen starts up, I`ve not yet figured 
  42.     out  a way of determining the processor speed which works on ALL  ATARI 
  43.     machines.  So at the minute YOU have to tell the program what speed you 
  44.     have (by pressing '8' for 8MHz or 'space' for 16MHz).   [If you`re  not 
  45.     sure, run both versions and see which looks best!]
  46.  
  47.         After showing the credits,  the program should load the appropriate 
  48.     palette  data file and run the scroller.   The 8MHz  scroller  consumes 
  49.     some 1800 colors a second, and the 16MHz version burns up no fewer than 
  50.     3600 colors a second - not exactly environmentally friendly!!
  51.     ¯¯¯¯
  52.         If the program reports a "File Not  Found"  error then you`ll  have 
  53.     to create the  palette  data  files (discussed shortly) before you  can 
  54.     run the main program.   If you don`t like the color scheme or get bored 
  55.     of  it,  you  may like to customise the palette data  files  (discussed 
  56.     shortly).
  57.  
  58.  
  59.     Bugs / Incompatibility
  60.     ======================
  61.         The 8MHz version has been tested on an STe,  and the 16MHz  version 
  62.     has  been  tested on a FALCON.   It #may# be that the timing`s  out  on 
  63.     other  ATARIs (TT,  MegaST,  etc) despite the fact their 680x0 runs  at 
  64.     8MHz or 16MHz.   This may be due to blitters,  co-processors,  resident 
  65.     programs, etc.
  66.  
  67.         If a screen doesn`t work on your machine then PLEASE report the bug 
  68.     (too fast, too slow, etc) and your setup (8MHz processor, 8MHz blitter, 
  69.     etc) to the screen`s author!
  70.  
  71.  
  72.     Creating And Customising Palette Tables
  73.     =======================================
  74.         Both versions of the -color-scroller- 'cycle',  or scroll, palettes 
  75.     up the screen.   The 8MHz version uses 6 palettes (numbered 0 to 5) and 
  76.     the 16MHz version uses 12 palettes (numbered 0 to 11).   These palettes 
  77.     are not calculated in realtime as it`s difficult to calculate  "pretty" 
  78.     color  schemes!!   Instead the 'palette tables' are stored in  external 
  79.     data   files:   the   8MHz  scroller  uses  a   6-palette   data   file 
  80.     (tables\st_pal.dat)  and the 16MHz version uses a 12-palette data  file 
  81.     (tables\falc_pal.dat).
  82.  
  83.         Two additional GFA programs are included, in the tables\ folder, to 
  84.     allow the respective palette data files to be created (if missing)  and 
  85.     customised - i.e. to allow palette data files to be 'generated'.
  86.  
  87.         Each  of  the 6 (or 12) palettes consists of a  'BASE  COLOR'  (for 
  88.     example medium red with a tinge of blue: &401) to which you add 'RANDOM 
  89.     INTENSITY' to produce a range of shades.   For example adding a  random 
  90.     intensity of 4 to a base of &401 will generate shades with reds between 
  91.     4 and 7,  greens between 0 and 3 and blues between 1 and 4.   In  other 
  92.     words shades between &401 and &734.
  93.  
  94.         The list of base colors for the palettes is contained at the end of 
  95.     the table generator program.   Each palette`s base color  'description' 
  96.     should be of the following form:
  97.  
  98.           DATA red_on,red_base, green_on,green_base, blue_on,blue_base
  99.  
  100.         There  should  be  as many base color  descriptions  as  there  are 
  101.     palettes - i.e.  tables\st_pal.gfa should contain 6 data lines (one for 
  102.     each palette) and tables\falc_pal.gfa should contain 12 data lines (one 
  103.     for each palette).
  104.  
  105.         Each   base  color  description  should  contain  six   values   as 
  106.     illustrated above:  the first two for the red COMPONENT, the second two 
  107.     for the green component and the last two for the blue component.   Each 
  108.     component_base  should be in the range from 0 to 7  (inclusive).   Each 
  109.     component_on value acts like a "switch",  and should either be set to 0 
  110.     if you wish the component off or 1 if you wish the component on.
  111.  
  112.         If you`re unsure about setting the base colors or random intensity, 
  113.     the  best thing to do is EXPERIMENT!   Once you`ve set the base  colors 
  114.     and  random intensity,  simply run to generate a palette data file  for 
  115.     the  main  -color-scroller-  (ensuring the data file is  saved  in  the 
  116.     tables\  folder).   You  may  also like to save  the  actual  generator 
  117.     program, to save your base color and random intensity settings.
  118.  
  119.         Important:
  120.         ~~~~~~~~~~
  121.         If  the sum of any component base (for any palette) and the  random 
  122.     intensity is greater that 8,  then it is likely you`ll have intensities 
  123.     greater than 7 in your data file.   At best this may not look  "pretty" 
  124.     (!), at worst in may be incompatible with your machine.  If you have an 
  125.     STfm  compatible (3 bit) palette,  for best results always ensure  'the 
  126.     sum' cannot exceed 8.   If you have an STe compatible (4 bit)  palette, 
  127.     for best results always ensure 'the sum' cannot exceed 16.
  128.  
  129.  
  130.     And Finally
  131.     ===========
  132.         Although  there  is no financial charge for  the  program,  support 
  133.     appreciated.  You can support in two ways:
  134.  
  135.     1) by  distributing  the programs to everyone you  know,  ensuring  all 
  136.        files remain together and unaltered,
  137.  
  138.     2) feedback:  all comments,  queries,  error / incompatibility reports, 
  139.        ideas,  suggestions,  etc are welcome - both positive and  negative. 
  140.        My postal and E-mail addresses are previously listed.
  141.  
  142.  
  143.     ---END---
  144.