The Datafile PD-CD 5/DATAFILE_PDCD5.iso/utilities/c/cbs/CSB/!CSB

Text File | 1996-04-10 | 14.4 KB | 249 lines

CSB: Cricket Scorebook; a powerful cricket scoring & stats program.

Please see Readme file for license conditions.

### Introduction ############################################################

   CSB is a replacement for the standard paper-and-pencil scorebook. It has
the advantage over this type of scorebook that it keeps track of both teams,
can provide instant, detailed statistics, and doesn't make mistakes when runs
and wickets start flowing fast.

   I wrote CSB after scoring for a cricket team for a season and discovering
that scoring is intricate and time-consuming work. I decided to write a
program that would do all the work from a minimal human input, leaving me
more time to watch the cricket. As the program grew in complexity, I added a
statistics section and separated out the part of the program dealing with
team creation.

### Please Note #############################################################

   CSB needs RISC OS 3.10 or above. To look nice, it needs 3D interface
sprites (bumper arrows that slab, round radio icons, tick-y option icons and
especially those nice 'gright', 'pgright' menu button icons). CSB will grab
memory as it requires it; running without the Laws loaded uses 208k.

### Basic Usage #############################################################

   To use CSB, you will first need to create two teams using the !MakeTeam
software, discussed elsewhere. Run CSB and click on its icon to display the
setup window. Drag the team files to the icons at the top of the window. You
can enter details of umpires and so on if you wish; you can change these
later if you wish (note that you CANNOT change the 'toss won by' field).
Select the match type you require and click OK.

   The 'Start innings' window will appear; this will return at (guess) the
start of each innings. You need to fill in all three fields using the menu
icons - note that you will not be able to select the team to bat if it is
obvious. When you click OK, the timers will start, so only do this as the
batsmen step onto the field (if you want to be really accurate).

   The 'Ball by ball' window will appear; this is CSB's main window. The name
of the facing batsman is shown; click 'Swap' to force the batsmen to change
ends. This is a completely 'free' operation, used for example when the
batsmen cross before one of them is caught.
   Below the batsman's name is the bowler of the current over; use the menu
icon under the 'Swap' button to choose this.
   Below the bowler's name is a writable icon. This is where you record each
delivery using a system of ball codes; click the window's toggle size icon to
see a list. So, for a 'dot ball' (ie. nothing happens) just press return, or
click 'OK'. You will see that 'Over 1 ball 1' has become 'Over 1 ball 2'. So,
to record some runs, just type the number scored & press return (or click
'OK'). For extras, enter  'n', 'x', 'b', or 'l' as appropriate and then the
number. If you make a mistake, see 'The Editor' below.
   A simple character typed on its own (eg. 'l') will be interpreted as one
extra (eg. 1 leg bye), EXCEPT FOR no-balls: 'n' means simply that, a no-ball.
'n1' is different - the striker gets credit & the batsmen swap ends. Think
about it.
   To the right of the 'OK' button is a clump of three buttons. 'Draw' and
'Declaration' are pretty straight-forward, but 'Halt' is possibly worthy of
comment. A click here will change the text displayed to 'Start', and pause
the timers (batsmen minutes at crease, innings length, partnership length &
so on). This is for tea intervals, drinks breaks, nights in 2+ day matches
and so on. Click again to restart.
   I haven't mentioned wickets yet; here we go. If a wicket falls or a
batsman retires, type 'w', irespective of which batter is out and of any runs
scored. The 'Batsman dismissed' window is displayed. Choose how the batsman
was out and, if necessary, /which/ batsman was out. If the batsman was run
out and runs were completed beforehand, type the number in the icon next to
the 'Run out' radio icon. If runs were completed before another type of
dismissal, see 'The Editor' below. You may enter a comment on the dismissal
if you wish; select the next batsman if there is one and click 'OK'.
   If a batter retires, you need to choose the 'retired hurt' option (under
'other') and use the Editor to change his 'how out' to 'retired hurt, out'.
   If you click on a code in the 'Ball codes' box, the letter will be entered
in the writable - try it and see.

### The File Submenu ########################################################

   Clicking MENU on the 'Ball by ball' window opens the CSB main menu.
