------------------------------------- ************************************* ------------------------------------- C P I C © Copyright 1990 by Thomas Zipproth Dr. Jochner Weg 10 8948 Mindelheim Germany Tel. 08261/4838 -------------------------------------------------------- Programs and procedures for an efficent handling of Pictures and graphics in connection with the CPic - Format V 1.0 (first release) Short version of the german documentation --------------------------------------------------------- Copyright: All programs and sourcecodes of the CPic package in exception of the module CPicSupport (.mod .sym .obj .def .asm) are Freeware. CPicSupport is Shareware. I think about 10 $ are correct. (If this is not possible I would also be glad about a disk with good pictures (of course in the CPic - Format) or something like that). No commercial use of CPic is allowed without my written permission. Short Overview: CPic (Crunched - Picture) is a graphic - format wich allows an efficient handling of pictures and graphics. The main advantages are the better compressing - algorithm which reduces the length of IFF-ILBM Files about 10 - 60 % (especially in connection with the Palette - Program), the high speed of decrunching and the possibility to load crunched Pictures direct from Memory. You can hold a large amount of graphics in memory (in form of the com- pressed CPic - Format) and directly and very fast load from there. You can convert the IFF-ILBM format into the CPic-Format and convert the CPic - Format back into the IFF - format. CPic saves only the Picture - data, other information like color - cycling is lost. The package includes the CPicSupport - Import Modul which contains proce- dures to load and save the CPic - format (with many possibilities and op- tions), programs for converting, displaying and optimizing, and demo - programs for the procedures in CPicSupport. --------------------------------------------------------------------------- The whole package: CPic.dok German documentation. CPic.doc English documentation. CPicSupport : CPicSupport.def CPicSupport.mod CPicSupport.sym CPicSupport.obj The procedures which you can import. CPicSupport.asm The assembler - Sources. CPicSupport.dok German documentation of CPicSupport. CPicTools : CPic Converts the IFF - format into the CPic - format ( CLI ) ILBM Converts the CPic - format into the IFF - Format ( CLI ) Disp Shows CPic - Pictures. (CLI + WB) Disp.info Show Picture - show program for CPic - pictures. (CLI) Palette Optimizes compression of CPic - Files. (CLI) CPicTools.dok German documentation of CPicTools. CPicDemos : Speed Demo - program. Speed.info Speed.mod M0 M1 M2 M3 M4 M5 M6 M7 Pictures used from Speed. Colors1 Demo - program. Colors1.mod Colors2 Demo - program. Colors2.mod C1 C2 C3 C4 Pictures used from Colors. Picture.CPic Demo - picture. CPicDemos.dok German documentation of CPicDemos. CPicSource : CPic.mod Sourcecodes of the CPicTools - Programs. ILBM.mod Disp.mod Show.mod Palette.mod ToolSupport.def ToolSupport.mod ToolSupport.sym ToolSupport.obj --------------------------------------------------------------------------- CPicTools : (If the arguments from CLI are not explained call the programs without arguments or refer to the Sourcecode - Headers.) CPic : This program converts the IFF-ILBM format into the CPic-format. It auto- matically searches the smallest rectangle which contains all picture - data (every pixel which is not from the color of the background) and saves it together with all information about the Screen (bitmap and viewport) in which the rectangle is (for example Viewmode). This rectangle is efficient- ly compressed and saved together with a variable from the type CPicInfo as Fileheader which contains all information (Size of screen and position of left upper corner of the rectangle and its size). Only the picture - data is converted, other information like color-cycling is lost ! Important !!! --------------------> Everything which has to do with the X - Axis works only with Byte - values. This means that you can save and load rectangles with the CPicSupport - procedures only in 8 - pixel steps. You can save a rectangle starting from byte 0 wich means pixel 0, byte 1 which means pixel 8 and so on. You have to stop at byte 1 which means pixel 7, byte 2 which means pixel 15 and so on. So the width of the rectangle always can be divide through 8 which means a number of bytes. In CPicSupport every variable which has to do with the x-Axis means byte - steps and not pixel - steps. The reason is efficiency. In most cases this restriction is not a disadvantage. (You can also blit a rectangle on an other bitmap and save from there). In the y-Axis everything is normal. IF the Screen (Bitmap) is empty, the whole Bitmap is saved. The output of the program : Screen : 320 * 200 * 4 CPic : ( 0 12 ) 14 * 88 = 1232 Byte for one Plane Crunched Planes : 792 788 732 569 / 3013 This means : The Screen which was used has the size 320 * 200 Pixel and 4 bitplanes. The left upper corner of the rectangle located in the Screen is at (0 12) which means byte 0 in the x - axis and row 12 in the y - axis. The size of the rectangle is 14 bytes (= 112 pixel) * 88 pixel. One bitplane of the rectangle has a size of 1232 Byte. At last the length of the crunched bitplanes and the length of the whole file are displayed. -------------------------------------------------------- ILBM : Converts the CPic - Format into the IFF - Format. As result you have exactly the same IFF - Picture as before converting it into the CPic - format with the program CPic. (But only the picture - data, not information like color - cycling !). -------------------------------------------------------- Disp : Shows a CPic - picture (One Argument from CLI or WB). If you want to pull down the screen, first press the left mouse button and then the right without releasing the left. Now release first the left mouse button and then the right. (This sounds more complicated than it is). Now the screen bar appears permanently. The same again will let him disappear. To stop the programm, click on the left side of the picture or press the Esc - button. -------------------------------------------------------- Show : Slideshow - programm : Show