home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / c128 / graphics / viewers / gds.readme < prev    next >
Encoding:
Text File  |  1998-01-11  |  10.4 KB  |  248 lines
  1.                   graphics interchange format display system
  2.  
  3.  
  4. cOPYRIGHT nOTICES AND OTHER SUCH STUFF....
  5.  
  6. 'gif' AND 'gRAPHICS iNTERCHANGE fORMAT' ARE TRADEMARKS OF cOMPUsERVE, iNC., AN
  7. h&r bLOCK cOMPANY. (YOU KNOW... THE GUYS WHO YOU GIVE MONEY TO FOR TELLING YOU
  8. HOW MUCH MONEY YOU WILL GIVE TO THE gOVERNMENT.)
  9.  
  10. basic 8 IS A TRADEMARK OF wALRUS sOFTWARE, iNC.
  11.  
  12. tHE gRAPHICS iNTERCHANGE fORMAT dISPLAY sYSTEM, OR gif dISPLAY sYSTEM FOR
  13. SHORT, OR BETTER YET - gds (MAINLY BECAUSE IT'S CATCHY, BUT ALSO BECAUSE i
  14. REALLY DON'T WANT TO TYPE OUT THE WHOLE THING), IS not pUBLIC dOMAIN.  tHIS
  15. PROGRAM CANNOT BE SOLD WITHOUT THE EXPRESS WRITTEN CONSENT OF THE AUTHOR (ME).
  16. tHIS PROGRAM MAY BE DISTRIBUTED FREELY AS LONG AS ALL ORIGINAL FILES ARE
  17. INCLUDED WITH IT.
  18.  
  19. gds FALLS UNDER THE CATEGORY OF freeware.  aLL i WANT FOR THIS IS THE FAME,
  20. GLORY, RECOGNITION, AND POSTCARDS.  yEP, YOU READ RIGHT! postcards.  i KINDA
  21. COLLECT POSTCARDS, AND i WOULD ALSO LIKE TO SEE HOW FAR THIS PROGRAM GETS
  22. DISTRIBUTED.  sO IF YOU USE THIS PROGRAM REGULARLY, YOU ARE OBLIGATED TO SEND
  23. ME A POSTCARD.  i GUESS YOU CAN CALL THIS postcardware!!!!!
  24. pLEASE SEND EVERYTHING YOU WANT TO SEND ME TO:
  25.  
  26.                              eRIC c. rAFANAN
  27.                              p.o. bOX 1428
  28.                              dUNNELLON, fl 32630
  29.  
  30. tHIS INCLUDES POSTCARDS, COMMENTS, PICTURES FROM CUTE GIRLS, OFFERS FOR ceo
  31. POSITIONS (ONLY FROM PROMINENT COMPANIES PLEASE), OR BETTER YET - gifS! i ONLY
  32. HAVE A SMALL COLLECTION AND anything (YES - anything) WOULD BE APPRECIATED.
  33.  
  34. aNYWAY, ON WITH THE DOCS...
  35.  
  36.  
  37. gif dISPLAY sYSTEM
  38.  
  39.  
  40. aFTER USING THE giffy PROGRAM FOR THE c64 BY jOHN r. wIND, i WAS IMPRESSED. i
  41. ALSO THOUGHT THAT ANYTHING THE c64 CAN DO, THE c128 CAN DO BETTER. sO i SET OUT
  42. TO WRITE A c128 gif dISPLAY PROGRAM THAT WAS EASIER TO USE, YET PRODUCED BETTER
  43. DISPLAYS.
  44.  
  45. sO HERE IT IS.
  46.  
  47. tHE PROGRAM ACTUALLY CONSISTS OF SEVERAL FILES:
  48.  
  49. 1) gds          - tHIS IS THE mAIN mODULE OF THE gds PROGRAM.
  50.                   iT LOADS IN THE 2 SUPPORT MODULES, HANDLES THE CHOOSING OF
  51.                   THE gif, THE INTERPRETATION OF THE gif HEADER, AND THE ACTUAL
  52.                   DECOMPRESSION OF THE COMPRESSED RASTER DATA.
  53.  
  54. 2) gds.defaults - tHIS FILE CONTAINS THE NAMES OF THE DEFAULT SUPPORT MODULES.
  55.  
  56. 3) gds.d/????   - fILES WITH THIS PREFIX ARE dISPLAY mODULE FILES.
  57.                   gds WAS WRITTEN TO BE MODULAR TO ALLOW DIFFERENT DISPLAY
  58.                   FORMATS TO BE USED.
  59.  
  60. 4) gds.x/????   - fILES WITH THIS PREFIX ARE eXTENSION hANDLER mODULES.
  61.                   gif FILES HAVE THE OPTION TO INCLUDE 'UPDATES' IN THE FORM
  62.                   OF eXTENSION bLOCKS, AND THE eXTENSION hANDLER mODULE TAKES
  63.                   CARE OF THESE BLOCKS.
  64.  
  65. ==============================================================================
  66.  
  67. tHE mAIN mODULE
  68.  
  69. tHE gds PROGRAM HAS BEEN WRITTEN FOR EASE OF USE. aLMOST EVERYTHING CAN BE DONE
  70. THROUGH THE USE OF MENUS.
  71.  
  72. uSE THE cURSOR kEYS TO HIGHLIGHT A CHOICE.
  73. uSE THE rETURN kEY TO PICK IT.
  74. uSE THE esc kEY TO ABORT ALMOST ANYTHING (THE PROGRAM WILL TELL YOU WHEN IT
  75. DOES SOMETHING ELSE).
  76.  
  77. mOST OF THE MENUS ARE SELF-EXPLANATORY, SO i WILL ONLY COVER THOSE AREAS THAT
  78. MAY NEED A LITTLE MORE CLARIFICATION.
  79.  
  80. tHE mAIN mENU HAS 3 CHOICES:
  81.  
  82. 1) vIEW A gif    - aLLOWS YOU TO VIEW A gif ON dRIVES 8, 9, 10, OR 11.
  83.                    yOU CHOOSE THE gif FROM A dIRECTORY LISTING.
  84.                    note - gifS MUST BE pROGRAM, sEQUENTIAL, OR uSER (THOUGH
  85.                           NON-geos) TYPE FILES.
  86.  
  87. 2) eXIT          - pRETTY SELF-EXPLANATORY.
  88.  
  89. 3) sELECT mODULE - aLLOWS YOU TO SELECT ANOTHER dISPLAY mODULE OR eXTENSION
  90.                    mODULE FROM dRIVES 8, 9, 10, OR 11.
  91.                    aLSO MAKES IT THE dEFAULT mODULE AS AN OPTION.
  92.                    note - wHEN YOU WRITE A NEW dEFAULTS FILE, BOTH THE cURRENT
  93.                           dISPLAY and eXTENSION mODULES ARE MADE THE dEFAULTS.
  94.  
  95. aLL THE SECONDARY MENUS ARE really SELF-EXPLANATORY (yes/no, cHOOSE A dRIVE,
  96. ETC.) SO i DON'T THINK i NEED TO GO INTO THEM (AFTER ALL, IF YOU OWN A c128,
  97. THEN YOU'VE got TO HAVE ABOVE AVERAGE INTELLIGENCE!).
  98.  
  99.  
  100. tHE sCREEN lAYOUT
  101.  
  102.  
  103. tHE sCREEN IS DIVIDED INTO 3 PARTS:
  104.  
  105. 1) cREDIT bLOCKS - tHIS IS THE UPPER HALF OF THE SCREEN. tHE TWO SMALLER BLOCKS
  106.                    ARE CREDITS READ FROM THE mODULES (SO IF YOU'RE WILLING TO
  107.                    PROGRAM A mODULE, YOU CAN LET PEOPLE KNOW WHO DID IT! iT'S
  108.                    ONLY FAIR AFTER ALL.).
  109.  
  110. 2) gif iNFO      - tHE LOWER LEFT PORTION OF THE SCREEN IS USED TO DISPLAY
  111.                    INFORMATION ABOUT THE gif YOU HAD CHOSEN.  mOST OF IT NEEDS
  112.                    NO EXPLANATION, BUT HERE'S ONE THING TO WATCH OUT FOR -
  113.                    i BELIEVE THERE HAS BEEN AN UPDATE TO THE gif FORMAT. iT
  114.                    HAS BEEN LABELED 'gif89A'.  gds RECOGNIZES ANY gif WITH THE
  115.                    'gif' SIGNATURE, BUT IT may NOT PROCESS '89A' TYPE gifS
  116.                    CORRECTLY.  mOST gifS ARE CURRENTLY 'gif87A'.
  117.  
  118. 3) mESSAGE aREA  - tHE LOWER RIGHT PORTION OF THE SCREEN IS THE mESSAGE aREA.
  119.                    tHIS IS WHERE MOST (IF NOT ALL) USER INTERACTION WILL TAKE
  120.                    PLACE.
  121.  
  122.  
  123. aND THAT'S ALL THERE IS TO IT!
  124.  
  125. ==============================================================================
  126.  
  127. gETTING tHIS tHING rUNNING
  128.  
  129.  
  130. tHE BASIC STEPS TO USING THIS PROGRAM ARE:
  131.  
  132. run "gds" on u(WHATEVER)
  133.   (IT WILL LOAD, RUN, THEN LOAD IN THE dEFAULT mODULES FROM THE cURRENT dRIVE)
  134.  
  135. cHOOSE 'vIEW A gif' FROM THE mAIN mENU.
  136.  
  137. pICK THE dRIVE THE gifS ARE ON.
  138.   (IT WILL THEN READ IN ALL FILENAMES WITH THE '.gif' SUFFIX)
  139.  
  140. hIGHLIGHT AND cHOOSE THE gif YOU WANT TO VIEW.
  141.  
  142. cONFIRM YOUR sELECTION.
  143.   (YOU CAN ABORT IF ALL YOU WANTED TO DO WAS LOOK AT THE gif INFO)
  144.  
  145. aND AWAY IT GOES!!!
  146.  
  147. ==============================================================================
  148.  
  149. tHE dISPLAY mODULE
  150.  
  151.  
  152. tHE dISPLAY mODULE IS THE PART OF THE SYSTEM THAT (YOU GUESSED IT!) ACTUALLY
  153. DISPLAYS THE gif.  iT ALSO IS RESPONSIBLE FOR DOING THE COLOR TRANSLATIONS.
  154. i CHOSE TO MAKE IT A MODULE SO THAT DIFFERENT FORMATS COULD BE CHOSEN WITHOUT
  155. ACTUALLY REWRITING THE ENTIRE PROGRAM.  tHESE FORMATS CAN INCLUDE 40-COLUMN
  156. hI-rES AND mULTICOLOR GRAPHICS SCREENS, bASIC 8 FORMATS, THE ipAINT FORMAT, OR
  157. EVEN CUSTOM MADE FORMATS.  aLL IT TAKES IS THE CORRECT dISPLAY mODULE.
  158.  
  159. tHE mAIN mODULE TAKES CARE OF EVERYTHING (INCLUDING DECOMPRESSING THE RASTER
  160. DATA - THAT WAS A TOUGHIE!) EXCEPT ACTUALLY PUTTING THE PICTURE ON THE SCREEN,
  161. SO IT'S NOT HARD TO COME UP WITH A NEW dISPLAY mODULE.  fOR ANY PROGRAMMERS WHO
  162. ARE INTERESTED, i WILL BE UPLOADING pROGRAMMING nOTES 'rEAL sOON nOW'. (fAMOUS
  163. lAST wORDS!)
  164.  
  165. tHERE ARE 3 dISPLAY mODULES INCLUDED WITH THE gds PROGRAM:
  166.  
  167. 1) gds.d/normal    - tHIS IS THE dEFAULT mODULE. iT IS SET TO PROVIDE A PRETTY
  168.                      GOOD DISPLAY FOR THE MAJORITY OF THE gifS.
  169.  
  170. 2) gds.d/lighter   - iF THE gifS SEEM TO BE COMING OUT TOO DARK (ALOT OF 256
  171.                      COLOR gifS TEND TO), THEN THIS MODULE WILL ATTEMPT TO
  172.                      MAKE THE COLORS BRIGHTER.
  173.  
  174. 3) gds.d/darker    - tHIS MODULE IS SET TO DARKEN THE COLORS IN A gif.
  175.  
  176. aLL 3 REQUIRE 64k OF vdc ram.
  177.  
  178. tHESE dISPLAY mODULES WERE CODED FOR 16-COLOR gifS, BUT 4 AND 32-COLOR gifS
  179. STILL SHOW UP PRETTY GOOD.  nOW 256-COLOR gifS ARE ANOTHER MATTER...
  180.  
  181. sINCE THE c128 HARDWARE ONLY SUPPORTS 16 COLORS, THEN TO GET ANY REASONABLE
  182. DISPLAY OF 256 COLORS REQUIRES SOME FORM OF software WORKAROUND, SUCH AS
  183. DITHERING OR INTERLACE (LIKE IN ipAINT - GOSH, i WISH i HAD THE ipAINT
  184. FORMAT!).  aNYWAY, THE dISPLAY mODULES THAT COME WITH THE gds PROGRAM ARE
  185. PRETTY SAD WHEN IT COMES TO 256-COLOR gifS (AND THAT'S COMING FROM THE PERSON
  186. WHO PROGRAMMED THEM!).
  187.  
  188. tHE dISPLAY mODULES WILL 'STRETCH' OR 'SQUASH' A gif TO FIT INTO THE 640X200
  189. bASIC 8 FORMAT.  iT CAN HANDLE iNTERLACED gif FILES UP TO A HEIGHT OF 200
  190. LINES.
  191.  
  192. aFTER VIEWING THE gif, HITTING ANY KEY EXCEPT FOR THE 's' KEY WILL RETURN YOU
  193. TO THE mAIN mODULE.
  194.  
  195. tHE 's' KEY ALLOWS YOU TO SAVE THE gif AS A 640X200 8X2-COLOR BLOCK bASIC 8
  196. PICTURE.  aFTER HITTING THE 's' KEY, YOU WILL HEAR 2 QUICK BELLS TO NOTIFY YOU
  197. THAT SAVING HAS BEGUN. wHEN IT IS DONE, YOU WILL BE RETURNED TO THE mAIN mENU.
  198.  
  199. tHE PICTURE WILL BE SAVED ON THE SAME DISK AS THE gif SO BE SURE THAT THERE IS
  200. ENOUGH ROOM ON THE DISK FOR IT (TYPICALLY 50-80 DISK BLOCKS).  tHE NEW FILE
  201. WILL HAVE THE SAME NAME AS THE gif WITH THE ADDITION OF THE 'pict.' PREFIX AND
  202. NO '.gif' SUFFIX.
  203.  
  204.       **** do not remove any disks while the green light is on! ****
  205.  
  206. tHIS MEANS YOU CANNOT CHANGE DISKS BEFORE SAVING THE PICTURE (ACTUALLY YOU CAN,
  207. BUT YOU'LL GET A DISK ERROR AFTERWARDS).  tHIS IS A SHORTCOMING OF THE dISPLAY
  208. mODULE WHICH IS CURRENTLY BEING WORKED ON.
  209.  
  210. ==============================================================================
  211.  
  212. tHE eXTENSION hANDLER mODULE
  213.  
  214.  
  215. tHE eXTENSION hANDLER mODULE HANDLES gif eXTENSION bLOCKS.  tHESE eXTENSION
  216. bLOCKS ARE USED TO IMPLEMENT SPECIAL FUNCTIONS, GIVE EXTRA gif INFO, ETC. THAT
  217. ARE NOT PROVIDED FOR IN THE STANDARD gif FORMAT.  tHE eXTENSION hANDLER mODULE
  218. PROVIDED JUST IGNORES THESE eXTENSION bLOCKS.  aCTUALLY, i HAVEN'T FOUND ANY
  219. gifS WITH eXTENSION bLOCKS AT ALL!  iF YOU DO, LET ME KNOW IF THE eXTENSION
  220. bLOCK hANDLER WORKS, EH?  (sORRY ABOUT THIS FOLKS, BUT YOU CAN'T TEST SOMETHING
  221. IF THERE'S NOTHING TO TEST IT WITH!)
  222.  
  223. ==============================================================================
  224.  
  225. iF YOU FIND ANY PROBLEMS WITH THIS PROGRAM, PLEASE LET ME KNOW.  i REALLY HAVE
  226. TRIED TO SQUASH ALL THE BUGS, BUT MY SUPPLY OF gifS TO TEST WITH IS very
  227. LIMITED.  sO IF YOU FIND ANYTHING WRONG, i WON'T TAKE IT TOO PERSONALLY.
  228.  
  229. uNFORTUNATELY, MY LAWYERS TELL ME TO INFORM YOU THAT i CAN'T BE HELD
  230. RESPONSIBLE FOR ANY DAMAGE INCURRED THROUGH THE USE OF THIS PROGRAM.  nOT THAT
  231. THERE'S ANY CHANCE OF THAT MIND YOU - NONE OF MY EQUIPMENT HAS BEEN DAMAGED AND
  232. IT WAS USED TO test THIS PROGRAM!  i did HAVE A PROBLEM WHILE WRITING THE
  233. DECOMPRESSION ROUTINE THOUGH - i THINK i DEVELOPED A NEW ART FORM!  i ALSO
  234. THINK i SUFFERED BRAIN DAMAGE LOOKING AT IT! <JUST KIDDING - REALLY!>
  235. aNYWAY, ABOUT THE ONLY WAY YOU COULD DO DAMAGE TO ANYTHING IS IF YOU GET SO
  236. OVERWHELMED BY THE INCREDIBLE PICTURES BEING DISPLAYED THAT YOU FALL OVER
  237. BACKWARDS AND STARTLE THE CAT WHO JUMPS ONTO YOUR DESK AND SPILLS YOUR DRINK
  238. ALL OVER YOUR COMPUTER!  yOU SHOULDN'T HAVE HAD THAT DRINK THERE ANYWAY...
  239.  
  240. wELL THAT'S ABOUT IT FOR THE DOCUMENTATION.  i HOPE i DIDN'T LEAVE OUT TOO MUCH
  241. BUT THE PROGRAM IS PRETTY EASY TO RUN ANYWAY.
  242.  
  243.                              eNJOY!
  244.                               eRIC c. rAFANAN
  245.                                qLINK: mEeRIC
  246.  
  247. cOPYRIGHT 1990
  248. aLL rIGHTS rESERVED