home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac / ccmdr_i.zip / CCMDR.DOC < prev    next >
Text File  |  1996-05-26  |  15KB  |  368 lines
  1.  
  2.                         ▄▄▄▄ ▄▄▄▄ ▄    ▄▄▄▄ ▄▄▄▄
  3.                         █    █  █ █    █  █ █▄▄█
  4.                         █▄▄▄ █▄▄█ █▄▄▄ █▄▄█ █ █▄
  5.             ▄▄▄▄ ▄▄▄▄ ▄▄▄▄▄ ▄▄▄▄▄ ▄▄▄▄ ▄▄▄ ▄ ▄▄▄▄▄ ▄▄▄▄ ▄▄▄▄
  6.             █    █  █ █ █ █ █ █ █ █▄▄█ █ █ █  █  █ █▄   █▄▄█
  7.             █▄▄▄ █▄▄█ █ █ █ █ █ █ █  █ █ █▄█ ▄█▄▄█ █▄▄▄ █ █▄
  8.             ────────────────────────────────────────────────
  9.                      Copyright (c) 1994 Mike Laszko
  10.  
  11.  
  12.                COLOR COMMANDER SHAREWARE SOFTWARE LICENSE
  13.                ──────────────────────────────────────────
  14.       This version of Color Commander is NOT public domain or free
  15.       software, but is being distributed as "SHAREWARE" for EVALUATION
  16.       PURPOSES ONLY. Your use of this software indicates your agreement
  17.       to the terms and conditions of this License.
  18.  
  19.                            USAGE RESTRICTIONS
  20.                            ──────────────────
  21.       The author and Data Management Systems grants a limited license to
  22.       individuals to use this shareware software for a 30-day evaluation
  23.       period on a private, non-commercial basis, for the express purpose
  24.       of determining whether Color Commander is suitable for their needs.
  25.       At the end of this 30-day evaluation period, the individual must
  26.       register the program or discontinue use.
  27.  
  28.       You may freely distribute the ShareWare version of Color Commander
  29.       and are encouraged to do so provided it is in its original,
  30.       unmodified form.
  31.  
  32.       This software and documentation is protected under the United States
  33.       Copyright Laws and International Treaty Provisions. Your support of
  34.       Shareware is appreciated.
  35.  
  36.                             LIABILITY WAIVER
  37.                             ────────────────
  38.       COLOR COMMANDER IS LICENSED "AS-IS."  THE AUTHOR OR HIS AGENTS
  39.       MAKE NO WARRANTIES, EITHER EXPRESSED OR IMPLIED, WITH RESPECT
  40.       TO THIS PROGRAM, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR
  41.       FITNESS FOR ANY PARTICULAR PURPOSE. IN PARTICULAR, IT IS NOT
  42.       GUARANTEED TO PREVENT OR DETECT DAMAGE TO YOUR DATA OR PROGRAMS.
  43.       IN NO EVENT SHALL THE AUTHOR OR HIS AGENTS BE LIABLE FOR ANY
  44.       CLAIMS FOR LOST PROFITS OR ANY DAMAGE, INCLUDING, BUT NOT LIMITED
  45.       TO, SPECIAL, INCIDENTAL, CONSEQUENTIAL OR OTHER DAMAGE. SOME
  46.       STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR
  47.       CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION OR EXCLUSION MAY
  48.       NOT APPLY TO YOU. IN NO CASE SHALL THE AUTHOR OR HIS AGENTS'
  49.       LIABILITY EXCEED THE LICENSE FEES PAID FOR THE RIGHT TO USE THE
  50.       LICENSED SOFTWARE.
  51.  
  52.                                DISCLAIMER
  53.                                ──────────
  54.       Color Commander is a DOS "TEXT" mode VGA/SVGA utility. It is not
  55.       intended for use under windows or any other graphical user interface
  56.       (GUI). It was written and tested on an SVGA system. Use of Color
  57.       Commander on a MONOCHROME, EGA or other NON VGA/SVGA compatible
  58.       system is not supported.
  59.  
  60.                                       -1-
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.       What is Color Commander?
  68.  
  69.       Color Commander is a DOS TEXT mode (non-graphics) utility that will
  70.       enable you to change any or all of the 16 DOS colors to any one of
  71.       262,144 colors. Color Commander accesses the VGA DAC registers
  72.       directly, bypassing normal color selecting conventions.
  73.  
  74.       Color Commander will allow you to edit existing palettes or create
  75.       new ones. You can save the new palettes to disk as a .PAL file
  76.       which can be loaded into Color Commander later on, or as a .COM
  77.       file which when called will set the VGA palette directly, without
  78.       having to run Color Commander first. The .COM file can be called
  79.       from the DOS prompt or from a batch file. Choosing softer, less
  80.       glaring colors for your VGA palette will reduce eye strain and
  81.       create a more aesthetically pleasing computing environment.
  82.  
  83.       Color Commander should never permanently change or damage your VGA
  84.       hardware. It simply temporarily reprograms the color registers in
  85.       your VGA card. When your system is rebooted DOS sets the color
  86.       registers in your VGA adapter to the DOS default colors.
  87.  
  88.  
  89.  
  90.  
  91.       Text mode color under DOS:
  92.  
  93.       Under DOS each of the 16 colors that are available to your programs
  94.       are assigned a number of 0-15. Color 0 is black, color 1 is blue,
  95.       color 15 is white etc. When a program is running under DOS and it
  96.       wants to display a color, say blue for example, it selects color 1.
  97.       If you change blue to orange using Color Commander and then run your
  98.       program again, when it selects blue this time, it will display
  99.       orange instead. Your program never knows it is not displaying blue
  100.       because you have changed blue to orange at the hardware level.
  101.       Every instance of blue now becomes orange.
  102.  
  103.       A graphics program like MS Windows will reset the VGA palette when
  104.       it is run. If a custom palette is active at this time it will be
  105.       reset. When the graphics program exits to DOS it sets the palette to
  106.       the DOS default colors. Some text mode (non-graphics) programs also
  107.       reset the VGA palette. These programs will also reset your custom
  108.       palette and set DOS default colors when they exit. When you run any
  109.       of these types of programs you can re-establish your custom palette
  110.       (If you have saved it as a COM file) by typing its name at the DOS
  111.       command line or by creating a batch file, or start up Color Commander
  112.       and load the palette using the F4 function key.
  113.  
  114.       Most text mode programs do not reset the color palette when they
  115.       run so your custom palette will not be zapped. For example the
  116.       Norton Utilities and Norton Commander are well behaved programs
  117.       that do not reset the palette when they run or exit. A custom
  118.       palette should work just fine for these programs.
  119.  
  120.                                       -2-
  121.  
  122.  
  123.  
  124.  
  125.  
  126.       COLOR COMMANDER:
  127.  
  128.       To run Color Commander, type:
  129.  
  130.       CCMDR <enter>
  131.  
  132.       A colorful screen will then pop up informing you that you are using
  133.       the UNREGISTERED version of Color Commander and that you are required
  134.       to register it if you continue to use it. Press the escape key to exit
  135.       this screen and start Color Commander.
  136.  
  137.       Pressing the <ESC> key while in a window or pick list will abort
  138.       the function and return you to the main display screen. If in doubt
  139.       hit <ESC>.
  140.  
  141.  
  142.  
  143.       ─────────────────────────────────────────────────────────────────────
  144.       DEFINITIONS
  145.       ─────────────────────────────────────────────────────────────────────
  146.  
  147.       PALETTE         : The 16 colors that DOS and your programs use.
  148.  
  149.  
  150.       DEFAULT PALETTE : The DOS default colors that are active when your
  151.                         computer first boots up. Color Commander knows
  152.                         what the default DOS colors are so you can reset
  153.                         the palette to default at any time.
  154.  
  155.  
  156.       ACTIVE PALETTE  : The palette that is displayed at the top part of
  157.                         the screen while in Color Commander.
  158.  
  159.  
  160.       CURRENT PALETTE : The palette that was active when Color Commander
  161.                         was run. The current palette is saved internally
  162.                         by Color Commander at start up.
  163.  
  164.  
  165.       CUSTOM PALETTE  : A palette that you create using Color Commander.
  166.  
  167.  
  168.       LOAD            : When you load a palette using <F4> or <F8> it
  169.                         becomes the ACTIVE palette. You can return to the
  170.                         CURRENT palette by pressing the <F6> function key
  171.                         or the DEFAULT palette by pressing <F7>.
  172.  
  173.  
  174.       SAVE            : When you save a palette using <F2>,<F3> or ALT<S>
  175.                         the active palette is saved.
  176.  
  177.                                       -3-
  178.  
  179.  
  180.  
  181.  
  182.       ─────────────────────────────────────────────────────────────────────
  183.       KEY FUNCTIONS
  184.       ─────────────────────────────────────────────────────────────────────
  185.  
  186.       <F1>             Help - display summary of commands. Press <ESC>
  187.                        to return to Color Commander.
  188.  
  189.  
  190.       <F2>             Save palette to disk as <filename>.pal. Can
  191.                        be loaded from disk later and becomes the ACTIVE
  192.                        palette. Press <ESC> to cancel.
  193.  
  194.  
  195.       <F3>             Save palette to disk as <filename>.com. Cannot be
  196.                        loaded into Color Commander, but can be executed
  197.                        from the DOS command line. Use this feature to save
  198.                        custom palettes that can be called from batch files.
  199.                        Press <ESC> to cancel.
  200.  
  201.                        For example if you create a custom palette for use
  202.                        with the Norton Commander called NCPAL.COM and a DOS
  203.                        default palette called DEFAULT.COM., the batch file
  204.                        might look like this:
  205.  
  206.                        @ECHO OFF    rem  Don't echo
  207.                        NCPAL        rem  Set the custom palette colors
  208.                        NC           rem  Call the norton commander
  209.                        DEFAULT      rem  reset colors to DOS defaults
  210.  
  211.  
  212.  
  213.       <F4>             Pop up a pick window showing all the .PAL custom
  214.                        palettes. Using the Up/Down arrow keys you can
  215.                        scroll the window. Press enter to load a palette
  216.                        or <ESC> to cancel. The loaded palette becomes the
  217.                        active palette.
  218.  
  219.  
  220.       <F5>             Reset the color selected by the cursor to the CURRENT
  221.                        palette color.
  222.  
  223.  
  224.       <F6>             Reset all palette colors (0-15) to the CURRENT palette
  225.                        colors. The ACTIVE palette becomes the CURRENT palette.
  226.  
  227.  
  228.       <F7>             Reset all palette colors (0-15) to the DOS DEFAULT
  229.                        colors. The ACTIVE palette becomes the DEFAULT
  230.                        palette.
  231.  
  232.  
  233.       <F8>             Pop up a pick window showing the internal Color
  234.                        Commander palettes. These palettes are provided to give
  235.                        you a reference or starting point for creating your own
  236.                        custom palettes. Using the Up/Down arrow keys you can
  237.                        scroll the window. Press enter to load a palette or
  238.                        <ESC> to cancel. The loaded palette becomes the
  239.                        active palette.
  240.  
  241.                                       -4-
  242.  
  243.  
  244.  
  245.  
  246.  
  247.       <F9>             Display an ASCII character chart. I used this chart
  248.                        while developing Color Commander so I just left it
  249.                        in. Pressing any key will bring up the next screen.
  250.                        Press <ESC> to return to Color Commander.
  251.  
  252.  
  253.       <F10>            Quit Color Commander and return to DOS. The Active
  254.                        palette remains in effect
  255.  
  256.  
  257.       ALT<C>           Display a color chart with decimal and hexadecimal
  258.                        values for each color. May be helpful to programmers,
  259.                        or if you just want to see what the new palette will
  260.                        look like in the real world.
  261.  
  262.  
  263.       ALT<S>           Save the ACTIVE palette as a PASCAL Constant statement.
  264.                        This function will be useful to programmers that want
  265.                        to manipulate the VGA palette and create their own
  266.                        colors and special effects. A TURBO PASCAL UNIT is
  267.                        available that allows you to save,load and change
  268.                        palettes from within your programs and create many
  269.                        special effects.
  270.  
  271.  
  272.       ALT<U>           Display the Color Commander registration screen.
  273.  
  274.  
  275.  
  276.  
  277.  
  278.       ─────────────────────────────────────────────────────────────────────
  279.       SPECIAL KEYS
  280.       ─────────────────────────────────────────────────────────────────────
  281.  
  282.       LEFT-ARROW          - Increase Red/Green/Blue color value.
  283.  
  284.  
  285.       RIGHT-ARROW         - Decrease Red/Green/Blue color value.
  286.  
  287.  
  288.       UP/DN-ARROW         - Select Red/Green/Blue color component.
  289.  
  290.  
  291.       INS
  292.       or
  293.       CONTROL-LEFT-ARROW  - Select 1 of 16 palette colors.
  294.  
  295.  
  296.       DEL
  297.       or
  298.       CONTROL-RIGHT-ARROW - Select 1 of 16 palette colors
  299.  
  300.  
  301.       PAGE-UP/PAGE-DOWN   - Intensity, increases or decreases
  302.                             all 3 color values.
  303.  
  304.                                       -5-
  305.  
  306.  
  307.       UTILITIES AND PALETTE FILES:
  308.       ─────────────────────────────────────────────────────────────────────
  309.       I have included several PAL and COM files to give you a better idea
  310.       of what you can do with Color Commander. DEFAULT.COM is the DOS
  311.       standard (default) color palette. These are the colors that DOS sets
  312.       when your system boots up.
  313.  
  314.       Also included is a small utility called SHOPAL.EXE. It will show you
  315.       the colors of the active palette from the DOS command line.
  316.  
  317.  
  318.       NOTE:
  319.       ────
  320.       When creating a custom palette for a program it is best to start
  321.       out with a gray palette. Change one or two colors, then run your
  322.       program to see the changes. Too much color is confusing. You will
  323.       be surprised at how good many programs look with a lot of grays and
  324.       just a few colors.
  325.  
  326.  
  327.       OTHER PROGRAMS:
  328.       ─────────────────────────────────────────────────────────────────────
  329.       Color Commander Interactive (CCI.ZIP) - A TSR version of Color
  330.       Commander. Allows you to change colors and create custom palettes
  331.       from within your favorite programs. You can actually create and save
  332.       a custom palette while you are using your program. No more guessing or
  333.       trying to remember which colors you want to change.
  334.       Download CCI.ZIP or CCMDR-I.ZIP
  335.  
  336.       CCMDR-I.ZIP contains COLOR COMMANDER and COLOR COMMANDER INTERACTIVE.
  337.       You can now register both programs for $25.00. See file REG.TXT for
  338.       details.
  339.  
  340.       Author: Mike Laszko
  341.  
  342.       Modem : 1-619-728-7307
  343.  
  344.       Fax   : 1-619-728-0264
  345.  
  346.       Mail  : Data Management Systems
  347.               P.O. Box 2828
  348.               Fallbrook, Ca. 92088-2828
  349.  
  350.  
  351.       The current version of Color Commander is available for
  352.       download from:
  353.  
  354.       THE FILE BANK BBS
  355.       1-619-728-7307
  356.       1200-115,200 baud
  357.       USR 28.8 HST DS v.34
  358.  
  359.  
  360.       Note from the author:
  361.  
  362.       Comments and suggestions are always welcome. I can be reached
  363.       on the File Bank BBS. Thank you for trying Color Commander.
  364.  
  365.                                       -6-
  366.  
  367.  
  368.