home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PROG_PAS / XLIB_TP5.ZIP / BEX / BEX.DOC next >
Text File  |  1993-12-28  |  10KB  |  222 lines
  1. bex v0.2a
  2.  
  3.  
  4. ( I'm a German with basic knowledge in english. If you want to
  5.   correct and post back this documentation  I would be happy. )
  6.  
  7.     email : harms@minnie.informatik.uni-stuttgart.de
  8.  
  9.  or real adress : Christian Harms
  10.                    Holbeinweg 6
  11.                   71229 Leonberg
  12.                  GERMANY - EUROPE
  13.  
  14.  
  15.  
  16. Well, well, well, this is another Bitmap-Editor for/in Mode X : BEX.
  17.                                   ─      ─                  ─
  18.  
  19.  
  20.   0.  BackGound-Information
  21.   0.1 History
  22.   1.  Introduction
  23.   2.  MainScreen                 1st Screen to Paint
  24.   3.  Pal - Menu
  25.   3.1 Palette-Screen             change Color-Table
  26.   4.  Tools - Menu               Tools like Rotate,Zoom, Get/Put ...
  27.   5.  Clipboard                  manage many Bitmaps on RAM-Cache
  28.  
  29. 0. BackGround-Information
  30.  
  31.   [Future on] 
  32.   Ok, but why v0.1, if this a ready program ?
  33.   Hmm, well : I want to make a Sprite-Animator and the first,little
  34.   step is this Sprite-Editor, and later (I dont know when), I will
  35.   program v1.0. And then, you will find BEX as one menu-point in
  36.   my Animator.
  37.   [Future off]
  38.  
  39.   This Program can be used by Mouse or Keys, Mouse is better.
  40.   Every Click on a Button (for example) with the Mouse emulates
  41.   a keycode. So - it was very easy to program these many Buttons.
  42.   
  43.   Every time, you can abort functions with ESC !
  44.  
  45.   Ideas - post it to my email-number.
  46.   If you are interested in the XLib for Turbo Pascal, wait until second 
  47.   half of October,93. OK, XLib are now real TP-Units ( with asm; ... ), 
  48.   but Button-Manager, 16x16-Font and so on are new.
  49.  
  50.  
  51. 0.1 History
  52.   
  53.   v0.1 OK, take all features, and sub all of v0.2... and you see, what
  54.        for functions was in v0.1 .
  55.   v0.2 Tools-Menu split in Tools-Menu (Pixel-functions) and Pal-Menu
  56.        (Color-functions). Added SOFTENING and Mode-Button for RGB or 
  57.        16x16-palette in Pal-Menu. Mode (Grafic modes of XLib) added
  58.        to Tools-Menu. Bugs in ClipBoard fixed.
  59.        Also new, painting with mouse from Tools-and-Pal menu.
  60.        Reading Gif and PCX-Pictures.
  61.        Good Looking Help-Screen from every Menu by pressing F1.
  62.  
  63.  
  64. 1. Introduction
  65.  
  66.   I named this editor "Bitmap Editor for Mode X" or short "BEX" .
  67.   
  68.   If exist a file "BEX.PAL", it will be loaded. If the Size min.
  69.   6 Bytes more then the real Palettes-Size (256*3), then are these 
  70.   six Bytes the Numbers of Gray0 to Gray5 for the Buttons, Text 
  71.   and so on. If no file exists, a "optimal 6-7-6 RGB-Color-Table" 
  72.   will be set as default. ( This Palette is also used by PhotoStyler 
  73.   for Windows, and you can design wounderful Pictures and save them with 
  74.   this Palette. )
  75.  
  76.   I used the PBM (Planar Bitmap) Format of Themie Goutas - XLib
  77.   Maximal Size are 250x250, for Rotate only 125x125 (more will forget).
  78.  
  79.   Usage :
  80.  
  81.   bex <filename> or   bex
  82.  
  83.  
  84. 2. MainScreen 
  85.  
  86.   MOUSE:
  87.   In the Zoom-Window of the bitmap, you can put a pixel with the left
  88.   Mouse-Button and get the color of a pixel with Right. Color are able 
  89.   to be chosen from the palette in the upper,right corner by pressing 
  90.   a Mouse-Button, too. Other options are able to be activated by Buttons. 
  91.   2,4,6,8 are the directions of the Numeric Keypad and it can have scrolled 
  92.   large pictures with the left Mouse-Button.  Horizontal Scroll is in 
  93.   Zoom 4 or 8 not so slow as in the other Zooms. If you activate the 
  94.   Scrooool-Buttons with the right Mouse-Button, it will scroll to the 
  95.   border of the Bitmap.
  96.   "Dir" is self-explaining. 
  97.   "Load" : First, you have to choose the file format and type the name.
  98.   Extension will added if necessary. After loading GIF and PCX the
  99.   picture with own color-palette will matched with actual palette. Results 
  100.   are better with RGB-like palettes then normal 16x16-painting-palettes.
  101.   Special palettes (XLoad in palettescreen) are the best way for best colors.
  102.   "Save" : like Load ...
  103.  
  104.   After having activated the "sIze"-Button you can change the save-Size 
  105.   of your Bitmap (See also "X"/"Y" in Tools-Menu). 
  106.   Click Left on the Pal-Button, you go into the Palette-Screen. With Right,
  107.   you can flip between two different Display-Modes of the Palettes. 
  108.   1st is the normal one of my RGB-Palette, 2ed is a 16x16-Display for
  109.   all other palettes (like Yak-Pal and so on.)
  110.  
  111.   KEYBOARD:
  112.   Using the cursor-keys, you can move a little Cursor. By pressing Space,
  113.   you Put a pixel, Enter, you get the pixel-color as actual Color. 
  114.   "+" Increases the actual Color, "-" Decreases the Color (Ok, it's stupid,
  115.   but If you have an other (simple) idea ?).
  116.   "sIze": Move the cursor to the new corner, an press I and the new borders
  117.   will be set.
  118.   Scrooooling: You can scroool the Bitmap with the numeric keypad, if NumLock
  119.   is lightend. Scroll to the End/Begin of the Bitmap, use PgUp,PgDown for 
  120.   Y-, Home/End for X-direction.
  121.   Buttons can be activated by big characters: L,S,D,T,I,P
  122.   With F10  you can change the Pal-Mode (See Pal-Menu).
  123.   After pressing "L", you can choose format by P,B,G or X.
  124.   Press F1 to open the Help-Screen.
  125.  
  126. 3. Pal - Menu
  127.   
  128.   MOUSE:
  129.   "big": If you have too sparse lines, you can make it bigger. By every
  130.   point all 4 neighbours will be filled with the Point-color if the are
  131.   in color 0.
  132.   "out": You can make Outlines for Sprites. It makes a comic-effect like
  133.   Commander Keen. Left Mouse-Button makes a little, Right Mouse-Button
  134.   a big OutLine in the actual color.
  135.   "Soft" : I had seen the "SOFTENING" in a big, prof. Picture-Designer.
  136.   The mathematical background was ready quickly , but a fast technic was
  137.   this not. With "<-" and "->" you can move the curv of the exp-function.
  138.   X-axis is radius from the pixel to the neighbours, Y-axis in *10% the
  139.   factor for the summ of the new color.
  140.   Softening with a loaded gif/pcx with matching palette do nothing.
  141.   "Mode" : The default RGB-palette is a 6-7-6-level palette and it will
  142.   showed in a 36x7 Array with separate 4 Gray-Colors. The normal palette
  143.   is showed al a 16x16-Array, because the first 16 colors are gray, next
  144.   red,green,blue,yellow and so on. Mode can be activated with rigth-click
  145.   on "Pal"-Button.
  146.   "Edit" jump into the palette-screen.
  147.  
  148.   KEYBOARD:
  149.   The two Outlines can be chosen with "O" and "o", "big" with "B" and "b".
  150.   Mode can activated from MainScreen with F10.
  151.   Press F1 to open the Help-Screen.
  152.  
  153.  
  154. 3.1 Palette-Screen
  155.  
  156.   MOUSE:
  157.   On the Colors, you can choose it by pressing into the Color-Array.
  158.   If you want to decrease the Red/Green/Blue-Part of the actual color,
  159.   activate the Button with the Left-Mouse-Button, Increase with the
  160.   Right Mouse-Button.
  161.   With the Buttons "Gray0" to "Gray5" you can change the Menu-Colors.
  162.   Save, Load and Directory are not to be commentated (I hope it.)
  163.   "Save" will save Color-Numbers of Gray0 to Gray5 after the Palette-Data,
  164.   too (see also 1.Introduction).
  165.   "Xload" load a palette directly fron the a images. You have to say
  166.   the name of the picture and the start-index of the palette. 
  167.   "Reset" will set the default RGB-palette.
  168.   "Match & Ok." will match actual Bitmap with the changed palette.
  169.   "Match all & Ok." will match actual Bitmap and Bitmaps on the Clipboard.
  170.   "Ok." set the palette - diff. colors in actual Bitmap could be.
  171.  
  172.   KEYBOARD:
  173.   The actual Color can be changed by the cursor-keys, the "Red"/"Green"/
  174.   "Blue"-Parts can be increased by the "r","g","b" and decrease by
  175.   "R","G","B". With "0".."5" you can change the Menu-Colors.
  176.   And with "L","S","D" you can Load,Save and show the Directory
  177.   for other Palettes-Files (most *.pal).
  178.   Other Keys : "X","E","M","A","O"-ESC
  179.   Press F1 to open the Help-Screen.
  180.  
  181.  
  182. 4. Tools - Button
  183.  
  184.   MOUSE:
  185.   "+" and "-" are the Buttons to Zoom, Unzoom the Big Bitmap, very
  186.   usefull in higher resolutions.On the "X"- and "Y"-buttons you can change
  187.   the Pixel-Width/Height of the Bitmap (2-250).
  188.   With "<->" and "v^" can flip the Bitmap horizontal/vertical.
  189.   Ok, "Fill" : Click in a area, and this area will be filled with actual
  190.   color. The Fill-Algorithm don't run over the (X,Y)-Border.
  191.   "Clear" will the Bitmap fill in the (X,Y)-Border with the actual color.
  192.   And "Rot" is a dirty Rotate-function with a Range of 1-359, but one-step-
  193.   Angle.
  194.   "Get" : You can save a rectangular area out of the Zoom-Window at disk,
  195.   and if possible (System-Memory), cache to the clipboard.
  196.   "Put" : choose one Bitmap from the clipboard and have put it to the
  197.   position you pointed to (see more 5. CLipboard).
  198.   "Mode" : In the menu you can select with clicking on the line the Mode X-
  199.   graphic mode. These are the some modes from XLib.
  200.  
  201.   KEYBOARD:
  202.   "+","-","X","Y","<->","v^" look under MOUSE.
  203.   "Fill" will fill on Cursor-Position with actual Color. Clear will the
  204.   Bitmap in the (X,Y)-Border have filled with the actual color.
  205.   "Get" and "Put", you can choose the Corners with Mouse or Keyboard.
  206.   "Mode" : Move with the cursor-keys in the row and select with Enter or Space.
  207.   Press F1 to open the Help-Screen.
  208.  
  209.  
  210. 5. Clipboard
  211.  
  212.   MOUSE :
  213.   Here you can choose a Bitmap by pointing on the Name-Button and get it
  214.   with the "Get"-Button. New bitmaps can be added to the Clipboard with "Load".
  215.   "Kill" will the actual bitmap kill from the Clipboard-list.
  216.   ESC will abort Clipboard and "Ins".
  217.  
  218.   KEYBOARD:
  219.   The first ten Bitmaps can be shown with "0".."9"-Keys. Other with "+" and "-".
  220.   "Get" can be activated with "G" or Enter. Other Keys: "L","S","D","K".
  221.  
  222.