Hall of Fame/HallofFameCDROM.cdr/window/winshow.lzh/README.TXT

Text File | 1989-01-20 | 22KB | 499 lines

                                 CLICK & SHOW
                       A UNIQUE "SLIDE SHOW" GENERATOR
                                     FOR
                              MICROSOFT WINDOWS

                                 Version 1.01

                                              Presented by:

                                              Sun Data, Inc.
                                              P.O. Box 37197
                                              Albuquerque, NM  87176
                                              [phone]

                                              Copyrighted @1988,1989 by
                                              Sun Data, Inc.


TABLE OF CONTENTS                                     Page #

DISCLAIMER & LICENSE AGREEMENT                             2

INTRODUCTION                                               3

HOW TO USE THE CLICK & SHOW SETUP PROGRAM                  5
   FILE OPTIONS                                            5
      NEW OPTION                                           5
      OPEN OPTION                                          5
      SAVE OPTION                                          5
      EXIT OPTION                                          5
   SETUP OPTIONS                                           6
      DEFINE TOP SLIDE OPTION                              6
      SHOW SLIDE OPTION                                    6
      STRETCH SLIDE OPTION                                 6
   EDIT OPTIONS                                            7
      ADD TA OPTION                                        8
      MOVE TA OPTION                                       8
      DELETE TA OPTION                                     8
      CHANGE TA SLIDE OPTION                               8
      CHANGE TA PRIORITY OPTION                            9
      DEL BACKGROUND TA OPTION                             9
   IMPORT OPTIONS                                          9

 HOW TO USE CLICK & SHOW                                  10
   OPENING NEW SHOWS                                      10
   EXITING                                                10


                        DISCLAIMER & LICENSE AGREEMENT

LICENSE AGREEMENT:

THIS IS NOT PUBLIC DOMAIN SOFTWARE.  IT IS HOWEVER A VERSION OF SHAREWARE.
OUR CONCEPT OF SHAREWARE IS THAT YOU ARE ONLY FREE TO DOWNLOAD THIS PACKAGE
FROM BULLETIN BOARDS WE HAVE PLACED IT ON.  YOU ARE NOT FREE TO UPLOAD THE
SOFTWARE ANYWHERE YOU WISH WITHOUT HAVING FIRST OBTAINED PERMISSION FROM US
AT SUN DATA, INC.  YOU MAY DISTRIBUTE THE SOFTWARE TO YOUR FRIENDS AND
ASSOCIATES BUT ONLY ON CONDITION THAT YOU DISTRIBUTE IT VIA MAGNETIC MEDIA,
THAT YOU DISTRIBUTE IT WITH THIS MANUAL, AND THAT YOU DON'T CHARGE ANYONE
FOR THE DISTRIBUTION.

THIS MEANS YOU MAY NOT EVEN CHARGE FOR THE DISTRIBUTION MEDIA.

YOU ARE FREE TO USE THIS PACKAGE FOR YOUR OWN PERSONAL TRIAL FOR A GRACE
PERIOD OF 30 DAYS WITH NO PAYMENT REQUIRED.
HOWEVER, IF AFTER THIS GRACE PERIOD YOU DECIDE THAT THIS SOFTWARE
IS USEFUL TO YOU, YOU ARE REQUIRED TO FILL IN THE REGISTRATION FORM
AT THE BACK OF THIS MANUAL AND SEND IT TO US ALONG WITH THE
$20.00 REGISTRATION FEE.

AFTER THIS YOU CAN FREELY USE THE PACKAGE FOR YOUR PERSONAL NEEDS
AS YOU SEE FIT.

YOU MAY NOT COMMERCIALLY USE OR DISTRIBUTE THIS PACKAGE IN ANY WAY WHATSOEVER
WITHOUT FIRST OBTAINING A "LICENSE TO DISTRIBUTE" FROM US.

DISCLAIMER OF SOFTWARE:

