home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Vectronix 2
/
VECTRONIX2.iso
/
FILES_01
/
SOL3_8_C.LZH
/
SPOFLT38.CRK
/
README
/
SCRIPTS.DOC
< prev
next >
Wrap
Text File
|
1995-03-23
|
6KB
|
163 lines
------------------------------------------------
--- SCRIPT COMMAND FILES (.SLS) ---
--- FOR SPEED OF LIGHT VERSION 3.7 AND AFTER ---
------------------------------------------------
Complete information on how to create and run your own SOL script files!
This documentation is (c) Copyright 1994, Stuart Denman.
----------------------------------------------------------
--==>> WHAT IS A SPEED of LIGHT SCRIPT (.SLS) FILE? <<==--
----------------------------------------------------------
A script file is simply a ASCII text file that contains commands. These
files are executed like a simple programming language. All you need to
make your own is any ASCII text editor or word processor than can save in
ASCII text format. You can also let SOL make them for you by recording
them from within the SOL slideshow dialog, but this feature is described
at the end of this document.
Each line of an .SLS file contains either a comment, a command, or a
filename. A comment line always has a '#' character at the beginning of
the line followed by text. Blank lines do NOT need to be started by a '#'
character. A command line begins with a forward slash '/' character,
followed by the command. All commands are described in detail below.
You can also put a filename on a line to tell SOL to load in that
filename and display it.
Filenames are typed out without any special characters before them. You
can either type out the full path and drive letter, or just the
filename. If you only put the filename, that file must be located
in the same directory as the script file. You can also use wildcards
(*,?) in your filename which will cause SOL to load in all files that
fit that wildcard, displaying each one in turn. By default, each file
that is loaded in will replace the previous file in memory, unless you
use the /ADD command (see below.)
Each filename can be followed by a integral number which indicates how
many seconds to display the image before executing the next script
command. If you do not include a number here, then the image will be
displayed for the number of seconds that the last image was displayed
for. If there was no number specified in the script file, SOL will use
the display time set in the Slideshow Settings Dialog Box.
-----------------------------
--==>> SCRIPT COMMANDS <<==--
-----------------------------
Each commands starts with a forward slash '/' character. You can only
have one command and its parameters per line. Case is ignored in the
commands (i.e. /ADD = /add = /Add). Some commands take parameters, and
some allow you to omit parameters. Omitting some parameters will leave
them unchanged from their previous settings. The first parameter must
ALWAYS be included in a command that takes parameters and omitted
parameters must be at the end of the list. Each parameter is separated
by one space character.
Any errors in the commands found before execution begins (while loading
in the script file) will be indicated to you and the script file will
abort. Errors found while running the script will cause an alert box
that will ask you whether you want to continue executing the other
commands in the script or not.
NOTE that most commands will alter settings and preferences in SOL.
/FIT - Sets the "Fit image to screen on load" preference.
/NOFIT - Turns off fitting.
/SCALE x y - Scales the next image to the width and height specified
in the 'x' and 'y' parameters.
/CLIP x y w h - Clips the next image.
/POS x y - Positions the upper left-hand corner of the display for
the next image.
/HFLIP - Flips the next image horizontally.
/VFLIP - Flips the next image vertically.
/ROTR - Rotates the next image 90 degrees right.
/ROTL - Rotates the next image 90 degrees left.
/ADD - Tells SOL to keep the next image it loads in memory instead
of purging it after display. If /ADD is not before an image
then it will be purged before the next image is loaded.
/COLOR - Sets the display mode to color.
/SHADES - Sets the display mode to shades.
/DRAW - Shows drawing of the image.
/NODRAW - Blanks the screen while drawing.
/MOUSE - Leaves mouse on while displaying image.
/NOMOUSE - Turns mouse off.
/TCLOAD x - Selects the type of truecolor conversion:
0=Octree , 1=Fixed, 2=Greyscale
/FIXPAL x - Selects the type of fixed palette used:
0=Red, 1=Green, 2=Blue,
3=Red-Green, 4=Red-Blue, 5=Green-Blue
/WARP p r x y w h - Sets the warping parameters (same as in dialog):
p - the wave pattern 0=off,1=Flat,2=Linear,etc.
r - repeat 0=single,1=periodic
x - the shift right or left of the wave (+/-)
y - the position in the image of the wave
w - the width of the wave (+/-)
h - the height of the wave
/SHOW - Displays the "progress" dialogs when the next image loads
in instead of working in the background.
/NOSHOW - Does all loading and processing of the next image in the
background so you can view the last image while SOL works.
/STOP - Stop executing the script. Same as just an end of file.
----------------------------------
--==>> EXAMPLE SCRIPT FILE: <<==--
----------------------------------
/clip 100 100 150 200
# This picture must be in the same directory as this .SLS file.
# Displays for the default display time.
PICTURE1.GIF
/ROTR
# These have a path. First one displays for 20 seconds.
D:\GRAPHICS\JPEG\FROGS.JPG 20
/ADD
/SCALE 320 200
# This displays for 30 sec.
D:\GRAPHICS\IMAGE\PICTURE2.IMG 30
/hflip
/WARP 3 0
# This also displays for 30 sec. Since /ADD was used for the PREVIOUS
# image, this image will NOT replace PICTURE2.IMG.
PICTURE3.PNT
/WARP 0
# We must turn off warping since it effects all images after it is executed.
# This causes SOL to stop executing this script file and to continue with
# the file ABS.SLS. You can also use the name of the current script to
# execute the same one over and over again.
ABC.SLS