home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
TopWare 18: Liquid
/
Image.iso
/
liquid
/
top1136
/
gifv2.hlp
< prev
next >
Wrap
Text File
|
1993-10-05
|
26KB
|
684 lines
END
The END command HALTS execution of the script file and EXITS.
GOTO LABEL
The GOTO statement jumps to location where LABEL can be found
in the script file.
IFINT LABEL
IFINT tests to see if the next image to be loaded is a GIF
Interlaced file. If so, control jumps to LABEL.
IF-LAST-FILE LABEL
IF-LAST-FILE tests to see if there are NO MORE files to be
processed. If there are no more files in the list, control
jumps to LABEL.
IF>=320X200 LABEL
IF>=320X200 tests the next image size. If the next image is
greater than or equal to 320X200 resolution, control jumps to
LABEL.
IF>=640X400 LABEL
IF>=640X480 LABEL
IF>=800X600 LABEL
IF>=1024X768 LABEL
The above tests are similar in nature to the IF>=320X200.
IFBMP LABEL
IFGIF LABEL
IFPCX LABEL
IFPIC LABEL
These test for the file extension of the next file to load. If
the extension matches, control jumps to LABEL.
IFEXIST Filename LABEL
If the filename indicated EXISTS in the currently selected
directory then control jumps to LABEL.
IFBUTTON-L LABEL
If mouse control is ON, IFBUTTON-L detects if the LEFT mouse
button was pressed to quit out of a picture. If the LEFT
button was pressed, control jumps to LABEL
IFBUTTON-R LABEL
IFBUTTON-C LABEL
These commands are similar to IFBUTTON-L, but testing for the
RIGHT and CENTER buttons instead.
IF V{1-10}{<,>,=}{###} LABEL
The IF command tests the value of one of the 10 variables
allowed. The test can be <(less than) or >(greater than) or
=(equal). The ### is a number to test against. LABEL is where
control jumps if the test is true. For example: "IF V4>10
:MORE" This statement checks to see if variable 4 is greater
than 10. If so control jumps to ":MORE".
GOSUB LABEL
This allows a procedure (routine, function) with the name
LABEL to be executed. Once the routine is finished, control
transfers back to the statement following the GOSUB LABEL.
NOTE: The called procedure must end with a SUB-END statement.
SUB-END
This statement indicates that the end of the subroutine is
found. Control will transfer back to where the calling GOSUB
statement was.
DISPLAY V{1-10}
This displays on the screen the current value of any of the 10
variables that you can manipulate. For example: "DISPLAY V2"
would cause the contents of V2 to be displayed on the screen.
ECHO text message
This command allows you to print any text on the screen (much
like the DOS ECHO command). Any text can be displayed. For
example: "ECHO Have a nice day!" would result in "Have a nice
day!" displayed on your screen. The ECHO command also allows
for system variables to be displayed in the message. Enclose
any system variable within % in the message. For example:
ECHO %FILE_NAME% has %IMAGE_COLORS% colors in it!
This would display something like:
GIRL.GIF has 256 colors in it!
The allowable system variables are described below in the SET
command. There is one (1) additional system variable that the
ECHO command can use that the SET command can't. It's the
"FILE_NAME" system variable. The reason the SET command can't
use it is because it's NOT a number!
HINT: By using system variables in the ECHO command and using
the PRINTER-ON command, you can essentially produce reports
about your picture files! (See the GIFV.SLU script file for
details.)
SET V{1-10} {###,+,-,system}
This command sets the value of any of the 10 variables allowed
in the script language to a particular value. For example:
"SET V3 100". This would set V3 to 100. You can also increment
and decrement variables. For example: "SET V5 +". This would
add 1 to the value of V5 and "SET V1 -" would subtract 1 from
the value of V1. You can also set your variables to some of
the various SYSTEM settings. For example: If you wanted V2 to
contain the size of the next file to process, you would say
"SET V2 FILE_SIZE". Below is a list of all system variables.
System variables List
DEBUG_SWITCH
If the DEBUG-ON option is turned on, this will be
equal to 1, otherwise it will be equal to 0.
PRINTER_SWITCH
If the PRINTER-ON option is turned on, this will be
equal to 1, otherwise it will be equal to 0.
RES_LOCK_SWITCH
If the RES-LOCK option is turned on, this will be
equal to 1, otherwise it will be equal to 0.
MOUSE_CONTROL_SWITCH
If the MOUSE-CONTROL-ON option is turned on, this
will be equal to 1, otherwise it will be equal to 0.
RES_X
This returns the value of the width of the next
image to load.
RES_Y
This returns the value of the height of the next
image to load.
FILE_NUMBER
This returns the number of files already processed
in a particular path.
FILE_ERROR
This returns the error number of the last file
operation (File-Copy, File-Move, File-Delete, File-
Rename.) The meaning of the different values that
FILE_ERROR can have are listed below:
0 File operation completed OK
1 Source file can't be found
2 Target area FULL, Subdirectory by same
name, or Target NOT a valid drive.
3 Target area doesn't exist or Target drive
full
4 Read/Write ERROR on file
5 NOT Enough Memory
6 NOT USED
7 Source and Target are the SAME
8 NOT USED
9 FILE-RENAME used invalid WILDCARDing
LINE_NUMBER
This returns the line number in the script file that
the set command is on.
DELAY
This returns the delay time for the slides to wait
after showing the image.
RESOLUTION
This returns what resolution number is currently
selected. It's only useful if RES-LOCK is turned on.
The numbers range from 1 to ??. Usually there are
about 3 to 6 resolutions available depending on your
Super VGA capabilities.
FILE_SIZE
This returns the file size of the next file to be
processed.
IMAGE_COLORS
This returns the number of colors in the file. This
would be 2 for black & white pictures, 16 for 16
color files and 256 for 256 color files. If the
image has 24BIT color then IMAGE_COLORS will have 24
stored in it.
V_#
Where # is 1 thru 10. This means you can set any
variable to the value of any other variable. For
example: "SET V2 V_1" This sets variable 2 to the
value in variable 1.
CHANGE-PATH {PATH, %1-%9)
This command changes the path to load files from the path
indicated by PATH. For example: "CHANGE-PATH *.GIF" would
point the file list to the current directory. "CHANGE-PATH
F:\PICTURES\*.GIF" would point to the F:\PICTURES directory
and only select GIF files.
NOTE: You can also use the %1 through %9 instead of a valid
path. In this case the path will be taken from the program
command line (very powerful!). So for example:
C>GIFV /P:R G:\*.* E:\CAT\*.GIF
If the script file called GIFV.SLR had a CHANGE-PATH %1 in it
then "G:\*.*" would be used instead. If it had a CHANGE-PATH
%2 then E:\CAT\*.GIF would be used. You can have up to 9
different selections.
NOTE: As in the normal menu operation of GIF-REED, you can use
the special wildcard of *.? to specify ALL image formats that
GIF-REED recognizes. This is powerful in the fact that it is
BETTER than using *.*. This is because *.* will get ALL files
including files that aren't image files (.EXE, .COM, etc...).
FILE-COPY Destination LABEL
This command allows you to take the next file in the list to
be processed and copy it to a new filename or even a new drive
and/or path. If there is an error in copying, control jumps to
LABEL. See the system variable called FILE_ERROR.
FILE-MOVE Destination LABEL
This command allows you to take the next file in the list to
be processed and move it to a new path or even a new drive
and/or path. If there is an error in moving, control jumps to
LABEL. See the system variable called FILE_ERROR.
FILE-DELETE LABEL
This command allows you to delete the next file to be
processed. If there is an error in deleting, control jumps to
LABEL. See the system variable called FILE_ERROR.
FILE-RENAME FileName LABEL
This command allows you to rename the next file to be
processed. You can specify either a regular filename or you
can WILDCARD the filename. See your DOS manual about WILDCARDS
in filenames if you are not familiar with the term. For
example "FILE-RENAME *.XXX" This would take the next file and
rename it to the same filename but .XXX for the file
extension! "FILE-RENAME X*.*" This would take the next file
and rename it so that the 1st letter will be a X and the rest
of the file name would remain intact! If there is an error in
renaming, control jumps to LABEL. See the system variable
called FILE_ERROR.
SUB-CREATE {Path,%1-%9} LABEL
This command creates a directory with the path specified by
PATH. For example: "SUB-CREATE NEWGIFS" would create a
subdirectory called NEWGIFS in the current path. You can
change paths by issuing the CHANGE-PATH command. "SUB-CREATE
E:\CAT :ERROR" would create a subdirectory called \CAT on the
ROOT of drive E:. If there was an error in creating the
directory, control jumps to LABEL.
NOTE: You can also use the %1 through %9 instead of a valid
path. In this case the path will be taken from the program
command line (very powerful!). So for example:
C>GIFV /P:R NEWGIFS E:\CATF
If the script file called GIFV.SLR had a SUB-CREATE %1 in it
then "NEWGIFS" would be used to create a directory instead of
%1. If it had a SUB-CREATE %2 then E:\CAT would be used. You
can have up to 9 different selections.
LOAD filename
This command will load a specific picture file onto your
screen.
LOADNEXT LABEL
This command loads the next file from the selected path used
by the CHANGE-PATH PATH command. The picture is also
displayed. If no more files exist (at end of list) control is
transferred to LABEL.
LOADPREV LABEL
This command is similar to LOADNEXT except the files are
loaded in reverse order. If you try to go too far backwards,
control jumps to LABEL.
SKIPNEXT LABEL
The same as LOADNEXT except the picture is NOT displayed. The
file pointer is merely incremented to point to the next file
in the list.
SKIPPREV LABEL
The same as LOADPREV except the picture is NOT shown. The file
pointer is merely decremented.
SLIDE-TYPE-NORMAL
This command puts the slide show into normal viewing mode.
That is to say, NO special effects.
SLIDE-TYPE-BLIND
This command makes the images appear on the screen with a
venetian blind effect.
SLIDE-TYPE-FADE
This command makes the images Fade IN/OUT on the screen.
SLIDE-TYPE-EXPAND
This command makes the images Expand on the screen.
SLIDE-TYPE-MERGE
This command makes the images Merge on the screen.
SLIDE-TYPE-ZEBRA
This command makes the images form like a Zebra.
SLIDE-TYPE-RANDOM
This command uses random slide show effects.
CENTER
This command centers the image on the screen
FLIP
This command flips the image on the screen
GRAY
This command turns the image into a Black & White (B&W)
picture.
INVERT
NEGATIVE
These commands make the pictures look like a negative. The
colors are reversed.
MIRROR
This command mirror images the picture on the screen.
ROTATE
This command rotates the image clockwise on your screen.
REDRAW
This command redraws the image on the screen in case you had
echoed some text on the screen and got rid of the picture.
RES+
RES-
These commands increase and decrease the screen resolution in
which the image is being displayed.
PRINT
This command prints the image to your printer. You must have
an HP or EPSON compatible printer. The default printer
configuration will be used to print all images. Make sure you
have selected good default printer settings and have saved
them with the ALT-U command from the main files list menu.
WRITE {B,G,P,C} {1,2,3,filename}
This command writes the current image to a file. If NO
parameters are given, the current file format is used and the
same name is used. If you specify "B" or "G" or "P" or "C"
then a BMP or GIF or PCX or PIC will be written out to the
same filename. For Example:
WRITE B
This would cause the current image displayed to be written out
as a BMP file. This is great for converting files over to a
different format!
NOTE: If you select "G" without "filename" for a GIF file, you
will NOT be able to add comments to the GIF file. If the GIF
file had comments in it already, these would be kept in the
file. If you use "filename", specify a file in the GIF-REED
directory that contains the comments you want to add to the
GIF file. For example:
WRITE G MYNOTES
This would force the image to have, as comments, the
information in the file called MYNOTES located in the GIF-REED
directory. If the name of the file had .ADD as an extension,
the comments would be added to any comments that may currently
be in the file. For example:
WRITE G MYNOTES.ADD
This would keep any old comments in the original GIF file and
add to them the text in the file called MYNOTES.ADD. If you
want to INSERT your personal comments IN FRONT of any comments
currently in the GIF file, you can use a filename with an
extension of .INS. For example:
WRITE G MYNOTES.INS
This would insert the text found in MYNOTES.INS and insert
before any comments found in the original GIF file.
HINT HINT HINT
It may not be readily apparent, but you can actually REMOVE
all comments from GIF files by specifying a filename without
any data in it. Then use the "WRITE G FILENAME" command in the
script language. This would remove any current comments and
add whatever text is in FILENAME (nothing of course).
NOTE: If you select "P" or "C" for PCX or PIC file, a default
of 256 color mode will be used to create the file. In order to
specify 2 or 16 color mode, you can use the SECOND parameter
of a 1,2 or 3. For example:
WRITE P 2
This will write out a PCX file in 16 color mode. 1 indicates
black and white (2 color mode). 2 indicates 16 color mode and
3 indicates 256 color mode.
LESS-RED (While viewing CTRL-F1)
MORE-RED (While viewing CTRL-F2)
LESS-GREEN (While viewing CTRL-F3)
MORE-GREEN (While viewing CTRL-F4)
LESS-BLUE (While viewing CTRL-F5)
MORE-BLUE (While viewing CTRL-F6)
LESS-CONTRAST (While viewing CTRL-F7)
MORE-CONTRAST (While viewing CTRL-F8)
DARKER (While viewing CTRL-F9)
BRIGHTER (While viewing CTRL-F10)
LESS-REDDER (While viewing SHIFT-F1)
MORE-REDDER (While viewing SHIFT-F2)
LESS-GREENER (While viewing SHIFT-F3)
MORE-GREENER (While viewing SHIFT-F4)
LESS-BLUER (While viewing SHIFT-F5)
MORE-BLUER (While viewing SHIFT-F6)
All of these commands alter the appearance of the image on the
screen. You should be able to figure out what each command
does.
RESET-COLORS
If you turned the image into B & W with the GRAY command or
used the color alter commands above, you can reset the colors
to the ORIGINAL colors with this command.
SORT-COLORS
SORT-COLORS allows you to sort the image's color-map. It sorts
the color map with the most frequently used colors at the
front of the color map. This is great for images being
displayed in Windows because Windows GRABS the TOP 4-16 colors
in every image's color map for display purposes. This produces
FUNNY looking pictures if the picture used a lot of a
particular color that Windows took and changed to its own
liking! By sorting the color map, the least used colors are
placed at the top. In fact, a lot of images don't use the full
256 colors available in the color map. This means most images
wouldn't be disturbed by Windows because the colors used by
Windows would be colors in the color map that weren't even
used by the image!
ADJUST-FOR-WINDOWS
This command will take the current image (picture) file and
strip off the TOP 16 colors in the image's color table. The
colors in the image that used the TOP 16 colors in the color
table will be substituted with the BEST match in the lower 240
colors in the color table. This produces results that are very
close to the original image. A file processed by this command
can then be used as a BMP file that Windows can use and
display without distorting the image. The distortion that
normally occurs when viewing a picture under Windows is
because Windows will CHANGE the TOP 16 colors in the color
table (map) of the image! By having the image NOT use the TOP
16 colors, the image will NOT be distorted while viewing under
Windows!
PRINTER Filename
The filename given forces all printer output to go to the file
instead of the printer. LPT1, LPT2 or PRN can be used as
filenames to revert back to printer output. The default
directory for the filename is in the current directory.
PRINTER-ON
This command turns on the printer. Anything that gets
displayed on the screen (except images) will be printed to
your printer. Things such as debug information, ECHO and
DISPLAY items will be printed to your printer as well as being
displayed on your screen.
PRINTER-OFF
This turns off the printer-on command.
PRINTER-FF
This command forces a Form-Feed on your printer. This means
the last page will be ejected from your printer.
MOUSE-CONTROL-ON
This turns on mouse control. When mouse control is ON, images
are left on the screen until you click a mouse button.
MOUSE-CONTROL-OFF
This turns off the mouse control. Images are finished
displaying after the specified time delays are reached.
DEBUG-ON
This command turns on the debug mode. Every line in the script
is shown on the screen as the script is being executed. Also,
useful information about your 10 variables are displayed.
DEBUG-OFF
This command turns OFF the debug mode.
BEEP ###
This command causes a beep to be heard. If you indicate a
NUMBER, you will hear that many beeps.
DELAY ###
This indicates how many seconds to delay before going to the
next picture.
ENTER
This command forces the user to press ENTER or RETURN.
SYSTEM {DOS COMMAND}
This command allow you to execute a DOS command. NOTE: If no
parameter is specified then you will be SHELLED out to DOS.
You will need to type EXIT at the DOS prompt to continue with
the script file.
TEXT
This puts the screen into TEXT mode, if it isn't already.
WAIT ###
This command waits for ### hundredths of a seconds. For
example: "WAIT 500" would wait for 5 seconds and "WAIT 50"
would wait for 1/2 a second.
RES ###
This command indicates the current resolution to be displayed
if res-locking is turned ON. NOTE: If a number larger than the
number of possible resolutions is used, the largest resolution
will be selected.
RES-LOCK
This forces all further images to load with the specified
resolution from "RES" to be used.
RES-UNLOCK
This forces res-locking off. This is the default state and all
images are displayed with the BEST resolution used.
RES-UP
This command increments the resolution that would be used for
res-locking.
RES-DOWN
This command decrements the resolution that would be used for
res-locking.
EGA-MODE
This command forces the picture to be loaded in EGA mode. This
produces POOR results compared to VGA mode. You probably
shouldn't ever use this command unless you plan on converting
your 256 color images to 16 color EGA images.
VGA-MODE
This command forces the picture to be loaded in VGA mode. This
is the default, unless you only have EGA capability.
EGA-COLOR-ADJUST {ON,OFF}
When viewing a picture in EGA mode, the normal process is to
convert all of the colors into 16 color selection. This makes
the picture viewable in EGA mode even though the picture may
be a 256 color image. This is the normal mode of operation.
However, if you only have EGA capability and wish to perform a
script file that manipulates the picture (Gray scale, rotate,
mirror, etc...) and then saves it back out, you may NOT want
the colors adjusted. In order to preserve the VGA quality of
the colors while operating the script on a machine with EGA
only capability, you may want to use the "EGA-COLOR-ADJUST
OFF" statement. This way you can process your files on a EGA
system without losing the VGA quality of the picture!
KEEP-SCREEN-SIZE {ON,OFF}
When using the WRITE command to write out GIF or PCX files,
the original screen size is overwritten with whatever
resolution mode you happen to be displaying the picture in.
This means if you load a picture in a VGA system that only
supports 320x200, when you go to write the GIF or PCX file,
the 320x200 mode information is written to the file to
indicate that it is to be displayed in 320x200 mode. This is
NOT particularly good since the picture may be a 1024x768
picture. In this case, any viewer would set the mode to
320x200 and then display the picture. This means you won't see
the whole picture! If you use the "KEEP-SCREEN-SIZE ON"
statement, when the picture is written to a GIF or PCX file,
the ORIGINAL screen size is kept intact. This means you can
process and convert your images to GIF or PCX files on a VGA
system with only 320x200 resolution and NOT have to worry
about how the picture will load with image viewers. The same
goes for older super VGA cards that only support 640x480.
Basically, if your card doesn't support the resolution the
picture was INTENDED to be displayed in, you should use the
"KEEP-SCREEN-SIZE ON" statement if you plan on writing out GIF
or PCX files.
NOTE: BMP files do NOT have this problem!. This is because BMP
files DON'T save the INTENDED RESOLUTION into the file.
READ-THIS-NOW
This little bit of text should be helpful in getting started
in the script command language. If you don't understand a
command, just point to the command in the Context-Help screen
and press RETURN. A complete description of the command will
pop-up on your screen.
For commands that have LABELS, such as GOTO and GOSUB and
others, the LABEL MUST start with a colon ":". For example:
GOTO :EXIT <This is a valid statement>
GOTO EXIT <This statement is NOT valid>
You can only put one (1) command per line. For example:
FLIP MIRROR ROTATE <This is NOT valid>
FLIP
MIRROR
ROTATE <This is the correct way>
You should look at the sample script files that comes with
GIF-REED. They are "A" through "W". X, Y and Z are not used
as of yet. As a matter of fact, you can take "A" through "W"
and modify (edit) them so that they do things completely
different than what they originally were intended to do.
It's really up to you as to what your script files should
do for you.
The kinds of things that you can do with script files are:
1. Specialized Slide Shows
2. Batch conversion of graphics files
3. Batch report files
4. Batch printing of picture files
5. Batch addition of comments to GIF files
6. Things I probably haven't thought of yet
END-OF-HELP