home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug131.arc / README < prev    next >
Text File  |  1979-12-31  |  9KB  |  166 lines
  1.                 PREMIUM/STANDARD GRAPHIC FILE CONVERSION
  2.                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.                      [ For Premium Microbees ONLY ]
  4.  
  5. Frustrated  with  having a  number  of  graphic drawing programs for  my 
  6. Premium   Microbee  and  what  initially   appeared  to  be  total  file 
  7. incompatability,  I set out to overcome some of these problems. I am now  
  8. able  to  draw  an opening screen with Electric  Paintbrush  or  Premium 
  9. BeeArtistic and convert it to a GRSAVE file (and back again). This way I 
  10. can  have  great  graphic  screens in any Basic  program  I  wish.  Text 
  11. Adventures could come alive.
  12.  
  13. I use eleven programs to do my conversions. They are as follows:-
  14.  
  15. SHOWBA.COM
  16. ~~~~~~~~~~
  17. Will simply load a file created with Premium BeeArtistic Ver 1.3 at  the 
  18. A> CP/M prompt (or SHELL) and display it on the screen. Press any key to 
  19. return you back to CP/M or Shell. Can be run by either:-
  20.                A>SHOWBA  <cr>   - then enter file name
  21.           or   A>SHOWBA FILENAME  <cr>
  22.  
  23. SHOWGR.COM
  24. ~~~~~~~~~~
  25. Will simply load a file saved with GRSAVE command from either Premium or 
  26. Standard  Basic  at the A> CP/M prompt (or SHELL) and dispay it  on  the 
  27. screen.  Press any key to return you back to CP/M or Shell.  The  HIRES2 
  28. command  needs  to have been called at some point in the  basic  program 
  29. prior to using the GRSAVE command and resulting in a Premium GRSAVE file 
  30. 20k long. Using HIRES results in a Standard GRSAVE file 8k(6k) long. Run 
  31. by either:-
  32.       A>SHOWGR <cr> - then enter file name and type
  33.   or  A>SHOWGR FILENAME <cr> and then answer
  34.                              P or S if Premium or Std. GRSAVE file.
  35.   or  A>SHOWGR FILENAME t <cr> - where 't' is P or S
  36.  
  37. BA2GR.MWB
  38. ~~~~~~~~~
  39. Will  load  a  file created with Premium BeeArtistic Ver  1.3  while  in  
  40. Premium  Basic  Ver 6.28 or higher and create a  Premium  HIRES2  GRSAVE 
  41. file. This file created can then be loaded into any Basic program with: 
  42.  
  43.                OPEN"I",6,"filename.ext":GRLOAD 6:CLOSE 6
  44.  
  45. The extention  of the  BA file name is replaced with  .PGR for a Premium 
  46. GRSAVE file  and replaced  with  .SGR for a Standard GRSAVE  file. The 8 
  47. PCG banks of a  BA file are placed  horizontally on  the screen from the 
  48. top to  the  bottom  while GRSAVE files  have  their 8 PCG  banks  layed 
  49. vertically on the screen from left to right (Compatability??). Will only 
  50. work using  Basic ver 6.28  or higher on a  Premium 'Bee. It  also loads 
  51. Standard BeeArtistic files  and converts them to  Standard GRSAVE files. 
  52. They can also  be  loaded into any  Basic program  using  the  same line 
  53. of code as listed above. Run by:-
  54.          A>BASIC BA2GR  <cr> and select type and enter filename
  55.  
  56. GR2BA.COM
  57. ~~~~~~~~~
  58. Will load a Premium GRSAVE file and convert it to a Premium  BeeArtistic 
  59. file.  There  are a lot of computations and data  movement  required  to 
  60. transform a Vertically banked GRSAVE screen to a Horizontally banked  BA 
  61. screen. That's why its a bit slow. ( I originally wrote it in Basic  but 
  62. fell asleep waiting for the first file to be converted.) It works  well, èhowever,  there  are a couple of problems with this  program.  Only  the 
  63. Graphic  component, NOT the Text, will be converted to the BA file.  So, 
  64. if  there  is  any text in the GRSAVE file then it has  to  be  manually 
  65. entered into the converted file by BeeArtistic. Also, another problem is 
  66. a GRSAVE file has colour data saved in its file but a BA file does  not, 
  67. thus  all colour data is lost during this conversion. (NOTE: A  Standard 
  68. GRSAVE file can be simply loaded straight into Standard BeeArtistic  and 
  69. the  program  CONVERT.COM on the Premium BA disk  converts  Standard  BA 
  70. files to Premium BA files). Run by either:-
  71.         A>GR2BA  <cr>   - then enter filename to load and save.
  72.    or   A>GR2BA FILENAME  <cr> - then enter filename to save.
  73.    or   A>GR2BA FILE1 FILE2  <cr> - where FILE1 is the filename to load
  74.                                     while FILE2 is the filename to save.
  75.  
  76. BAGR2EP.MWB
  77. ~~~~~~~~~~~
  78. This program will load Premium or Standard BeeArtistic files and Premium 
  79. or  Standard Basic GRSAVE files (menu selectable) and convert them to  a 
  80. loadable  Electric  Paintbrush file. Do not list (or EDIT  or  RENUMber) 
  81. lines  10  or  20 as they contain machine code which  turns  the  screen 
  82. crazy!  (I seem to do that often!!) Run on a Premium 'Bee with at  least 
  83. 20k in M: drive using Basic Ver 6.28 or higher. After running, it  exits 
  84. to  CP/M and you then save the file created in memory by typing  in  the 
  85. following from CCP (NOT from the Shell!) :-
  86.                    A>SAVE 76 M:EPTEMP.$$$  <cr>
  87. Then run EP and when the Recover  message appears,  press any key except 
  88. the  ESC.  The picture then appears.  Immediatly save and reload  if you 
  89. wish to edit it. Run by: 
  90.       A>BASIC BAGR2EP  <cr> - then select type and enter filename
  91.  
  92. EP2BA.COM
  93. ~~~~~~~~~
  94. Thσ  actua∞  picturσ oµ ß Electriπ PaintbrusΦ filσ i≤  generall∙  large≥ ì
  95. thaε thσ ful∞ screeε limi⌠ oµ BeeArtistiπ files« Therefore¼ ╔ decideΣ t∩ ì
  96. conver⌠ thσ filσ CLIPBRD.DA╘ t∩ ß Premiuφ B┴ file« LoaΣ E╨ anΣ thσ áfilσ ì
  97. yo⌡ wisΦ t∩ convert« Theε clicδ  thσ HAN─ icoε anΣ movσ t∩ thσ árequireΣ ì
  98. par⌠ oµ thσ file« Clicδ thσ CLIPBOAR─ icoε  (nex⌠  t∩ HAND⌐ anΣ movσ thσ ì
  99. cros≤ t∩ thσ uppe≥ lef⌠ corne≥ anΣ clicδ t∩ mark« T∩ ge⌠ righ⌠ int∩ áthσ ì
  100. corner¼ usσ FIN┼ modσ (pres≤ Spacσ Bar⌐ iµ usinτ ß ChalkBoard« No≈ ámovσ ì
  101. t∩ bottoφ  righ⌠ corne≥  oµ thσ screeε anΣ clicδ t∩ select« Clicδ áEDIT¼ ì
  102. clicδ COP┘ theε exi⌠ E╨ a≤ normal« Thi≤ i≤ thσ larges⌠ picturσ tha⌠ ácaε ì
  103. bσ ásaveΣ áa≤ áCLIPBRD.DA╘ «  Afte≥ convertinτ áwitΦ áEP2BA¼ áloaΣ áint∩ ì
  104. BeeArtistiπ anΣ edi⌠  o≥ repositioε iµ required« Ruε b∙ either║-
  105.           A>EP2BA  <cr> - then enter filename to load (<cr>=CLIPBRD.DAT)
  106.                             and then filename to save.
  107.      or   A>EP2BA FILE1  <cr> - then enter file name to save.
  108.      or   A>EP2BA FILE1 FILE2  <cr> where FILE1 is filename to load
  109.                                     while FILE2 is filename to save.
  110.  
  111. PM2EP.COM
  112. ~~~~~~~~~
  113. For a PRINTMASTER picture to be loaded into  Electric Paintbrush,  first 
  114. select  the  picture from a SLIB.SHP or ULIB.SHP file using the  editing 
  115. program EDIT.COM (c) Tripple R and then save it and exit. It will always 
  116. be saved on A: drive with the name ULIB.SHP. A: drive must initially NOT 
  117. have  a file on it called ULIB.SHP as saving will add to that  file.  We 
  118. want  a  ULIB.SHP  with  only one picture saved to  it.  Then  run   the 
  119. PM2EP.COM  program and it will produce a file called  CLIPBRD.DAT.  This 
  120. CLIPBRD.DAT  file must be on the EP disk.  Run  EP,  click  EDIT,  click 
  121. PASTE,  position square and click. It then appears  on screen. Save file 
  122. as  normal. This  might all be a  bit complicated and only  converts one 
  123. file at a  time, but it works! I have  a Chalk Board to run  EP and clip èart is saved as CLIPBRD.DAT only. Run by either:-
  124.          A>PM2EP  <cr> - then enter file name or <cr> for ULIB.SHP
  125.    or    A>PM2EP FILENAME  <cr>
  126.  
  127. BA216K.COM and 16K2BA.COM
  128. ~~~~~~~~~~~~~~~~~~~~~~~~~
  129. On  my Electric Paintbrush master disk was a program  named  LOAD16K.COM  
  130. The  EP Manual page 7.4 and 7.5  talks about this file and  describes  a 
  131. "16K  Format"  file but no files were included. I have since  found  the 
  132. opening  screen  to STORY MAKER is this type of file. (Whow!!)  These  2 
  133. programs  lets me convert these files to Premium BeeArtistic, edit  them 
  134. and convert them back. (Just what everyone needed.) Run by either:-
  135.              A>BA216K  <cr>   - then enter filename to load
  136.                                   and then filename to save.
  137.         or   A>BA216K FILENAME  <cr> - then enter filename to save
  138.         or   A>BA216K FILE1 FILE2  <cr> - where FILE1 is the filename
  139.                         to load while FILE2 is the filename to save.
  140.  
  141. SHOW16K.COM
  142. ~~~~~~~~~~~
  143. This is functionally the same as LOAD16K,  but is far easier to use.  It 
  144. simply  shows any "16K Format" file  at the  A> CP/M prompt (or  SHELL).  
  145. Press any key to exit. Run by either:-
  146.               A>SHOW16K  <cr>  - then enter filename
  147.          or   A>SHOW16K FILENAME  <cr>
  148.  
  149. FON2EPF.COM
  150. ~~~~~~~~~~~
  151. This file simply  converts Graphic Wordbee Fonts  to Electric Paintbrush 
  152. Fonts. The filename extention is changed to .EPF  Run by either:-
  153.               A>FON2EPF  <cr>  - then enter filename
  154.          or   A>FON2EPF FILENAME  <cr>
  155.  
  156. The  eleven  files  all work well on my 128k Premium 'bee.  I  have  not 
  157. tested  them  on a 256TC but see no problems. Let me know via  the  MBUG 
  158. Bulletin Board if you have problems or questions.
  159.  
  160. NOTE:   None of these programs check the disk to see if a  file  already 
  161. exists  with the same name. When a file is created, it  will  over-write 
  162. any  pre-existing file of the same name. The original file will then  be 
  163. un-recoverable. You have been warned!
  164.  
  165. Alan Laughton -  MBUG Member #679                          3rd July 1988
  166.