home *** CD-ROM | disk | FTP | other *** search
/ Kompuutteri Kaikille K-CD 2001 #5 / K-CD_2001-05.iso / LiquidPaint / LIQUIDP.TXT < prev    next >
Text File  |  2000-05-16  |  12KB  |  253 lines

  1. Liquidpaint (c)2000 Christopher Emirzian
  2. Based on Rainbox by Alex Rosen
  3. GIF Loader by Paul Bartrum
  4.  
  5. Webpage: http://rydia.net/udder/prog/lp.html
  6. E-mail: divinebovine@netzero.net
  7.  
  8. Release version 3.0
  9.  
  10.   Liquidpaint is a DOS paint program written in DJGPP, using the Allergo graphics library.
  11. It uses pallete animation to give images the appearance of movement.
  12.  
  13.   Liquidpaint allows you to create mesmerizing displays of flowing colors in seconds.
  14. With it's many options and settings, it is easy to make something creative and 
  15. different each time.
  16.  
  17.   Liquidpaint is based on Rainbox, made by Alex Rosen.  Rainbox is for the Macintosh.
  18. I created Liquidpaint because I felt many people could enjoy a similar program on PC as
  19. well as Mac.  Also, Rainbox kix butt :) Over the course of it's development, Liquidpaint
  20. met and rose above Rainbox.  I hope you enjoy my hard work :)
  21.  
  22. Thanks go to:
  23. Alex Rosen, for making Rainbox, sending me source code, and inspiring me to write Liquidpaint :)
  24. Shawn Hargreaves, for making Allegro, thus making Liquidpaint a possibility
  25. Paul Bartrum, for the GIF loader, and lots of suggestions :)
  26. Peter Wang, for the Allegro PNG wrapper code
  27. Josh Munce, for the shroom icon, Kitsune, for fanfare @_@;;, my bro Matt for dealing with endless windoze crashes
  28. And all the people I bugged to test Liquidpaint out on their computers :)
  29.  
  30. Requirements: 
  31.   Monitor + video card capable of displaying 640x480, 256 colors
  32.   486 or higher
  33.   4MB RAM
  34.   Mouse + Keyboard
  35.   An active right side of the brain :)
  36.  
  37. Warning
  38.  
  39. Since Liquidpaint can create moving colors and images at very high speeds, there is the
  40. possibility of creating seizure-inducing images.
  41. I have taken all steps possible to make Liquidpaint safe.
  42. I take no responsibility for any injuries related to using Liquidpaint.
  43. You have been warned!
  44.  
  45. Basics
  46.  
  47. To draw in Liquidpaint, hold the mouse button and drag around the screen.
  48. Using the second mouse button will create different effects.
  49.  
  50. Keys
  51.  
  52. ESC=quit
  53. SPACE=Show/hide toolbar
  54.  
  55. F5=QuickSave=Saves a file to disk, using the last filename used with Save.
  56. F6=QuickLoad=Loads a file from disk, using the last filename used with Load.
  57.  
  58. Toolbar
  59.  
  60.   The toolbar contains all the commands that can be used in Liquidpaint.  Each key has a 
  61. corresponding shortcut key.  The toolbar will automatically hide itself while drawing.
  62.  
  63. Toolbar buttons / Shortcut key
  64.  
  65. Key=1 Undo=undo/redo last draw command
  66. Key=2 Reverse=changes direction of pallete rotation
  67. Key=3 Geometric=Mirrors drawn tool/shape
  68. Key=4 Pause=Pauses pallete animation.  Pausing will also make any drawing operation insanely fast :)
  69. Key=5 Alternate Tools=Will create different effects.  Try fooling around with it :)
  70. Key=6 Line Paint=When used with shapes, causes shapes to be drawn much smoother.  This works better when used with smaller shapes.  This also causes the color sync to be slower by half.
  71. Key=7 Splotchy=Shape is random in size and location
  72. Key=8 Swirly=Shape is rotated in a circle.  Hold down Z to reverse the rotation.
  73. Key=9 Wiggly=Shape size shrinks and grows in a loop
  74. Key=0 Black=Sets color to black
  75. Key=- White=Sets color to white
  76. Key=+ Solid Color=Sets color to solid (nonflowing) color.  Also effects tools.
  77. Key=\ Two Tone=When used with shapes, creates a second smaller shape on top that is slighty different in color
  78.  
  79.       Save=Saves a file to disk.  Files are saved as 256 color PNG.
  80.       Files are saved into directory 'saved'.
  81.  
  82.       Load=Loads a file from disk.  You can load any 256 color PNG, GIF, PCX, BMP or TGA.
  83.       Files are loaded from directory 'saved'.
  84.       Use the pretty file window to select a file. :)
  85.  
  86.       Liquidpaint will automatically create the directory 'saved' if it is not found at startup.
  87.  
  88. Key=F1 Color=Opens up Color toolbar
  89. Key=F2 Size=Opens up Size menu
  90. Key=F3 Clear=Opens up Clear toolbar
  91. Key=F4 Shape=Opens up Shape toolbar
  92. Key=Q Grid off=Turns off grid
  93. Key=W Grid 10=Turns grid to 10
  94. Key=E Grid 20=Turns grid to 20
  95. Key=R Grid 40=Turns grid to 40
  96. Key=T Grid 80=Turns grid to 80
  97. Key=Y Transparency 100%=Turns transparency to 100% (opaque)
  98. Key=U Transparency 75%=Turns transparency to 75%
  99. Key=I Transparency 50%=Turns transparency to 50%
  100. Key=O Transparency 25%=Turns transparency to 25%
  101. Key=[ Speed up=Raises overall speed of Liquidpaint.  Starts at maximum speed.
  102. Key=] Speed down=Lowers overall speed of Liquidpaint.
  103.       Click a couple of times, and the colors will be oozing down your screen :)
  104.       This also slows the speed of drawing.  Make it run as slow as your old Mac.. yay :)
  105.  
  106. Color toolbar buttons
  107.  
  108. Invert: Inverts the entire pallete
  109. Color 128: Sets the pallete to use 128 of 128 colors
  110. Color 64: Sets the pallete to use 64 of 128 colors
  111. Color 32: Sets the pallete to use 32 of 128 colors
  112. Light spots: Makes every 16th pallete entry lighter.
  113. Color spots: Makes every 16th pallete entry inverted.
  114.  
  115. The next buttons are the realtime pallete modifiers.
  116. These modify the basic pallete color values in the hue, saturation and value range.
  117. Contrast thrown on as a extra goodie :)
  118.  
  119. Hue up: Raises the speed of the hue increment.
  120.   Clicking this with the 2nd mouse button will reset the hue increment.
  121. Hue down: Decreases the speed of the hue increment.
  122.   Clicking this with the 2nd mouse button will reset the hue.
  123. Saturation up: Raises the saturation value of the pallete
  124. Saturation down: Decreases the saturation value of the pallete
  125. Value up: Raises the value (brightness) of the pallete
  126. Value down: Decreases the value (brightness) of the pallete
  127. Contrast up: Raises the contrast value of the pallete
  128. Contrast down: Decreases the contrast value of the pallete
  129.  
  130. Click the PALLETE button to bring down the list of palletes.  There are plenty to try out :)
  131.  
  132. Size toolbar buttons
  133.  
  134. All these buttons change the current size.  Click the CUSTOM button to enter a custom size.
  135.  
  136. Clear toolbar buttons
  137.  
  138. All these buttons clear the screen, with a paticular effect.  You can undo clears.
  139. Clears are also effected by transparency.
  140.  
  141. The exception to this is the Black New and White New clears.
  142. These clear the screen reguardless of transparency, 
  143. and reset the hue, saturation, value, and contrast to 0.
  144.  
  145. Bonus: Clicking with the 2nd mouse button on the Solid clear will make an Inverted clear
  146.  
  147. Tool/Shape toolbar buttons
  148.  
  149. Line Shape: Creates a line with the current shape and shape settings
  150.   If used with the SHIFT key held down, will create a synchronized line
  151.  
  152. Spiral Shape: Creates a spiral with the current shape and shape settings
  153.   If used with the SHIFT key held down, will create a synchronized spiral
  154.   If used with the CTRL  key held down, will create a slower spiral
  155.   If used with the ALT   key held down, will create a reverse spiral
  156.  
  157. Spiral I: Creates a spiral.  Effected by Alt-Tool.  Cannot be used with Line or Spiral shape
  158. Spiral II: Creates another spiral.  Effected by Alt-Tool.    Cannot be used with Line or Spiral shape
  159.  
  160. Fan: Creates a Spinning fan
  161. Yin Yang: Creates a design that looks like a yin yang
  162. Well: Creates a sunken pool
  163. Spline: Draws random spline curves.
  164. Cloud: Increments the color under it by 1.  Like a plasma effect
  165.   If used with the SHIFT key held down, will create a reverse flowing cloud
  166. Fire: Creates a fire effect.
  167.   If used with the SHIFT key held down, will create a reverse flowing flame
  168.   If used with the CTRL  key held down, will create a rougher flame
  169. Fill: Fills an area with a color.
  170. Text: Allows you to type text on the screen.
  171. Flip Icon X: Flips the icon shape on its X-axis
  172. Flip Icon Y: Flips the icon shape on its Y-axis
  173.  
  174. All other buttons are shapes.  Click the ICON button to bring down a list of icon shapes to use.
  175.  
  176. shapes.gif can be modified to change the appearance of any of the icon shapes.
  177. If this file is missing or damaged, you will not be able to use any icon shapes!
  178.  
  179. During the drawing of a Line or Spiral, press ESC to stop the draw.
  180.  
  181. Tips on loading images:
  182.  
  183. You can load any ol image into Liquidpaint, but it will probabally look like crap unless you do some stuff to it.
  184.  
  185. Liquidpaint animates colors 1-128 of the pallete.  Color 0 is black/transparent, Color 129 is black, 130 is white, and 131 is grey.  132 to 137 are used for file saving purposes.  Any colors past this are ignored.  You should make sure all your colors are within the range of pallete colors 1 to 128, and 0 for black.
  186.  
  187. Your best bet is to convert the image to grayscale, then copy and paste the image into a saved .PNG file from Liquidpaint, saved with the gray pallete.
  188.  
  189. Make sure your imaging software does not optimize the pallete!  This will screw it up!
  190.  
  191. Since Liquidpaint ignores colors 138-255, you can use these as any static (non-changing) color you want.
  192.  
  193. Liquidpaint works great with fractal images and other computer-generated effects. :)
  194.  
  195. How to import Rainbox drawings into Liquidpaint:
  196.  
  197. 1. In Rainbox, choose File:Save As PICT.. and save the file.
  198. 2. Convert this file to a GIF.  Make sure any extras (pallete optimization, dithering, etc.) are turned off.
  199. 3. Copy the file to your PC, and load it in Liquidpaint as you would any other GIF image.
  200. 4. Unfortunatley, Rainbox does not save the entire pallete when saving as a PICT, so you will have to choose one of the predefined palletes.
  201.  
  202. How to import Liquidpaint drawings into Rainbox:
  203.  
  204. What, are you nuts? :) Rainbox and Liquidpaint use very different formats for saving files.  There is no plan for a "Export to Rainbox" command.  Sorry!
  205.  
  206. Extra notes about the file format:
  207.  
  208. Liquidpaint saves information about the pallete settings in pallete entries 132 to 137.
  209.  
  210. pallete entry 132's red value is the pallete type.  1-30 are valid.
  211. pallete entry 132's green value is the number of colors.  1-4 are valid.
  212. pallete entry 132's blue value is the setting for light/color spots.  0-2 are valid.
  213.  
  214. pallete entry 133's red value is the setting for inverted pallete.  0-1 are valid.
  215. pallete entry 133's green value is the hue.  0-180 are valid.  This is multipled by 2 once loaded.
  216. pallete entry 133's blue value is the setting for reversed pallete.  0-1 are valid.
  217.  
  218. pallete entry 134's blue value is the setting for speed.  0-255 are valid.
  219.  
  220. pallete entry 134's red value is the saturation value.
  221. pallete entry 134's green value is the positive/negative toggle for the saturation value.  0 is positive, 1 is negative.
  222.  
  223. pallete entry 135's red value is the value (brightness).
  224. pallete entry 135's green value is the positive/negative toggle for the value (brightness).
  225.  
  226. pallete entry 136's red value is the hue incrementer.  This is divided by 4 once loaded.
  227. pallete entry 136's green value is the positive/negative toggle for the hue incrementer.
  228.  
  229. pallete entry 137's red value is the contrast value.
  230. pallete entry 137's green value is the positive/negative toggle for the contrast.
  231.  
  232. All these numbers are multiplied by 4 in the saved file's pallete.
  233. Example: 4 would be 16.  8 would be 32.
  234.  
  235. Liquidpaint puts a pixel at 0,0 with pallete entry 132.
  236.  
  237. When Liquidpaint loads a file, it checks:
  238. if the pixel at 0,0 is pallete entry 132
  239. if pallete entry 132's red value is less than or equal to 30
  240. if pallete entry 132's green value is less than or equal to 4
  241. if pallete entry 132's blue value is less than or equal to 2
  242.  
  243. If all these are found to be true, it deterimes the file to be saved by Liquidpaint and treats it as such, loading in all values from the pallete.
  244. If even one of these are found to be false, it determines the file to be a custom file.
  245.  
  246. When Liquidpaint loads a PCX or TGA file, it flips the pallete around.
  247. Example: Pallete entry 0 becomes pallete entry 255, and vice versa.
  248.          Pallete entry 5 becomes pallete entry 250, and vice versa.
  249.  
  250. Notes about .SPR file format:
  251.  
  252. .SPR is a custom image file format made by me.
  253. If you need more information on SPR files, E-Mail me.