Opening the 'File' submenu enables you to access a standard save box, a
standard(-ish) fileinfo window and the print menu. CSB can produce two types
of printout: a match summary and an innings summary. You need to have run
!Printers to print from CSB.

### The Match Submenu #######################################################

   The 'Match' submenu contains five entries (one shaded) which mimic the
buttons in the main window, and another entry below a dotted line which opens
the CSB editor - see later.

### Extra Features - Clocks & Scoreboards ###################################

   Examination of the 'Scoreboards' & 'Timing' submenus will reveal four
entries, each of which opens a window. These can be toggled from the keyboard
('^' means CTRL) or using the menus. The clock and small scoreboard can be
moved around by dragging them; if you drag the timer display it will move.
The timer is included for fun - I'm not sure what you could use this for
(possibly time off field). Click the green button to start the timer (hours
and minutes - cricket's a slow game!), the red to halt it and the 'oo:oo'
button to reset.

### Extra Features - Miscellaneous ##########################################

   Choosing 'Quick entry' from the main menu or pressing CTRL-Q will toggle
the 'Quick entry' window (where do I get these names from). Click a number to
enter it as a ball code. The window can be moved around by dragging the small
icon above the '1' & '2' buttons. Using this in combination with the 'Ball
codes' box can eliminate the keyboard altogether (eg. click on "z wides : xz"
and then '2' to enter the code 'x2' - two wides run).

   In some (most) forms of cricket, a certain number of overs need to be
bowled in the last hour; after these expire the match ends. If a result has
not been reached, the match is drawn. To impose such an overs limit, open the
'Countdown' submenu from the main menu and type in the limit. This number
INCLUDES the current over - you can check this from the large scoreboard.

### Statistics & Comments ###################################################

   Following 'Statistics' from the main or iconbar menus leads to the
Statistics submenu (duh...). Choosing one of the first three options opens a
statistics window (double duh...). From the top:
   The 'Match' option reveals the 'Match Information' (eh?) window containing
