home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / z / zoomdoc.zip / MANUAL2.TXT < prev    next >
Text File  |  1992-11-15  |  39KB  |  900 lines

  1.  
  2.                             ZOOM
  3.            ■════════════════════════════════════■
  4.  
  5.           ADMINISTRATOR'S GUIDE TO ZOOM VERSION 2.3
  6.  
  7.       (c) Copyright 1992 by ATI.  All Rights Reserved.
  8.                         October 1992
  9.  
  10.                   ■═══════════════════════■
  11.  
  12. Notes  
  13.  
  14.       If you create stacks that may be of interest to others, you are free
  15.       to market them.  However, we would like to obtain a copy of it
  16.       as well.  If we like your stack and include it with Zoom for
  17.       distribution, we will also give you a free registration.
  18.  
  19. Disclaimer
  20.       ATI hereby disclaims all warranties relating to this software,
  21.       whether expressed or implied, including without limitation any
  22.       implied warranties of merchantability or fitness for a particular
  23.       purpose.  ATI will not be liable for any special, incidental,
  24.       consequential, indirect or similar damages due to loss of data or
  25.       any other reason, even if ATI or an agent of ATI has been
  26.       advised of the possibility of such damages.
  27.  
  28.       For technical assistance, contact:
  29.  
  30.       Alternative Technologies, Inc.
  31.       MIT Branch
  32.       P.O. Box 118
  33.       Cambridge, MA 02139  
  34.       USA                   
  35.              
  36.       Phone:  1-617-742-5161                     
  37.       FAX:    1-617-253-2514                     
  38.       email:  ati@hotstuff.mit.edu
  39.  
  40.  
  41.       The Zoom software has been produced with the assistance of the
  42.       World Health Organization and the E.M. Clark Foundation.
  43.  
  44. Trademark 
  45. Acknowledgments
  46.  
  47.  
  48.       All terms mentioned in this Guide that are known to be
  49.       trademarks or service marks are listed below.
  50.  
  51.       dBASE III is a registered trademark of Ashton-Tate.
  52.  
  53.       Hercules is a registered trademark of Hercules Computer
  54.       Technology.
  55.  
  56.       IBM, PC-DOS, PC-AT, PC-XT, and PS/2 are all registered
  57.       trademarks of International Business Machines, Inc.
  58.  
  59.       Lotus is a registered trademark of Lotus Development
  60.       Corp.
  61.  
  62.       MS-DOS is a registered trademark of Microsoft, Inc.
  63.  
  64.       MultiMate is a registered trademark of Ashton-Tate.
  65.  
  66.       PC Paintbrush is a registered trademark of Z-Soft
  67.       Corporation.
  68.  
  69.       ScanJet Plus is a registered trademark of Hewlett-Packard
  70.       Corporation.
  71.  
  72.       Wordperfect is a registered trademark of WordPerfect
  73.       Corporation.
  74.  
  75.       WordStar is a registered trademark of MicroPro International
  76.       Corporation.
  77.  
  78.  
  79. 1.   Introduction
  80.  
  81. Zoom is a computer software package for IBM-PC and compatible
  82. computers capable of organizing and presenting ideas.  Zoom enables the
  83. user to search through the stacks (database) using the concepts of Index
  84. and Key Words.  Zoom is easy to use and requires only a basic hardware
  85. and software configuration.  In addition, Zoom stacks are easy to create,
  86. and has the capability to interact with the user in English, French, Spanish
  87. and Portuguese (planned).  
  88.  
  89. 1.1  Computer Hardware Requirements
  90.  
  91. Zoom is designed to run on IBM PC, XT, AT and PS/2 computers and 
  92. compatibles with at least 512 KB of RAM.  A hard disk is highly
  93. recommended.  If a mouse is installed, Zoom will use it.  A color monitor
  94. is a plus, but it is not required.  If the information consists only of text,
  95. then there are no additional hardware requirements.  If the information
  96. consists of text and pictures, a graphics adapter is required.  Zoom
  97. supports all graphics modes up to and including VGA.  (The current
  98. version of Zoom, version 2.3, supports all the graphics modes, but the
  99. images will be distorted on CGA and HGA.)  If images need to be
  100. scanned, a scanner such as a  Hewlett-Packard ScanJet Plus is required. 
  101.  
  102. 1.2  Computer Software Requirements
  103.  
  104. Zoom requires PC/MS-DOS Version 3.0 or higher.  A text editor, capable
  105. of writing ASCII format, is required to enter the text information and
  106. establish links.  Popular word processors, such as WordStar or
  107. WordPerfect, are ideal for this purpose.  If pictorial information are
  108. required, a paint software package capable of manipulating PCX image
  109. format, such as PC PaintBrush by ZSoft Corporation, Maretta, GA 30067,
  110. USA (404) 428-0008, is required.  Zoom reads the PCX image format. 
  111. For database files, any program that can write DBF files is acceptable. 
  112. For spreadsheets, any program that can write WKS files is acceptable.
  113. 1.3 Structure and Organization
  114.  
  115. Zoom allows the organization of text and pictures into a logical, inter-
  116. connected structure.  Information is linked using key words and through
  117. an index file.  The Index file is also an ASCII file, modifiable by the
  118. administrator.  The Index file will be talked about in more detail later in
  119. the manual.
  120.  
  121. The basic unit of information in Zoom is the slide.  A slide consists of a
  122. screen of graphical or textual information.  Zoom utilizes what is called a
  123. virtual screen.  A virtual screen allows the displaying of images larger
  124. than the size of the monitor.  The computer monitor works like a window
  125. looking into a larger piece of image, allowing the user to scroll through
  126. the entire image.  The actual size of the window is dependent on the type
  127. of graphics adapter used.  Usually, a piece of information will consist of
  128. several connected text and graphic slides.  Connection are made by
  129. linking the slides through the use of branches.  These concepts will be
  130. explained later on.
  131.  
  132. Next level of organization is the chapter.  A chapter is formed by
  133. grouping a set of slides together.  Thus, a chapter can consist of both text
  134. and pictures.  Chapters are different from branches mainly in the size and
  135. the heterogeneity of the material contained.  For example, a branch may
  136. consist of a discussion on apple seeds.  However, a chapter may discuss
  137. fruits in general.  Apple seeds branch will then be a subset of the Fruits
  138. chapter.   Zoom can handle up to 300 chapters, each with up to 300
  139. slides.  The total number of slides that a Zoom stack can hold is 300 x
  140. 300 or 90,000.
  141.  
  142. In addition to the organization of material, Zoom assigns a level of
  143. priority for each slide.  This will determine how a slide is displayed.  The
  144. slides that the administrator feels are essential are called Slides and the
  145. slides which contain information that may be too detailed or may be of
  146. little interest to most readers are called Subslides.  When the user selects
  147. Run command from the menu, Zoom sequences through series of Slides
  148. which make up the body of information.  If the user desires more detailed
  149. information on a particular topic, it is possible to branch off to a related
  150. set of slides.  These related slides will consist of both Slides and
  151. Subslides.  
  152.  
  153. The user moves from topic to topic by using the concept of link.  A link
  154. is a relationship between different slides established by the administrator
  155. through the use of the index file.  A slide can point to a number of other
  156. slides and in turn may be pointed to by other slides.  Through the use of
  157. function keys, the user can jump between various topics and return to the
  158. starting point at any time.  
  159.  
  160. 1.3.1  The Slide
  161.  
  162. As mentioned previously Zoom partitions the information into basic units
  163. of slides.  There are two types of slides - @Slides and @SubSlides. 
  164. @Slides make up the core sequence, and may include more basic
  165. material.  Therefore, when the user begins Zoom, the user is usually led
  166. through a sequence of slides made up of @Slides.  @SubSlides may
  167. contain more detailed information about a particular subject matter which
  168. is available to the user only through a link from another @Slide or
  169. @SubSlide.  @SubSlide is not shown if the user selects the automatic
  170. mode.
  171.  
  172. For example, a chapter contains a set of slides, both @Slide and
  173. @SubSlide.  The core material is made up only of @Slides.  Therefore, if
  174. the user does not branch off to other subjects by using Key words or
  175. Index, the user will only view the @Slides.  Each @Slide can be linked
  176. to @SubSlides or @Slides.  The following diagram is used to illustrate
  177. this point - S represents @Slides and SS represents @SubSlides.
  178.  
  179.  
  180. Slide 1          2          3          4          5          6
  181.       S════════S════════S════════S════════S════════S
  182.                                                           
  183.                  │          
  184.                  │          SS───────SS──────SS──────SS
  185.                  │                              
  186.                                                
  187.                  SS───────SS───────SS──────SS
  188.                                                
  189.                                                
  190.                             SS───────SS──────SS
  191.                                                
  192.                                                
  193.                                        SS──────S(6)
  194.  
  195.                   Fig. 1 - Slide link tree
  196.  
  197. The level of references (linking) may be very complicated or very
  198. simple.  It is up to the administrator to create those links.  Only a
  199. very simple example has been used to illustrate the linking concept. 
  200. As can be seen on Figure 1, @Slides can be linked to @SubSlides or
  201. other @Slides.  @SubSlides can also be linked to @Slides and other
  202. @SubSlides. 
  203.  
  204. When a user begins Zoom in automatic mode (by selecting Run command
  205. from the menu), the first slide of chapter 1 is shown (refer to Fig.
  206. 1).  By using the Page Down key or the Next menu command, the following
  207. slide, Slide 2, is shown.  The user can, at any point, view the
  208. previous slide by using the Page Up key or the Previous menu command. 
  209. If there are no previous or following slides, Zoom notifies the user of
  210. the proper action to take.  
  211.  
  212. In addition to viewing the core slides, the user can view the SubSlides
  213. (SS in Fig. 1) by branching from the core slides.  In Figure 1, two
  214. sets of SubSlides are linked to Slides 2 and 3.  A key word provides
  215. the link to other Slides and SubSlides.  A set of key words can be
  216. associated with each Slide or SubSlide and is available to the user
  217. from the Key words menu command.  The user can select one of the key
  218. words from the key words menu and branch to the slides which are linked
  219. to the key word.  There can be up to 20 key words per slide, and the
  220. maximum length of the key words is 46 characters, including the "hide
  221. character ^".
  222.  
  223. The Index file can be considered as a road map used by Zoom.  The index
  224. file contains the links for all the key words in all the chapters of a
  225. Zoom stack.  When the user selects a key word from the Key word menu,
  226. Zoom searches the index file and locates the links and loads the proper
  227. sequence of slides.  The Index is available to the user at any point
  228. during the program from the Index menu command.  Since the Index file
  229. contains all the key words from all the slides, the user can branch to
  230. any slide on any chapter.
  231.  
  232. 1.3.2 The Chapter
  233.  
  234. A chapter contains the text information and the commands used by Zoom
  235. to display the information.  There are several commands used by Zoom to
  236. determine, for example, to display text in a window on the screen, to
  237. change the color of the text and to control the duration of pause at
  238. the end of each text line.  A chapter may hold up to 300 slides, and
  239. there may be up to 300 chapters per stack.  
  240.  
  241.  
  242. 2.   The Formation of Slides and SubSlides
  243.  
  244.  
  245. The interaction of Zoom with the stack file is analogous to the
  246. interaction between say a BASIC program and a BASIC interpreter.  Zoom
  247. reads each line in the stack and looks for commands which tell it how
  248. to display the information.  The commands are, however, much simpler
  249. than any programming language.  All commands begin with an '@' and take
  250. an  argument, followed by an open bracket '[',  the text, and an close
  251. bracket ']'.  For example, the command that tells Zoom to display a
  252. phrase in red looks as follows:
  253.  
  254.               @red[This text will be printed in red.]
  255.  
  256. The commands can be placed in any position in the text.  Zoom will not
  257. show the command or brackets when displaying on the computer screen or
  258. printing.  In this example, only the sentence This text will be printed
  259. in red. will appear on the screen (in red).  A command cannot occur
  260. within another command.  
  261.  
  262. 2.1 The Text Slide
  263.  
  264. A chapter is divided up into slides using the '@Slide[ ]' command. 
  265. Each slide must have a unique label that is no longer than 12
  266. characters (any characters beyond 12 will be ignored).  Since the key
  267. words and the index use the slide label to identify each slide in a
  268. stack, each label must be unique among the entire stack (all the slides
  269. in all the chapters).  For example, the first slide in the Middle Ages
  270. chapter, may look like:
  271.  
  272. @Slide[FirstSlide-TEXT-]
  273.  
  274. This is the text in the first slide on the Middle Ages. The Middle Ages
  275. were neither high, nor low; they were in the middle.
  276.  
  277. In general, a text slide can have up to 21 lines of text.  However, if
  278. a slide is longer than 21 lines, Zoom will allow the user to scroll the
  279. rest of the text on the screen.  
  280.  
  281. The first argument after the @Slide command, 'FirstSlide', is the slide
  282. label.  No other slide can have 'FirstSlide' as its label.  Zoom is
  283. case insensitive - FirstSlide is same as firstslide or FIRSTSLIDE. 
  284. However, for ease of comprehension, mixed upper and lower case letters
  285. should be used.  The slide label can be up to 12 characters long,
  286. including the "hide character".
  287.  
  288. The second argument, 'Text', tells Zoom that this is a text slide and
  289. to print the information on the screen.  The dashes, '-', are essential
  290. and are used to separate arguments.  The arguments are also case
  291. insensitive.  
  292.  
  293. Suppose that in the second slide we wish to give the user the freedom
  294. to look at a certain topic in greater detail.  We must, then, provide
  295. key words for the slide.  A key word points to an entry in the index
  296. file which contains a sequence of Slides or SubSlides that can explain
  297. in greater detail the selected key word.  It is up to the author to
  298. determine how links are established.  
  299.  
  300. Do not confuse key words with slide labels.  A slide label is the name
  301. of a particular slide.  It is how a slide is identified by Zoom.  A key
  302. word, on the other hand, is used by Zoom to establish links between
  303. slides.  It is done through the index file.  A typical line in the
  304. Index file may look like this:
  305.  
  306. Industrial revolution^One-IndustAge1-IndustAge2-Machines-
  307.  
  308. Industrial revolution^One is the key word and IndustAge1, IndustAge2,
  309. Machines are slide labels.  The "hide" character (^) allows you to have
  310. multiple index entries that appear to be the same entries to the user. 
  311. Characters after the hide character is not displayed on the screen, but
  312. Zoom will use it to identify the link.  In this case, the user will see
  313. only Industrial revolution on the screen but Zoom will consider the
  314. entry to be Industrial revolution^One.  This is useful if you need to
  315. have several of the same entries in the index.  The following example
  316. explains this concept further.
  317.  
  318. Industrial revolution^One-IndustAge1-IndustAge2-Machines-
  319.  
  320. Industrial revolution^Two-NotClean1-NotClean2-
  321.  
  322.  
  323. In this example, the author wanted to have sub-index headings in two
  324. different places that is called Industrial revolution.  Each of the
  325. index entries has its own list of slides to display.  To  the user,
  326. only the phrase Industrial revolution will be displayed.  But Zoom will
  327. use the hide character and the characters after it to identify them as
  328. unique entries.
  329.  
  330. If Industrial revolution^One was selected from the key word menu or
  331. from the index, the three slides called IndustAge1, IndustAge2,
  332. Machines will be lined up in the sequence to be viewed by the user.  At
  333. the end of the third slide, Machines in this case, Zoom will tell the
  334. user that the end of the sequence for Industrial revolution^One was
  335. reached and that the user can press either F2 or F4 key to get back to
  336. where they were before.
  337.  
  338. It will be explained a little later in detail how one makes the link
  339. between key words and the corresponding slides.  For now the second
  340. slide with links to such topics as  'Aristocracy', 'Clergy', and
  341. 'Peasants' may look like this:
  342.  
  343. @Slide[SecondSlide-Text-Aristocracy-Clergy-Peasants-]
  344.  
  345. Life in the Middle ages was very difficult, especially if you were a
  346. peasant.   Life was much better if you were a member of the clergy, but
  347. life was the best if you were part of the aristocracy.
  348.  
  349. Note that the first two arguments after the @Slide command are the
  350. slide label and the slide type.  The remaining arguments are the key
  351. words for this slide.  A slide can have up to 20 key words and the key
  352. words can be up to 46 characters long, including the hide character
  353. ("^").  A key word can be a combination of words, spaces, and extended
  354. ASCII characters.  However, a dash ('-') or brackets ('[]') are not
  355. allowed.  The key words thus defined will appear under the Key words
  356. menu choice.  If a key words is selected, Zoom displays the referenced
  357. slides on the screen.  
  358.  
  359. The other kind of slide, SubSlide, is used in a manner similar to the
  360. Slide, except the SubSlide is accessible only through links. 
  361. Therefore, SubSlide is suitable for information that may be very
  362. detailed and may not be of interest to the majority of the users.  An
  363. example of the SubSlide is as follows.
  364.  
  365. @SubSlide[DetailedInfo-Text-]
  366.  
  367. With the advance of the plow, made by @red[Jethro Tull], crop
  368. production during the Middle Ages increased tenfold.
  369.  
  370. This particular SubSlide, DetailedInfo, can only be accessed through
  371. references from other Slides and SubSlides.  The links are formed
  372. through the use of index file.  
  373.  
  374. In the SubSlide 'DetailedInfo', we have also used the color command to
  375. make 'Jethro Tull' stand out. Zoom can display different combination of
  376. foreground and background colors.  Zoom will let you select same the
  377. foreground and background colors, so you have to make sure that the
  378. color combinations are visually acceptable.  The following is a list of 
  379. color commands available in Zoom.
  380.  
  381. @black[Color Text] 
  382. @blue[Color Text] 
  383. @green[Color Text]
  384. @red[Color Text]
  385. @magenta[Color Text] 
  386. @brown[Color Text] 
  387. @lightgray[Color Text] 
  388. @darkgray[Color Text] 
  389. @lightblue[Color Text] 
  390. @lightgreen[Color Text] 
  391. @lightcyan[Color Text] 
  392. @lightred[Color Text] 
  393. @lightmagenta[Color Text] 
  394. @yellow[Color Text] 
  395. @white[Color Text]
  396.  
  397. All the colors can be used as a background color by using @bgcolor
  398. command.  
  399.  
  400. @bgwhite[Color Text]
  401. @bggreen[Color Text]
  402. .
  403. .
  404.  
  405. Simply printing the text to the screen can be boring.  Often it would
  406. be more interesting to change the speed of printing to the screen. 
  407. Zoom has the capabilities to delays the printing the text on the
  408. screen.  When such pause is introduced, it makes the printing more
  409. dramatic.  The command is issued as:
  410.  
  411. @Slide[DelayExample-Text-]
  412.  
  413. This line is printed without delay.
  414. @Delay[5000] This line is printed after a 5 second delay.
  415.  
  416. The argument to the delay command, 5000, is the number of milliseconds
  417. to wait before printing. 
  418.  
  419. 2.2   The Quiz Slide
  420.  
  421. Zoom as the ability to ask the user a question and wait for the correct
  422. answer.  Zoom will not let the user go on without answering the
  423. question.  The user is given three attempts at answering the question. 
  424. If the user fails at the third attempt, Zoom provides the user with the
  425. correct answer and allows the user to continue on.  Thus, with the Quiz
  426. slide, one has the ability to test the user's retention of the
  427. information.  As with the text slide, the administrator can provide key
  428. words. The index is also available to the user during the quiz, but the
  429. Previous and Next menu choices are not available.  The format of the
  430. Quiz slide is:
  431.  
  432. @Slide[Question1-Quiz-Answer-key word1-key word2-]
  433.  
  434. The Quiz slide can either be a Slide or a SubSlide.  As with any other
  435. slide, the Quiz slide must be given a unique label.  The argument
  436. following the slide label, Quiz, tells Zoom that this is a quiz slide. 
  437. The third argument is the correct question answer.  In addition, the
  438. Quiz slide may have key words which may be linked to the review
  439. information.  The user, however, is not allowed to progress in the
  440. chapter sequence until answering the question.  An example is as
  441. follows.
  442.  
  443. @Slide[EuropeWar1-Quiz-C-]
  444.  
  445.    The Thirty Years War raged through Europe for:    
  446.             (Answer A, B, or C and press Enter)
  447.  
  448.    A) Three months, but it seemed like thirty years.   
  449.    B) Three years, but the name was actually mistranslated.   
  450.    C) Thirty years, and this is a really stupid question.
  451.  
  452. In this example, EuropeWar1 is the slide label, and C is the correct
  453. answer.  All Text slide commands are available in the Quiz slide.
  454.  
  455. 2.3   The Picture Slide
  456.  
  457. The Picture slide gives Zoom the capability to display not only text,
  458. but pictures as well.  The picture must be in the PCX (ZSoft, PC
  459. Paintbrush) format and the computer must be equipped with a graphics
  460. adapter.  A picture slide can also be a Slide or a SubSlide.  When Zoom
  461. encounters the PCX slide command, it will search the current directory
  462. for a file with name of the slide label and the extension PCX.  If no
  463. file exists with that name, an error message is displayed.  A picture
  464. slide is accessed by using the following command.  
  465.  
  466. @Slide[Picture1-PCX-keyword1-keyword2-keyword3-]
  467.  
  468. As you can see, a Picture slides may also have key words.  The key
  469. words for the Picture slide will appear in the Key words menu and will
  470. work in the same way as the key words from the Text or Quiz slide.  The
  471. index will work as well.  In the example given above, Zoom will search
  472. the current directory for a file called 'PICTURE1.PCX'.  If the file is
  473. found, and is in correct PCX format, the image will be displayed.  If
  474. the file is not found, an error message is generated.
  475.  
  476. 2.4   The Pointer Slide
  477.  
  478. The Pointer slide is the fourth category of slides, after Text, Quiz
  479. and PCX.  The Pointer slide is used as a pointer to another slide in
  480. the stack.  A Pointer slide could be used, for example, when you want
  481. to present the information from another slide in the stack, but do not
  482. want to re-type the information.  Using the Pointer slide can save a
  483. lot of disk space, especially if multiple showing of same picture slide
  484. is done.  An example of the pointer slide implementation is:
  485.  
  486. @SubSlide[Picture2-Pointer-Picture1-]
  487.  
  488. This example shows the Pointer slide, labeled Picture2, as a SubSlide. 
  489. The Pointer slide points to the slide labeled 'Picture1'.  The slide
  490. 'Picture1' will be displayed by this command along with all of
  491. Picture1's key words and attributes. 
  492.  
  493. 2.5   The Executable Slide
  494.  
  495. The Executable (EXEC) slide expands the capability of Zoom beyond
  496. simple text and picture links to the endless possibilities of linked
  497. programs.  The scope of the linked programs is determined by your
  498. imagination.  The Executable slide will temporarily exit Zoom and run
  499. any DOS command, .EXE file, .COM file, or .BAT file.  The use of this
  500. feature requires more advanced knowledge of DOS.  
  501.  
  502. The execution of DOS commands with the Exec slide is easy.  Suppose,
  503. for example, upon the selection of a slide you would like to have the
  504. files on the current directory displayed.  The Exec slide command to
  505. perform this would look as follows.
  506.  
  507. @Slide[Directory-Exec-DIR-]
  508.  
  509. 'Directory' is, of course, the slide label; 'Exec' is the type of
  510. slide; and 'DIR' is the DOS command you want to execute.  When this
  511. slide is selected, first Zoom loads a copy of the command processor,
  512. then the 'DIR' command is executed, and finally the control is returned
  513. to Zoom.  The execution of any of the other DOS commands is possible.
  514.  
  515. The execution of other computer programs (those programs contained in
  516. .EXE or .COM files) is accomplished in a similar manner to the DOS
  517. commands. The slide command for program execution is as follow.
  518.  
  519. @Slide[Programlabel-Exec-kermit.exe-]
  520.  
  521. This command will run the program 'kermit.exe' provided that
  522. 'kermit.exe' is in the directory with Zoom. It is also possible to
  523. specify a full path for program execution. 
  524.  
  525. @Slide[Programlabel-Exec-c:\util\kermit.exe-]
  526.  
  527. This example will look in the directory 'util' for the program 
  528. 'kermit.exe'.
  529.  
  530. A batch file is an ASCII file which contains a series of DOS commands
  531. and/or programs for execution.  The batch file is stored in a file with
  532. the .BAT extension.  The slide command for a batch file is similar to
  533. the  previous executable slides.
  534.  
  535. @Slide[BatchLabel-Exec-Example.BAT-]
  536.  
  537. In the previous example, Zoom expects the file 'Example.BAT' to be in
  538. the current directory.  However, like with other executable programs, a
  539. full path name can be used.
  540.  
  541. @Slide[BatchLabel-Exec-c:\bat\Example.BAT-]
  542.  
  543. In this example, Zoom will look in the directory BAT for the batch file
  544. 'Example.BAT'.  The Example.bat file may look like this:
  545.  
  546.  ECHO OFF 
  547.  DIR | MORE 
  548.  PAUSE Hit any key to return to Zoom.
  549.  
  550. This batch file is a more useful way to display the current directory
  551. since we are using the DOS program 'MORE' to view the directory one
  552. screen at a time.  Issuing the DOS command 'DIR' by itself will result
  553. in the printing of the current directory without a pause, and immediate
  554. return to Zoom at the end of the command.  The user will only get a
  555. glimpse of the directory.  With 'MORE' the user will be prompted to
  556. press a key to view the directory screen at a time.  See a DOS manual
  557. for more description on how 'MORE' works.
  558.  
  559.  
  560. 2.6  The Exit Slide
  561.  
  562. The Exit slide allows you to exit the program from a slide queue.  The
  563. command would look like this:
  564.  
  565. @Slide[FinalSlide-Exit-]
  566.  
  567. When this slide is accessed, Zoom will terminate and put you back in
  568. DOS.
  569.  
  570.  
  571. 2.7  The Goto Slide
  572.  
  573. The Goto slide allows you to jump to a branch and play out the slides
  574. of the queue.  The command looks like this:
  575.  
  576. @Slide[loop-goto-loopit-]  
  577.  
  578. When this slide is accessed, it will go and look up the index entry for
  579. "loopit" and play that queue.  Using this slide type will allow you to  
  580. build an endless-loop. An example index entry would look like this: 
  581.  
  582. Loopit-slide1-slide2-slide3-loop-      
  583.  
  584.  
  585. 3.  The Hot Area
  586.  
  587. Zoom has a unique feature that enables the administrator to define
  588. areas within the monitor screen and link the areas to key words.  Key
  589. words, as was described previously, allow a slide to be linked to other
  590. slides.  With the Hot Area, key words can be used to identify a
  591. rectangle on the screen and made available to the user.  Hot Areas show
  592. up on the screen as a rectangle made with broken lines.
  593.  
  594. For computers equipped with a mouse, the shape of the mouse cursor will
  595. change when the cursor is passed over a defined Hot Area.  This
  596. indicates to the user that the defined area is associated with a key
  597. word, and additional information is available to the user.  The process
  598. of clicking the mouse in the hot area is the same as selecting a key
  599. word from the Key words menu.  If there is no mouse, the Hot Areas can
  600. be accessed with the cursor keys, and selected with the Enter key.
  601.  
  602. Hot Areas are defined using either the text or the pixel coordinates on
  603. the screen.  This means that for the text coordinates, the largest box
  604. can be 78 columns by 21 rows (see manual section 1.3 Structure and
  605. Organization), and the smallest can be 1 column by 1 row.  For pixel
  606. coordinates, the maximum size is limited by the resolution of the type
  607. of graphics adapter used.   Hot Areas will work with Text, Quiz and PCX
  608. slides.  
  609.  
  610. Hot Areas are defined by adding screen coordinates to a key word in the
  611. slide command.  For an example: 
  612.  
  613. @Slide[MapOfEurope-PCX-England,1,1,8,8-France,7,10,15,15-]
  614.  
  615. will display a map of Western Europe, and will have two key words,
  616. England and France.  The numbers following the key words define the
  617. upper left-hand corner and lower right-hand corner coordinates of the
  618. Hot Area.  Therefore, the Hot Area for England starts at position (1,1)
  619. and ends at position (8,8).  Likewise, the Hot Area for France starts
  620. at position (7,10) and ends at position (15,15).  The key words England
  621. and France are still available under the Key words menu.  The user now
  622. has a choice of pointing to an area on the screen or using the Key
  623. words menu to find out about England and France .  
  624.  
  625. The same hot areas using pixel coordinates will look like this:
  626.  
  627. @Slide[MapOfEurope-PCX-England;1;1;80;80-France;7;10;150;150-]
  628.  
  629. Notice that the coordinate seperator is a semicolon instead of a comma. 
  630.  
  631.  
  632. The templates for slide command with Hot Areas are given as:
  633.  
  634. @Slide[Label-Type-KeyWord1,X1,Y1,X2,Y2-] for text coordinates
  635. @Slide[Label-Type-KeyWord1;X1;Y1;X2;Y2-] for pixel coordinates
  636.  
  637.  
  638. The syntax for defining the Hot Area using text coordinates requires
  639. that a comma follow the key word, and then the X1 coordinate, WITH NO
  640. SPACES, a comma, Y1, a comma, X2, a comma, Y2 and a dash ('-').  For a
  641. Hot Area using pixel coordinates, semicolons have to be substituted for
  642. the commas.  A slide can have up to ten Hot Areas.  
  643.  
  644. 4.    Making the link with the Index
  645.  
  646.  
  647. Throughout this guide, we have talked about links and linking words and
  648. areas to slides without ever mentioning just how that link is
  649. accomplished. The link is defined in the index file.  The index file
  650. (an ASCII file which is kept in the Zoom directory and named
  651. 'stackname.ind')  contains a list of key words and the slides
  652. referenced by the key words.  In fact, the index file is analogous to
  653. an index in a book.  Zoom uses the index file to look up word(s) and
  654. then brings up the slides referenced by the word(s) on the screen
  655. automatically.  The syntax for an index entry is as follows.
  656.  
  657. key word-label1-label2-label3-label4-label5-
  658.  
  659. In the example 'key word' is the key word from the slides.  The
  660. arguments, 'label1', 'label2', 'label3', etc. are the slide labels that
  661. are associated with the 'key word'.  These slides are loaded into the
  662. queue upon the selection  of 'key word' by the user, either through the
  663. Index menu command, or through the Key word menu command.  Since Zoom
  664. uses the index file and the key words to establish the links, you have
  665. to make sure that they are spelled the same way.  For example, if a
  666. slide has a key word 'T. Edison', and the index file has the entry
  667. 'T.Edison' (without the space), Zoom will not be able to match the two
  668. words.  The capitalization of the letters does not matter.  However,
  669. the spelling must be identical, including the punctuation marks and
  670. spaces in the words. 
  671.  
  672. If you wish to show an entry, but not make it available to the user as
  673. a choice, you can start the line with the characters '(' or '═' (ASCII
  674. 205) or ASCII 255 character (null character).  You can get these
  675. characters for example in WordPerfect by pressing the Alt key and
  676. entering the ASCII numbers on the numeric pad.  It will not work if you
  677. enter the numbers using the number keys above the letter keys. 
  678. However, each of these 'no-choose' lines must terminate with a dash ('-
  679. ').
  680.  
  681. There can be up to 1800 index entries.
  682.  
  683. See Appendix B for an example of an entire index file.
  684.  
  685.  
  686.                  Appendix A: Example Stack 
  687.  
  688.  
  689. The stack is stored in ASCII format.  The following example is an
  690. example  stack that contains some textual information.  Note that the
  691. '@End' command must be placed at the end of the file to mark the end. 
  692. The file is called Mid_Age.STK and it contains all the textual
  693. information.  The associated index file is called Mid_Age.IND.  When
  694. Zoom starts up, it will look at the current directory for all files
  695. with the extension .STK.  If there is more than one file with .STK
  696. extension, Zoom will display a window with the names of stacks and a
  697. short description as described by the @Summary command in the stack.  
  698.  
  699. @Language[English]
  700. @Summary[This stack is about Western European History]
  701. @Chapter[Introduction]
  702. @Slide[Intro-Text-]
  703. @bgblack[@lightCyan[Western European History: First Semester Course]]
  704.  
  705. @window[This computer program has been put together to aid your studies
  706. on the Western European History and provide an interactive supplement
  707. to your text book.]
  708.  
  709.         The material has been organized into three chapters:         
  710. @delay[2000]  Chapter 1: The Middle Ages. (600 to 1300 AD)
  711. @delay[2000]  Chapter 2: The Renaissance. (1400 to 1600 AD)
  712. @delay[2000]  Chapter 3: The Enlightenment. (1600 to 1800 AD)
  713.  
  714. This program has been put together to allow the viewing of issues such
  715. as @yellow[politics, religion, class, and gender] while transcending
  716. the causality of time and the vastness of space. 
  717.  
  718. @Chapter[The Middle Ages]
  719. @Slide[OutlineCh1-Text-]
  720.  
  721.                     Chapter 1: @lightcyan[The Middle Ages]
  722.  
  723.    In this chapter, the following issues will be presented:
  724.  
  725.                        I.   The Aristocracy         
  726.                        II.  The Church                       
  727.                        III. The Plague
  728.  
  729.  
  730. @Slide[Aristch1-Text-]
  731.  
  732. @bgmagenta[@Red[I. The Aristocracy]]
  733.  
  734.     The aristocracy of the Middle ages was comprised of a bunch of rich
  735. people, who wanted to have a heavenly justification for their begin
  736. rich and other people being poor. Thus royalty was invented. 
  737.  
  738. @Slide[ChurchCh1-Text-]
  739.  
  740. @bgmagenta[@Red[ II. The Church ]]
  741.  
  742.     During the Middle Ages in Europe, the Church held quite a monopoly
  743. on religion. You were either in the Church, or you were not. If you 
  744. were not, then you were killed as a heretic.
  745.  
  746. @SubSlide[WitchCh1-Text-]
  747.  
  748.    During the Middle Ages, people often feared witches. A witch was
  749. someone practicing black magic, possessed by the devil, or just plain
  750. weird.
  751.  
  752.    Witches, if found were burned at the stake. How do you find a witch?
  753. You take a person and throw them into the water with their hands and
  754. feet tied. If the person floats then he or she is a witch. If the
  755. person drowns, then the person was innocent. Well it was justice in the
  756. early days.
  757.  
  758. @Slide[PlagueCh1^1-Text-]
  759.  
  760. @Black[III. The Plague]
  761.  
  762.    The bubonic plague, often called the @Black[Black Plague], ravaged
  763. through  Europe, especially during the Fourteenth century. A entire
  764. third of the  continents population  died.
  765.  
  766. @Chapter[The Renaissance]
  767. @Slide[IntroCh2-Text-]
  768.  
  769.               Chapter 2: @lightCyan[The Renaissance]
  770.  
  771.                    I.   Art                   
  772.                    II.  The Reformation                   
  773.                    III. Literature
  774.  
  775.  
  776.  @Slide[ArtCh2-Text-]
  777.  
  778.     During the Renaissance the Arts flourished and monarchs invested in
  779. painting and sculpture. During this time such works as the Mona Lisa,
  780. the Sistine Chapel, etc.
  781.  
  782. @Slide[ReformCh2-Text-Hell-]
  783.  
  784.     During the Reformation, preachers such as Martin Luther, Calvin and
  785. Zwingli preached against the evils and corruption in the Catholic
  786. Church.
  787.  
  788. @Slide[LitureCh2-Text-Hell-]
  789.  
  790.    During the Renaissance, such literary works as Dante's Inferno, 
  791. Shakespeare's Hamlet, and Thomas Moore's Utopia were written. 
  792.  
  793. @Subslide[HellCh2-Text-]
  794.  
  795.      The Count Malatesta of Rimini is the only person ever to be
  796. publically condemned to Hell by the pope.
  797.  
  798. @Chapter[The Enlightenment]
  799. @Slide[IntroCh3-Text-]
  800.  
  801.              Chapter 3: @LightCyan[The Enlightenment]
  802.  
  803.                      I.   Mathematics
  804.                      II.  Science
  805.                      III. Literature
  806.  
  807.  
  808. @Slide[MathCh3-Text-]
  809.  
  810.     During the Enlightenment Newton in England and Liebinez in Germany
  811. simultaneously invented calculus. Newton's form of calculus was based 
  812. on geometry while Liebinez's description of calculus was based on
  813. symbolic formulas.
  814.  
  815. @Slide[ScienceCh3-Text-]
  816.  
  817.     During the Enlightenment, Astronomy advanced to the point where is
  818. was discovered that the earth orbits the sun with an elliptical path.
  819.  
  820. @Slide[LitureCh3-Text-]
  821.  
  822.    Literature during the enlightenment flourished as well. 
  823.  
  824. @End
  825.  
  826.  
  827.  
  828.                  Appendix B: Example of Index File.
  829.  
  830. This is the content of the MID_AGE.IND file which is the index file for
  831. the MID_AGE.STK stack.  The information is stored as ASCII text.
  832.  
  833.  
  834. Black Plague-PlagueCh1- 
  835. Bubonic^Part1-PlagueCh1^1-      (Only Bubonic will be displayed to the user,
  836. Church-ChurchCh1-ReformCh2-     but Zoom will use the entire label)
  837. Class-AristCh1- 
  838. Dante-LitureCh2- 
  839. Hell-HellCh2- 
  840. Justice-WitchCh1- 
  841. Literature-LitureCh2-LitureCh3- 
  842. Mathematics-MathCh3- 
  843. Middle Ages-OutlineCh1- 
  844. Plague-PlagueCh1- 
  845. Politics-AristCh1- 
  846. Religion-ChurchCh1-ReformCh2- 
  847. Shakespeare-LitureCh2- 
  848. Witch-WitchCh1-
  849.  
  850.  
  851.                     Appendix C:  Command Summary
  852.  
  853.                         Command Line Switches
  854.  
  855. -f  <file>      The stack <file> is automatically loaded
  856. -r      ZOOM skips the main menu and jumps to the viewing menu
  857. -ch#    ZOOM skips the main menu and jumps to chapter number #
  858. -l <Language>   <Language> is used for interaction.  Overrides the
  859.                 command in the stack
  860. -bw     For use with black and white monitors or laptops computers
  861.  
  862.                            Stack Commands
  863.  
  864. @Summary        The stack description as displayed by Load Stack
  865.                 command, optional
  866. @Language       Language used for interaction.  English, French,
  867.                 Spanish or Portuguese, optional.  Default is English
  868. @Chapter        Marks the beginning of a new chapter in the stack
  869. @Slide  Marks the placement of a slide
  870. @SubSlide       Marks the placement of a subslide
  871. @End    Marks the end of a stack
  872.  
  873.                              Slide Types
  874.  
  875. Text    Slide made up of characters, numbers, lines, etc
  876. PCX     Graphic image slide for Bit-mapped images
  877. Quiz    Quiz slide for asking questions
  878. Dbf     Reads dBASEIII+ compatible file and displays the content
  879. Wks     Reads Lotus 123 compatible file and displays the content
  880. Exec    Executes a DOS command
  881. Pointer Displays the content of another slide
  882. Loop    Jumps back to another slide in the loop
  883. Exit    Exits Zoom upon access of this slide type
  884.  
  885.                          Other Stack Command
  886.  
  887. @Window Displays text inside a window over a slide
  888. @Timer[n]       automatically advances to the next slide in the queue
  889.                 after n seconds
  890.  
  891.                          Text Slide Commands
  892.  
  893. @Color  Command to display the text in chosen color, ie @Yellow[]
  894. @BgColor        Command to change the background color of the text, ie
  895. @bgblack[] @Delay[n]    Puts a pause in the text of n/1000 seconds
  896.  
  897.  
  898.  
  899.                                The End
  900.