home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / PROG / RMAST37.ZIP / RM.DOC < prev    next >
Encoding:
Text File  |  1993-09-04  |  11.9 KB  |  323 lines
  1.                        Raster Master V3.7
  2.  
  3.           (c) Copyright 1991-93 by Blueview Software.
  4.                       All Rights Reserved. 
  5.  
  6.  
  7.  
  8.  
  9.  
  10. Introduction...
  11.  
  12.   Raster Master is a powerful sprite/icon editor that allows programmers to
  13.   create and edit small images. Raster Master can edit images from 1x1 pixels
  14.   up to 100x100 pixels. Images can be saved in standard PCX format or as source
  15.   code. Raster Master was designed to work in conjunction with other toolkits
  16.   and graphic libraries. This includes Fastgraph and TEGL Windows Toolkit as
  17.   well as the standard graphic libraries for Turbo C, QuickC, Turbo Pascal, and
  18.   QuickBasic.  Additional BMP and ICO formats are supported for Windows 3
  19.   programmers.
  20.  
  21.  
  22. Requirements...
  23.  
  24.   VGA Card, SVGA optional for the 256 color mode
  25.   Mouse
  26.   DOS 3.0 or higher
  27.  
  28.  
  29. Customer Service...
  30.  
  31.      If you have any questions, comments, or suggestions,
  32.      Blueview Software can be contacted by:
  33.  
  34.      Voice - (416) 757-7944
  35.  
  36.      BBS   - Baudeville BBS (416) 283-0114
  37.            - Leave message to NICK ONOUFRIOU in the main conference.
  38.  
  39.      Shareware Conferences - RIME, INTELEC, NANET, CITY2CITY, FIDONET,
  40.                              and ILINK. Leave message to NICK ONOUFRIOU.
  41.  
  42.      Internet: nick.onoufriou@bville.gts.org
  43.  
  44.      Fido net-mail: 1:250/304
  45.  
  46.      Surface Mail  - Blueview Software
  47.                      2300 Lawrence Ave. East BOX 80551
  48.                      Scarborough, Ontario
  49.                      CANADA  M1P 2R0
  50.  
  51.      NOTE: All mail _will_ be answered. If you do not receive a reply
  52.            within a few days please try again, mail does get lost.
  53.  
  54.  
  55.  
  56. Using the editor...
  57.  
  58. OPEN/SAVE:  Click in the FILENAME area and type in the name.
  59.  
  60. Any FILE in the FILE LISTING can be selected by simply pointing to it.
  61.  
  62. DIRECTORIES can be accessed in one of two ways. Either by changing the contents
  63. of the DIRECTORY area or pointing to the actual directory in the listing.
  64.  
  65. CHANGING THE OPEN FORMAT: Press the RIGHT mouse button over the OPEN gadget.
  66.  
  67. CHANGING THE SAVE FORMAT: Press the RIGHT mouse button over the SAVE gadget.
  68.  
  69. Use the up and down gadgets to select the new format.
  70.  
  71.  CLR       Clears the screen.
  72.  
  73.  UNDO      Deletes last step taken.
  74.  
  75.  GRID      Toggles the grid ON/OFF.
  76.  
  77.  SIZE      Allows you to select the size of the zoom area. 25x25, 50x50,
  78.            100x100 pixels are supported.  The scrollers can be used to move to
  79.            different areas of the image when in the 25x25 or 50x50 zoom mode.
  80.  
  81.  VIEW      Previews  drawing in one of the listed resolutions.
  82.  
  83.  MODE      Toggles between 16 and 256 color mode. Note: ONLY registered users
  84.            will be given the opportunity to save their images in the 256 color
  85.            mode.
  86.  
  87.  EXIT      Exits Raster Master.
  88.  
  89.  CLIP      Switches to clip mode allowing you perform the following functions.
  90.  
  91.            OPEN/SAVE: Works the same way as the OPEN/SAVE described above. When
  92.                       OPENing/Saving, only the clipped area will be affected.
  93.  
  94.            HFLIP/VFLIP: Horizontally/vertically flips the clipped image.
  95.  
  96.            LEFT/RIGHT/UP/DOWN:  Scrolls the clipped image in the appropriate
  97.                                 direction.
  98.  
  99.            EXIT:  Returns to the main menu.
  100.  
  101.  
  102. Drawing tools...
  103.  
  104.       FREEHAND DRAWING  Move the pointer inside the zoom area and click to plot
  105.                         a pixel.
  106.  
  107.       SPRAY PAINT  Randomly plot pixels until release of mouse button.
  108.  
  109.       FLOOD PAINT  Fills an enclosed area with the current color.
  110.  
  111.       ALL remaining tools work by selecting the starting point, dragging the
  112.       mouse, then releasing the mouse button.
  113.  
  114.  
  115. Selecting colors...
  116.  
  117. Simply select  the color of your choice. In the 256 color mode you can scroll
  118. through the remaining colors by pressing on the up or down gadgets.
  119.  
  120.  
  121. Pallete editing...
  122.  
  123. Press the PAL gadget, select a color, use the RGB scrollers and gadgets to
  124. modify the color.
  125.  
  126.  
  127. Adding graphics to your programs...
  128.  
  129.   One of the great features of Raster Master is its ability create images
  130.   compatible with the standard graphic libraries included with Turbo C,
  131.   QuickC, Turbo Pascal, and QuickBASIC. Raster Master also supports additional
  132.   libraries like Fastgraph and TEGL Windows Toolkit. Source code can be
  133.   generated for images, palettes, and mouse pointers.
  134.  
  135.  
  136. 1.  RM RAW               - Raster Master's RAW format.
  137.  
  138. 2.  Palette              - Binary format containing RBG values.
  139. 3.  Palette (C)          - Source code in C for the palette.
  140.                            see demo5.c and demo6.c
  141. 4.  Palette (PAS)        - Source code in Pascal for the palette.
  142.                            see demo3.pas
  143. 5.  Palette (BAS)        - Source code in BASIC for the palette.
  144.                            see demo3.bas
  145.  
  146. 6.  TP/TC (Binary)       - Turbo C/Pascal binary image format to be displayed
  147.                            with the putimage function.
  148.                      
  149.                            see Demo1.c for Turbo C
  150.                            see Demo1.pas for Turbo Pascal
  151.                            For 256 color images you must use the supplied
  152.                            SVGA256.bgi driver.
  153.  
  154.  
  155. 7.  TP Constants         - Turbo Pascal source code for format 6
  156.                            see Demo2.pas
  157.  
  158. 8.  TC Constants         - Turbo C source code for format 6
  159.                            see Demo2.c
  160.  
  161. 9.  QC/QB (Binary)       - QuickC/BASIC binary image format to be displayed with
  162.                            _putimage (QC) or PUT (QB).
  163.                            See Demo3.c for QuickC
  164.                            See Demo1.bas for QuickBASIC
  165.  
  166. 10. QC Constants         - QuickC source code for format 9
  167.                            see Demo4.c
  168.  
  169. 11. BASIC DATA           - QuickBASIC source code for format 9
  170.                            see Demo2.bas
  171.  
  172. 12. TEGL DEF             - TEGL Windows Toolkit text based HEX format
  173.                            Refer to manual and TEGL code for DEF.
  174.  
  175. 13. PPR  Fastgraph       - Fastgraph Packed Pixel Run format. 16 colors or less.
  176.  
  177. 14. SPR  Fastgraph       - Fastgraph Single Pixel Run format. max 256 colors.
  178.  
  179. 15. FG PPR (C)           - C code for format 13
  180. 16. FG SPR (C)           - C code for format 14
  181. 17. FG PPR (PAS)         - Pascal code for format 13
  182. 18. FG SPR (PAS)         - Pascal code for format 14
  183. 19. FG PPR (BAS)         - Basic code for format 13
  184. 20. FG SPR (BAS)         - Basic code for format 14
  185.  
  186.                           Refer to the Fastgraph user and reference manuals.
  187.                           Use the included program xinfo.exe to obtain the run
  188.                           count and width from Raster Master created  SPR and
  189.                           PPR files.
  190.  
  191. 21. Mouse (C)            - C code for mouse image.
  192. 22. Mouse (PAS)          - Pascal code for mouse image.
  193. 23. Mouse (BAS)          - Basic code for mouse image
  194.  
  195.                           When saving in this format only the first 16X16 pixels
  196.                           from the left top corner will be saved. If the image
  197.                           is clipped only the first 16X16 pixels starting from
  198.                           the top left corner of the clipped image will be
  199.                           saved.
  200.  
  201.  
  202.                           The colors black, white, and dark blue are used to
  203.                           build the mouse image. Dark blue will be considered
  204.                           transparent. Any other color is used to indicate that
  205.                           the screen pixel under the mouse image will be
  206.                           inverted.
  207.  
  208.  
  209.  
  210. THE 'RAW' FORMAT
  211.  
  212.   Raster Master supports its own format for saving and retrieving files. The
  213.   format is broken up into three main parts. The header, palette, and image
  214.   portions.
  215.  
  216.                        ---  HEADER  ---
  217. Bytes
  218. -----
  219. 1 , 2 - Width of Image
  220. 3 , 4 - Height of Image
  221. 5 , 6 - Number of Colors - if 0 image does not contain a palette
  222.  
  223.                       ---  PALETTE  ---
  224.  
  225. 7 , 8 , 9  - Red, Green, Blue values of the first color. The values will range
  226.              from 0 to 63. Each additional three bytes indicate the values of
  227.              the next color. For an image that contains 16 colors the PALETTE
  228.              size will be 48 bytes (3*16).  
  229.  
  230.                         ---  IMAGE ---
  231.  
  232. What ever follows after the palette is the actual image. The first byte
  233. following the palette will be the first pixel starting from the left top corner.
  234. The remaining pixels follow row by row. Each pixel takes exactly one byte no
  235. matter how many colors there are in the image.
  236.  
  237.  
  238. The api...
  239.  
  240.   Raster Master also supports additional formats with its tiny API system.
  241. Raster Master does this by allowing the programmer to write a conversion program
  242. that will be executed automatically when the format is selected. When selecting
  243. the change format option (RIGHT mouse over OPEN or SAVE) Raster Master will look
  244. for a file called RM.FIL. This is a standard TEXT file that will contain the
  245. parameters of your conversion program. Lets say you want to write a conversion
  246. program that will save your image as a GIF file. The first line of RM.FIL should
  247. be:
  248.  
  249. RAW2GIF.EXE GIF 1 W CIS_GIF_FORMAT
  250.    |         |  | | |_________________  Format Description 
  251.    |         |  | |
  252.    |         |  | |___________________  Read/Write
  253.    |         |  |  
  254.    |         |  |_____________________  Format Number            
  255.    |         |
  256.    |         |________________________  Format Extension
  257.    |
  258.    |__________________________________  Filename                 
  259.                           
  260.                                        
  261. FILENAME of conversion program must 12 characters or less.
  262.  
  263. FORMAT EXTENSION must be 3 characters or less
  264.  
  265. FORMAT NUMBER must be 3 character or less
  266.  
  267. FORMAT TYPE must 1 character. Either 'W' OR 'R'. The W indicates that the listed
  268. format will only appear in the 'Save format menu.'  The R indicates that it will
  269. appear in the 'open format menu.'
  270.  
  271. FORMAT DESCRIPTION must be 20 characters or less
  272.  
  273. The FORMAT EXTENSION is required by the file requester to list the appropriate
  274. files.
  275.  
  276. The FORMAT number is what will be passed to your conversion program in the
  277. command line parameters.  One conversion program can have more than one input
  278. and/or output format(s).
  279.  
  280. The conversion program will be executed by Raster Master in the following manner
  281. when a file is being saved:
  282.  
  283. RAW2GIF.EXE <FILENAME> <FORMAT NUMBER>
  284.  
  285. Once your conversion takes over there will be a file called RM$$.RAW in the
  286. current directory that it must convert to the specified format and name.
  287. The RM$$.RAW file is saved just like the previously described RAW format. The
  288. RM$$.RAW file will be deleted by Raster Master automatically after your
  289. conversion program is through with it.
  290.  
  291. If your going to write a conversion program that reads an image into Raster
  292. Master you must create the RM$$.RAW file from your original format. Raster
  293. Master passes the following parameters when executing a conversion program for
  294. reading an image.
  295.  
  296. GIF2RAW <FILENAME> <FORMAT NUMBER> <X> <Y> <X2> <Y2> <PAL>
  297.  
  298. The additional information indicates the co-ordinates that the image will be
  299. displayed in. If the <PAL> value is 1 it means that you may include a palette in
  300. the RM$$.RAW file. If 0 it means that a palette is not required and will not be
  301. used.
  302.  
  303. Your conversion program should not display any kind of messages.
  304.  
  305.  
  306. Registeres users...
  307.  
  308. Thank You!!!
  309.  
  310. Your key file should be placed in the same directory as your RM.EXE file.
  311.  
  312.  
  313. Registering...
  314.  
  315.  Raster Master is NOT free software. If you use this program you must pay for
  316. it. Registration entitles you to a key file that removes the nag screens and
  317. enables the 256 color "save option." For a limited time you will also
  318. receive BONUS programs when you register! See BONUS.TXT for more information.
  319.  
  320.  Raster Master is updated constantly with new features being added all the time.
  321. Fill out ORDER.TXT to register.
  322.  
  323.