home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / miscutil / scm.lzh / SCM / SCM&L.DOC < prev    next >
Encoding:
Text File  |  1991-08-15  |  9.6 KB  |  249 lines
  1.  
  2.                                                     Screen  Color Modifier
  3.  
  4.  
  5.  
  6.  
  7.                        SCREEN      COLOR      MODIFIER
  8.  
  9.                                by Jean-Marc  NOGIER
  10.  
  11.                                    (release 1.0)
  12.  
  13.  
  14.  
  15.          (First, I'd like to apologize for my poor english.)
  16.  
  17.  
  18.  
  19.          This utility is public domain freeware. Everybody that could find
  20.  
  21.       an interest in this program  can copy it and use it freely.
  22.  
  23.  
  24.  
  25.  
  26.          SCM stands  for "Screen  Color Modifier". It allows you to change
  27.  
  28.       the  colors of  any (didn't check  fully for HAM  screen,  and can't
  29.  
  30.       check for  halfbrite screen) opened screen under Intuition.
  31.  
  32.          I created it to be able to change the  colors of program that  do
  33.  
  34.       not support  user color modification (e.g. Sculpt3D).
  35.  
  36.          Then the modified colors can be saved to  disk to be used later.
  37.  
  38.  
  39.  
  40.          SCL stands for  "Screen color Loader". It allows you to load some
  41.  
  42.       colors to a specified screen from  a file saved under SCM.
  43.  
  44.          SCL  is smaller  and  uses  less  memory   than  SCM.  I keep  it
  45.  
  46.       separated  from  SCM for  these reasons, and also because I was  not
  47.  
  48.  
  49.       able to use overlays under  AmigaDOS.
  50.  
  51.          SCL waits  for  the specified screen to  be opened, then  changes
  52.  
  53.       its colors, and exits.
  54.  
  55.  
  56.  
  57.          The procedure to  use SCM and SCL  is:
  58.  
  59.          - load the application the screen colors have to be modified,
  60.  
  61.          - load SCM from  the CLI or the  WorkBench,
  62.  
  63.          - modify the colors under  SCM,
  64.  
  65.          - save color modifications to a file.
  66.  
  67.  
  68.  
  69.          At a later use:
  70.  
  71.          - load SCL from  the CLI specifying the screen,
  72.  
  73.  
  74.          - load the application,
  75.  
  76.          - look at the screen colors being modified.
  77.  
  78.  
  79.  
  80.          SCM  and  SCL were   written  on  a NTSC  Amiga  1000, using  the
  81.  
  82.       Lattice C compiler (release 5.04), and PowerWindows  (release 2.5).
  83.  
  84.  
  85.  
  86.          I didn't check the  PD  libraries to see if a similar program  is
  87.  
  88.       already available (excepted the  Palette program  on  the Workbench
  89.  
  90.       disk), but  anyway  if there  is enough people interested  in SCM  &
  91.  
  92.       SCL, I may update  them later.
  93.  
  94.  
  95.  
  96.          I know the  code size is too big (I'm not a professional), that I
  97.  
  98.  
  99.       did not  check all possibilities (but my time is limited). So if you
  100.  
  101.       discover  a bug  and would  like it to be fixed, you  can mail me  a
  102.  
  103.       letter  at  the following address,  I'll try to  find some  time  to
  104.  
  105.       answer  you.
  106.  
  107.  
  108.  
  109.       address: Jean-Marc  NOGIER        in FRANCE: BAL JMN  on Sgt FLAM
  110.  
  111.                30 Bd. de La Paix                   (1 39 55 84  59)
  112.  
  113.                92400  COURBEVOIE
  114.  
  115.                           FRANCE
  116.  
  117.  
  118.  
  119.         JMN                         page 1                    20-Apr-90
  120.  
  121.                                                     Screen  Color Modifier
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                              SCM     description
  128.  
  129.  
  130.  
  131.          To run  SCM click on its icon, or type "SCM"  at the  CLI prompt.
  132.  
  133.       A  new   screen  which  name  is  "Screen Color  Modifier"  is being
  134.  
  135.       displayed  at  the  bottom   of  the  current  screen  (usually  the
  136.  
  137.       Workbench  screen). It  is lo-res and features  a title bar to  drag
  138.  
  139.       it  and 2  depth  arrangement  gadgets. The  window  opened  in this
  140.  
  141.       screen   is  called  "Screen  Color  Modifier"  (well  that's   free
  142.  
  143.       advertisement  space)  and features  2  to 32  color gadgets on  the
  144.  
  145.       left, the  color  currently selected, 3  RGB  sliders to modify  the
  146.  
  147.       selected color, a gadget called "OK" to save your  changes, a gadget
  148.  
  149.       called "NO" to  undo your  modifications, and 2 arrows  to allow you
  150.  
  151.  
  152.       to find the  screen the colors of which you want  to modify.
  153.  
  154.  
  155.  
  156.          First, click once on the down  arrow  to display the next  screen
  157.  
  158.       name.  If no other  screen than  the Workbench  is opened, then  you
  159.  
  160.       should see  SCM  screen  name. Otherwise  the  next  screen name  in
  161.  
  162.       Intuition list is displayed in the string  gadget. You  can click on
  163.  
  164.       the down  arrow  until you reach the last screen.
  165.  
  166.          Now  click on the  upper  arrow  to  display the previous  screen
  167.  
  168.       name  and continue until you reach the first screen name.
  169.  
  170.          Since screens are linked by Intuition if you change screen display
  171.  
  172.       order  when   using SCM,  you  may  have  to  search forward,   then
  173.  
  174.       backward  until you find that  screen name.  Notice that  clicking on
  175.  
  176.  
  177.       the  arrow  gadget display the screen name,  but doesn't display the
  178.  
  179.       screen.  You  need  to  find  the  screen  using depth  arrangement
  180.  
  181.       gadgets if you want  to look at the  modifications you've made.
  182.  
  183.  
  184.  
  185.          Click on the gadget colors (from  2 to 32 gadgets)  to select the
  186.  
  187.       color you  want  to modify. The color selected appears  in the large
  188.  
  189.       rectangle between  the color gadget and the  RGB sliders.
  190.  
  191.          Notice that when  you select another  screen the number  of color
  192.  
  193.       gadgets is adjusted to the  screen depth.
  194.  
  195.  
  196.  
  197.          Modify the  selected color using the RGB sliders as you  would do
  198.  
  199.       in Preferences.  The  amount  of red,  green and  blue are  displayed
  200.  
  201.  
  202.       right to the  corresponding sliders (from 0 to 15).
  203.  
  204.  
  205.  
  206.          The changes  you've just made may  be canceled by clicking on the
  207.  
  208.       NO  gadget.
  209.  
  210.          Otherwise you can save  to a file the modification you've made by
  211.  
  212.       clicking on the  OK  gadget. A  file requester  opens and  you must
  213.  
  214.       select  a drawer   and  a file name,  by  typing  the names  in  the
  215.  
  216.       corresponding string  gadgets. As an alternative you can  select the
  217.  
  218.       drawer  by  clicking on one of  the 5  gadgets on the  right of  the
  219.  
  220.       requester.  When  the drawer   is selected, the file names  of  that
  221.  
  222.       drawer  are  displayed sorted by alphabetical order, followed by the
  223.  
  224.       sub-directories  of that  drawer  if  any. Files and sub-directories
  225.  
  226.  
  227.       can  be selected by clicking on their respective names. If you want
  228.  
  229.       to go  backward in the directory tree  click on the "/" gadget.
  230.  
  231.          Modifications are saved  under the  specified file name when  you
  232.  
  233.       click on  the  OK  gadget  of  the  file requester.  You can  cancel
  234.  
  235.       anytime by  pressing the Cancel gadget.
  236.  
  237.  
  238.         JMN                         page 2                     20-Apr-90
  239.  
  240.                                                     Screen  Color Modifier
  241.  
  242.  
  243.  
  244.          Click on the windowclose gadget to quit SCM.
  245.  
  246.  
  247.  
  248.          There is also a menu featuring 4  items:
  249.  
  250.  
  251.  
  252.  
  253.          -  Load: allows  you  to  replace the  colors  of  the  currently
  254.  
  255.       selected screen with  the colors contained in a file previously saved
  256.  
  257.       under SCM.
  258.  
  259.          If the number  of  colors in the file is less than the number  of
  260.  
  261.       colors  of  the  current   screen, only  the  first  colors  of  the
  262.  
  263.       current  screen are replaced.
  264.  
  265.  
  266.  
  267.          -  Save: save  your  modifications to  a  file under  the  latest
  268.  
  269.       specified file name.
  270.  
  271.  
  272.  
  273.          - Save as: same action as clicking on the OK gadget.
  274.  
  275.  
  276.  
  277.  
  278.          - Quit: same action as clicking on the windowclose gadget.
  279.  
  280.  
  281.  
  282.  
  283.  
  284.          Note: do  not try  to modify  the colors  of a screen  under SCM
  285.  
  286.       after  this screen  has been closed, or  you may  crash the  system.
  287.  
  288.       This  is because  SCM  doesn't know  about  closed screen  until you
  289.  
  290.       select a new  screen with the gadget  arrows.
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.         JMN                         page 3                     20-Apr-90
  328.  
  329.                                                     Screen  Color Modifier
  330.  
  331.  
  332.  
  333.  
  334.                                SCL    description
  335.  
  336.  
  337.  
  338.          To run SCL type  at the CLI prompt:
  339.  
  340.  
  341.  
  342.                SCL -c<file name>  [-t<timeout>] [-p<period>]
  343.  
  344.  
  345.  
  346.           The  filename is mandatory. it  can be created  using the save
  347.  
  348.      option of SCM.
  349.  
  350.  
  351.  
  352.  
  353.           The  timeout is by  default quite  a long time  (more  than 68
  354.  
  355.      years should be  above Amiga  MTBF), but can  be changed to  a value
  356.  
  357.      you specify in seconds.
  358.  
  359.  
  360.  
  361.           The  period (by  default 5  seconds) is  the interval  of time
  362.  
  363.      between  2 screen checking. Specify it in seconds.
  364.  
  365.  
  366.  
  367.           SCL  tries to  change  the  color of  the  screen  whose  name
  368.  
  369.      appears  in the  file name  specified in the  command   line. If the
  370.  
  371.      screen  is not yet  opened, SCL  waits for  it to open, changes  its
  372.  
  373.      colors, and then exits. The new  colors are read  from  a file which
  374.  
  375.  
  376.      can be created  using the screen color modifier utility (SCM).
  377.  
  378.           If the  screen is not  opened, SCL goes  to sleep for  a period
  379.  
  380.      of  time  you can  specify  with the  -p  option. It defaults  to  5
  381.  
  382.      seconds. After  this period of time, SCL checks  again if the screen
  383.  
  384.      is opened and so on.
  385.  
  386.           The  time  SCL  wait  for  the  screen  to  be  opened  can  be
  387.  
  388.      specified with the -t option.
  389.  
  390.  
  391.  
  392.           An example to  use it (replace Sculpt3D with your choice):
  393.  
  394.  
  395.  
  396.           - load Sculpt3D,
  397.  
  398.           - load SCM,
  399.  
  400.  
  401.           - find Sculpt3D screen,
  402.  
  403.           - modify the  colors as you like,
  404.  
  405.           - save the  modification to a file named: "dh0:Sculpt.scm",
  406.  
  407.           - create  a batch file called Sculpt3D_my_colors, with 2 lines:
  408.  
  409.                - Run SCL  -cdh0:Sculpt.scm
  410.  
  411.                - Run Sculpt3D
  412.  
  413.           - type Execute  Sculpt3D_my_colors,
  414.  
  415.           - watch  the colors of the Sculpt3D screen  being changed.
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.         JMN                         page 4                     20-Apr-90
  434.