home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_01 / SOL3_8_C.LZH / SPOFLT38.CRK / README / SPOFLT38.DOC < prev    next >
Text File  |  1995-04-16  |  70KB  |  1,507 lines

  1.  __________
  2. |          |                                               __
  3. |   _______|                                              |  |
  4. |  |                                                      |  |
  5. |  |_______    _______      _______      _______      ____|  |
  6. |          |  |       \    /       \    /       \    /       |
  7. |_______   |  |   __   |  |  _____  |  |  _____  |  |   __   |
  8.         |  |  |  |  \  |  |         |  |         |  |  /  |  |
  9.         |  |  |  |  |  |  |  ______/   |  ______/   |  |  |  |
  10.  _______|  |  |  |__/  |  |  \_____    |  \_____    |  \__|  |
  11. |          |  |        |  |        |   |        |   |        |
  12. |__________|  |   ____/    \_______|    \_______|    \_______|
  13.               |  |
  14.               |  |    _____   _____
  15.  __           |__|   |  _  | | ____|
  16. |  |                 | | | | | ___|
  17. |  |                 | |_| | | |
  18. |  |                 |_____| |_|
  19. |  |                        __               __
  20. |  |                       |  |             |  |
  21. |  |    __                 |  |             |  |
  22. |  |   |__|      ______    |  |_____     ___|  |___
  23. |  |    __      /      \   |        \   |          |
  24. |  |   |  |    |   __   |  |   ___   |  |___    ___|     _____        _____
  25. |  |   |  |    |  /  |  |  |  |   |  |      |  |        |____ |      |  _  |
  26. |  |   |__|    |  |  |  |  |  |   |  |      |  |          __| |      | |_| |
  27. |  |________   |  \__|  |  |  |   |  |      |  |___      |__  |  __  |  _  |
  28. |           |  |        |  |  |   |  |      |      |     ___| | |  | | |_| |
  29. |___________|   \____   |  |__|   |__|       \_____|    |_____| |__| |_____|
  30.                      |  |
  31.  ____________________|  |
  32. |                       |
  33. |______________________/
  34.  
  35.  
  36. This document and all included documents are
  37. (C) Copyright 1993-1995, Stuart Denman
  38. All Rights Reserved.
  39.  
  40. This document may only be reproduced for personal use.
  41.  
  42. All coding and design by Stuart Denman.
  43. Internet: sdenman@cs.washington.edu
  44.           (Valid through summer 1996)
  45.           
  46. Released April 16, 1995
  47.  
  48. Speed of Light is a comprehensive image processor/viewer with many
  49. advanced and highly configurable features.
  50.  
  51. Speed of Light is SHAREWARE!
  52.                   SHAREWARE!
  53.                   SHAREWARE!
  54.              This SHAREWARE! version is an incomplete demonstration 
  55. version until you register and receive a keycode to gain access to 
  56. the disabled features.  See the registration section for complete 
  57. information on how to register.
  58.  
  59. *******
  60. NOTE: If you have already read the manual for version 3.1, you need 
  61. not read this whole manual again.  Simply read the CHANGES.DOC file, 
  62. as well as the new (or changed) sections in this manual marked with 
  63. an (*) or (**) below.
  64.  
  65. Please take a look at the file SOL_AEO1.DOC which is an article I
  66. did for Atari Explorer Online about how to get the most out of
  67. Speed of Light.  Check it out!
  68.  
  69. I have included a file called GLOSSARY.DOC which defines some of the 
  70. more complicated image processing terms used throughout this manual. 
  71. So if there are any words that you don't understand, chances are 
  72. that it is in the glossary.
  73. *******
  74.  
  75. This manual is a semi-brief introduction to the features of Speed of 
  76. Light version 3.8.  Unfortunately, I do not have enough time to 
  77. completely discuss the features in as much detail as they should be, 
  78. so the best way to learn them is by playing with them.  PLAY, PLAY, 
  79. PLAY!  Also, I have not discussed items which are redundant or
  80. obvious (like some of the items on the display-screen popup menu).
  81.  
  82. This manual is organized into the sections, so even if you do not 
  83. feel like reading the whole manual, at least keep in mind what the 
  84. different sections are so if you have trouble figuring something out 
  85. (and I know you will) you can find your way to the section you need 
  86. quickly.  I recommend printing this whole thing out and following 
  87. along with the program.
  88.  
  89. The manual is organized into the following sections (in order): 
  90.  
  91. >> WHAT IS SPEED OF LIGHT?
  92. >> HOW TO REGISTER (**)
  93. >> LEGAL STUFF/DISCLAIMERS (**)
  94. >> RUNNING THE PROGRAM AND IMAGE LOADING
  95. >> IMAGE FORMATS (**)
  96. >> DIALOG BOX TRICKS
  97. >> THE DISPLAY SCREEN
  98. >> THE OPTIONS DIALOG (**)
  99. >> THE HISTOGRAM EDITOR
  100. >> THE COLOR EDITOR (*)
  101. >> SAVING IMAGES
  102. >> THE DISPLAY SCREEN POPUP MENU (*)
  103. >> FILTERED IMAGE SCALING (*)
  104. >> IMAGE WARPING (*)
  105. >> DITHERING
  106. >> PREFERENCES (**)
  107. >> COLORS TO PLAY WITH
  108. >> GRAPHICS CARDS
  109. >> KNOWN BUGS
  110. >> FINAL REMARKS
  111.  
  112. (*) Indicates that a significant amount of new information was added 
  113. as of version 3.5.
  114. (**) Indicates that a significant amount of new information was added 
  115. as of version 3.7.
  116.  
  117.  
  118. ---------------------------------------------
  119. ---===>>>  WHAT IS SPEED OF LIGHT?  <<<===---
  120. ---------------------------------------------
  121.  
  122. Speed of Light started as a GIF viewer with a twist.  It could
  123. display more colors and shades on a standard ST than usual.  It was
  124. also the FASTEST GIF decompressor on the ST, written in pure
  125. assembly language.  NOW, Speed of Light is still the fastest GIF
  126. viewer, but also the fastest JPEG viewer (for machines without a DSP
  127. chip).  Version 3.8 contains all the features of version 2.x, but
  128. also adds more image formats, more image processing features, and
  129. many other impressive tools, including the most extensive color map
  130. editing capabilities available on Atari systems.
  131.  
  132. As of version 3.5, SOL includes two new capabilities fully available 
  133. only to registered users: Filtered Image Scaling (FIS) and Image 
  134. Warping. FIS allows images to be scaled to any size, yet retain their 
  135. clarity.  It can also be used to blur images, smooth out blocky zoomed 
  136. images, and take into account lost pixels due to reduction. Version 
  137. 3.5 includes 8 new filters for some unusual effects including 
  138. sharpening and "3D Pixel" effects.  It is probably the most advanced 
  139. tool the program has to offer.  Image warping allows you to shift and 
  140. bulge your image in a variety of ways.  You can stretch one part of 
  141. your image, or repeatedly warp the whole image. A variety of waveforms 
  142. can be used for the warping effect.
  143.  
  144. Speed of Light (here on referred to by SOL) has been tested on all 
  145. Atari computers and works on ST,MEGA,STE,TT, and Falcon computers. SOL 
  146. 3.8 now runs in all resolutions of 256 colors or less, including 
  147. MONOCHROME (2 color) and medium (4 color) resolutions!  It also runs 
  148. under MultiTOS, and allows switching from image to desktop in a flash.
  149.  
  150. Several people have asked why SOL does not fully use GEM.  The main 
  151. reason is speed.  I draw directly into screen memory for speed. This 
  152. causes SOL to be very device-dependent, but it is a trade-off that 
  153. myself and other users are willing to put up with.  Believe it or 
  154. not, all of SOL's dialog boxes and menus are 100% GEM.  If I used 
  155. the standard "desktop" look instead of my custom colors to create 
  156. SOL's unique dialog boxes, it would be a lot different.  It's just 
  157. too hard, at this point, to convert all the dialogs to plain GEM.
  158.  
  159.  
  160.  
  161. -------------------------------------
  162. ---===>>>  HOW TO REGISTER  <<<===---
  163. -------------------------------------
  164.  
  165. When you register for SOL 3.8, you will receive a keycode that will 
  166. allow you to access the disabled features.  Filtered Scaling and
  167. Warping will also display without blank lines.  Your Shareware
  168. donation will help support my Shareware efforts so that I may bring
  169. you more quality Atari software like SOL.  Once you type your
  170. keycode into the registration dialog box, this copy of SOL becomes
  171. your personal registered copy, and your keycode will work with any
  172. versions released after 3.8.  The keycode will also make it so that
  173. the SOL title/information dialog and registration box will not come
  174. up when you run the program.
  175.  
  176. To register, fill in the registration dialog box with the required 
  177. information, and click on "Print EZform" to print the information 
  178. and EZform registration letter.  You will be asked whether you want 
  179. to print a filled out form to the printer or to a disk file called 
  180. REGISTER.TXT in ASCII format.  A blank form is also included in the 
  181. file REGIFORM.TXT.  Send an EZform (with all the information 
  182. required in the registration dialog box) and AT LEAST $25 United 
  183. States funds (see below for foreign registrations) to this address:
  184.  
  185. Stuart Denman
  186. 1751 N.E. NAOMI PL.
  187. SEATTLE, WA 98115    <<==-- This was wrong in SPOFLT35.DOC!
  188. U.S.A.
  189.  
  190. Make checks or money-orders payable to Stuart Denman, or send CASH. 
  191. Please allow at MOST one month for a response (especially during the 
  192. summer) before you try to contact me again.  PLEASE SEND YOUR E-MAIL 
  193. ADDRESS IF YOU HAVE ONE.  If using E-mail, you will get your keycode 
  194. within one week (of when I received it), sometimes the day I receive 
  195. your letter (for cash shareware donations).  I do sometimes go on 
  196. vacation, so please be patient with me, especially during the 
  197. summer, thanks!
  198.  
  199.  
  200. ***** FOREIGN ORDERS READ BELOW *****
  201.  
  202. If you are registering from a country other than the United States, 
  203. you have two choices on how to register.  You may either send your 
  204. registration money and form to me, or send it to a designated foreign 
  205. registration site.
  206.  
  207.  
  208. IF REGISTERING IN EUROPE:
  209. -------------------------
  210. (This is the preferred way, if you are in Europe).
  211.  
  212. Denesh Bhabuta will be handling registrations for Speed of Light in 
  213. Europe.  He will accept UK cheques or cash, Euro-cheques, and Postal 
  214. Orders.  Eventually, he may accept credit cards (you should contact 
  215. Denesh about this).  The registration is 20 pounds UK.
  216.  
  217. Make cheques (20 pounds UK) payable to "Denesh Bhabuta" and send along 
  218. with your completed registration form to:
  219.  
  220. CyberSTrider
  221. 203 PARR LANE
  222. UNSWORTH
  223. BURY
  224. LANCASHIRE
  225. BL9 8JW
  226. UNITED KINGDOM
  227.  
  228. If you have questions about registering with Denesh, he can be reached
  229. at the above address or by e-mail:
  230.  
  231.     dbhabuta@cix.compulink.co.uk
  232.     danny@micros.hensa.ac.uk
  233.  
  234.  
  235. IF REGISTERING FROM OTHER NON-U.S. COUNTRIES:
  236. ---------------------------------------------
  237. Send your registration payment and form to me (Stuart Denman) in the 
  238. United States.  Foreign orders must send AT LEAST $25 U.S. CASH or 
  239. money order, or you can send the EQUIVALENT of AT LEAST $30 U.S. MONEY 
  240. IN CASH NOTES OF YOUR FOREIGN CURRENCY.  NO UNSTABLE CURRENCIES, only 
  241. things like Deutch-Marks, UK Pounds, and other stable currencies that 
  242. I can easily exchange with small fees.  If you are in Europe, please 
  243. register using the prodedure above.
  244.  
  245.  
  246. ***** FOREIGN ORDERS READ ABOVE *****
  247.  
  248.  
  249.  
  250. ---------------------------------------------
  251. ---===>>>  LEGAL STUFF/DISCLAIMERS  <<<===---
  252. ---------------------------------------------
  253.  
  254. Use of this program is restricted to 30 days, after which, if you
  255. do not register the program and pay the $25 Shareware donation, you
  256. must TERMINATE USE.
  257.  
  258. USE THIS PROGRAM AT YOUR OWN RISK!  The author assumes no liability
  259. what-so-ever for any damages that may result from using this program
  260. or its accompanying files.  This program includes absolutely no
  261. warranty, written or implied.
  262.  
  263. PLEASE distribute this UNREGISTERED program everywhere, provided
  264. that this text file and all other files are included with the
  265. program.  DO NOT RE-ARCHIVE SPEED OF LIGHT!  Keep a copy of the
  266. original ZIP file so you can upload it to BBS's and distribute it to
  267. your friends.
  268.  
  269. SPEED OF LIGHT MAY NOT BE SOLD FOR ANY PRICE BY ANYONE OTHER THAN
  270. THE AUTHOR.  PUBLIC DOMAIN AND SHAREWARE RETAILERS HAVE PERMISSION
  271. TO DISTRIBUTE THE UNREGISTERED VERSION FOR A MINIMAL FEE NOT ANY
  272. HIGHER THAN THE COST TO REPRODUCE THE DISK.
  273.  
  274. ***  THIS PROGRAM MAY NOT BE PLACED ON A MAGAZINE COVER DISK WITHOUT 
  275. MY PERMISSION!  YOU MUST WRITE AND ASK FIRST, THANKS!  ***
  276.  
  277. WARNING:  Any attempt to alter the program or its supporting files
  278. could result in permanent damage to your computer or i/o devices.
  279. The author assumes no liability or damages resulting from this.
  280.  
  281. The Graphic Interchange Format(c) is the Copyright property of
  282. CompuServe Incorporated.  GIF(sm) is a Service Mark property of
  283. CompuServe Incorporated.
  284.  
  285.  
  286.  
  287. -----------------------------------------
  288. ---===>>>  RUNNING THE PROGRAM  <<<===---
  289. ---===>>>   AND IMAGE LOADING   <<<===---
  290. -----------------------------------------
  291.  
  292. To run SOL, double click on SPOFLT35.APP from the desktop, or drag 
  293. an image file (in newer TOS versions) to the program name or icon.  
  294. The title dialog should come up (if an unregistered program), 
  295. followed by the registration dialog box (see "HOW TO REGISTER" above 
  296. for information on how to use this box to register).  Click on 
  297. Cancel in the registration box to go to the Options Dialog.  This
  298. is the main settings dialog where you tell SOL how to display the
  299. image.  Click on "Add" to load an image and you will be prompted
  300. with a fileselect box.
  301.  
  302. Select an image to load with the fileselect box.  Some example
  303. images are included in the IMAGES folder.  You can also type in
  304. wildcards like "*" and "?" to make SOL load in all the images in a
  305. particular directory that match the wildcard.  Use "*.*" to load in
  306. all the images.  You will then get a status/information box
  307. informing you that your image is being loaded, uncompressed, or
  308. whatever.  Next, the Options Dialog box will appear again where you
  309. can change the display parameters before displaying the image.
  310.  
  311. I recommend that you use a program like Warp 9 or NVDI with SOL, as
  312. it often can take a long time to draw the dialog boxes without these
  313. software accelerators, especially the Options Dialog.  Selectric 
  314. Fileselector is now supported, so you can select multiple files if you 
  315. have it installed.
  316.  
  317. A description of the items in the Options Dialog will appear in a 
  318. section below, but there is a row of buttons at the bottom of the 
  319. dialog that I will describe now.  These are buttons for loading, 
  320. saving, and displaying the current image, as well as for quitting 
  321. the program.
  322.  
  323. Click on "Quit", "Save As", and "Display" to quit the program, save 
  324. the image, and display the image.  "Add" and "New" are for loading 
  325. in images.  Clicking on these will call up the fileselect box again 
  326. and you can select an image to load or Cancel.  "Add" will load an
  327. image and place it at the end of the list of loaded images (this
  328. will occur even if you are not on the last image when you click on
  329. Add).  "New" will replace the current image with the one you load
  330. in.  Use "Purge" to remove the last image (or images) in the list
  331. and free up memory if needed.
  332.  
  333.  
  334.  
  335. -----------------------------------
  336. ---===>>>  IMAGE FORMATS  <<<===---
  337. -----------------------------------
  338.  
  339. Speed of Light version 3.8 identifies the images it loads by their 
  340. file extension.  SOL can LOAD and display the following image 
  341. formats:
  342.  
  343. FORMAT NAME                           EXTENSION
  344.  
  345. Graphics Interchange Format (GIF)     *.GIF
  346. JPEG                                  *.JPG
  347. Degas Uncompressed                    *.PI?
  348. Degas Compressed                      *.PC?
  349. Prism Paint                           *.PNT
  350. GEM (X)Image Format                   *.IMG
  351.  
  352.  
  353. SOL 3.8 now supports Brainstorm's DSP JPEG decoder for the Falcon030.
  354. If you have this program installed in your AUTO folder, SOL 3.8 will
  355. use it to quickly decode JPEG images.
  356.  
  357.  
  358. SOL version 3.8 can also SAVE in the following formats:
  359.  
  360. FORMAT NAME                           SAVE TYPE
  361.  
  362. GIF                                   As original (as on screen 
  363.                                         only with graphics cards)
  364. Degas Compressed/Uncompressed         As on screen
  365. Prism Paint                           As on screen
  366. GEM (X)Image Format                   As original and as on screen
  367.  
  368.  
  369.  
  370. --------------------------------------
  371. ---===>>>  DIALOG BOX TRICKS <<<===---
  372. --------------------------------------
  373.  
  374. SOL uses an "enhanced 3D GEM" interface with special features that you 
  375. can take advantage of:
  376.  
  377. * Popup menus are easy to use ways of selecting several items.  
  378. Click on these to "pop" them up, then click again to select the 
  379. item you want.
  380.  
  381. * On any slider box, DOUBLE-click on the arrows to move the 
  382. slider bar all the way to that side of the bar.
  383.  
  384. * Real-time slider bars allow instant results.  Click and hold on a 
  385. slider bar until the mouse cursor turns into two arrows (like <>).  
  386. Then drag it back and forth to see the numbers change.
  387.  
  388. * In places where there are two or more slider boxes in a row, you 
  389. can double click on the slider bar and the other slider boxes will 
  390. move to the same position as the one you clicked on.
  391.  
  392. * Keyboard equivalents in the dialog boxes were left out so that 
  393. they would not interfere with programs like Let 'em Fly that enhance 
  394. the dialog boxes.
  395.  
  396.  
  397.  
  398. ----------------------------------------
  399. ---===>>>  THE DISPLAY SCREEN  <<<===---
  400. ----------------------------------------
  401.  
  402. After you load an image and the Options dialog box appears, click on 
  403. DISPLAY to look at the image.  SOL will scan the image and create 
  404. tables of color conversions that it uses for display, and then it 
  405. will draw the image onto the screen.  This is called the Display 
  406. Screen.  To return to the previous dialog, click the RIGHT mouse 
  407. button.
  408.  
  409. There are a lot of image manipulation things that you can do from 
  410. this screen without going to the Options Dialog.  All of these 
  411. things are accessible by pressing the appropriate key or by clicking 
  412. and holding the mouse button.  When you click and hold the LEFT 
  413. mouse button, a popup menu appears with a large selection of items, 
  414. as well as their keyboard equivalents listed beside them.  The 
  415. function of these items will be described below in the section "THE 
  416. DISPLAY SCREEN POPUP MENU".  The section you are reading now will
  417. discuss some basic things not available in the popup menu.
  418.  
  419. If the image is larger than the size of your display screen, you can 
  420. move around in the image with the arrow keys, or by using the mouse. 
  421. Pressing the UP, DOWN, RIGHT, and LEFT ARROWS will move your display 
  422. in that particular direction on the image by 20 pixels.  To move the 
  423. screen by one quarter of the screen, hold down CONTROL when you 
  424. press the arrow keys.
  425.  
  426. MOVING WITH THE MOUSE is more complicated.  When you enter the 
  427. display screen, the mouse appears in the center of the screen (even 
  428. if it is not being displayed, it will still be in the center). 
  429. Imagine a small box centered in the middle of the screen.  The mouse 
  430. can move freely inside of this box, but when it goes outside of the 
  431. box, the display will move in the direction that the mouse went 
  432. outside of the box.  The farther the mouse goes outside of the box, 
  433. the more the display moves.  If the mouse is being displayed, and 
  434. arrow will briefly appear showing the direction of motion.
  435.  
  436. To stop the display screen from scrolling, move the mouse back to 
  437. the center of the screen OR quickly press the left mouse button to 
  438. return the pointer to the center.  Holding it down longer will make 
  439. the popup menu appear.  You can also hold down ALTERNATE to prevent 
  440. the screen from scrolling when the mouse goes out of the center box.
  441.  
  442. If you have more than one image loaded, you can press the function 
  443. keys to go to the first TEN images (F1-F10).  To go to the NEXT TEN 
  444. images, hold down SHIFT and press a function key (F11-F20).  Use
  445. ALTERNATE for F21-F30.  You can also press ']' to go to the next
  446. image and '[' to go to the previous image.
  447.  
  448. In flicker mode, you can stop SOL from flickering the screen by 
  449. pressing the SPACEBAR.  This shows you the first of the two screens 
  450. that SOL flickers to get the expanded palette.  Press the SPACEBAR 
  451. again to resume flickering.  You can also use the SPACEBAR to pause 
  452. during the drawing of the screen.  Pauses during FIS as well.
  453.  
  454.  
  455.  
  456. ----------------------------------------
  457. ---===>>>  THE OPTIONS DIALOG  <<<===---
  458. ----------------------------------------
  459.  
  460. The related items (text, buttons, sliders, etc.) in the Options
  461. Dialog are arranged in the same area with a thin line dividing each
  462. area.  Each item is discussed in order from left-to-right, then
  463. top-to-bottom, in each specific group.  Text items are indicated by
  464. a T>, buttons are indicated by a B>, editable items are indicated
  465. by an E>, slider bars are indicated by an S>, and popup menus are
  466. indicated by a P>.  Group titles are surrounded by astrixes (**) and
  467. the specific items are listed under the group title.
  468.  
  469.  
  470. ** Image Specifications **
  471.  
  472. T> Image Filename - name of current image file whose display
  473. specifications are shown in the rest of the options dialog.
  474.  
  475. T> Image Dimensions - size of the image in pixels.  An 'I' is 
  476. printed after this to indicate and interlaced image.
  477.  
  478. T> Image Palette - the size of the palette used by the image.
  479.  
  480. T> Image Colors - the actual number of colors in the current image.
  481.  
  482. B> "H" Button - Displays the histogram for the current image.  The
  483. histogram is separated into its red, green, and blue planes and you
  484. can switch between them with the buttons at the top of the histogram
  485. screen.  A greyscale image (loaded in as greyscale, not displayed as
  486. Shades) will have the same histogram for red, green, and blue planes
  487. (as expected).  Notice that additive color transformations will not
  488. effect this histogram, but complex histogram transformations will
  489. (see below for info on these color effects).
  490.  
  491. B> "P" Button - This optimizes the palette of the image.  The initial
  492. palette value is taken directly from the image header, or the
  493. expected palette.  This button scans through the image and tries to
  494. find the actual palette resolution.  A lot of times I get GIF
  495. pictures that say they only have 64 color palette when they actually
  496. have 16 million.  I did not automatically optimize the palette on
  497. loading because it can take some time, and it is not necessary for
  498. normal use.
  499.  
  500.  
  501. ** Machine Specifications **
  502.  
  503. T> Machine - the machine you are using.
  504.  
  505. T> Resolution - the size of your display.
  506.  
  507. T> Palette - the size of the palette your system can display.
  508.  
  509. T> Colors - Number of colors in the system.  This can be changed by
  510. clicking on the arrows next to it.  This sets the actual number of
  511. colors that the image will be displayed with.  This allows you to
  512. reduce the number of display colors.
  513.  
  514. B> "Delta" Button - On TTs and STs, you can change the resolution 
  515. that you display in by clicking on this button and selecting the 
  516. resolution in the popup menu.  Machine specifications for color and 
  517. resolution should change.  The mouse does not always look right and
  518. has a limited range when enabled on ST Medium.
  519.  
  520. B> "3-Bars" Button - This allows setting of program preferences as
  521. well as truecolor loading and inverse colormap settings.  See the
  522. "PREFERENCES" section below for complete information.
  523.  
  524.  
  525. ** Picture Number, Display Mode, and **
  526. **   Color Transformation Settings   **
  527.  
  528. S> Picture Number - This slider bar selects the current image.  There
  529. may be a pause after switching to a different picture.  This is due
  530. to the computer taking some time to draw the new image parameters
  531. into the Options Dialog (the screen blanks during redraw).
  532.  
  533. P> Display Mode - This selects between a color interpretation of the
  534. image and a shades display of the image.  "Shades" are normally
  535. greyscale unless you change the color with the color transformation
  536. settings.  On TT computers, you can select "TTGrey" mode which
  537. allows you to display 256 shades of grey when in TT Low display.
  538.  
  539. B> Red Downward Pointing Arrow - This changes the color
  540. transformations so that the image looks as close to the original as
  541. possible (sets sliders to zero, or changes histograms to a
  542. one-to-one transformation).
  543.  
  544. B> Complex - This switches between additive color transforms and
  545. histogram color transforms.  When this is highlighted, three small
  546. histograms are displayed (one for red, green, and blue).  Click on
  547. any of these histograms to edit that particular color plane in the
  548. histogram editor (see below).  These histograms take a particular
  549. intensity of red, green, or blue color and map it to a new
  550. intensity.  That is why the one-to-one transformation is a
  551. triangular shape (the graph represents the line y=x).  Flipping this
  552. transformation will cause inversion of the color map (low
  553. intensities map to high ones, and visa-versa).  For some
  554. interesting effects with these transformations, see the section
  555. "COLORS TO PLAY WITH" below.
  556.  
  557. S> Additive Color Transforms - These three slider bars are active
  558. when "COMPLEX" is NOT highlighted and they allow you to add various
  559. levels of red, green, and blue to your image.  Positive values
  560. increase the intensity, negative values decrease the intensity.  For
  561. example, moving the green slider bar to the left makes the image
  562. look purple/red/blue when displayed.  Putting all three sliders to
  563. the same value will brighten or darken the image without changing
  564. the colors' relative differences.  NOTE AGAIN that these sliders are
  565. used only when the "COMPLEX" button is NOT highlighted.
  566.  
  567.  
  568. ** Color Reduction/Selection Settings **
  569.  
  570. P> Color Reduction Method - If the display colors are fewer that the
  571. number of colors in the image, then SOL will try to reduce the
  572. number of colors using the method selected by this popup menu.  All
  573. color reduction methods take into account the "Color Contrast"
  574. settings (described below).  The "Frequency" method is the most
  575. automatic and it selects the colors based on their frequency in the
  576. picture.  The next two methods, "Influence" and "By Rank", use a
  577. ranking histogram to choose the colors.  The only difference between
  578. these two methods is that "By Rank" selects the colors purely upon
  579. how they are ranked in the histogram, whereas "Influence" takes into
  580. account the frequency of the color in the image as well as its rank.
  581.  
  582. B> Color Rank - The "Rank" button switches to the Color Ranking 
  583. Histogram Editor where you can define the ranks of the red, green, 
  584. and blue color planes.  See "THE HISTOGRAM EDITOR" section of this 
  585. manual for more information on how to use the editor.  The ranking 
  586. histogram for each color plane is organized with intensity on the
  587. horizontal axis from dark to light (left to right) and rank on the 
  588. vertical axis from low to high (bottom to top).  For example, if I 
  589. wanted to make red, green, and yellow colors chosen more often than 
  590. other colors, I would draw histograms like this:
  591.  
  592. ^     Red:            Green:            Blue:
  593. ^   |        ___    |        ___     |
  594. R   |       /       |       /        |
  595. A   |______/        |______/         |___________
  596. N   |               |                |
  597. K   +-----------    +-----------     +-----------
  598.  
  599.     Intensity > >
  600.  
  601. When ranks for intensities are the same for all color planes, then 
  602. the order of those colors will be chosen based on the order that 
  603. they appear in the image's original palette (unless you are using 
  604. the "Influence" method, in which case the frequency that they appear 
  605. in the image will also have an effect).  Rank has no effect when
  606. using the "Frequency" method; that is why you cannot edit the rank
  607. histograms when this method is selected.  Rank also has no effect
  608. when all intensities, in all color planes, have the same rank.  The
  609. height of the rank has no importance, except relative to the height
  610. of the rest of the histogram.
  611.  
  612.  
  613. B> Complex - This button selects between simple color contrast 
  614. slider bars and a more complex histogram color contrast.  If 
  615. "COMPLEX" is highlighted, the three contrast slider bars will be 
  616. replaced by three histograms which allow you to define the contrast 
  617. for each intensity level of the red, green, and blue planes.  To 
  618. edit a particular contrast histogram, click on the small histogram 
  619. of the one you want to edit.  Contrast is on the vertical axis, and 
  620. intensity is on the horizontal axis of each histogram.  Read about 
  621. the contrast slider bars (below) for more information on how 
  622. contrast effects the image...
  623.  
  624. S> Color Contrast/Separation - This trio of slider bars defines the 
  625. minimum separation between the colors that SOL chooses to display 
  626. the image with.  This contrast can be set from 1 (choose colors as 
  627. close together as possible) to 256 (choose colors with highest 
  628. contrast, like black and white).  A setting of 1 is best when the 
  629. picture has equal or less than the number of displayed colors, but 
  630. when the color must be reduced, like from a 256 color image down to 
  631. a 16 color display, a contrast between 18 and 32 is best.  If the
  632. contrast is too high, the color map will not be completely filled
  633. due to rejected colors.  The best separation value is just below
  634. the point where colors are starting to be omitted from the map (use
  635. the "color-loss warning" alert box (see Preferences section) to help
  636. you find this point).
  637.  
  638.  
  639. ** Image Scaling and Some Miscellaneous Buttons **
  640.  
  641. E> Horizontal and Vertical Size in Pixels - These two editable 
  642. fields define the size (in pixels) that the image will be scaled
  643. to.  Click or use the arrows to move the editing cursor.
  644.  
  645. P> Axis Effect - This popup menu selects "Horizontal, Vertical, or
  646. Both" as the axis that the buttons to the right of this popup
  647. effect (see below).  The buttons "+, -, O, and A" will change the
  648. scaling of the axis that you set here.  The first letter of your
  649. selection will appear in the button (either H, V, or B).
  650.  
  651. B> "O" Button - With this button, scaling is set to the original
  652. size of the image.
  653.  
  654. B> "A" Button - This calculates the aspect ratio of the original 
  655. width and height of the image based on the effected axis (if "Both" 
  656. is selected, then this button bases its effects on the horizontal 
  657. axis).  It then sets the other axis to the proper value to match 
  658. this ratio.
  659.  
  660. B> "-" Button - This button will halve the selected axis.  This 
  661. reduces the image by a factor of two.
  662.  
  663. B> "+" Button - This button will double the selected axis.  This 
  664. enlarges the image by a factor of two.
  665.  
  666. B> "Fltr" Button - This turns filtered scaling on and off.  The 
  667. filter that it uses is set with the "Set" button below.
  668.  
  669. B> "Set" Button - Clicking on this button will switch to the 
  670. Filtered Scaling Settings Dialog where you can set the filter type 
  671. and scaling.
  672.  
  673. B> "Fit" Button - This stretches the widest edge of the image out
  674. to the width or height of the screen so that the image is at its
  675. largest size without exceeding the screen's borders.  The image's
  676. original aspect ratio is restored.
  677.  
  678. B> "Mous" Button - If this is highlighted, then the mouse will be 
  679. displayed in the Display Screen, otherwise it will be hidden.  This 
  680. is the same as pressing TAB from the Display Screen.
  681.  
  682. B> "SmDr" Button - This turns on and off "Smooth Draw" mode.  When 
  683. flickering is used to increase the number of colors, this will make 
  684. SOL flicker the screen even when it is drawing for a smoother 
  685. effect.  The only drawback is that drawing is considerably slower.
  686.  
  687. B> "Warp" Button - This switches to the Warp Setting dialog where 
  688. you can set various warping and stretching effects.  See the
  689. Image Warping section for more details.
  690.  
  691.  
  692. ** Flicker Contrast and Dithering **
  693.  
  694. S> Flicker Contrast - This slider bar sets the maximum contrast 
  695. allowed between flickered colors.  Greater contrast may cause 
  696. increased flickering, while lower contrasts will reduce flickering.  
  697. When the slider is moved all the way to the left, the slider will 
  698. indicate "OFF".  Drawing will be twice as fast when flickering is
  699. off.  If you have a large display palette and number of colors,
  700. flickering SHOULD be turned off, because you DO NOT NEED IT.
  701. Flickering may produce weird effects on graphics cards, and is
  702. unavailable with Byteplane Mode (see Preferences Dialog).  There is a
  703. known bug on the Falcon when you have the mouse being displayed while
  704. flickering; the screen jumps around in funny ways on large resolution
  705. displays and sometimes may not flicker at all.  This is due to a
  706. hardware bug that is unavoidable.
  707.  
  708. P> Dither Pattern - This popup menu selects between dither patterns. 
  709. See the dithering discussion section below for more information.
  710.  
  711. B> "Set" Button - This switches to the Dithering Dialog so that you 
  712. may have more detailed control over dithering than just what pattern 
  713. is used.  See the dithering section below for more information.
  714.  
  715.  
  716. ** Miscellaneous Buttons **
  717.  
  718. B> "Desk" Button - SOL allows you to go to the desktop to access 
  719. accessories (or return to other programs in MultiTOS).  Some menu 
  720. items are available there, and a scrolling list of all the loaded 
  721. images is also accessible from the menu.  Most entries are 
  722. self-explanatory.  Keyboard equivalents for menu items are listed
  723. next to them.  Loading can be done WITHOUT returning to the
  724. non-windowed environment of SOL.
  725.  
  726. B> "?" Button - This displays the title dialog with credits and 
  727. shareware information.  It also shows you how much free memory you 
  728. have available and who the program is registered to.
  729.  
  730. B> "Purge" Button - This allows you to remove the last image from 
  731. the image list and free the memory it takes.  Unlike version 3.1, 
  732. 3.8 lets you purge an image if it is the only one loaded into SOL. 
  733. You can also double-click on "Purge" to remove all the images from 
  734. memory.
  735.  
  736. B> "Colors" Button - This goes to the powerful color editor.  This 
  737. is not available in Shades or Greyscale modes.  See the section
  738. below on how to use the color editor.
  739.  
  740. ** Lower Row of Buttons **
  741.  
  742. B> ">>" Button - This calls up the Slideshow Settings Dialog.  Here 
  743. you can move the slider bar to select the number of seconds to 
  744. display each image.  When the direction is selected (forward, 
  745. backward, etc) SOL will automatically switch between images, 
  746. displaying each one for the specified number of seconds.  The way it 
  747. switches between images is determined by the second popup menu. 
  748. "First" and "Last" allow you to select the first and last image for 
  749. display.  Only images between and including these images will be 
  750. displayed.  If the first image comes after the last image, the two 
  751. image numbers will be exchanged.  If you display an image outside of 
  752. this range of images while in the middle of a slideshow, the 
  753. slideshow will terminate until you enter the range again.  The 
  754. display time is calculated from the point where the image finishes 
  755. drawing.  The Record Script button is described in the file SCRIPTS.DOC.
  756.  
  757. Other buttons are described in the section "RUNNING THE PROGRAM AND 
  758. IMAGE LOADING" above, but are fairly obvious.
  759.  
  760.  
  761.  
  762. ------------------------------------------
  763. ---===>>>  THE HISTOGRAM EDITOR  <<<===---
  764. ------------------------------------------
  765.  
  766. This editor makes it easy to edit graphical histograms for color 
  767. manipulation purposes.  The main editing area is a large box in the 
  768. center of the dialog.  To set the level for a particular intensity, 
  769. click the mouse where you want the level to be.  You can hold the 
  770. mouse button down and SLOWLY move it right or left to draw the shape 
  771. of the histogram.  You can easily switch between the red, green, and 
  772. blue color planes by clicking on one of the three buttons at the top 
  773. of the dialog.
  774.  
  775. Most of the buttons at the bottom of the dialog are for editing and 
  776. creating the shape of the histogram.  "Stretch" and "Squash" are for 
  777. doing just that.  They effect the level of the histogram.  "Invert" 
  778. subtracts the maximum level of the histogram from the histogram 
  779. level at each intensity and makes that the new level.  The "Flip" 
  780. button flips the image horizontally.  The four ARROW buttons move 
  781. the histogram in the direction specified.  "Copy" will copy the 
  782. histogram onto the GEM clipboard (disk) and you can use "Paste" to
  783. copy it back in to any other histogram.  If you DOUBLE-CLICK on
  784. "Copy", it will copy the current histogram to the other two color
  785. plane histograms.  For example, if you double-click on "Copy" in the
  786. green histogram, red and blue will become the same as green.
  787.  
  788. "Undo" reverts the histogram back to what it was when you first 
  789. started editing that particular color plane.  "OK" goes back to the 
  790. Options Dialog, and "Cancel" will Undo any changes you have made to 
  791. any of the color planes since you entered the editor, and then goes
  792. back to the Options Dialog.
  793.  
  794. "Gamma" allows you to automatically make a gamma-correction
  795. histogram.  This is used for color transformations and is the most
  796. realistic way to brighten or darken an image without getting
  797. washout.  After clicking on the button, type in the gamma-
  798. correction value and click on "Generate" to create it. A value
  799. greater than 1 will darken the image, less than 1 will brighten the
  800. image.  A value of 1 is a one-to-one transformation.
  801.  
  802. "Linear" allows you to automatically generate a linear histogram by 
  803. setting the rise and run.  The histogram has a width and height of 
  804. 256, so a rise and run of 256 will have a slope of one.  You can 
  805. also shift the graph by a positive or negative pixel value to the
  806. right.
  807.  
  808. "Step" was never implemented.
  809.  
  810.  
  811.  
  812. --------------------------------------
  813. ---===>>>  THE COLOR EDITOR  <<<===---
  814. --------------------------------------
  815.  
  816. Ten colors are displayed at the top of the dialog and each has its 
  817. actual color number above it.  These colors are displayed in either 
  818. VDI-order or Device-Dependent order, depending on whether you have 
  819. "VDI Order" selected or not.  To move the "window" of ten colors 
  820. around in the larger color map, you can either adjust the slider bar 
  821. below the colors, or click on the arrows to the right and left of 
  822. the ten color boxes.  Double-clicking moves all the way to the 
  823. beginning or end.
  824.  
  825. You can change the red, green, and blue color values of a color by 
  826. clicking on the color.  It is marked by an inner box.  Even when you 
  827. move the color "window" to a different spot in the color map, the 
  828. one being edited always stays the same, even if it is not displayed 
  829. in the current window of colors.  To alter the color, use the three 
  830. slider bars labeled RED, GREEN, and BLUE under the color map to the 
  831. right.
  832.  
  833. If a color exists in the color map that is not being used by the 
  834. current image, it will be marked with a small X in the middle of the 
  835. color box.
  836.  
  837. The buttons in the editor are divided into two groups.  The ten
  838. upper-left-hand buttons are tools for manipulating two or more 
  839. colors.  This is the "Toolbox."  These buttons are slightly thinner 
  840. than the other buttons.  The lower-left-hand and right-hand buttons 
  841. are for switching to other dialog boxes, undoing, or are used for 
  842. other global operations.
  843.  
  844. All the "toolbox" buttons are used in the same way.  To apply the 
  845. tool to the whole color map or to define the first and last colors 
  846. in the color map as the "hot" colors, double click on the tool 
  847. button.  Otherwise, you must manually mark the "hot" colors.  Click 
  848. on the first "hot" color that you want in the color map and it will 
  849. be marked with an inner box. Next, click on the tool button you want 
  850. to use.  The mouse pointer should turn into a pencil pointer.  Then 
  851. move to the second "hot" color and click on it to apply the tool 
  852. between the two colors.  To cancel the tool, click off the color 
  853. map, or press the right mouse button.
  854.  
  855. Here is the effect that each tool has:
  856.  
  857. COPY - this copies the first color to the second one.
  858.  
  859. SWAP - the two colors are exchanged.
  860.  
  861. FILL - this fills all the colors in between and including the second
  862. color with the color of the first one.
  863.  
  864. FLIP - this flips the colors in the selected area so that the first 
  865. color goes the the last color's position and the last color ends up 
  866. in the first color's position.
  867.  
  868. < ROTATE - this shifts the colors to the left and takes the first 
  869. color in the selected area and puts it in the last color slot.
  870.  
  871. ROTATE > - this shifts the colors to the right and takes the last 
  872. color in the selected area and puts it in the first color slot.
  873.  
  874. SORT GROUP - this groups the colors in the selected area based on
  875. their color values.  For example, all the greens and blues will be
  876. sorted into separate groups.
  877.  
  878. GRADIENT - this smoothly fills in all the colors in between the 
  879. first and the second color so that there is a gradual change from 
  880. one to the other.  For example, a gradient between black and white 
  881. would fill in with increasingly brighter greys until it finally 
  882. reaches white.  Play with it!
  883.  
  884. SORT DK > LT - this button sorts the colors in the selected area 
  885. from the darkest color to the lightest color.
  886.  
  887. SORT LT > DK - this sorts the colors in the selected area from the 
  888. lightest color to the darkest color.
  889.  
  890.  
  891. The functional buttons are located in the left half of the Color 
  892. Editor Dialog under the three RGB slider bars and on the right half 
  893. under the "toolbox."  Here is the what each button does when you 
  894. click on it:
  895.  
  896. MATCH - this is a on/off highlight button.  When "Match" is
  897. highlighted, any changes to the color palette will cause SOL to try
  898. to match the images colors to the new palette.  If it does not use
  899. one of the colors in the color map, it will be marked with a small X.
  900. If "Match" is NOT highlighted, then the pixels will retain their
  901. mappings to the old palette, and your changes will appear in the
  902. displayed image.  NOTE that FIS matches your palette to the 
  903. original image no matter what.
  904.  
  905. DISPLAY - this goes to the display screen.  You can press the right 
  906. mouse button or the 'E' key to return to the Color Editor.
  907.  
  908. UNDO - you can undo any changes you make to the palette using this 
  909. button.
  910.  
  911. CPY/SWP - this allows you to swap or copy the current palette to
  912. another image.  Select the image in the small dialog and click on
  913. "Copy" or "Swap" depending on what you want to do.
  914.  
  915. IMAGE - this allows you to edit another image's palette.  Select the 
  916. new image in the dialog box and click on "OK" to make it the current 
  917. image.
  918.  
  919. RESCAN - sometimes you want to revert back to the original palette 
  920. that SOL calculated for this image originally.  This button will do that.
  921.  
  922. SELECT - clicking on this will switch to the display screen where 
  923. you can click on any pixel in the image and that color entry in the 
  924. palette will be selected in the Color Editor when you return.  This
  925. is so you can be sure that you are editing the correct color.
  926.  
  927. TAKE - this allows you to select a pixel from the image in the same 
  928. way as SELECT.  The color that you are currently editing will then 
  929. take on the value that that pixel had in the original image.
  930.  
  931. LOAD - this loads a .PAL palette file into the current color map.
  932. If there are more colors in the .PAL file than will fit into the
  933. current map, only the first ones that will fit are used.
  934.  
  935. SAVE - this saves the current palette as a .PAL file.
  936.  
  937. CANCEL - this aborts any changes you have made and returns to the 
  938. previous screen.
  939.  
  940. OPTIONS - this goes to the Options Dialog.
  941.  
  942.  
  943. .PAL FILE FORMAT:
  944. =================
  945.  
  946. BYTE OFFSET   DESCRIPTION
  947. -----------   -----------
  948. 0             Number of Colors in the file - 1
  949.  
  950. 1             Red intensity (0-255) color 0
  951. 2             Green intensity (0-255) color 0
  952. 3             Blue intensity (0-255) color 0
  953.  
  954. 4             Red intensity (0-255) color 1
  955. 5             Green intensity (0-255) color 1
  956. 6             Blue intensity (0-255) color 1
  957.  
  958. 7             color 2...etc.
  959.  
  960.  
  961.  
  962.  
  963. -----------------------------------
  964. ---===>>>  SAVING IMAGES  <<<===---
  965. -----------------------------------
  966.  
  967. Clicking on "Save As" in the Options Dialog or from the Display 
  968. Screen popup menu will bring up the Saving Dialog where you can 
  969. select the image format that you want to save in.  There are two 
  970. ways to save images, some only apply to certain formats:
  971.  
  972. SAVE AS ORIGINAL - this saves the image as it is stored in memory.  
  973. The display scaling and display palette has no effect.  The only
  974. things that have effects are flipping, rotating, clipping, and
  975. complex histogram color transformations.
  976.  
  977. SAVE AS ON SCREEN - this saves the image as you see it on your 
  978. screen.  Any part of the image that is off screen will not be 
  979. saved.  If the image is being flickered, then you will be prompted 
  980. for which of the two flickering screens should be the one that is 
  981. saved.  These are essentially the same except for some small 
  982. dithering differences.  It is best to turn off flickering and use
  983. dithering if you need to before saving.
  984.  
  985. Select the image to save in with the popup menu.  For some images, 
  986. you can save the display information and scaling with the image 
  987. (like with GIF images).  Select this option with the small button. 
  988. You can also save a text comment file with GIF89a images.  Upon 
  989. saving, you will be prompted with a fileselect box asking for the 
  990. text file that you wish to incorporate into the image as a comment.
  991.  
  992. GIF Images can only save as original on non-graphics card systems,
  993. so to save the screen as a GIF image, simply save the screen as a
  994. GEM Image or Prism Paint picture, the load that one in, clip if
  995. necessary, and save as original in GIF format.  You can also use
  996. the new feature "Image = Screen [X]" from the Display Screen menu
  997. to make the original image the same as the screen.  Then, just save
  998. as original.  Using this feature is easier and faster than 
  999. converting it from another format.
  1000.  
  1001.  
  1002.  
  1003. ---------------------------------------------------
  1004. ---===>>>  THE DISPLAY SCREEN POPUP MENU  <<<===---
  1005. ---------------------------------------------------
  1006.  
  1007. While displaying an image, click and hold the left mouse button 
  1008. until the popup menu appears.  All of the commands listed can also 
  1009. be used by pressing the corresponding key in square brackets [] next 
  1010. to each item.  Move up and down while holding down the mouse to 
  1011. highlight an entry and release the mouse button to select it.
  1012. Canceling can be done by releasing with "Center Mouse/Cancel"
  1013. highlighted or by releasing outside of the menu.  Most of the menu
  1014. items have been discussed before or are self explanatory, so only
  1015. some of them will be explained below.  The keyboard equivalent is
  1016. indicated in brackets.
  1017.  
  1018. CLIP IMAGE [C]- this displays the mouse as the corner of a frame.  
  1019. Click on the image where you want to start the upper-left corner of 
  1020. the clipped area.  Clipping outside of the image will cause the 
  1021. mouse to turn into an X and it will not let you click there.  To 
  1022. cancel at any time before clipping, click the RIGHT mouse button.  
  1023. You can now drag a box from the upper-left corner that you defined 
  1024. down to the lower-right corner of the clipping area.  Click again to 
  1025. finish marking the area.  A dialog box will come up where you can 
  1026. either replace an image with a copy of the clipped area or add this 
  1027. clipped area to the end of the image list.  Clipped images have the 
  1028. same filename as the image that they were clipped from, but the 
  1029. extension is ".CLIPxx" where "xx" is a number that increases with 
  1030. each clipped image.
  1031.  
  1032. ZOOM [+/-/Z/O/I] - this pops up another menu to select one of four
  1033. items.  "Zoom Area" allows you to select an area of the image to
  1034. zoom in on.  You can select an area the same way as you do with
  1035. clipping (see above).  "Zoom In" and "Zoom Out" will double and half
  1036. the size of the image, respectively.  "Zoom Original" will resize
  1037. the image to its original size, and "Fit to Screen" will enlarge or
  1038. reduce the image to fit onto the screen while keeping its original
  1039. aspect ratio.
  1040.  
  1041. ROTATE IMAGE [,/.] - this pops up another menu to select the
  1042. direction of the 90 degree rotation.  Extra memory is required for
  1043. rotation, so you will be alerted if there is not enough.
  1044.  
  1045. FLIP IMAGE [H/V] - this pops up a menu where you can select the
  1046. direction of flipping (horizontal or vertical).  This requires no
  1047. extra memory.
  1048.  
  1049. CHANGE PICTURE/VIEW [P] - this goes to the picture selection dialog
  1050. where you can select the next picture you want to view by using the
  1051. scroll bar.  Each picture is shown in miniature greyscale.  You can
  1052. also change the location of your view-screen on the image.  Do this
  1053. by moving the mouse over the small greyscale image until a box
  1054. appears.  Click inside of the box and drag the mouse to move the
  1055. box.  Release the mouse to place the box and click on OK to view the
  1056. new position on the image.
  1057.  
  1058. TOGGLE COLORING [T] - this switches to "Shades" mode if in "Color"
  1059. mode and visa-versa.
  1060.  
  1061. IMAGE = SCREEN [X] - this allows you to make the current screen
  1062. into an image.  This way, you can permanently keep any warping or
  1063. filtering changes and modify them with other effects.  This also a
  1064. way of saving GIF images by converting the screen to an "Original"
  1065. image.  When you select "Image = Screen [X]" from the popup menu (or 
  1066. press 'X') a dialog box will appear where you can select the image 
  1067. slot where you would like to store the screen image.  Click on 
  1068. "Convert" to make the screen into an image without clipping.  Click 
  1069. on "Shrink" to do the same, but the image will be clipped if it does 
  1070. not take up the full screen.
  1071.  
  1072. NOTE: clipping, flipping, and rotating, all effect the original 
  1073. image (not just the screen), so "Save As Original" will save these 
  1074. kinds of changes.  However, zooming, warping, filtering, and other
  1075. features only effect what is on screen and therefore saving "As On
  1076. Screen" should be used to save these changes.  Use "Image = Screen"
  1077. to make any screen changes permanent.
  1078.  
  1079.  
  1080.  
  1081. --------------------------------------------
  1082. ---===>>>  FILTERED IMAGE SCALING  <<<===---
  1083. --------------------------------------------
  1084.  
  1085. Filtered Image Scaling (FIS) is a similar feature as "averaging" was 
  1086. in SOL version 2.6, but is MUCH more powerful.  This technique is 
  1087. used to smooth out or alter images that have been enlarged or 
  1088. reduced.  FIS is very calculation intensive and takes a long time to 
  1089. draw, so it was not meant as a quick way to view images.  Instead, 
  1090. you should position and scale the images to the way you want them, 
  1091. and ONLY THEN use filtering.  To turn on filtering, highlight "Fltr" 
  1092. in the Options Dialog Box or, from the Filter Settings Dialog, click 
  1093. on the round button above the filter graph until "Filter On" 
  1094. appears.
  1095.  
  1096. FIS has been improved since version 3.3 and before.  Color scaling 
  1097. is now almost as fast (when not dithering) as greyscale and "shades" 
  1098. modes by utilizing inverse colormaps.  You can improve the quality of 
  1099. color FIS by using at least a 5 bit Inverse Colormap and dithering.  
  1100. Dithering only works with color FIS.  Likewise, flickering only 
  1101. works with "Shades" display mode.
  1102.  
  1103. To see how FIS works, load in a small 256 color picture, and switch 
  1104. to "Shades" display mode in the Options Dialog.  Then click on 
  1105. "Display" and press the '+' key several times from the display 
  1106. screen to zoom in.  Press the 'F' key to go to the Filtered Scaling 
  1107. Dialog.  Click on the popup menu under "FILTER CURVE:" to select a
  1108. Standard filter (select B-Spline).  Then click on "OK" to display
  1109. it.  There may be a small initial pause, but then scan lines will
  1110. appear one by one.  You will notice that the completed output will
  1111. look much better than the blocky original.  It looks like a slightly
  1112. blurred representation of the original.
  1113.  
  1114. Enhancing filters were added in version 3.5 and can be used for 
  1115. weird effects.  Note that these filters work best when the scaling 
  1116. is a multiple of the original image (i.e. x 2, x 4, etc.)  Often you 
  1117. will get banding due to the inability of these filters to shift 
  1118. phase.  Sharpening and Diffusion filters works best on the original 
  1119. image (no scaling) and the other enhancing filters work best when 
  1120. the image is enlarged.  These other filters can be used to create 
  1121. interesting effects on the pixels themselves.  For example, the 
  1122. Sharp Bias filter produces a 3-D pixel effect by lightening one side 
  1123. of the pixel when enlarged.
  1124.  
  1125. Some of the enhancing filters are asymmetric and therefore can be 
  1126. flipped for different effects.  The filter can be flipped when 
  1127. filtering horizontally or vertically by highlighting the appropriate 
  1128. selection in the Filter Settings Dialog.  Filters can also be 
  1129. wrapped at the edges of the image or faded.  Both have drawbacks in 
  1130. that fading will darken the edge of the image, while wrapped edges 
  1131. can sometimes produce duplicate pixels close to the edges.
  1132.  
  1133. When reducing an image without FIS, lines are removed to make the 
  1134. new size, so a lot of the image is lost.  Standard filters are used 
  1135. to accurately take these lost lines into account.
  1136.  
  1137. Box and triangle filters work better for integral reduction/ 
  1138. enlargement factors because they are not phase-adjusting filters.  In
  1139. other words, if you scale the image by a factor of 1.7432, you will
  1140. get banding across the image with these filters.  The smoother, more
  1141. curved filters are better for most scaling factors.  Banding also
  1142. occurs with some of the Enhancing Filters.  Play with all the
  1143. settings to get the best feel for how filtering works.
  1144.  
  1145. Because filtering is limited in unregistered versions, four pictures
  1146. have been included in the IMAGE folder showing the effects of
  1147. filtering:
  1148.  
  1149. ENLWOFIS.GIF is an enlarged image without FIS.
  1150. ENLWFIS.GIF is an enlarged image showing the benefits of FIS.
  1151. REDWOFIS.IMG is a reduced image without FIS.
  1152. REDWFIS.IMG is a reduced image showing the benefits of FIS
  1153.  
  1154. In the Filter Settings Dialog, you can also change the scaling of 
  1155. the filter itself.  This can be used, among other things, to blur 
  1156. the image.  First, click on "Scale Filter" to highlight the round 
  1157. button.  This will use the scaling values that you type into the 
  1158. boxes to the right and below.  Values of 1 do not scale the filter, 
  1159. but values greater than 1 will widen the filter and cause blurring.  
  1160. A value of 2 is for a little blurring, 4 for even more and so on. 
  1161. These values need NOT be integers, and they can be less than 1 as 
  1162. well.  Values less than 1 produce a weird patterned darkening 
  1163. effect.  You can also scale the filter in height to compensate for 
  1164. darkening caused by the horizontal and vertical scaling factors.
  1165.  
  1166. The temporary memory usage of filtering is shown at the bottom of 
  1167. the Filter Settings Dialog and shows how much space you will need 
  1168. for a particular filter and filter scaling.  Higher filter scaling 
  1169. values take more memory, as do wider filters.  You can click on the 
  1170. memory value to update it when new scaling values are typed in.
  1171.  
  1172.  
  1173.  
  1174. -----------------------------------
  1175. ---===>>>  IMAGE WARPING  <<<===---
  1176. -----------------------------------
  1177.  
  1178. This is a new feature as of version 3.3.  Clicking on Warp in the
  1179. Options Dialog or selecting "Image Warping [W]" from the Display
  1180. popup menu will go to the Set Image Warping dialog box.  Here you
  1181. can turn on warping and type in the values that change how warping
  1182. looks.
  1183.  
  1184. The basic principle behind warping is that the scan lines of the
  1185. image are stretched and shifted in a particular pattern to make an
  1186. interesting (and usually amusing) change in the image.  To do this,
  1187. there are several numbers which you type into the warping dialog
  1188. box to create the warping.  These are all in units of pixels
  1189. relative to the image itself, so if you display the image enlarged
  1190. twice, 1 pixel unit = 2 screen pixels.  Therefore, each number is
  1191. scaled by the same factor as the current image scaling.
  1192.  
  1193. The warping is centered around a specified area (referred to as a 
  1194. "bulge") and can be repeated (a periodic bulge.)  This center is 
  1195. usually at the peak of the curve selected for warping, except when 
  1196. using a sine wave.  There are four numerical entries which define 
  1197. how the wave looks.
  1198.  
  1199. The numerical entries are width, height, horizontal shift, and 
  1200. vertical center position.  Vertical center determines which scan 
  1201. line in the image will be used as the center of the bulge.  This is 
  1202. where the largest (or smallest if width is negative) bulge point on 
  1203. the curve is located.  The width determines how many pixels on each 
  1204. side of the image the bulge will extend at its peak.  A negative 
  1205. value causes the curve to bulge inward, squashing the image.  If the 
  1206. width is zero, no stretching occurs, but horizontal shift still has 
  1207. an effect.  Horizontal shift sets how many pixels to the right 
  1208. (negative is to the left) the image will be shifted at the peak of 
  1209. the curve.  The height sets how many scan lines above or below the 
  1210. vertical center position that the bulge extends.
  1211.  
  1212. The warp pattern popup menu turns warping on by selecting the 
  1213. pattern of the bulge curve.  Flat, Linear, Cubic, B-Spline, and 
  1214. Plateau are all positive curves (only warp in one direction; in or 
  1215. out), and the Sine Wave is both positive and negative (stretches or 
  1216. shifts in and out).  Note that the B-Spline curve is twice as wide 
  1217. as the others, and it actually extends to twice the height that you 
  1218. specify.  Experiment with these curves to see their effects.
  1219.  
  1220. The Repeat popup sets whether you get a single bulge or a repeated 
  1221. (periodic) warping.  "Periodic" repeats the pattern after every 
  1222. period of the currently selected curve.  Vertical center position 
  1223. will then effectively change the phase shift of the resulting wave.
  1224.  
  1225.  
  1226.  
  1227. -------------------------------
  1228. ---===>>>  DITHERING  <<<===---
  1229. -------------------------------
  1230.  
  1231. There are three dithering patterns built into SOL (ordered 1+2 and 
  1232. random dithering).  Others can be loaded into two empty slots.  These 
  1233. dithering patterns are the same as the ones used by GEMview and have a 
  1234. .DIT extension. To load one of these, click on the Load button from 
  1235. the Dither Settings Dialog, choose slot 1 or 2 from the alert box, and 
  1236. select the .DIT file with the fileselector.  Some dither patterns are 
  1237. included in the folder DITHER.
  1238.  
  1239. Click on "Set" next to DITHER PATTERN in the Options Dialog to enter 
  1240. the Dithering Settings.  Here you can see what the different dither
  1241. patterns look like, and set other things.  There are two "folder-tabs" 
  1242. that control dithering patterns for normal and FIS (filter) dithering.  
  1243. Filter dithering does not have contrast or step slider bars.
  1244.  
  1245. When you have the "normal" tab selected, the two sliders control
  1246. the number of dither steps and the dithering contrast.  Slide the
  1247. dither steps bar to see the effect that it may have on your image.
  1248. The dithering contrast sets the maximum contrast that two dithered
  1249. colors can have between them.  This is so that you do not get a lot
  1250. of bright specks in your image.  Play with these settings to see the
  1251. results.  These two slider bars have no effect on when FIS is used.
  1252.  
  1253. For an example, say you wanted to dither a color image to a black 
  1254. and white image.  Do the following:
  1255.  
  1256. 1. Turn off flickering.
  1257. 2. Switch to "Shades" display mode.
  1258. 3. Turn on dithering and set the dithering contrast to 255.
  1259. 4. Reduce the display colors to 2.
  1260. 5. Display the image.
  1261.  
  1262. OR:
  1263.  
  1264. 1. Turn off flickering.
  1265. 2. Turn on dithering and set dithering contrast to 255.
  1266. 3. Switch to "Color" display mode.
  1267. 4. Go to the color editor and fill the palette with black.
  1268. 5. Make the second color white.
  1269. 6. Highlight "Match" and re-display the image for the final result.
  1270.  
  1271.  
  1272.  
  1273. ---------------------------------
  1274. ---===>>>  PREFERENCES  <<<===---
  1275. ---------------------------------
  1276.  
  1277. The preferences dialog can be selected from the Options Dialog by 
  1278. clicking on the "three-bars" button in the upper right corner of the 
  1279. dialog.  The following options are available:
  1280.  
  1281. *** Preferences under the "Settings" tab: ***
  1282.  
  1283. >> Start program is GEM menu mode.  This is mainly for MultiTOS
  1284. users, but it causes the program to start at the desktop menu.
  1285.  
  1286. >> Warn of lost colors due to contrast.  This puts up an alert box 
  1287. after the colors are reduced if the palette has not been completely 
  1288. filled.  This occurs when the contrast is too high or fewer colors 
  1289. are created by complex transformations.  The number of lost colors 
  1290. are shown in the alert box.
  1291.  
  1292. >> Fit image to screen on loading.  This stretches (or shrinks)
  1293. the image to fit the screen automatically when the image is loaded
  1294. in.  It still keeps the proportions of the image, so at least one
  1295. side is guaranteed to be as wide (or as long) as the screen.
  1296.  
  1297. >> Display image on loading.  This displays the image directly after 
  1298. loading it without going to the Options Dialog or GEM menu.
  1299.  
  1300. >> Store histograms for each picture.  If this is selected, then
  1301. when the program is re-run, it will allocate histogram memory for
  1302. each image.  Otherwise, the histograms will be common to all
  1303. images, and if you make a change in one color histogram, it will
  1304. effect the colors of the other images in memory.
  1305.  
  1306. >> Capture options dialog.  This helps to speed up flipping
  1307. to-and-from the Options Dialog by capturing the screen so that it
  1308. doesn't have to re-draw it, which can take time.  This does take up 
  1309. some memory to store the screen.
  1310.  
  1311. >> Show image comments if supported.  This will show the comments
  1312. in an image when you load it if the image supports comments.  GIF 
  1313. and JPEG images contain comments.
  1314.  
  1315. >> Force "byte planes" in 256 colors.  Does just what it says if
  1316. selected.  See the "GRAPHICS CARDS" section for more information.
  1317.  
  1318. >> Blank screen while drawing image.  This displays a blank screen while
  1319. an image is being drawn to the screen.  When the image is done 
  1320. drawing, the image appears instantly.  This is used mostly for 
  1321. slideshows.
  1322.  
  1323.  
  1324. *** Preferences under the "Truecolor" tab: ***
  1325.  
  1326. >> Truecolor Palette Conversion.  This popup selects the type of 
  1327. color conversion that SOL uses for loading in JPEGs.  "2-Pass 
  1328. Octree" is the best and uses an octree data structure to accurately 
  1329. convert the truecolor image for display.  This method takes three 
  1330. times the final memory for temporary storage than is required for 
  1331. final storage of the image when displayed.  "Fixed Palette" is 
  1332. quick, fast, and takes only the memory needed for the final image, 
  1333. but can be grainy.  "Greyscale" is even faster, uses little memory, 
  1334. and is as smooth as it gets, but is, well, not colored.
  1335.  
  1336. >> No Dithering/Standard/Error-Diffusion.  This selects the type of
  1337. dithering and turns dithering off and on for truecolor conversions
  1338. while loading in JPEG images.  Error-Diffusion dithering is not
  1339. supported as of this version.  No dithering is the same as random
  1340. dithering only when using "Fixed Palette" conversions.  No dithering
  1341. is much faster when using "2-pass Octree" conversion, but does not
  1342. produce as nice results.
  1343.  
  1344. >> Truecolor Dithering.  This popup selects the current dither pattern 
  1345. used for "2-pass Octree" and "Fixed Palette" conversions. Loading a 
  1346. dither pattern can be done from within the Dither Settings Dialog, and 
  1347. can then be accessed from the Preferences Dialog for use in truecolor 
  1348. conversions.  Previous version of SOL used only random dithering for 
  1349. fixed palette conversion, but standard dither patterns can now be used 
  1350. for better (or just different) results.
  1351.  
  1352. >> Octree Pixel Coverage.  With this popup you can select the 
  1353. percentage of the image that will be examined when building the 
  1354. octree colormap.  The smaller percentage used, the less accurate the 
  1355. results will be, but the conversion will be much faster.  Low 
  1356. percentages (5% or 10%) are good for most viewing purposes.
  1357.  
  1358. >> Fixed Palette Principal Colors.  This popup selects which colors 
  1359. will be most abundant in the fixed palette.  Older versions of SOL 
  1360. used the "Red-Green" palette, which is best for most images.  There 
  1361. are a fixed number of bits available for use in the fixed palette, 
  1362. so this popup menu effectively determines how the bits are 
  1363. distributed to the red, green, and blue color-planes.  The following 
  1364. table shows how much resolution each selection distributes:
  1365.  
  1366. Fixed Palette       Red          Green        Blue
  1367. -------------       ---          -----        ----
  1368. Red                 16 shades    4 shades     4 shades
  1369. Green               4 shades     16 shades    4 shades
  1370. Blue                4 shades     4 shades     16 shades
  1371. Red-Green           8 shades     8 shades     4 shades
  1372. Red-Blue            8 shades     4 shades     8 shades
  1373. Green-Blue          4 shades     8 shades     8 shades
  1374.  
  1375. Red, Green, and Blue fixed palettes produce a much grainier and 
  1376. lesser-quality image than the Red-Green, Red-Blue, and Green-Blue 
  1377. palettes do because of the uneven distribution, and therefore should 
  1378. be used rarely under normal circumstances.
  1379.  
  1380. >> Inverse Colormap Resolution.  This popup sets the number of bits 
  1381. of resolution used in the inverse colormap.  The inverse colormap is 
  1382. used with "2-pass Octree" truecolor conversion as well as with color 
  1383. Filtered Image Scaling (FIS).  4 bits can be used for most purposes 
  1384. (requiring only 20K bytes of extra memory) but is best with 
  1385. dithering.  5 bits produces quite good results, but takes a little 
  1386. longer to calculate and requires over 100K bytes of extra memory.  I 
  1387. recommend 5 bits for most images, if you can wait.  The extra 
  1388. temporary memory required for the inverse colormap is displayed 
  1389. underneath this popup menu when you select a new resolution.
  1390.  
  1391.  
  1392. *** Load/Save/Accept Buttons: ***
  1393.  
  1394. >> Load preferences.  This loads a preference file.  Display
  1395. parameters are only set if you saved the preference file in the same
  1396. resolution.  Other settings are loaded regardless of the resolution.
  1397.  
  1398. >> Save preferences.  Save the current preferences to a file.  The
  1399. file SPOFLT35.PRF is automatically loaded in when the program is
  1400. run, but you can save the preferences to other files.
  1401.  
  1402.  
  1403.  
  1404. -----------------------------------------
  1405. ---===>>>  COLORS TO PLAY WITH  <<<===---
  1406. -----------------------------------------
  1407.  
  1408. Switch to "complex" color transformation histograms, click on the 
  1409. red arrow above them to make them all one-to-one, then try these 
  1410. tricks for awesome effects:
  1411.  
  1412. >> FLIP the green histogram and display the image for a NEON effect.
  1413.  
  1414. >> FLIP the red, green, and blue planes in different combinations 
  1415. for interesting "inverted" effects.
  1416.  
  1417. >> Use gamma correction (value from 0.5 to 0.8) on the red histogram
  1418. (leave green and blue at one-to-one) to brighten the reds.  This
  1419. produces a warmer image.  Brighten the blue plane instead for a
  1420. colder image.  Brighten the green image for an algae look. =)
  1421.  
  1422. >> Try experimenting with some of the histograms in the folder 
  1423. HISTGRMS included in the SPOFLT35.ZIP.  Try these in separate planes 
  1424. and with different combinations.
  1425.  
  1426.  
  1427.  
  1428. ------------------------------------
  1429. ---===>>>  GRAPHICS CARDS  <<<===---
  1430. ------------------------------------
  1431.  
  1432. Speed of Light version 3.8 was programmed to work mainly on standard 
  1433. Atari graphics hardware, but it does work on some graphics cards.
  1434. SOL v3.8 was tested on NOVA graphics cards and ONLY works in 256
  1435. color modes.  Other graphics cards MAY work, but you have to
  1436. manually tell the program that you have one...
  1437.  
  1438. Most graphics cards store their screens in a byte-plane format as 
  1439. opposed to the Atari format (bit-planes), so if you have a graphics 
  1440. card, you can see if it will work in byte-plane format by selecting 
  1441. "byte-planes" in the Preferences Dialog.  Make sure you are in a 256 
  1442. color screen resolution.  Flickering will be shut off if in
  1443. byte-plane mode.
  1444.  
  1445. Any saving "As Original" will work with graphics cards, but the only 
  1446. saving that works "As On Screen" is GEM (X)Image format and GIF
  1447. format.  Saving "As On Screen" can be done by using the "Image = 
  1448. Screen [X]" option from the Display Screen.  See the "SAVING IMAGES" 
  1449. section for more information.
  1450.  
  1451.  
  1452.  
  1453. ------------------------------------
  1454. ---===>>>  KNOWN PROBLEMS  <<<===---
  1455. ------------------------------------
  1456.  
  1457. When reporting bugs to the author, make sure your bug is not listed 
  1458. below!  These problems are already known to the author:
  1459.  
  1460. * Flickering acts funny on Falcons due to unknown hardware
  1461. incompatibilities.  This is not really a SOL bug.
  1462.  
  1463. * Flickering does not look too well in MultiTOS due to slowdown.  
  1464. Giving SOL more processor priority usually helps.  This is not a SOL
  1465. bug, you just need a faster machine! <grin>
  1466.  
  1467. * The clipping and zooming boxes in 4-color and 2-color modes leave 
  1468. junk behind when you move the mouse.  This does not change the image 
  1469. in memory, only on screen.  Just press 'R' to redraw the image if the
  1470. lines are still left behind when you finish clipping.
  1471.  
  1472. * Error handling is not as good as it could be...when you get a disk 
  1473. full error, the program quits!
  1474.  
  1475. * Image reduction while loading is not supported in version 3.8 as 
  1476. it was in version 2.6 due to problems.  Future versions may include 
  1477. it, but it is recommended that users of low-memory systems use 
  1478. version 2.6 to view large GIF images.
  1479.  
  1480.  
  1481.  
  1482. ------------------------------------
  1483. ---===>>>  FINAL COMMENTS  <<<===---
  1484. ------------------------------------
  1485.  
  1486. Speed of Light version 3.8 represents over three years of very hard
  1487. work.  I would like to thank Dan Aylward for his help in testing.  I
  1488. would also like to thank all of those who registered for version 2.x
  1489. and version 3.x early on...here it is!  Finally!  Hope it lived up to 
  1490. your expectations!  If you have not registered yet, please do!  Your
  1491. support helps me bring more quality software to the Atari platform.  
  1492. Since Atari computers are a dieing breed (*sniff*), Shareware is the 
  1493. only reliable source of good software, so if you see something you 
  1494. like, SUPPORT IT BEFORE IT IS TOO LATE!!!
  1495.  
  1496. During November of 1993, MajicSoft, under the hands of John Stewart, 
  1497. accidentally (so I was told...) leaked a copy of Speed of Light 
  1498. version 3.0 into the Public Domain.  If you or anyone else finds or 
  1499. has a copy of this beta-test version, please delete it immediately. 
  1500. It is very buggy and is an out-of-date copy, as well as NOT being a 
  1501. Public Domain OR Shareware version of SOL.
  1502.  
  1503. For a list of other software available or soon to come by StuSoft, 
  1504. see the file SOFTWARE.DOC included with this ZIP file.
  1505.  
  1506. Enjoy Speed of Light 3.8, and please register!
  1507.