home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / SCANRIP1.ZIP / README.1ST < prev    next >
Text File  |  1994-01-06  |  7KB  |  202 lines
  1.                       --------------------------------
  2.                          
  3.                          SCANRIP.EXE and DECRIP.EXE
  4.  
  5.                         Release 1 -- 05 January 1994
  6.  
  7.                        RIP Graphics Development Tools
  8.  
  9.                            by Merrick J. Stemen.
  10.  
  11.                    Copyright(c)1994.  All rights reserved.
  12.  
  13.                       --------------------------------
  14.  
  15.                      Developed using Borland Turbo C/C++.
  16.  
  17.                RIP is a (tm) of TeleGrafix Communications, Inc.
  18.  
  19.                  (makers of RIPaint, RIPterm, and RIPdraw!)
  20.                       
  21.                       --------------------------------
  22.  
  23. Page 1
  24.  
  25.  
  26.  
  27.  
  28. SCANRIP and DECRIP were both written out of frustration.  The
  29. frustration was born of a dissatisfaction with existing RIP-
  30. compatible drawing/painting programs.  There are many fine RIP
  31. paint-style programs that do not include features like *copy*
  32. and *move* that do not convert the screen region into a graphic
  33. which must be downloaded by the remote user in order to display
  34. it (i.e., a "icon").  SCANRIP.EXE and DECRIP.EXE were steps
  35. taken to solve this problem.
  36.  
  37. I have found SCANRIP and DECRIP to be invaluable tools in my
  38. quest to develop "excellent" RIP screens for my BBS.  I am still
  39. in the development stages of my RIP screens, because I like things
  40. to be nearly perfect before I put them up for all the world to
  41. see; in fact, that I even released this software at this time is
  42. a deviation from my generally cautious nature.  BUT I WANTED YOU
  43. TO GAIN THE BENEFIT I HAVE GAINED FROM THESE EXCELLENT GRAPHICS
  44. DEVELOPMENT TOOLS!
  45.  
  46. SCANRIP and DECRIP are not graphical in nature -- neither one
  47. has a fancy graphical user interface.  The programs are designed
  48. to work TOGETHER to help you create PROFESSIONAL-LOOKING RIP
  49. graphics screens for your BBS!
  50.  
  51. The general use of SCANRIP and DECRIP will follow this pattern:
  52.  
  53. (1)  Develop a rough layout for your screen using your favorite
  54.      RIP graphic program.
  55.  
  56. (2)  Run DECRIP.EXE against your rough RIP screen to create a
  57.      "decoded" RIP text file.
  58.  
  59. (3)  Modify the decoded RIP file to enhance your RIP screen.
  60.  
  61. (4)  Run SCANRIP.EXE against your newly modified text file to
  62.      turn it back into a RIP-compatible graphic!
  63.  
  64. THAT'S IT!  IT CAN BE THAT EASY!
  65.  
  66. Page 2
  67.  
  68.  
  69.  
  70.  
  71. But there's more!!
  72.  
  73. SCANRIP can also build RIP-compatible screens from files you
  74. create yourself!  Use your favorite text editor to type in
  75. RIP-compatible commands, and build your own RIP screens from
  76. scratch!
  77.  
  78. Wait!  That's not all!
  79.  
  80. Another POWERFUL feature of SCANRIP is the command RIP.TRANSLATE!
  81.  
  82. RIP.TRANSLATE (xoff,yoff) allows you to MOVE a *group* of RIP
  83. graphics commands according to the x-offset and y-offset specified.
  84. The corresponding command RIP.TRANSOFF cancels the movement of
  85. any subsequent graphics elements.  For example:
  86.  
  87. RIP.TEXTXY (81,104),TAGGART TRANSGALACTIC BBS
  88. RIP.COLOR (0)
  89. RIP.TEXTXY (78,103),TAGGART TRANSGALACTIC BBS
  90. RIP.FONT.STYLE (2,0,4,0)
  91. RIP.TEXTXY (446,100),Fido 1:3612/312
  92. RIP.FONT.STYLE (2,0,6,0)
  93. RIP.COLOR (8)
  94. RIP.TEXTXY (84,94),RBBS-PC v17.4
  95. RIP.COLOR (4)
  96. RIP.TEXTXY (82,94),RBBS-PC v17.4
  97.  
  98. could be written as:
  99.  
  100. RIP.TRANSLATE (100,50)
  101. RIP.TEXTXY (81,104),TAGGART TRANSGALACTIC BBS
  102. RIP.COLOR (0)
  103. RIP.TEXTXY (78,103),TAGGART TRANSGALACTIC BBS
  104. RIP.FONT.STYLE (2,0,4,0)
  105. RIP.TEXTXY (446,100),Fido 1:3612/312
  106. RIP.TRANSOFF
  107. RIP.FONT.STYLE (2,0,6,0)
  108. RIP.COLOR (8)
  109. RIP.TEXTXY (84,94),RBBS-PC v17.4
  110. RIP.COLOR (4)
  111. RIP.TEXTXY (82,94),RBBS-PC v17.4
  112.  
  113. Notice the RIP.TRANSLATE right before the first line and the
  114. RIP.TRANSOFF right after the line containing "Fido."  This
  115. arrangement would cause the lines between RIP.TRANSLATE and
  116. RIP.TRANSOFF to be moved to the right 100 pixels and down
  117. 50 pixels.  After the RIP.TRANSOFF command, the RBBS-PC lines
  118. would not be moved!
  119.  
  120. Page 3
  121.  
  122.  
  123.  
  124.  
  125. The RIP.TRANSLATE command can be "stacked" so that elements can
  126. be moved over, and then other elements inside them may be moved
  127. even further.  You must be very careful to "unstack" the RIP.TRANS-
  128. LATE commands with RIP.TRANSOFF, or the results will be unpredictable.
  129.  
  130.  
  131. The best way to learn how to use DECRIP and SCANRIP is to use them.
  132. Example files have been included with this archive to allow you
  133. to experiment with the programs.  Close examination of the .TXT
  134. files will give you a good understanding of what SCANRIP compatible
  135. commands look like.  The .RIP and .SCN files are RIP-compatible
  136. screens that may be viewed with a RIP viewer of some sort.
  137.  
  138. The syntax for DECRIP is:
  139.  
  140.    DECRIP ripfile > textfile
  141.  
  142. This will take a RIP-compatible file and "decode" it into a text file.
  143. If the "> textfile" part is left off, DECRIP will decode the file to
  144. the screen.
  145.  
  146. The syntax for SCANRIP is:
  147.  
  148.    SCANRIP textfile > ripfile
  149.  
  150. This will take a SCANRIP compatible text file, and generate a
  151. RIP-compatible graphic from it.  The RIP-compatible graphic can
  152. then be viewed with a RIP graphic viewer or edited in a RIP-
  153. compatible paint program!
  154.  
  155. By the way, an excellent resource to grab ahold of is a file
  156. commonly called RIPSC154.ZIP.  This file contains the specifi-
  157. cations for the RIP graphics language and can shed great light
  158. on the parameters of various RIP-compatible commands that SCANRIP
  159. recognizes.  If you really want to use these utilities to their
  160. fullest extent, RIPSC154.ZIP is a must!
  161.  
  162. Page 4
  163.  
  164.  
  165.  
  166.  
  167. LEGAL STUFF
  168.  
  169. Since SCANRIP and DECRIP are basically rough cuts (though really
  170. GOOD rough cuts) at graphic development tools, the author of SCANRIP
  171. and DECRIP cannot be held responsible for any inconvenience
  172. resulting from the use of the SCANRIP and DECRIP utilities.
  173. Guidelines for use of the utilities have been included in this
  174. short document, but may not extend to the scope to which you
  175. may try to stretch them.  Since you are responsible for naming
  176. the input and output files for both SCANRIP and DECRIP, use the
  177. utmost care to ensure that no important files are named and
  178. consequently overwritten by these utilities.
  179.  
  180. The author, Merrick J. Stemen, can be reached at:
  181.  
  182. Fidonet 1:3612/312
  183. CServe  70670,2522
  184. AOL     MickStemen
  185. My personal BBS: Taggart Transgalactic BBS
  186.                  (14400 and down) 24hrs.
  187.                       (904)494-2517
  188.                     Pensacola, Florida
  189.  
  190. I really would like to get some money from all this work.  If you
  191. like SCANRIP and DECRIP and would like to encourage me to develop
  192. more and better versions of the same, please drop me a line at
  193. one of the above addresses, and let me know what you think they're
  194. worth!
  195.  
  196. Taggart Transgalactic BBS is full, free access the first time on,
  197. and if you have BWAVE or some other mail reader, I have a .QWK
  198. door you could upload a message to.  Or you could simply call my
  199. BBS and leave a Comment to the Sysop!  
  200.  
  201. Thank you for your support!
  202.