DragonFly On-Line Manual Pages

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)