home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / multimedia / ammoguide.lha / AmmoGuide / ReadMe < prev   
Encoding:
Text File  |  1995-02-27  |  10.9 KB  |  260 lines
  1.  
  2.                Haas' Guide to Small-Arms Ammunition
  3.                ====================================
  4.                ©1995 Mike Haas, All Rights Reserved
  5.  
  6.  
  7. This is a small-arms ammunition database with GUI-based front end.
  8.  
  9. The program is freely distributable, but all rights are reserved.
  10. Permission is granted to include this package in Freeware and
  11. Shareware distributions.  The producers of these distributions
  12. may ask a fee for media and a small charge for their service.
  13. Distribution for profit under any other arrangement requires
  14. the written permission of the author.
  15.   
  16. The goal of this program is to be a technically-accurate reference 
  17. engine that is easy, interesting and fun to use.  The program
  18. programatically calculates the graphic images for any small-arms
  19. caliber cartridge in it's (extensible) database and displays it
  20. in characteristic brass coloring in high-resolution graphics.
  21.  
  22. Most cartridge dimensions are from official SAAMI drawings, ballistics 
  23. information is from commercial manufacturers sources, etc.  Still, the 
  24. occasional error creeps in, so...
  25.  
  26. NO RESPONSIBILITY IS ASSUMED FOR THE ACCURACY OF ANY INFORMATION.  USE 
  27. OF THE INFORMATION HEREIN IS DONE AT THE RISK OF THE USER.
  28.    
  29. This first version does not include ballistics tables, reloading 
  30. information, a ballistics calculator, etc... all features that I'd 
  31. like to add at some point (even have a lot of compiled data to start 
  32. with) given sufficient interest (read: feedback).
  33.  
  34. No attempt is made to display the cartridge at actual size.  In fact, 
  35. things are drawn almost twice that on most monitors.  It's the same 
  36. reason I use a hi-res, interlaced screen...  displaying these things 
  37. involves some subtle angles and features, and any less resolution 
  38. would create serious identification problems, I think.  It just 
  39. wouldn't 'look like' a .30-06, y'know?
  40.  
  41. Hope you enjoy the program.  If you do, please *do provide feedback*...  
  42. it's the real guage at to whether enough folks are interested to 
  43. continue development.  If you didn't like it, well, it's not for lack
  44. of trying on my part.  :-)
  45.  
  46.    Mike Haas
  47.    3867 La Colina Rd.
  48.    El Sobrante, CA 94803
  49.    
  50.    haas@starnine.com
  51.  
  52. Below...
  53.  
  54.    - Instructions
  55.    - Add new cartridges!
  56.    - Specifications
  57.    - Special Thanks
  58.    
  59. ---------------------------- Instructions ---------------------------
  60.  
  61. The program is menu-driven and very easy to use.  Note that the
  62. "Ammo_Drawer" directory must be in the same directory as the
  63. "Ammo Guide" program.
  64.  
  65. No additional instructions are necessary.  (unless you are a fellow 
  66. firearms/ammo enthusiast and want to...)
  67.  
  68.  
  69. ------------------------ Add new cartridges! ------------------------
  70.  
  71. The database is extensible.  I've tried to provide a sufficient number 
  72. of cartridges to be useful and interesting in this first version... 
  73. each cartridge entails a little bit of work!
  74.  
  75. (After adding one, you'll have a better idea how much work this 
  76. program was!)
  77.  
  78. This version 1.0 includes 90 cartridges, 24 of which have descriptive 
  79. text used in the "Describe Cartridge" feature.  If you don't see a 
  80. favorite, you can add it via the procedure below.  if you do such a 
  81. thing, PLEASE send me the files you create for inclusion in the 
  82. release.  Also, I have to reserve the right to edit your submission,
  83. (or even not use it) but will keep that to a minimum.
  84.  
  85. To add a new cartridge...
  86.  
  87.    NOTE: Adding a cartridge minimally involves creating a ".ctg"
  88.          file (described below).   This provides the dimensions
  89.          of your cartridge to the engine and gives it the ability to
  90.          draw it, among other things.
  91.          
  92.          After this is done, you can then opt to create a
  93.          textual description in the form of a ".ctx" file,
  94.          allowing your cartridge to appear in the
  95.          "Describe Cartridge" item list.
  96.    
  97.    1. Think of a good, short filename for your ".ctg" file.  For 
  98.       example, if adding the "218 Bee", you might call it 
  99.       "218.ctg" or "218Bee.ctg", etc.  Don't try to use an 
  100.       existing name, though!  (the name must end in ".ctg")
  101.    
  102.    2. In the "Ammo_Drawer/Cartridges" drawer, copy the .ctg file 
  103.       for another cartridge of the same type (see below).  Each 
  104.       type has a different set of required dimensions and this is 
  105.       the easiest way to get a complete set without having to 
  106.       worry about the specific subsets.
  107.       
  108.       Our example cartridge, the .218 Bee, is a Rimmed, 
  109.       bottle-neck cartridge, so for a .ctg file to copy to an 
  110.       initial "218Bee.ctg", we might choose the 30-30 Winchester 
  111.       or any cartridge that is of the same type.  Suggestions
  112.       for each type...
  113.       
  114.          Rimmed BottleNeck     - 3030.ctg
  115.          Rimless Bottleneck    - 308.ctg
  116.          Rimmed Straight-wall  - 4570.ctg
  117.          Rimless Straight-wall - 9mm.ctg
  118.    
  119.    3. Edit the various fields in the new .ctg file, entering the 
  120.       values for your cartridge case.  Some considerations...
  121.       
  122.       a. All case dimensions (anything with 'width' or 'height') 
  123.          are required but the other info is optional.  For 
  124.          non-required fields that you do not know the value for 
  125.          your new cartridge, either delete the line or enter -- 
  126.          (two dashes) for the value (don't forget the space after 
  127.          the : char!).  There are many examples in the provided 
  128.          files.
  129.          
  130.          NOTE: "Short Name:" should not exceed 7 characters.  Our
  131.                example would probably use "218 Bee".
  132.       
  133.       b. Sometimes different dimensions are the same, such as 
  134.          "Rim Height:" and "Stem Height:" in a Rimmed (stemless) 
  135.          cartridge.  Still, they are all required for a given type.
  136.          Never delete a case dimension from a .ctg file you are
  137.          editing... change it to what is appropriate for your
  138.          new cartridge.  You can derive this information from
  139.          spec drawings, empirically or whatever, but please try
  140.          to be accurate.  I've tried to mark all of the non-SAAMI-
  141.          based .ctg files as such for reference.  The program doesn't
  142.          care, but someone might at some time.
  143.       
  144.    At this point, the engine should be able to draw your cartridge
  145.    and provide a "Technical Info..." screen.  (You will have to restart
  146.    the program to see it though, because the .ctg files are only read
  147.    once, at startup).
  148.    
  149.    NOTE: If you've added a .ctg file, restarted the program, and
  150.          STILL your cartridge isn't showing up in either
  151.          "Draw Cartridges..." or "Technical Info...", you have
  152.          probably deleted a required field after copying one
  153.          of the original .ctg files.  If not, it still means that
  154.          something is wrong with the .ctg file and so the engine
  155.          doesn't add it to the list.  Feel free to send me
  156.          files that do this, but I don't think you'll have the
  157.          problem... the .ctg file is pretty straightforward, I think.
  158.    
  159.    Now, if you want to also provide a "Describe Cartridge..." screen
  160.    for your newly-added cartridge...
  161.    
  162.    4. In the "Ammo_Drawer/Texts" drawer, create a file with the
  163.       same name as before, except change the ending to ".ctx".
  164.       Our example would be "218Bee.ctx" if "218Bee.ctg" was used
  165.       above.
  166.    
  167.    5. In the .ctx file. enter the text that you want to appear in the
  168.       "Describe Cartridge" screen.  Formatting notes...
  169.       
  170.       For now, there is no scrolling or auto-text formatting 
  171.       capabilities to the text display area.  I might add this, 
  172.       but for now, the following restrictions are in force...
  173.       
  174.       a. Lines should not exceed 50 characters in width.
  175.       
  176.       b. Number of lines should not exceed 31.
  177.       
  178.       (Exceeding either limit will not hurt anything, it just
  179.       won't display).
  180.    
  181.    6. Once you save the file, the cartridge should become visible in the
  182.       "Describe Cartridge" selection list.  (You don't have to
  183.       restart the program for these to show up).
  184.    
  185.    Please, SEND ME YOUR NEW CARTRIDGE FILES! -- If interest warrents
  186.    further versions, I will make every effort to keep your work
  187.    compatible.
  188.  
  189.  
  190. -------------------------- Specifications --------------------------
  191.  
  192.                Cartridge-Drawing Engine Specifications
  193.                ---------------------------------------
  194.                          (units = inches)
  195.  
  196. Internal resolution: .001
  197. On screen resolution: .01
  198. Shell bases supported: Rimmed, Rimless, Rebated, Belted
  199. Shell cases supported: Necked, Straight-walled (either at any taper)
  200.  
  201. Cartridges library is extensible.  Release 1.0 includes 90 .ctg
  202. (cartridge definition) files and 24 .ctx (cartridge description)
  203. files.
  204.  
  205.  
  206. -------------------------- Special Thanks --------------------------
  207.  
  208. The idea for this program occurred in the fall of 1994.  JForth 
  209. Professional 3.1 was used for the programming, DpaintIV for the
  210. iff construction.
  211.  
  212. Special thanks to the following publications, all paragons of accuracy
  213. and well worth buying...
  214.  
  215.     Hodgen Data Manual No. 26  (©1992 Hodgen Powder Co. Inc.)
  216.     
  217.         Hodgen is an icon in the firearms industry for their
  218.         consistent high-quality gunpowders, technical data and
  219.         general support of the shooting sportmen.  I'd be lost
  220.         without H4350!
  221.     
  222.     Sierra Bullets Reloading Manual (©1978 Sierra Bullets)
  223.     
  224.         Sierra bullets are the best you can buy, it's about as 
  225.         simple as that!  My first 100 yd. 5-shot group with 
  226.         Federal's 30-06 "Gold Medal" Factory ammunition (loaded 
  227.         with Sierra's 168 grain MatchKing boattail hollow-points) 
  228.         measured .76" (using a $200 sporterized Springfield, 
  229.         bought at a gun show).  'nuff said!
  230.     
  231.     NRA "Handloading" Manual (©1981 National Rifle Association)
  232.         
  233.         Fact...
  234.         
  235.         An independant survey recently rated a large number of 
  236.         organizations on accuracy of published statistics and 
  237.         data.  The National Rifle Association of America came in
  238.         2cnd, just behind the National Associations of Librarians!
  239.         
  240.         And a second on the soapbox (for the '2cnd')...
  241.         
  242.         In 1968, the Second Amendment of the Constitution began 
  243.         to suffer it's worst attacks by those who want to 
  244.         repeal your Right to Keep and Bear Arms (RKBA).  These
  245.         attacks continue today, assisted by a sympathetic Clinton 
  246.         Administration.  Many thanks to the NRA for taking the 
  247.         banner lead in protecting the rights of law-abiding 
  248.         Americans.  By providing free firearms safety training, 
  249.         "Eddie Eagle" youth education programs, the powerful 
  250.         "CrimeStrike" program (aimed at correcting the problems 
  251.         in the current justice system), and many others, they 
  252.         have taken an active role in working to fix the problems 
  253.         at their source WHILE fighting gun-control laws wrongly 
  254.         directed at restricting the rights of the law-abiding 
  255.         citizen.  Thunderous applause to this group.
  256.  
  257.     This space reserved...
  258.  
  259.         ...for YOUR name (if you send in new cartridge files!)
  260.