home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Frozen Fish 2: PC
/
frozenfish_august_1995.bin
/
bbs
/
d07xx
/
d0787.lha
/
GetSC
/
GetSC.doc
< prev
next >
Wrap
Text File
|
1992-12-24
|
10KB
|
257 lines
__
/ ////
__ ///
\ \ /// < < <<< GetSC v2.00 >>> > >
\ \///
\__////
USER MANUAL
- Release : 15-Nov-92
Copyright ⌐1991-1992 Chris P. Vandierendonck, [AmiSYS].
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Copyright Notice
~~~~~~~~~~~~~~~~
GetSC
is released as
SHAREWARE
, not excluding the copyright and
all other rights, which remain with the author Chris P.
Vandierendonck. If you use
GetSC
then you must pay the shareware
fee and register.
Prior written permission from the author is required to
distribute
GetSC
and to use
GetSC
in commercial releases, on
coverdisks or diskmagazines. When distributed, all files must be
kept together, in their original unmodified form.
(AmigaDOS and Workbench are trademarks of Commodore Amiga Inc.)
Disclaimer
~~~~~~~~~~
GetSC
is provided "AS IS", WITHOUT ANY WARRANTY to its quality,
performance or fitness for a particular purpose. In no event
shall the author be liable or responsible to the user or any
other person, for any kind of damage caused by the use of this
software.
Shareware registration, suggestions, remarks and bug reports
about this program can be send to the following address :
Chris Vandierendonck
Koning Albertstraat 188
B-8210 VELDEGEM
BELGIUM
SHAREWARE information
~~~~~~~~~~~~~~~~~~~~~
It's essential for the further development of
GetSC
to pay the
shareware fee
. You can register your version of
GetSC
for
5 (five) US dollars. If you register both
GetSC
and
SetSC
at the
same time, then the registration fee is 10 (ten) US dollars,
including one update of
GetSC
and of
SetSC
.
If possible, use a printout of the '
RegForm
' file to register.
Send this form along with the shareware fee to the above
address. You can send the money in cash (fastest and cheapest
way), or by (international) money order payable to Chris
Vandierendonck. (DO NOT send bankcheques, since they are too
expensive to clear!)
Preface
~~~~~~~
GetSC
is a program to grab the colours of a screen. It'll be
used primarily to get the colour palette of a certain screen,
GetSC v2.00 User Manual - Page 1
and save it under a name to the SetSC MAPS file (see "SetSC.doc"
for more information), so that you can access it with SetSC at
any time.
GetSC
is reentrant, so it can be made resident.
System Requirements
~~~~~~~~~~~~~~~~~~~
GetSC
requires AmigaDOS v1.2 or higher.
Program Usage
(Shell/CLI only)
~~~~~~~~~~~~~
FORMAT : [[NAME] <mapname>] [SCREEN <name>] [WB] [ALL] [FORCE]
[DELAY <secs>] [T] [S] [LIST] [VERSION]
If no arguments are used, then
GetSC
will grab the colour palette
of the topmost (first) screen, and show the colours as
hexadecimal values.
Example output
of 'GetSC WB' :
ColourMap: (hBBB,h000,hFFF,h68E) ; Workbench Screen...
o
GetSC arguments
:
("?" gets the program format.)
[[NAME] <mapname>] : save the colour palette under the given
name. By default the colour map will be
saved to 'S:SetSC.MAPS' (unless you used
'T'. If 'T:SetSC.MAPS' exists, then the map
will be saved here as well (unless you used
'S'). The NAME keyword is optional.
| E.g. 'SetSC NAME test WB' results in :
| test (hBBB,h000,hFFF,h68E) ; Workbench
| Screen...
NOTE: when the 'S:SetSC.MAPS' doesn't
exist, then
GetSC
will create this
file (unless you used the 'T'
option).
[SCREEN <name>] : get the colour palette of the screen with
the given <name>. The <name> corresponds to
the first words of the screen title. If
this name contains spaces then you must
enclose the name between double quotation
marks. The screen is searched on a non-case
sensitive basis, so 'name' matches 'NAME'.
| 'GetSC SCREEN workbench', or 'GetSC
| SCREEN "workbench screen"', gets the
| colour palette of the Workbench screen.
[WB] : get the colour palette of the Workbench
screen. This option is disabled when SCREEN
is used.
[ALL] : get the colour palettes of all available
GetSC v2.00 User Manual - Page 2
screens. This option is disabled when
SCREEN or WB is used.
[FORCE] : if you have specified a name to save the
colour palette under, and this name already
exists in the MAPS file, then
GetSC
will
ask the user to exit or overwrite the map,
unless you use FORCE. This option instructs
GetSC
to overwrite the map, if it already
exists.
[DELAY <secs>] : wait a given number of seconds before
grabbing the screen colours. This can be
useful to bring a screen to the front,
while
GetSC
is waiting.
[T] : only use 'T:SetSC.MAPS' when saving a
colour palette, or when using listing all
maps. NOTE that this file is ony a
temporary file!
[S] : only use 'S:SetSC.MAPS' when saving a
colour palette, or when using listing all
maps.
[LIST] : show all colour maps available in the
'S:SetSC.MAPS' and 'T:SetSC.MAPS' files. If
you also use 'S' then only the first file
will be listed, with 'T' the latter.
[VERSION] : print the program's copyright and version.
o
Compiling a collection of colourmaps
:
GetSC
is THE tool to compile a collection of colourmaps, for use
with
SetSC
. You can do this in two ways :
- You can use
GetSC
(See "GetSC.doc" for more information!) and
grab the colourmap of an existing screen.
- Another way is to use a palette requester (like the one
supplied with your system software) to change the colours of
the Workbench screen (or any other screen), and then using
GetSC
to grab the colour map.
IMPORTANT: if you want to store your colourmaps permanently, you
must add the colourmaps to the 'S:SetSC.MAPS' file,
not to the temporary file in 'T:'!
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Program antecedents
~~~~~~~~~~~~~~~~~~~
VERS RELEASED RC COMMENT
==== ========= == =============================================
1.00 15-nov-91 PU First program version.
1.01 29-Mar-92 PU Minor code changes.
2.00 15-Nov-92 SW First release version.
The code has been improved and made more
GetSC v2.00 User Manual - Page 3
efficient. This resulted in a much smaller
program.
o Option changes :
[<name>] -> [[NAME] <mapname>]
[-d#] -> [DELAY <#>]
[SILENT] -> [VERSION]
o New options : [SCREEN <name>], [ALL] and
[WB].
o Removed the [HELP] option.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
GetSC v2.00,
Copyright ⌐1991-1992 Chris P.Vandierendonck [AmiSYS],
All Rights Reserved.
GetSC v2.00 User Manual - Page 4