Basically we don't guarantee this software to do anything for you.
However, if you pay us for a license to use the package and then decide
within 30 days of payment that you have wasted your money,
no problem, we'll refund your registration fee, but that is all.
We are not responsible for any time, money, goods or any other
tangible or intangible item you feel you have lost
directly or indirectly due to use, performance or lack of performance of this
software package.

However, we think it is a good package with a wealth of potential uses.
Not only that, it's fun to use.

If you want hard copy of this manual, at the DOS prompt just type in
"type readme.txt > prn" and hit return (don't type the " marks).

BTW, Windows is a trademark of the Microsoft Corporation.



                                 INTRODUCTION

Hardware Requirements:
Both Click & Show (show.exe) and Click & Show Setup (clsetup.exe) run under
Microsoft Windows 2.1 and require a mouse and 640K of memory.  We also
strongly suggest you have both extended and expanded memory if you will be
working with color screens.  And of course an 80286 is almost mandatory
for all Windows applications.

The Click & Show system is a set of two programs used for laying out
and then presenting a collection of "slides" or screens in a logical
and useful manner.  One program, Click & Show Setup (clsetup), is used to
to design the slide show layout and the "touch areas" (TA's) on each slide,
while the Click & Show program is used to "run" the show.  In a sense you can
think of this system as a mouse driven hypertext system for graphical images.

The system is not slide generator, it only takes previously generated
slides (more on this in a minute) and allows the designer to put
together a "slide show".

Click & Show Setup (clsetup.exe) is a program for designing the layout
and setup of "slide shows" to be presented by the Click & Show program.
For each slide show, the user defines a starting slide, and then for
each slide in the show he/she can define touch areas (TA's).  Each touch
area is defined so that it "points" to another slide in the show.
During a run, the end user double clicks on a TA and the new slide the
TA points to is rapidly displayed.  Each slide in the show also has an
associated background touch vector which points to a "default slide".
Double clicking on a region not in a touch area will display the default
slide.  For example, the default slide may be the top slide in the show
or perhaps the top slide in this series.  This is analogous to returning
to a previous menu.

Click & Show Setup obtains its slides (or screens) in one of two ways,
either off of the clipboard or from disk files.  Currently we only support
bitmaps and metafiles (from clipboard or disk).  If the designer loads
a metafile, this is then saved as bitmap for the "run" mode.  These slides
are generated by the designer using any one of a number of the drawing
programs currently so popular.  If the drawing program is a Windows app
then it will be easy to put these images on the clipboard and import them
into Clsetup.  Otherwise, an image can be grabbed with the frame grabber
provided with Windows.  Finally if the drawing application can store
the slide in a Windows bitmap or metafile format, the designer can import
the image from disk to clsetup.

The other half of the system is the Click & Show engine (show.exe).
Show is the program which presents the collection of "slides",
known as a "show", put together by the designer using clsetup.exe.
The user moves from slide to slide in the show by clicking on the
predefined "touch areas" with the mouse.  Currently, the only type
of slides supported in a show are bitmaps in Microsoft Windows format.

Show.exe does not explicitly show the touch areas that are defined
via clsetup.  It is assumed that the locations of the touch areas
will be obvious from the slides themselves.


The system is designed as two separate programs to reduce run time
size and speed execution.  It is really rather surprising how fast bitmap
images can be loaded from disk.

Unfortunately, at this time, Click & Show only supports slides that
are in a bitmap format.  We are of course working on supporting a
number of other image formats (metafiles, TIFF files, MGX, PCX &
compressed bitmaps) but this is for the next release.  Thus because
of the hardware dependent nature of bitmaps, it is highly recommended
that both the design and target "run" machine be of the same hardware
configuration.  Of course you can go between different display adapters
by using our STRETCH mode but the results are not as good.

The potential applications for this system are many and with the
advent of cheap optical disks, the size of the shows is almost
unlimited.  One example application would be a collection of maps.
The first slide in the show might be a map covering an entire state.
Double clicking on a county or city would bring up a corresponding map
of greater detail.  Double clicking on sections of a city could bring
up more detailed maps and so forth.




                  HOW TO USE THE CLICK & SHOW SETUP PROGRAM

To start, type "win clsetup" from DOS or double click on clsetup.exe from
the Windows executive.  CLSETUP has four entries on its menu bar:
FILE, SETUP, EDIT, and IMPORT.  Each entry has its own submenu.


FILE OPTIONS:
Each slide show has a show file associated with it that stores the
TA links and pointers to images.  We recommend using the default
extension ".shw" for these files.  The FILE option is used to access
the show files.  The FILE option has a submenu with six entries:
NEW, OPEN, SAVE, SAVE AS, EXIT, and ABOUT.


NEW OPTION:
Choose NEW when you want to start work on a slide show that doesn't
already exist.  This clears memory of data from the slide show you
have been working on.  Be sure you save (see below) your work before
doing a NEW.  You don't need to choose new if you have just entered
the program.


OPEN OPTION:
Choose OPEN if you want to edit a show that already exists.  Be sure
to save (see below) your work before doing an OPEN, because the show
currently in memory will be overwritten.  Choosing OPEN produces a
list box and an edit box.  The list box shows those files in the
current directory having a ".SHW" extent.  This is the default extent
for slide show files.  If your show file name has a different extent,
you will have to enter the name into the edit box, otherwise choose a
file from the list box by double-clicking on it with the mouse.  As
soon as you pick a slide show, the first slide in that show will be
displayed.


SAVE OPTION:
Choose SAVE to save your work.  Keep in mind that SAVE will overwrite
the file that you last OPENed.  If you haven't done an OPEN or if you
did a NEW after the last OPEN, you will be asked to specify a file name.
If you want to save your work to a file other than the one you
opened, choose SAVE AS.  SAVE AS is the same as SAVE, except that
SAVE AS always asks for a file name.  It is better if the file names
you use for your slide show files end in ".SHW", since this is
the default extent used by the program.


EXIT OPTION:
Choose EXIT to exit the program.  Be sure to save your work first.


SETUP OPTIONS:
The SETUP option has a submenu with three entries:  DEFINE TOP SLIDE,
SHOW SLIDE, and STRETCH SLIDE.


DEFINE TOP SLIDE OPTION:
Choose DEFINE TOP SLIDE to pick the first slide in a slide show.
This can only be done for a new slide show and is the first thing you
must do when beginning a new show !  At this time you cannot
change the first slide in an existing show, so choose the first slide
carefully.
Choosing DEFINE TOP SLIDE produces a list box and an edit
box.  The list box shows those files in the current directory having
a ".BMP" extent.  This is the default extent for slide files.  If your
slide file name has a different extent, you will have to enter the name
into the edit box, otherwise choose a file from the list box by
double-clicking on it with the mouse.  As soon as you pick a slide it
will appear on the screen.


SHOW SLIDE OPTION:
Choose SHOW SLIDE to look at another slide in the slide show.  A list
box will appear showing all the slides in the show.  Choose one of
the names from the list box.  This will cause that slide to appear on
the screen, along with all its touch areas.  You cannot use this
option to look at a slide that is not in the show.  To put a slide in
the show, it has to be "pointed to" by a touch area on an existing
slide (see below).


STRETCH SLIDE OPTION:
Choose STRETCH SLIDE to stretch (or compress) a slide (bitmap) so
that it fits the screen exactly.  This option pulls up a list box
and asks for the name of the slide in the show to STRETCH.  After
stretching the image the fit the screen, it is then saved back to
disk in this stretched format.  For this reason make sure you have
backed up any image before stretching it.  You may not like the
new stretched image and will want to discard it and reinstate
the unstretched image.  See below for more information on the
subject of stretching.


NOTE:
Show and Clsetup are designed to run with a maximized window.
Generally, bitmaps produced by your drawing program will not exactly
fit the maximized Show or Clsetup screens.  If you don't stretch your
slides somehow, your slide will either be clipped or will not fill
(or both) the maximized Show or Clsetup screens.

You don't have to use STRETCH SLIDE to make your slides fit the
maximized screen.  You can tell both the Clsetup and Show programs to
stretch or compress the slides as they are read in.  Both programs
will ask the user if he wants to stretch or compress the slides if
the program encounters a slide that does not exactly fit the
maximized screen.  (Whatever the answer given, it will apply to all
subsequent slides in the show that don't exactly fit.  The program
will ask only once for each show.) But unlike using STRETCH SLIDE,
answering "yes" will NOT cause the program to write the stretched or
compressed slide back to its file.  The main disadvantage to
stretching the slides as they are read in is that the Show program
will run much slower if it has to do this.

Alternatively, you can use the STRETCH SLIDE option to stretch your
slides to fit the Show and Clsetup maximized screens.  The disadvantage
in doing this is that your slides may be distorted.  Since CLsetup will
write the stretched slide back to the file, you should probably make
backup copies of your slides before doing this.  You can stretch any
slide at any time, even if it is not in the current show.

If your slides are smaller than the Show and CLsetup maximized screens,
another possibility is to simply run Show and CLsetup with smaller
screens.  This will preserve the original "look" of the slide.


EDIT OPTIONS:
The EDIT option is used to add, delete, or change the touch areas
on the slide currently being displayed.  This option has a submenu
with six options:  ADD TA, MOVE TA, DELETE TA, CHANGE TA SLIDE,
CHANGE TA PRIORITY, and DEL BACKGROUND TA.  TA stands for touch area.
A touch area is a rectangular area on the slide that the user has
defined to "point" to another slide in the show.  When the slide show
is run using Click & Show, double-clicking within that rectangle will
cause the other slide to be displayed.

The first five of these options are mutually exclusive; that is, one
and only one of them is always in effect at any given time.  The
option currently selected is indicated by a check mark.  When the
program is started, ADD TA is automatically selected.  None of these
options will do anything unless a slide is displayed.


ADD TA OPTION:
Choose ADD TA to add touch areas to the current slide.  The touch
area is indicated by drawing a rectangle with the mouse.  Put the
mouse cursor at one corner of the rectangle, then depress the mouse
button.  Then, with the button still depressed, move the mouse cursor
to the opposite corner of the rectangle and release the button.
After drawing the touch area, you will be asked to name the slide
that the touch area "points" to.  A list box will appear showing the
names of files in the current directory with the ".BMP" extent.
Choose a file from the list box or enter a file name using the edit
box.  The slide you choose need not be one that is already in the
show.

NOTE:
You can have many different TA's pointing to the same slide.  However,
all touch areas must be rectangular.  A non-rectangular TA must be
approximated with a collection of smaller rectangular TA's.


MOVE TA OPTION:
Choose MOVE TA to move touch areas already on the current slide.  To
move an existing touch area, put the mouse cursor within the touch
area you want to move, then depress the mouse button.  With the
button still depressed, move the mouse cursor (the touch area will
follow along with it) to the new location.


DELETE TA OPTION:
Choose DELETE TA to remove touch areas from the current slide.  To
delete an existing touch area, put the mouse cursor within the touch
area you want to delete, then double-click with the mouse button.
You will be asked to verify that you really want to do a delete.


CHANGE TA SLIDE OPTION:
Choose CHANGE TA SLIDE to change the slides that touch areas point
to.  To change the slide that an existing touch area points to, put
the mouse cursor within that touch area, then double-click with the
mouse button.  A list box will appear showing the names of files in
the current directory with the ".BMP" extent.  The edit box above the
list box shows the slide that the touch area currently points to.  If
you want to change this, make a selection from the list box or type a
new file name into the edit box.


The background of a slide (all the area outside the touch areas) is
itself considered to be a touch area.  The user doesn't have to draw
a rectangle to define its extent, but initially it doesn't "point" to
another slide.  To make the background touch area point to another
slide, choose CHANGE TA SLIDE, double-click somewhere on the
background, then choose a slide.


CHANGE TA PRIORITY OPTION:
Choose CHANGE TA PRIORITY to change the relative priority of touch
areas on the current slide.  "Priority" of touch areas has meaning
only when two or more touch areas overlap.  As touch areas are added,
the new touch area is placed "below" any overlapping touch areas on
that slide.  To change this resulting priority, simply double-click
within the touch area you want to bring to the top.


DEL BACKGROUND TA OPTION:
Choose DEL BACKGROUND TA to make the background touch area point to
nothing again.  You will be asked to verify that you really want to
do this.  This option requires no further action with the mouse, and
does not change the EDIT "mode" (i.e.  which option is checked in the
EDIT submenu).  This option has no effect unless you have made the
background of the slide point to another slide (see second paragraph
under CHANGE TA SLIDE above).


IMPORT OPTIONS:
The IMPORT option is used to get bitmaps, text, or metafiles from the
clipboard and save them as bitmaps.  The submenu, not surprisingly,
has three entries:  BITMAP, METAFILE, and TEXT.  The usual procedure
is to use a drawing program to make a slide, then copy your work to
the clipboard in Windows bitmap or metafile format.  You can then go into
CLsetup and retrieve the slide from the clipboard.  Choose the appropriate
option from the IMPORT submenu (BITMAP, METAFILE, or TEXT).  If the
clipboard has the requested data, it will display it (otherwise you
will be told, for example, that the clipboard has no metafile).  You
are then given the option of saving the data as a bitmap.  You will
be asked to give it a file name.  A file name with a ".BMP" extent is
recommended.


                           HOW TO USE CLICK & SHOW

To start, type "win show".  Click & Show has four entries in its menu
bar: OPEN, TOP, PREVIOUS, and QUIT.  There are no submenus.  Upon
entering the program, there are only two options: OPEN or QUIT.  QUIT
is for exiting the program.  OPEN allows you to start a show.
Clicking on OPEN produces a list box showing the files in the current
directory ending in ".SHW".  This is the default extent for show
files.  If your show file name has a different extent, you will have
to enter the name in the edit box, otherwise choose a file from the
list box by double-clicking on it with the mouse.

When you choose a show, the first slide in that show will be
displayed.  At this point you can move among the slides by
double-clicking on touch areas on the slides.  The touch areas are
not explicitly indicated as in the setup program, but should be
fairly obvious from the slides themselves.  Besides using touch areas
to move between slides, you can move to the previous slide or the top
slide by using the PREVIOUS or TOP options on the menu bar.

If the Show program encounters a slide that does not exactly fit the
maximized Show screen, it will ask the user if he wants the slides to
be stretched or compressed to fit exactly.  Whatever the answer
given, it will apply to all subsequent slides in the show that don't
exactly fit.  The program will ask only once for each show.  The Show
program will not write the stretched/compressed slide back to its
file; the slide file remains unaffected in either case.


OPENING NEW SHOWS:
To open a new show, use OPEN as desciribed above.

EXITING:
To exit the program, use QUIT.


APPENDIX A
REGISTRATION FORM

Registration form for Click & Show System Ver 1.0

Payment of the $20 registration fee for this software entitles the end user
to one year of free updates of the product and six months of free technical
support (your nickel however).

Name:____________________________________________________________

Company:_________________________________________________________

Address1:________________________________________________________

Address2:________________________________________________________

City:_____________________________  St:____  Zip: _______________

Phone:______________________________________


Primary Use of the Software:








Suggestions for improvement:











Please return this form to:

               Sun Data, Inc
               P.O. Box 37197
               Albuquerque, NM  87176

               [phone]