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.