home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / graphics / utilities / cardmaker_375 / cardmaker.docs < prev    next >
Text File  |  1989-06-06  |  5KB  |  89 lines
  1. ////// CardMaker 2.1 ©1990 by Terry W. Gintz //////
  2.  
  3. CardMaker is a programmer's aid for creating card image data that can be
  4. used in any card game.  Version 2.1 now provides support for Basic
  5. programmers.
  6.  
  7. About the Menus:
  8.  
  9. The Main menu has the operational commands, Make Suit, Load
  10. IFF, Change Images, Save Images and Load Images, Generate Code and Quit.
  11.  
  12. Make Suit will create a card suit on screen according to the Suit Menu:
  13. hearts, clubs, spades, or diamonds.  These images can be redefined with the
  14. Change Images option after loading an ILBM IFF file.  An empty template with
  15. the custom color palette that CardMaker uses is provided for the user to draw
  16. his own images.  There are 47 images that compose a standard 52 deck of
  17. cards.  Jokers would have to be defined separately as a Jack, for instance,
  18. if required in a card game such as Canasta.  Each of the images has a
  19. limited size range to fit the blanks that make up the card fronts.  These
  20. are outlined in the empty template.
  21.  
  22. Selecting "Change Images" from the main menu calls up a window containing
  23. all the current card images and a cancel gadget.  All the images are actually
  24. gadgets, and clicking on any of them will close the window and return the
  25. user to the main window.  The image clipping routine is invoked and you may
  26. clip any image from the window by clicking twice with the left mouse
  27. button.  Click once to set one corner of the image, and release the button.
  28. Move the mouse to the opposite corner of the image you wish to grab and
  29. click again.  Trace lines appear that extend across the screen as an aid to
  30. define the image you are clipping.  Once the image has been set, the program
  31. takes over and transfers the image to the card image selected.  If the image
  32. is too large to fit the image selected, the screen will flash.  In either
  33. case, the user will be returned to the change image window, where the
  34. results of the clipping will be seen.  The process is repeated for as many
  35. images the user wishes to change, until clicking on Cancel.
  36.  
  37. "Load IFF" loads any ILBM file, up to 5 bitplanes, lo-res or up to 320
  38. pixels wide and 200 rows high, and displays the picture as an image
  39. on the main window.  Color information for that file is also loaded and
  40. displayed.  The user is supplied an empty template with the default palette
  41. of CardMaker therein, to allow matching the colors of the card images as
  42. they initially appear inside CardMaker.  The user is free to use any palette
  43. desired, however, as the default system colors are restored during menu
  44. and requester operations.
  45.  
  46. "Save Images" allows you to save the current set of card images for future
  47. edit.  Takes about 20K of disk space for each set of images.  Also saves the
  48. current screen palette.
  49.  
  50. "Load Images" loads a set of images that has been saved previously.  Also
  51. loads the screen palette for the image set.
  52.  
  53. "Generate 'C' Code" calls up a file requester and writes the USHORT data
  54. for all composite card images in that suit to the file requested.  This
  55. takes an average 70K bytes for one suit (maximum 103K), so be careful to
  56. have plenty of space on your disks before executing this command.
  57. Cursor changes to a digital wait image (:01) while the disk transfer is
  58. going on.  Palette information for the current screen's ColorMap is also
  59. written.  Images for the cards are 51 pixels wide by 66 rows high, to
  60. whatever depth is selected.  The implementation of suitable image/bob
  61. structures for the image data created is left to the user.
  62.  
  63. "Generate 'Basic' Code" writes the PALETTE statements and DATA statements
  64. that are necessary to use the basic PUT command.  You must READ the data
  65. statements into an array before using PUT to place the card image in the
  66. output window.  A sample basic program, "queen.bas" is supplied to illustrate
  67. how to use the basic file created by CardMaker.  You need an integer array
  68. of 3+4*66*CARDDEPTH(number of bitplanes in card data)elements for
  69. each card image used in your basic program. 
  70.  
  71. A Depth menu is provided to allow the user to limit the number of bitplanes
  72. that are generated in the finished image data.  This menu affects the number
  73. of bitplanes that are loaded through "Load IFF", also.  The screen
  74. depth for CardMaker is not changed by the Depth menu, and images saved
  75. through the "Save Images" option are always saved with all 5 bitplanes.
  76. You will see the affect of using a two-bitplane image when you use the
  77. "Change Image" option after loading a two-bitplane (four-color) IFF file.
  78.  
  79. Any questions, comments or donations for CardMaker should be address to:
  80.  
  81. Terry W. Gintz
  82. 4237 Marcum Lane
  83. Eugene, Or 97402
  84.  
  85. A donation of $20 for CardMaker gets you the documentation to all my current
  86. programs, plus additional help with CardMaker if you need it, plus any of the
  87. other programs for $5 off their suggested price, plus upgrade privileges for
  88. $10.
  89.