home *** CD-ROM | disk | FTP | other *** search
/ AMOS PD CD / amospdcd.iso / 351-375 / apd372 / slideshow / documentation / ssm.doc < prev   
Encoding:
Text File  |  1991-12-31  |  21.5 KB  |  463 lines

  1. =========================================================================
  2. *************************************************************************
  3. *                                                                       *
  4. *                  S L I D E   S H O W   M A N A G E R                  *
  5. *                              Version 1.2                              *
  6. *                                                                       *
  7. *                       Created by Norman C. Borg                       *
  8. *                              Using  AMOS                              *
  9. *                                                                       *
  10. *                  Copyright  ©  Norcomm Software 1992                  *
  11. *                                                                       *
  12. *************************************************************************
  13. =========================================================================
  14.  
  15.     Slide Show Manager (SSM) has a number of features which take it beyond
  16. the standard slide show viewer which simply displays IFF pictures in a
  17. regular sequence.  Thanks to its VCR-style panel at the bottom of the
  18. screen, the user can 'navigate' through the series of pictures available.
  19.  
  20.  
  21. THE DEMO DISK
  22. ~~~~~~~~~~~~~
  23.     To have an idea of what is SSM just boot the disk and the demo will
  24. automatically load.  Use the Control Panel at the bottom of the screen
  25. to navigate around the Album, from one slide to the next, and read
  26. carefully the information presented in the slides.  There's no better
  27. introduction to the program than that.  Click on the seventh button from
  28. the left (the one with a single arrow pointing to the right) to load the
  29. next slide.  As you go along the Demo itself will explain more about 
  30. 'navigating' through the Album.  Have fun!
  31.  
  32.  
  33. THE CONCEPT BEHIND SSM
  34. ~~~~~~~~~~~~~~~~~~~~~~
  35.     The concept behind SSM is actually very simple.  The pictures, or
  36. slides, are accessed from the disk one at a time, but not necessarily in a
  37. sequential order, and can be kept on screen for as much as needed.  The
  38. trick for complete control over the slide Album is a user interface with
  39. enough features for the viewer to access the slides with ease.  This is
  40. SSM.  Thanks to a "Driver" file, SSM can be applied to any Album of
  41. slides, and the Album is completely controlled by the viewer through its
  42. user interface: the Control Panel.
  43.  
  44.  
  45. THE CONTROL PANEL
  46. ~~~~~~~~~~~~~~~~~
  47.     There are a number of buttons on this panel all with distinctive
  48. features which enable the user to go forward or backward through the
  49. Album of slides, to jump from one part of the Album to another and to view
  50. the slides at one's own leisure.  The buttons should be indicative enough
  51. as to their functions, but here are some notes on the more important ones.
  52.  
  53.     The Control Panel is divided into two 'levels'.  On the upper level
  54. are two windows; a small one on the left and a larger one on the right. 
  55. The small window automatically displays the number of the slide currently
  56. on screen, out of the maximum number in the Album: "1/13", for instance,
  57. means Slide "1" out of an Album of 13.  SSM will display this information
  58. automatically when the slide is loaded.  The larger window will display
  59. the title of the Album, or the current slide in particular.  This is
  60. optional, and its contents will depend on the way the user disposes of it.
  61.  
  62.     The lower 'level' of the Control Panel includes all the functions
  63. available.  From left to right, they are:
  64.  
  65.     JUMP TO FIRST SLIDE IN ALBUM
  66.     REWIND (Rew)
  67.     GOTO PREVIOUS SLIDE
  68.     STOP (during Rew or FF only)
  69.     GOTO FUNCTION Button
  70.     PAUSE (during Rew and FF only)
  71.     GOTO NEXT SLIDE
  72.     FORWARD (FF)
  73.     JUMP TO LAST SLIDE IN ALBUM
  74.     Buttons for digits 1 through 0
  75.     OKAY Button
  76.     GOTO FUNCTION Display Screen
  77.     SWITCH OFF Album (exit)
  78.  
  79.     Most of the buttons as described above speak for themselves.
  80.  
  81.     Clicking with the Left Mouse Button will enable the required function.
  82. Be patient and wait for some seconds before anything happens.  As soon
  83. as a function is called, the computer will take some time to load the
  84. slide from disk: unless, of course, one is using a hard drive.  On
  85. clicking a particular function, its button will light red.  This is an
  86. indication that the instruction has been recognized and that the function
  87. is in operation.  If the button does not light up, this may be because the
  88. function called will at the moment be inoperative.
  89.  
  90.     For instance, should you click on REWIND while Slide "1" is on screen,
  91. SSM will know that there is no other slide to load: the button will not
  92. light up and the function will not be called.
  93.  
  94.     Note that while on Standby Mode (when no function is being called and
  95. you are just idly looking at the slide) calling STOP or PAUSE will have no
  96. effect.  These two functions work only in conjunction with REWIND and
  97. FORWARD.
  98.  
  99.     REWIND will skim through all the slides from the one currently on
  100. screen back to the first in the ALBUM.  FORWARD will skim through all the
  101. slides from the current one to the last.  While these functions are in
  102. operation, they can either be STOPped or PAUSEd.  In either case, keep
  103. holding the mouse button down until either of the STOP or PAUSE buttons
  104. lights up.  This is because the computer will not immediately recognize
  105. the instruction while accessing the disk.
  106.  
  107.     The STOP button will definitely stop the REWIND or FORWARD functions. 
  108. In this case all related buttons will switch off.  The PAUSE button will
  109. only hold the REWIND or FORWARD instructions for as long as you wish, but
  110. these can then be continued.  For instance, if you click on REWIND and
  111. PAUSE, both buttons will be lit.  If you click now on any other button but
  112. PAUSE, nothing will happen.  To continue the function, click on the PAUSE
  113. button.  It will switch off and the REWIND function will continue.
  114.  
  115.  
  116. THE GOTO FUNCTION
  117. ~~~~~~~~~~~~~~~~~
  118.     The GOTO Function is probably the most powerful feature of SSM.  It
  119. enables the user to jump to any desired slide in the sequence (forwards or
  120. backwards) without having to skim through the entire Album.  Clicking on
  121. the GOTO Button (the fifth from the left) will switch the function on. 
  122. Nothing will happen at this point, but the GOTO Button will light up
  123. indicating that it is waiting for instructions.  Use the digit buttons to
  124. enter the figures of the slide number.  As soon as this is done, the
  125. figures will appear on the GOTO FUNCTION Display Screen.  When you are
  126. ready, click on the OKAY Button.  The required slide will soon appear on
  127. the screen.  If an illegal number is entered (below 0 or beyond the
  128. maximum number of the slide Album) it is ignored and nothing happens.
  129.  
  130.  
  131. THE INDEX PAGE
  132. ~~~~~~~~~~~~~~
  133.     An Index page can be included in the Album containing information on
  134. each slide available.  The page is an IFF picture in itself, but it is not
  135. considered as one of the Album slides.  It can only be accessed by simply
  136. entering "0" in the GOTO FUNCTION.  Although this page is optional, it is
  137. suggested you make good use of it, especially in an Album which contains
  138. quite a number of slides.  It is after all indispensable if one wants to
  139. exploit the GOTO FUNCTION at its fullest.
  140.  
  141.  
  142. CUSTOMIZED SLIDE SHOWS
  143. ~~~~~~~~~~~~~~~~~~~~~~
  144.     Of course it is easy to include your own favourite slides into SSM, as
  145. long as the following points are kept in consideration:
  146.  
  147.     (a)  The pictures must strictly be in IFF format (I use DPaint III
  148. pictures, for instance).
  149.     
  150.     (b)  The pictures must be in Med-res mode, 8 or 16 colours.  (Sorry for
  151. this limitation: I intend to widen the range of screens in a later version
  152. of SSM).
  153.     
  154.     (c)  Each picture must have the Control Panel displayed at the
  155. bottom, and must be saved to disk with a number as a name: "0", "1",
  156. "2", etc.
  157.  
  158.     You can delete the slides of the Demo from the disk and put your own
  159. slides (I suggest you make a backup first).  The number of slides included
  160. is only limited by the disk/s capacity (8-Colour screens take less memory,
  161. of course: therefore more can fit on 1 disk).  To include your own
  162. pictures and have SSM running smoothly, some operations have to be carried
  163. out on your pictures first.  Simply replacing the IFF files on disk is not
  164. enough.
  165.  
  166.     First of all the files on disk are not given any alphabetical names,
  167. but numbers; from "0" (the Index) up to "99" if possible.  Make it a point
  168. to check that there are no spaces in front of, behind or between the
  169. digits.
  170.  
  171.     The Control Panel at the bottom of the slide is actually part of the
  172. IFF file itself, and is not superimposed by SSM.  This means that in order
  173. to have the Control Panel and all its features, you must first stamp down
  174. the Control Panel on your own picture while using DPaint.  Otherwise, if
  175. you put your own pictures in SSM , you will only load the picture, but no
  176. panel will appear!  Don't panic.  In the Drawer marked "tools" on the disk
  177. you can find a file called "ALBUMtemplate".  This is an IFF picture of the
  178. Control Panel with an otherwise blank screen.  All you have to do is stamp
  179. this down on your own picture.
  180.  
  181.     The whole operation is easy to run, provided you do have a copy of
  182. DPaint (but I don't believe there's any Amiga user who doesn't!).  Follow
  183. the instructions below:
  184.  
  185.     (1)  Load "ALBUMtemplate" into DPaint.
  186.  
  187.     (2)  From the "Pictures" Menu select "Copy to Spare" in the "Spare"
  188.          submenu.
  189.  
  190.     (3)  Load your own picture (it MUST be med-res, 8- or 16-colour!)
  191.  
  192.     (4)  Again from the "Pictures" menu, go to the "Spare" submenu and
  193.          select "Merge to front".
  194.  
  195.     (5)  With DPaint text function write whatever you like in the Control
  196.          Panel's title window, on the top right-hand side.  If you wish
  197.          you might as well leave it blank.
  198.  
  199.     (6)  Now save your picture back onto the disk.  Remember, use only
  200.          numerical figures from 0 to 9 to name the file.
  201.  
  202.     This has to be done to ALL the slides in the Album, including Slide
  203. "0".  Your slides should now have their own Control Panel neatly placed at
  204. the bottom.  This will naturally trim away the bottom part of your own
  205. picture, but the Control Panel will cover only a very small area.
  206.  
  207.     Note that if the picture's palette is not exactly like the original
  208. palette of "ALBUMtemplate", the Control Panel will now have different
  209. colours, according to your own picture's palette.  If you wish to keep the
  210. Control Panel's original colours you can always load your picture first
  211. and copy it to the Spare page and then load "ALBUMtemplate" as the main
  212. picture before merging; but then of course, your own picture's colours
  213. will change drastically, then.
  214.  
  215.     A hint on saving disk space: DPaint files are generally automatically
  216. iconized.  Icons in this case are unnecessary, so select the "No Icons"
  217. function in the "Prefs" menu in DPaint before resaving any pictures.
  218.  
  219.  
  220. THE "TOOLS" DRAWER
  221. ~~~~~~~~~~~~~~~~~~
  222.     
  223.     The "Driver" File
  224.     *****************
  225.     You may have noticed that the "Tools" Drawer contains more than just
  226. the "ALBUMtemplate".  The most important item here is the
  227. "SSM-DriverCreator" program, which enables SSM to manipulate any
  228. customized slide Album.
  229.  
  230.     In short, in order to function properly SSM will want to know how many
  231. slides are in the Album and in which device or devices are they stored. 
  232. SSM collects this information from a sequential files called "Driver".  At
  233. the moment, the information in "Driver" concerns the demonstration slide
  234. Album, and is telling SSM that the Album has 13 slides accessible from
  235. device "df0:".  If you want to change this information (you MUST if your
  236. Album will contain more or less than 13 slides), run the AMOS program
  237. "SSM-DriverCreator".  Simply follow the prompts, and the new information
  238. will soon be written to "Driver", over-writing the previous data.
  239.  
  240.     Note that "SSM-DriverCreator" will automatically take "df0:" as the
  241. current drive where to store "Driver", so make sure to have the Album disk
  242. in device "df0:" before running the program.
  243.  
  244.     Note also that the Index page (Slide "0") is taken for granted by SSM,
  245. so on the Creator's prompt to enter the number of slides, do not include
  246. the Index page.  If, for example, your Album is made up of 24 slides and
  247. an Index page, type in "24", and not "25".  Since the index is considered
  248. as Slide "0", it is automatically included in the Album.
  249.  
  250.     SSM can access pictures either from a hard drive (dh0:) or from as
  251. much as three floppy drives (df0:, df1: and df2:).  You may have an Album
  252. of slides distributed across three disks.  By putting the bootable disk
  253. (including SSM and "Driver") in df0: and the two other disks in the
  254. external drives, SSM will happily access any slide from any drive without
  255. any fuss.
  256.  
  257.     For this to happen SSM will have to know how many of the slides are in
  258. which drive.  This explains why the SSM-DriverCreator program will ask for
  259. the number of the last slide in each of the drives.  Make sure you enter
  260. the necessary information here correctly, or there will certainly be
  261. trouble during the Slide Show session.
  262.  
  263.     Palettes
  264.     ********
  265.     Some extra IFF files included in the "Tools" Drawer which have no
  266. direct relevance to SSM but which can be useful as tips for budding artists
  267. are the PALETTE screens.
  268.  
  269.     In an 8-Colour screen, 28 additional tints can be created in addition
  270. to the eight basic colours (totalling 36 colours).  This is achieved by
  271. mixing one colour with all the rest of the palette.  Using a brush two
  272. pixels high by two pixels wide with two colours in a chequered fashion, an
  273. area can be filled in with any of the proposed tints.  In a 16-Colour
  274. screen, there can be up to 136 colours.  It is a way of having a  greater
  275. number of colours while using less memory.  Load the Palette screens into
  276. DPaint, use the Zoom tool to observe the patterns and note the extra
  277. number of tints which can be achieved with only eight colours.  This trick
  278. of course is much more effective in Med-res than in Low-res.
  279.  
  280.     All the slides in the Demo Album are actually 8-Colour files, but you
  281. can note, especially in Slides "5" and "6", how much effective this
  282. "blending of colours" can be.  In short, with a basic 8-Colour screen you
  283. can access around 36 different hues; but this will occupy just the space
  284. of an 8-colour file on disk.
  285.  
  286.  
  287. MORE HINTS ON SAVING DISK SPACE
  288. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  289.  
  290.     Deleting Files
  291.     **************
  292.     The best way of having your own bootable Album is by copying the Demo
  293. disk and replacing the slides with your own.  But once this is done, a
  294. number of files and drawers can be deleted from your own Album disk.  The
  295. "Tools" Drawer, for instance, can be completely deleted.  Also delete any
  296. Trashcan drawer and files with ".info" at the end.  These are useless for
  297. SSM, and the disk space can be used for more slides.
  298.  
  299.     Compacting Screens
  300.     ******************
  301.     If you own AMOS you may know that IFF screens saved from AMOS are
  302. compacted and take slightly less disk space.  I found little difference
  303. when trying it our, but if you wish to include as much slides as possible
  304. into one disk, compacting them could help.  The "Compacter" program in the
  305. "Tools" Drawer does just that.  Run the program, type in the number of the
  306. first slide and the number of the last slide in the disk, sit down and let 
  307. Compacter do the rest.  It will load all slides (starting from Slide "0") 
  308. one by one and will resave them in a compacted form.
  309.  
  310.  
  311. STEP BY STEP GUIDE TO CREATING AN ALBUM
  312. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  313.  
  314.     We have already discussed the method of putting together a customized
  315. Album, but here is a resumé of the more salient points to use as a quick
  316. reference:
  317.  
  318.     (1) Make a copy of the Demo Disk and place the original safely away.
  319.     Two or three copies, in fact are better than one, just in case!
  320.  
  321.     (2) Delete from your copy unnecessary files and drawers in order to
  322.     make more disk space for your slides.  Suggested drawers to delete 
  323.     are the "Tools" drawer and the "Documentation" drawer.  Delete 
  324.     also all files which have ".info" at the end.
  325.  
  326.     (3) Run DPaint and switch on the "No Icon" function in the "Prefs" 
  327.     menu.  This will make sure no unnecessary ".info" files are saved 
  328.     when you resave your slides.
  329.  
  330.     (4) Load the "ALBUMtemplate" picture and copy it to the Spare page.
  331.  
  332.     (5) Load your own picture, and Merge-to-Front the Spare page.  If you 
  333.     do everything correctly, the Control Panel should now be 
  334.     superimposed at the bottom of your own picture.  Don't mingle with 
  335.     the colour palette of the "ALBUMtemplate" screen before you merge 
  336.     it.  The colour white in "ALBUMtemplate" is considered as the 
  337.     transparent colour.  You must leave it as it is, or else, when 
  338.     you merge the two pictures, "ALBUMtemplate" will completely cover 
  339.     the other picture!
  340.  
  341.     (6) Check again that the "No Icons" function is on.  Resave your 
  342.     picture into the Album disk.  Remember to give a NUMBER as a name.
  343.  
  344.     (7) DO make an Index page of your own on the disk.  If you don't 
  345.     over-write Slide "0" with your own, your Album will load the Demo 
  346.     Index instead.
  347.  
  348.     (8) Leave everything else on the disk as it is.  There is no need 
  349.     change the startup-sequence.  Install the disk if it fails to boot, 
  350.     but apart from that, there should be no other problems.
  351.  
  352.     (9) Run the Compacter program to compact your slides should you wish to 
  353.     save some more space on your disk.
  354.  
  355.    (10) Run the SSM-DriverCreator and give precise information on the way 
  356.     your Album is set up: how many and which devices are to be used, 
  357.     and how many slides are there in how many disks.  Leave your Album 
  358.     disk in drive "df0:" during this session, and SSM-DriverCreator will
  359.     automatically update the Driver available in the disk.
  360.  
  361.  
  362. APPLICATIONS AND FURTHER SUGGESTIONS
  363. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  364.  
  365.     When I originally created SSM my intention was to have a facility to 
  366. access IFF pictures easily from disk.  Actually in time I realized SSM 
  367. could be used for other applications as well, apart from being simply a 
  368. slide viewer.
  369.  
  370.     Educational Programs
  371.     ********************
  372.     With the help of the text functions of DPaint, your IFF pictures can 
  373. include quite a deal of text as well.  Of course there is nothing in 
  374. DPaint of the usual wordprocessing facilities, but text can easily be 
  375. typed in and then manipulated as a brush.  The Demo Album, in fact, 
  376. includes more text than actual graphics.  Educational programs are 
  377. therefore natural in this case, including charts, notes and drawings on 
  378. particular topics.  In this way SSM can create simple-to-use reference 
  379. Albums which are easily accessible to children.
  380.  
  381.     Simple Databases
  382.     ****************
  383.     SSM Albums can be used as rudimentary card systems.  The Index page 
  384. can help as a reference to the contents of the cards.  The best use I 
  385. have found for SSM in this case is an Album of Clip Art brushes.  Each 
  386. slide includes a number of Clip Art graphics.  The Title Screen on the 
  387. Control Panel serves to indicate the Disk and drawers where the graphics 
  388. can be found, and in the Index page the graphics are grouped according 
  389. to subjects or topics.  Going through them by means of the GOTO Function 
  390. is very easy, and the Album will serve as a quick reference to the 
  391. hundreds of Clip Art graphics one could have spread about in countless 
  392. disks.
  393.  
  394.     Branching the Index
  395.     *******************
  396.     If there are too many slides in the Album to be all listed in a 
  397. single slide, other slides in the Album can be used as sub-indexes apart 
  398. from the main Index which is Slide "0".  Slide "0" can then be used to 
  399. refer to these sub-indexes.  If, for instance, you are creating an Album 
  400. on "Mammals", and wish to divide it into sections such as "Land Mammals", 
  401. "Sea Mammals" and "Air Mammals", each section can have its own sub-index 
  402. which will be accessed through the main Index.
  403.  
  404.     Considering these ideas it is actually up to the user's imagination 
  405. how to go about using SSM.  I am sure other users will have more ideas 
  406. for using SSM which I have not yet considered.
  407.  
  408.  
  409. CREDITS
  410. ~~~~~~~
  411.  
  412.     This program was mainly created using AMOS The Games Creator, by 
  413. François Lionet and DPaint III, by Dan Silva.  They are both excellent 
  414. programs which have in their own right helped me to access the full 
  415. potential of the Amiga: something which would have otherwise been much 
  416. more difficult if not impossible.
  417.  
  418.  
  419. PROGRAM HISTORY AND FUTURE ENHANCEMENTS
  420. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  421.  
  422.     This present version, Version 1.2, actually has little changes from 
  423. Version 1.1.  The most notable difference is the position of the Control 
  424. Panel itself, which in the previous version tended to hide a slightly 
  425. larger area of the screen.  It has also some enhancements on the overall 
  426. functions of the Control Panel, making it more reliable.
  427.  
  428.     My intention is to prepare other versions of the "ALBUMtemplate" to 
  429. work with Low-res and Hi-res screens.  Not having a hard disk drive myself 
  430. I was unable to test the program on one, so I cannot say whether it 
  431. actually works on a hard disk as it should.
  432.  
  433.     In this version the "Driver" file only recognizes the official device 
  434. names of the internal and external drives (that is, "df0:", "df1:" and 
  435. "df2:").  I intend to change this so that the "Driver" program and SSM 
  436. itself will be able to recognize particular disk names.  In this way 
  437. SSM will not be limited to the number of devices connected, and an Album 
  438. could thus be distributed across more than the present maximum of three 
  439. disks.
  440.  
  441. ============================================================================
  442. ****************************************************************************
  443.  
  444. Document completed: 31st December 1991
  445.  
  446. Norman C. Borg
  447. Mayfair Flat 1,
  448. Upper St. Albert Street,
  449. Gzira GZR 04
  450. MALTA
  451. EUROPE
  452.  
  453. ============================================================================
  454. ****************************************************************************
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.