TKSOL(6)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 explic‐
itly, 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)
