home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / c / cbs / CSB / !CSB next >
Text File  |  1996-04-10  |  15KB  |  249 lines
  1. CSB: Cricket Scorebook; a powerful cricket scoring & stats program.
  2.  
  3. Please see Readme file for license conditions.
  4.  
  5. ### Introduction ############################################################
  6.  
  7.    CSB is a replacement for the standard paper-and-pencil scorebook. It has
  8. the advantage over this type of scorebook that it keeps track of both teams,
  9. can provide instant, detailed statistics, and doesn't make mistakes when runs
  10. and wickets start flowing fast.
  11.  
  12.    I wrote CSB after scoring for a cricket team for a season and discovering
  13. that scoring is intricate and time-consuming work. I decided to write a
  14. program that would do all the work from a minimal human input, leaving me
  15. more time to watch the cricket. As the program grew in complexity, I added a
  16. statistics section and separated out the part of the program dealing with
  17. team creation.
  18.  
  19. ### Please Note #############################################################
  20.  
  21.    CSB needs RISC OS 3.10 or above. To look nice, it needs 3D interface
  22. sprites (bumper arrows that slab, round radio icons, tick-y option icons and
  23. especially those nice 'gright', 'pgright' menu button icons). CSB will grab
  24. memory as it requires it; running without the Laws loaded uses 208k. 
  25.  
  26. ### Basic Usage #############################################################
  27.  
  28.    To use CSB, you will first need to create two teams using the !MakeTeam
  29. software, discussed elsewhere. Run CSB and click on its icon to display the
  30. setup window. Drag the team files to the icons at the top of the window. You
  31. can enter details of umpires and so on if you wish; you can change these
  32. later if you wish (note that you CANNOT change the 'toss won by' field).
  33. Select the match type you require and click OK.
  34.  
  35.    The 'Start innings' window will appear; this will return at (guess) the
  36. start of each innings. You need to fill in all three fields using the menu
  37. icons - note that you will not be able to select the team to bat if it is
  38. obvious. When you click OK, the timers will start, so only do this as the
  39. batsmen step onto the field (if you want to be really accurate).
  40.  
  41.    The 'Ball by ball' window will appear; this is CSB's main window. The name
  42. of the facing batsman is shown; click 'Swap' to force the batsmen to change
  43. ends. This is a completely 'free' operation, used for example when the
  44. batsmen cross before one of them is caught.
  45.    Below the batsman's name is the bowler of the current over; use the menu
  46. icon under the 'Swap' button to choose this.
  47.    Below the bowler's name is a writable icon. This is where you record each
  48. delivery using a system of ball codes; click the window's toggle size icon to
  49. see a list. So, for a 'dot ball' (ie. nothing happens) just press return, or
  50. click 'OK'. You will see that 'Over 1 ball 1' has become 'Over 1 ball 2'. So,
  51. to record some runs, just type the number scored & press return (or click
  52. 'OK'). For extras, enter  'n', 'x', 'b', or 'l' as appropriate and then the
  53. number. If you make a mistake, see 'The Editor' below.
  54.    A simple character typed on its own (eg. 'l') will be interpreted as one
  55. extra (eg. 1 leg bye), EXCEPT FOR no-balls: 'n' means simply that, a no-ball.
  56. 'n1' is different - the striker gets credit & the batsmen swap ends. Think
  57. about it.
  58.    To the right of the 'OK' button is a clump of three buttons. 'Draw' and
  59. 'Declaration' are pretty straight-forward, but 'Halt' is possibly worthy of
  60. comment. A click here will change the text displayed to 'Start', and pause
  61. the timers (batsmen minutes at crease, innings length, partnership length &
  62. so on). This is for tea intervals, drinks breaks, nights in 2+ day matches
  63. and so on. Click again to restart. 
  64.    I haven't mentioned wickets yet; here we go. If a wicket falls or a
  65. batsman retires, type 'w', irespective of which batter is out and of any runs
  66. scored. The 'Batsman dismissed' window is displayed. Choose how the batsman
  67. was out and, if necessary, /which/ batsman was out. If the batsman was run
  68. out and runs were completed beforehand, type the number in the icon next to
  69. the 'Run out' radio icon. If runs were completed before another type of
  70. dismissal, see 'The Editor' below. You may enter a comment on the dismissal
  71. if you wish; select the next batsman if there is one and click 'OK'.
  72.    If a batter retires, you need to choose the 'retired hurt' option (under
  73. 'other') and use the Editor to change his 'how out' to 'retired hurt, out'.
  74.    If you click on a code in the 'Ball codes' box, the letter will be entered
  75. in the writable - try it and see.
  76.  
  77. ### The File Submenu ########################################################
  78.  
  79.    Clicking MENU on the 'Ball by ball' window opens the CSB main menu.
  80. Opening the 'File' submenu enables you to access a standard save box, a
  81. standard(-ish) fileinfo window and the print menu. CSB can produce two types
  82. of printout: a match summary and an innings summary. You need to have run
  83. !Printers to print from CSB.
  84.  
  85. ### The Match Submenu #######################################################
  86.  
  87.    The 'Match' submenu contains five entries (one shaded) which mimic the
  88. buttons in the main window, and another entry below a dotted line which opens
  89. the CSB editor - see later.
  90.  
  91. ### Extra Features - Clocks & Scoreboards ###################################
  92.  
  93.    Examination of the 'Scoreboards' & 'Timing' submenus will reveal four
  94. entries, each of which opens a window. These can be toggled from the keyboard
  95. ('^' means CTRL) or using the menus. The clock and small scoreboard can be
  96. moved around by dragging them; if you drag the timer display it will move.
  97. The timer is included for fun - I'm not sure what you could use this for
  98. (possibly time off field). Click the green button to start the timer (hours
  99. and minutes - cricket's a slow game!), the red to halt it and the 'oo:oo'
  100. button to reset.
  101.  
  102. ### Extra Features - Miscellaneous ##########################################
  103.  
  104.    Choosing 'Quick entry' from the main menu or pressing CTRL-Q will toggle
  105. the 'Quick entry' window (where do I get these names from). Click a number to
  106. enter it as a ball code. The window can be moved around by dragging the small
  107. icon above the '1' & '2' buttons. Using this in combination with the 'Ball
  108. codes' box can eliminate the keyboard altogether (eg. click on "z wides : xz"
  109. and then '2' to enter the code 'x2' - two wides run).
  110.  
  111.    In some (most) forms of cricket, a certain number of overs need to be
  112. bowled in the last hour; after these expire the match ends. If a result has
  113. not been reached, the match is drawn. To impose such an overs limit, open the
  114. 'Countdown' submenu from the main menu and type in the limit. This number
  115. INCLUDES the current over - you can check this from the large scoreboard.
  116.  
  117. ### Statistics & Comments ###################################################
  118.  
  119.    Following 'Statistics' from the main or iconbar menus leads to the
  120. Statistics submenu (duh...). Choosing one of the first three options opens a
  121. statistics window (double duh...). From the top:
  122.    The 'Match' option reveals the 'Match Information' (eh?) window containing
  123. match info (toss, umpires etc.), the result (if available), and a
  124. fall-of-wicket table. Click 'Partnerships' to display a nice bar chart of
  125. partnerships (not shaded like the BBC's one though). 'Print' prints a match
  126. summary. Click MENU to choose the innings whose stats are being displayed.
  127.    The 'Batting' option reveals a batting summary. Click 'Print' to print the
  128. innings, or MENU to choose the innings whose stats are being displayed. Any
  129. 'not out's are displayed in red. Click on a player's name to display a player
  130. batting summary, both for the match & previous career.
  131.    The 'Bowling' option reveals a bowling summary. Click 'Print' to print the
  132. innings, or MENU to choose the innings whose stats are being displayed. Click
  133. on a player's name to display a player bowling summary, both for the match &
  134. previous career. Note that if more than seven bowlers are used, their names
  135. will not be displayed. This will change when I alter the window from using
  136. loads of icons to a non-auto redrawn one.
  137.  
  138.    The fourth entry on the 'Statistics' submenu leads to the 'Comments'
  139. submenu. Click 'Display' to open the 'Comments' window. This is where CSB
  140. wil