match info (toss, umpires etc.), the result (if available), and a
fall-of-wicket table. Click 'Partnerships' to display a nice bar chart of
partnerships (not shaded like the BBC's one though). 'Print' prints a match
summary. Click MENU to choose the innings whose stats are being displayed.
   The 'Batting' option reveals a batting summary. Click 'Print' to print the
innings, or MENU to choose the innings whose stats are being displayed. Any
'not out's are displayed in red. Click on a player's name to display a player
batting summary, both for the match & previous career.
   The 'Bowling' option reveals a bowling summary. Click 'Print' to print the
innings, or MENU to choose the innings whose stats are being displayed. Click
on a player's name to display a player bowling summary, both for the match &
previous career. Note that if more than seven bowlers are used, their names
will not be displayed. This will change when I alter the window from using
loads of icons to a non-auto redrawn one.

   The fourth entry on the 'Statistics' submenu leads to the 'Comments'
submenu. Click 'Display' to open the 'Comments' window. This is where CSB
will record momentous events (batsmen's 50s, the first boundary of the
innings and so on). You can also add comments; just type them in a text
editor (eg. Edit, Zap) and save the file onto the comments window. You can
save off all the comments (eg. for editing) from the 'Save' option on the
'Comments' menu (or shift-f3).

### The Editor ##############################################################

   Open the 'Editor' window from the match submenu, choose 'Edit' from the
iconbar menu, or press ^E or f5. This dialogue box is complex and can do
dangerous things. It can be used to correct errors (on your part or that of
CSB), deal with unusual situations, or enter a [partial] record of a match.

   To do some Editing, first choose the innings you wish to edit with the
top row of radio icons. You cannot edit an innings that hasn't started or
doesn't exist. Then choose the area of play you wish to alter.
   'Batting' & 'Bowling' enable you to change, for example, the number of
runs scored / balls faced / overs bowled / no-balls bowled (etc.) by a player
- pick the player in question using the menu icon.
   'Score' enables you to alter the score breakdown for the innings and the
score at which the last wicket fell IN THE PRESENT INNINGS.
   Choosing 'FoWs' enables you to alter the partnerships-cum-fall of wickets
in the innings. Here, 'bat no.'s refer to batting order (as you'd expect).
   'Match' is simple - you can alter the names of the umpires, scorers and so
on. 'match title' should be something like '6th Cornhill Test'.
   'Innings' contains data such as total overs bowled and wickets down. The
'facing batsman' entry IS NOT the batting order. Use the menu button to
choose the batsman who you want to be facing; this will enter the correct
number in the icon. The bottom writable here, 'change innings now' is really
an option button. If you enter a number here, the current innings will end
when you click 'OK'.
   When you've finished editing an area, click an 'OK' button. The one inside
the box will update CSB's internals, while the outside one will do this and
then close the Editor.

   For more information on the Editor, several worked examples (I sound like
my Advanced Mechanics textbook) and just WHY you need a 'change innings now'
button, see the 'Editor' file in this directory.

### The Laws ################################################################

**********
          Laws not included in this release due to MCC regulations
                                                                  ***********

### The Options Window ######################################################

   Choose 'Options' from the iconbar menu to open this window (you probably
already have - I know it's the first thing I do when I get a new program).
   The options are split into five sections and are really self-explanatory
(like most of the program too, I reckon). 'Default match details'
(surprisingly) has nothing whatsoever to do with lost balls. Note that values
supplied here are just defaults; they can be changed. When the first innings
of a new match commences, or a new match is loaded into CSB, CSB is able to
open certain support windows (because everything works on toggles, if they're
open they'll be (unhelpfully) closed again) - you can choose these here.
   When you load some comments (ie. drop a &fff file onto the comments
window), CSB will either c-c-c-concatenate them, replace them, or leave the
decision up to you. You can choose this here. CSB will occasionally make a
comment; choose which you require here. Note that although partnership
minutes and balls are kept track of (see the 'Partnerships' window), they are
not present in the comment (due to a technical hitch. I forgot).
   The final area - Miscellaneous - contains five options. From the top:
   Time check on startup - if ticked, CSB will tell you what time it thinks
it is when it is first loaded (good word, it, eh?).
   Use 8-ball ove.... - if the 'overs bowled' field in the players' careers
refers to 8-ball overs tick this box or the strike rates given will be wrong.
   Update team files - if ticked, when the match (or is it innings? I forget)
is complete, the statistics for the match will be added on to the career
stats (just checked, it is innings) ie. normally tick this!
   Add comments to printout - if this is ticked, the comments will be added
to the foot of any 'Match summaries' output. If you have a lot of comments in
a 2-innings match, they may get cut in half. This is 'cos I don't have the
PRMs, so have worked out how to print in a very basic & haphazard way.
   Automatically load Laws - The Laws take up quite a lot of memory. If this
option is NOT ticked, they will only be loaded & decompressed when required
(ie. you choose something from the 'Laws' submenu). If it /is/, they will be
loaded on initialisation.

   Click 'Default' to set the default options, 'Save' to set and save the
current options, 'Cancel' to undo any option changes & close the window, 'OK'
to set the options & close the window. The options are recorded in the file
'Options' (did you guess?) in the !CSB app. directory. Please delete this
file (The 'Options' one, not /this/ this file!) before passing on the
application.

### Limitations #############################################################

   Damn - I wanted to say 'None' here, but I can't quite yet. In one-day
games, if a result cannot be reached for some reason (rain, tie), the result
is worked out from (eg.) a score comparison after (say) 20 overs. The problem
with CSB is that you can't edit the actual match result.
   If you get to the end of an innings, nine wickets fallen & one man retired
hurt, to end the innings you need to put the retiree in (even if he doesn't
bat again), and use the "Editor->Innings->Change innings now" option. Ok, it
works but it could be better.
   Partnership comments could be better.
   Toss cannot be changed.
   Also, CSB has been known to crash with an error of 'Uncaught trap: No
stack for trap handler' when requested to display some statistics. This
happens very rarely, completely unpredictably, and usually at the most
annoying time possible. You have been warned.
   The tick for the 'Quick Entry' menu option can appear by the 'Timing' menu
option.

### Final Bit ###############################################################

   I welcome any feedback - my addresses are at the bottom of the Readme file
in the same directory as this file.
   !CSB was written by John Fairhurst using DeskLib.