home *** CD-ROM | disk | FTP | other *** search
/ 100 Great Games for Palm OS & Handspring 3 / 100_Great_Games_for_Palm_OS_and_Handspring_Visors_Volume_3_Global_Star_Software_2001.iso / Arcade / handigolf / manual.txt < prev    next >
Text File  |  2001-01-05  |  17KB  |  349 lines
  1.  
  2.  
  3.  
  4.                           HandiGolf User's Manual
  5.  
  6.           Introduction
  7.  
  8. HandiGolf is a Palm Pilot program which allows you to play golf on your
  9. Palm III or better handheld. You play from an overhead view on the fairways
  10. and a view from the green when putting. The program has fairways, greens,
  11. sand traps, water, and trees. HandiGolf keeps track of your score and up to
  12. 3 other players, and saves any games which are interrupted. HandiGolf comes
  13. with a separate program to build the courses called HandiEdit.
  14.  
  15. This program is shareware, until you register the program you will be
  16. nagged when you start up to register. Also, when you register the program
  17. you will get notified of any updates or new courses. You will also have
  18. access to other courses that we have made, or that other registered users
  19. have made. Finally, this program will time out eventually, and then only
  20. all you to play 3 holes.
  21.  
  22. ---------------------------------------------------------------------------
  23.  
  24. Installation
  25.  
  26. Follow the standard PalmPilot installation procedure for HandiGolf:
  27.  
  28. First, unzip HANDI.ZIP somewhere on your PC or Mac. Then from Windows, run
  29. the PALMPILOT INSTALL TOOL program which will be in the same group as your
  30. PalmPilot Desktop application. When the install dialog comes up, click on
  31. the BROWSE button and navigate to the directory where you unzipped the PRC
  32. files. Select HANDI.PRC, TheLinks.PDB, StNasty.PDB, Duffers.PDB, and
  33. HEDIT.PRC by double-clicking it in the FILE OPEN dialog and then click on
  34. the INSTALL button. On the next HotSync, the HandiGolf application will
  35. appear in your list of applications.
  36.  
  37. The 5 files you installed are: HANDI.PRC - the actual golf program,
  38. TheLinks.PDB - a 9 hole course, Duffers.PDB - an 18 hole course,
  39. StNasty.PDB - a difficult 18 hole course, and HEDIT.PRC which is the course
  40. editor. HandiGolf uses databases of type PGlf (I was going to call the
  41. program a different name and registered PGlf) as courses, which is what
  42. HEDIT will make, so over time you will have databases of this type on your
  43. Palm device for each course that you have installed or created. HandiGolf
  44. also creates a small database on your Palm Pilot with registration
  45. information, and the status of the last game played.
  46.  
  47. WARNING: This game occasionally does not work with HackMaster installed. It
  48. runs in a timing loop to do the golf club swings, and HackMaster slows down
  49. the loop to the point of where the program dies. Uninstall hackmaster or
  50. turn it off before running HandiGolf. Or, if you feel daring, please try it
  51. out and let me know if it works now. I made a fix that might have fixed the
  52. problem.
  53.  
  54. ---------------------------------------------------------------------------
  55.  
  56. Shareware Registration
  57.  
  58. There are several ways to register this shareware program:
  59.  
  60. 1) Go to www.palmgear.com and register on-line, where they can take the
  61. usual credit cards and such. They also handle phone orders at 800 741-9070
  62. or fax at 817 640-6614. They can handle getting you the registration code.
  63.  
  64. 2) Send a check or money order for $15 US to:
  65.  
  66. Rick Eesley
  67. 1804 Middle Road
  68. Martinsville, NJ 08836 (USA)
  69.  
  70. Include an email address or return address so I can mail you the code to
  71. enter in the shareware screen. If there are problems contact me via Email
  72. at: reesley@eclipse.net.
  73.  
  74. ---------------------------------------------------------------------------
  75.  
  76. Operation
  77.  
  78. The program operates similarly to most Palm applications, most of the major
  79. dialogs are described in some detail below.
  80.  
  81. ---------------------------------------------------------------------------
  82.  
  83.           Starting
  84.  
  85. When you bring up HandiGolf you will be presented with a screen which asks
  86. if you would like to start a new game, load a previous game, or practice
  87. your drives or putting. Normally you will select New Game to start a new
  88. match. If you choose to practice drives or putts you will moved to a screen
  89. where you can work on your timing and test the lengths that different clubs
  90. will hit on the fairway. To reload a previous game click Reload Game and
  91. the last game that you were playing will come up.
  92.  
  93. ---------------------------------------------------------------------------
  94.  
  95.           Players Form
  96.  
  97. Once you have selected to start a new game you must enter the names of the
  98. players, or the program will cleverly choose names for you like Plyr1 and
  99. Plyr2. You also must select the number of players, by default there is only
  100. 1 player. If you enter more than one name but forget to set the number of
  101. players to more than one, the other names are ignored and the first name is
  102. used as the one players name. When you are finished entering the players
  103. names click done. Keep the players names short as they must be displayed on
  104. the Swinging form in the control area which is fairly small. Names much
  105. longer than about 6 characters will be brutally truncated.
  106.  
  107. ---------------------------------------------------------------------------
  108.  
  109.           Course Form
  110.  
  111. The names of all the courses installed on your Palm device will be listed
  112. here, pick one of them to play. If there are none listed then you must
  113. install at least one course from the Palm Desktop. To create other courses
  114. you use the HEDIT program which is documented somewhere else, and only
  115. available to registered users. If you want to play a course someone else
  116. has written just download their course.PDB file to your Palm device using
  117. the Palm Desktop. If it was created by HEDIT it will magically show up in
  118. your list of courses.
  119.  
  120. ---------------------------------------------------------------------------
  121.  
  122.           The Swing Form
  123.  
  124. This brings us to the actual play of the game, the Swing Form indicates
  125. whose turn it is, the current hole, the distance from the ball to the hole,
  126. and the number of strokes the indicated player has spent trying to complete
  127. this hole. The ball generally start on the tee and the idea is to hit it
  128. into the hole in as few strokes as possible. The different shading
  129. indicates the type of playing surface, the light shading is used for greens
  130. and fairways, medium shading is the rough, dark shading is used for trees
  131. and water, and no shading is used for the ball and for sand traps. The hole
  132. is indicated by the flag sticking up, and the ball flashes black and white.
  133.  
  134. The scale of the hole varies depending on how long the hole is, the longest
  135. holes are scaled so the screen covers 600 yards, medium length holes cover
  136. just shy of 300 yards, and short holes somewhat less than 150 yards. You
  137. must pay attention to this when determining how hard to hit a shot.
  138.  
  139. The Swinging screen is divided into two areas, the control area on the left
  140. and the overhead view on the right. The control area has status
  141. information, along with the current club selection, the direction the ball
  142. is going to be hit, and the hitting meter.
  143.  
  144. To hit a shot, first determine where you want to aim and what club to use.
  145. The box in the lower right corner of the control indicates the direction
  146. the shot will travel. When this form comes up it points directly at the
  147. hole, this will often be the direction you want to hit, but other times you
  148. will need to change it so as not to hit into the rough or some other
  149. obstacle. To change the direction tap on the screen with your pen, the
  150. arrow in the direction box will change to follow it. Next pick the club you
  151. want to use from the club pulldown form. You must be aware of what surface
  152. you are hitting the ball from when selecting a club. For example, when you
  153. are in the rough clubs hit with approximately 20% less power, when in the
  154. trees it is 40% less power. If you are in a sand trap you hit with 20% less
  155. power, and if you do not use a pitching wedge you will hit with 80% less
  156. power on top of that. Once that is set, hold down any of the four buttons
  157. along the bottom of your Palm device. A bar will come up the left side of
  158. the driving meter to determine the swing power, try and stop it at the bar
  159. across the meter by releasing the button. After that the bar will come up
  160. the right side of the meter to determine slice and hook, again try and stop
  161. it at the bar across the meter. There will be times when you don't want to
  162. hit full power, and times when you want to hit with some hook or slice,
  163. just experiment until you get the hang of it.
  164.  
  165. Once the swing is completed the path of the ball is traced out until it
  166. comes to rest, then information about your drive is displayed on the screen
  167. for about 5 seconds. This information includes what surface you landed on,
  168. such as sand, trees, water, the rough, the green, or on the fairway. If you
  169. land in water you will be penalized a stroke and have to hit from the same
  170. location you did last time. If there is more than one person playing this
  171. goes on in order until all players complete the hole.
  172.  
  173. Just a couple of technical notes on this form, if you hit the ball so hard
  174. that it goes off the screen it stops at the edge of the screen. You can
  175. cheat with this sometimes by whacking a ball with a 1 wood and get right to
  176. the top of the screen on shorter holes. Someday I may do something better
  177. with this, but for now HandiGolf acts like you hit the end of the world
  178. when you go off the drawn course. Additionally, you may notice that holes
  179. are scaled differently to fit on the screen. There are 3 scale factors; 1,
  180. 2, and 4. Holes drawn on a scale of 1 have one pixel to the yard, so the
  181. maximum lenght of a hole is 160 yards if the pin is right at the top, and
  182. the tee right at the bottom. Realistically this results in holes of about
  183. 130 yards maximum. At scale factor two you can have holes up to 260 yards,
  184. and scale 4 goes up to about 520 yard holes. You can usually figure out the
  185. scale by the length of the hole, so be careful to choose the right club
  186. based on the distance to the hole HandiGolf says, and not by the size of
  187. the screen.
  188.  
  189. ---------------------------------------------------------------------------
  190.  
  191.           Putting Form
  192.  
  193. Once you make it onto the green HandiGolf switches from the overhead view
  194. to the putting view. In the putting view you can only using the putter, and
  195. you cannot putt off the screen, it will just stop at the edge.
  196. Additionally, you cannot putt off of the green, no matter how hard you
  197. whack the ball. Putting also undergoes some scaling so you must carefully
  198. watch the distance to the pin when determining how hard to putt the ball.
  199. The direction arrow works the same for putting as for driving, and is
  200. normally set pointing right at the pin. Hitting works the same too except
  201. for that instead of hook and slice, the putt is just skewed to the left or
  202. right to make it harder to putt.
  203.  
  204. ---------------------------------------------------------------------------
  205.  
  206.           Score
  207.  
  208. After all the players complete the hole the scoreboard is displayed, when
  209. you are finished reading it tap on the Done button and you will go to the
  210. next hole. If you have completed the course then you will return to the
  211. course form where you can pick another course to play.
  212.  
  213. ---------------------------------------------------------------------------
  214.  
  215. ---------------------------------------------------------------------------
  216.  
  217.           HandiEdit
  218.  
  219. HandiEdit creates golf courses for HandiGolf, it is still a little raw, if
  220. you try to break it you will probably be able to. To run HandiEdit, leave
  221. HandiGolf and go to the Applications list by tapping on the applciations
  222. button. Tap on HandiEdit. When you start HandiEdit you will be in a form
  223. which allows you to create a new course or delete any old ones. To create a
  224. new course enter a name for it and click the New button. To go to the
  225. course deleting form click on the Dele button.
  226.  
  227. ---------------------------------------------------------------------------
  228.  
  229.           Deleting Courses
  230.  
  231. The course deleting form puts up a list box with all the courses installed
  232. on your Palm device, select one and click the Del button to remove it. When
  233. you are finished click Done to return to the previous form.
  234.  
  235. ---------------------------------------------------------------------------
  236.  
  237.           Describing a Hole
  238.  
  239. After naming your course and clicking on New from the main form, you go to
  240. this form to describe the hole. Make sure and set all the fields you are
  241. interested in before going to the Next screen, you cannot come back. The
  242. fields are: Hole, Par, Scale, Green Lean, Lean Amt, Wind, and Wind Amt. Do
  243. not set Hole, that is automatic. Set Par to the par for the current hole.
  244. Set Scale to 1, 2 or 4, where 1 is for holes in a 100 X 160 yard area, 2 is
  245. for holes in a 200 X 320 yard area, and 4 is for holes in a 400 X 640 yard
  246. area. Green Lean is a direction such as N for North, or NW for north west,
  247. this is the direction that the green leans. The Lean Amt is how sharp the
  248. green leans, it can be 0 for no lean up to 4. Wind is the direction of the
  249. wind, North is the top of the screen. Wind Amt is a value from 0 to 4 to
  250. specify how strong the wind is. Once these values are entered click the
  251. Next button.
  252.  
  253. ---------------------------------------------------------------------------
  254.  
  255.           Entering the Hole Layout
  256.  
  257. On the next screen you will do the actual hole layout. You MUST enter a
  258. Hole location and a Tee location, if you enter more than one, only the last
  259. one is remembered. In order to be uniform, the tee should be on the bottom
  260. of the screen, and the hole somewhere on the top of the screen. Then click
  261. one of Fairway, Green, Sand, Tree, or Water to enter those things. Trees
  262. are single points on the screen, just tap the pen where you want them. The
  263. other things are polygons, enter a series of points and then click EndPgn
  264. to end the polygon and close it. Make sure NOT to enter any points twice.
  265. When you are finished putting up obstacles click Done to go to the overhead
  266. page which draws the final version of the hole.
  267.  
  268. There are a few restrictions on data you can enter into the course. First,
  269. there are limits to how much data a course can have. It is safe to have a
  270. few fairways, a green, 3 or 4 sand traps and 3 or 4 water traps, along with
  271. 20 or so trees. Much more than that and you will run into data limitations
  272. which will now allow you to continue the current hole. It is hard to give
  273. exact limits for the amount of data because the space limitation is really
  274. the number of scan line events (math goop). The program will warn you and
  275. require you to re-enter the hole. There are severe restrictions on the
  276. polygons you enter for course topography. FIrst, polygons cannot cross
  277. themselves or other polygons. No figure 8 type polygons are allowed. You
  278. cannot have a sand trap intersect water, or a fairway, instead you must
  279. leave room on the fairway for the sand trap. There are no holes allowed in
  280. the polygons, because you cannot make a hole without self crossing.
  281. Although these restrictions may sound severe, in practice they rarely come
  282. up.
  283.  
  284. ---------------------------------------------------------------------------
  285.  
  286.           Accepting the Hole Layout
  287.  
  288. Click Okay to accept the hole, Redo to do it again, and Finish to complete
  289. the entire course. When entering the polygon data make every effort not to
  290. cross lines, or draw figure 8's, or repeat points. If you do they should be
  291. trapped and you will have to redo the entire hole.
  292.  
  293. Next time you start up HandiGolf you will see this new course in the list
  294. of courses
  295.  
  296. ---------------------------------------------------------------------------
  297.  
  298. Release Notes
  299.  
  300. Release 1.4
  301.  
  302. - Fixed a loophole in the program, if you let hook run off the bar (ie:
  303. full hook) the power was HUGE, so you could get to the top of the screen in
  304. one shot even on 600 yard holes.
  305.  
  306. Release 1.3
  307.  
  308. Fixed a number of bugs:
  309.  
  310. - Finally got the elusive huge par number bug, some holes showed a par
  311. value like 163. It turned out the courses had the wrong par's in them due
  312. to a bug in Hedit. The courses have been fixed, and the bug in Hedit is
  313. also fixed.
  314.  
  315. - There were places that referred to a 2 wood and 4 wood, now the only
  316. woods are a 1 and 3 wood consistently. The clubs are 1W, 3W, 2I, 3I, 4I,
  317. 5I, 6I, 7I, 8I, PW, and PT (putter).
  318.  
  319. - Changed the sayings around after shots just for some variety.
  320.  
  321. - Added the Par for the current hole to the swinging form.
  322.  
  323. - Allowing a player to sink the ball from other than the greens, it used to
  324. be you could only get the ball in the hole by putting, now if you are close
  325. enough on your drive you can sink it too.
  326.  
  327. - Added the distance that a putt travelled on the after putting form.
  328.  
  329. - Changed registration to time out, maybe some more people will register
  330. now.
  331.  
  332. Release 1.2
  333.  
  334. Added St Nasty course, a much more difficult course
  335.  
  336. Release 1.1
  337.  
  338. Ported to Palm OS3.5 (not as easy as it sounds). I expect this to clear up
  339. a number of problems that I have had on newer platforms. In particular,
  340. this game now works with Palm Vx's and Color Palms.
  341.  
  342. Fixed a number of bugs reported by users, mostly to do with restarting a
  343. saved game.
  344.  
  345. ---------------------------------------------------------------------------
  346.  
  347. Last Updated: Apr, 2000
  348. reesley@eclipse.net
  349.