DragonFly On-Line Manual Pages

Search: Section:  


TKSOL(6)                    DragonFly Games Manual                    TKSOL(6)

NAME

Tksol - Tcl/Tk based solitaire card game.

DESCRIPTION

TkSol is a Tcl/Tk version of the standard card solitaire. It is relaxed with the official rules of Klondike, notably - * An Autofinish button is presented when all cards on the playing stacks are upturned. * There is a modest cheat feature.

FEATURES

Double clicking on a face-up card will try to move it to an end-stack. Double clicking on a King will try to move it to a vacant play-stack. Middle button of 3 button mice performs a double-click. Moving cards from the end-stacks back to the playing-stacks ~is~ allowed. The Autofinish button will appear when the last face-down card on the playing stacks is overturned. There may still be face-down cards on the draw stacks and, ~technically~, the game may not be won even though the button allows a quick finish. Holding the 'control' key while dragging a single upturned card to the drawleft stack will return it to the stack. This is a cheat.

SCORING

Movement Score -------- ----- draw-stack -> end-stack: +6 points play-stack uncovered: +3 points play-stack -> end-stack: +3 points play-stack -> play-stack: -1 points end-stack -> play-stack: -8 points undo: -10 points

OPTIONS

Game options are accessible through the options window, from the command-line , or by editing ".tksolrc" in the users home directory (see Customization). Command line options override those specified in the .tksolrc file. These are: -flip number Number of cards flipped from the drawleft stack to the drawright stack at a time. -speed number The relative speed by which the cards "fly" around in the game, eg. when you double click on a card. -back colour Canvas background colour. -red colour Colour of the red suit cards. -black colour Colour of the black suit cards. -spacing number Number of pixels spacing between the playing-stacks. -debug

CUSTOMIZATION

TkSol can be further customized by editing "~/.tksolrc". Commands are of the form: set <variable> <value> for example: set Var(canvas.background) ForestGreen set Var(flip) 3 The following are some variables that are not otherwise accessible: Var(card.redBackground) Background colour of the red suit cards. Var(card.blackBackground) Background colour of the black suit cards. Var(cardback_bg) Background colour of the card face down bitmap. Var(button.font) Font for the buttons and score-box. Var(button.foreground) Var(button.background) Foreground and background colours of the buttons when not depressed. Var(button.activeForeground) Var(button.activeBackground) Foreground and background colours of the buttons when depressed. Var(stack.up_spacing) Vertical spacing between the face-up cards on a stack. The default spacing is 15 pixels. Var(stack.down_spacing) The vertical spacing between the face-down cards on a stack. The default spacing is 8 pixels. Var(stack.side_spacing) horizontal spacing between the cards on the drawright stack when more than one card is flipped over from the drawleft stack. The default is 15 pixels. Var(side_margin) Left and right margins on the canvas. The default is 15 pixels. Var(top_level) The position of the top edge of the draw and end-stacks on the top level. The default is 15 pixels from the top of the canvas. Var(bottom_level) The position of the top edge of the stacks on the bottom level, i.e. the playing-stacks. The default is 150 pixels from the top of the canvas.

GEOMETRY

Tksol has a very flexible geometry, and may be set by changing some of the above width and height variables... But as of version 1.4, this feature is deprecated, and not extensively bug-tested. The canvas width is computed with the following twisted formula: (7 * card.width) + (2 * side_margin) + (6 * stack.spacing) while that for the canvas height is (card.height * 4.5) Note that the top_level and bottom_level options have to be set explicitly, ie. they do not depend on other options. KNOWN-BUGS Please send bug reports to S.A.

AUTHORS

Bao Trinh (bao@cs.umd.edu). Steven Atkinson (stevenaaus@yahoo.com) MAINTAINED-BY Steven Atkinson (stevenaaus@yahoo.com)

COPYRIGHT

Copyright (c) 1993 by Bao Trinh. 2004 by Steven Atkinson. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. May 22, 2004 TKSOL(6)

Search: Section: