home *** CD-ROM | disk | FTP | other *** search
/ Transactor / Transactor_18_1987_Transactor_Publishing.d64 / hr2rle.doc < prev    next >
Text File  |  2023-02-26  |  3KB  |  70 lines
  1.  HR2RLE
  2. HiRes to Run Length Encoder
  3. For the Commodore 64
  4. (c) 1985 by Chrisdos.
  5. All rights reserved.
  6. Ver 1.0
  7.  
  8.  
  9. The HR2RLE program will allow you to convert almost any HiRes image to
  10. a RLE format file that can be uploaded online, and can be read back by
  11. any computer that can translate the RLE data.
  12. HR2RLE will convert the area of memory starting at $6000 and extending for
  13. 8000 bytes to RLE data and save it to disk. This is compatable with DOODLE
  14. and other programs that store their HiRes bitmaps at $6000.
  15.  
  16. Usage
  17. -----
  18. Simply LOAD"HR2RLE",8 and run.
  19. You will be prompted for the exact filename of the picture to convert.
  20. Then you will be asked for the filename for the output. HR2RLE will add
  21. ".RLE" to the filename so you know it is in a RLE Format.
  22. You will then be prompted for <RETURN to TEXT>. If you enter "y" then 
  23. HR2RLE will add the code that tells the RLE decoding program to return to
  24. TEXT mode to the end of the file. Entering any other key means No.
  25. Next question is X Offset. Since the C64 screen is 320 pixels wide,
  26. and the RLE file can only handle 256, there is a 64 pixel gap. You can tell
  27. HR2RLE on what pixel column to start the conversion. 0 is the first column.
  28. 32 would be the 256 pixels in the center of the screen. 63 would be the
  29. 256 of the right most pixels.
  30. You can then do the same for the Y Offset. The screen is 200 pixels
  31. long, but RLE can only do 192 of them. Y = 0 is the top 192 rows, Y = 7 is the
  32. bottom 192 rows. (in other words, skip the first 7.)
  33. iThe last question is Normal or Inverse. This means you can create an
  34. RLE file with white and black reversed if you enter an "i". Any other key
  35. means normal.
  36.  
  37. The screen will goto HiRes and the picture file you gave will load.
  38. HR2RLE will then read the picture from the scree and write the RLE
  39. file. As it does it, the area it is working on will reverse image.
  40. iIf there is a DISK ERROR, (picture file not found, bad file name, drive 
  41. not ready, etc.) HR2RLE will hang, Hit Run/Stop/Restore to exit.
  42.  
  43. The file will be written to disk, and when finished, you will return
  44. to normal text screen.
  45. The RLE file may then be uploaded for use online.
  46.  
  47. NOTE: The option to selectively add the <RETURN to TEXT> signal at the end
  48. of the RLE file is there because of the way RLE Decoding programs operate.
  49. When you view a RLE file from a CIS source (CB pictures, weather maps, etc.)
  50. a <GOTO HIRES> signal is sent to you, then the RLE data. At the end, CIS waits
  51. for you to send a <RETURN> then cis sends a <RETURN TO TEXT> signal that
  52. resets your terminal program to text mode. If you did not get the <RETURN TO
  53. TEXT> then your terminal program might be hung in graphics mode.
  54. iThe problem with creating your own RLE file is that there is no eazy
  55. way to hold off that <RETURN to TEXT> signal at the end of the file since
  56. it is only a character in the file. About the only way to hold off the <R2T>
  57. is to send a Control-S at the very last line of the file. You may then
  58. process or look at the image on your screen. When you are ready to continue
  59. you may send a Control-Q to resume transmition. The <R2T> characters will be
  60. send and your terminal reset to normal.
  61. Unless you have a special need to not have the <R2T> characters, the add it.
  62. If you upload a file that does not have it, make sure to say so in the
  63. description.
  64.  
  65.  
  66. The RLE files should be uploaded in 7 bit ASCII mode so that they may
  67. be directly READ from a Data Library.
  68.  
  69. This file and the program are (c) 1985 by Chrisdos. All rights reserved.
  70.