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