home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / xjig / xjig.cat < prev    next >
Text File  |  1996-07-24  |  16KB  |  216 lines
  1.  
  2. NAME
  3.        xjig - the jigsaw puzzle
  4.  
  5. SYNOPSIS
  6.        xjig <options>
  7.  
  8. DESCRIPTION
  9.        XJig  is a puzzle, that tries to replicate a jigsaw puzzle
  10.        on the screen as close as possible.  As  in  every  jigsaw
  11.        puzzle, the goal is to set all the pieces together. If you
  12.        like, you can watch the time that you spent for it.
  13.  
  14.        Any image-file in gif-format can be used as the source for
  15.        the  puzzle,  which is then randomly created regarding the
  16.        sizes selected by the options.
  17.  
  18.        The control should be as intuitive as possible in the  way
  19.        that  you will usually pull the freely rotatable pieces at
  20.        one edge, drag them to the desired  destination  and  drop
  21.        them  so  they  will snap together easily when close to an
  22.        neighboured tile.
  23.  
  24.  
  25. SPECIAL EFFECTS
  26.        Tiles are freely formed and rotatable with texture mapping
  27.        routines  to  give  the  appearance  of a real mess on the
  28.        screen.
  29.  
  30.        Tiles snap together very easy if they  are  dropped  some-
  31.        where  close  to another matching tile, when turned in the
  32.        correct direction.
  33.  
  34.        Puzzles can be doubled sided so you might have to flip the
  35.        tiles to the correct side to let them snap together.
  36.  
  37.        If the Xserver supports the Shape-Extension, the tiles can
  38.        be opened directly on the desktop, which is a pretty show-
  39.        case,  but you need a very fast machine for really getting
  40.        this playable. (Any ideas on how to add  double  buffering
  41.        to  the  shaped-window  approach  of the jigsaw are warmly
  42.        welcome!)
  43.  
  44.  
  45. CONTROLS
  46.        The usual way to move the pieces on the screen  should  be
  47.        to drag the piece with the left mouse button to their des-
  48.        tination by pulling them at on edge.  The piece will auto-
  49.        matically  rotate  like if you pull or push them with your
  50.        fingertip on a table.
  51.  
  52.        In addition, the following movements are possible:
  53.  
  54.          click left:        rotate 90 degrees left
  55.          click right:       rotate 90 degrees right
  56.          click middle:      flip tile to backside
  57.          drag left:         rotator drag (as mentionned above)
  58.             +middle:        pause rotator drag for a straight drag
  59.          drag middle:       straight drag
  60.             +left:          pause drag for a static rotation
  61.             +click left:    rotate 90 degrees left during drag
  62.             +click right:   rotate 90 degrees right during drag
  63.          CTRL+click left:   same as click middle
  64.  
  65.        The right button has actually the  same  functionality  as
  66.        the  middle button so that 2 button systems shouldn't have
  67.        problems. Only the "drag middle+click right" move will not
  68.        work  in  that  mode, and the flipping has to be done with
  69.        the help of the CTRL-key.
  70.  
  71.  
  72. OPTIONS
  73.    Tile Selection
  74.        -file name  use the specified file as the source image for
  75.                    the puzzle
  76.  
  77.        -side p     select  the side of the image to be on top, if
  78.                    you don't like the mess with the double  sided
  79.                    tiles.
  80.  
  81.    Size Selection
  82.        -w x        Select  number  of  tiles in horizontal direc-
  83.                    tion. The Images are automatically rotated  in
  84.                    portrait  orientation  before they are sliced.
  85.                    Therefore x usually should be smaller  than  y
  86.                    of the next option.
  87.  
  88.        -h y        Select  number  of tiles in vertical direction
  89.                    respectively.
  90.  
  91.        -ts n       Select average tile width. Instead of  explic-
  92.                    itly  specifying  the number of tiles by using
  93.                    the previous options -w and  -h,  the  average
  94.                    tile  width  in pixels can be selected and the
  95.                    values for x and y above are computed  accord-
  96.                    ing to to the selected size.
  97.  
  98.    Image Options
  99.        -ww x       Select  width  of image in pixels. This can be
  100.                    used to scale the image before playing for the
  101.                    case that a very large image is the source.
  102.  
  103.        -wh h       Select  height of image in pixels. If only one
  104.                    of -ww and -wh, the aspect ratio is kept  con-
  105.                    stant.
  106.  
  107.        -no_crop    The  image  is  usually automatically cropped,
  108.                    since many images are surrounded by frames  or
  109.                    textual  comments.  The  cropping  stops  at a
  110.                    reasonable amount of colors per line  or  row.
  111.                    If  this is not desired of if you want to puz-
  112.                    zle with painted images with  few  color,  you
  113.                    should disable this feature.
  114.  
  115.        -no_flip    Before  tiling  takes place, a landscape image
  116.                    is rotated to  portrait  mode,  which  effects
  117.                    successive  options like -w or -ww. If this is
  118.                    not desired, you can switch this feature  off.
  119.  
  120.  
  121.    X-Window options
  122.        -display name
  123.                    Select the display to connect to.
  124.  
  125.        -shapes     If  the  SHAPE-extension  is supported by your
  126.                    display, you can use this option to  let  each
  127.                    puzzle  tile  appear in its own shaped window.
  128.                    The results might depend on the  behaviour  of
  129.                    the  window-manager.  The  manager is actually
  130.                    advised by  the  override  redirect  attribute
  131.                    flag  of  the puzzle shapes not to do anything
  132.                    with them. But who knows ...
  133.  
  134.        -no_shm     When the program was build with support of the
  135.                    MIT-SHM extension, it might crash when started
  136.                    to display on a remote machine or  X-terminal.
  137.                    You  can  deselect  the usage of the extension
  138.                    with this option.
  139.  
  140.  
  141.    Miscellaneous
  142.        -no_anim    Turns off animation of rotation and  flipping,
  143.                    for  the case the machine isn't fast enough to
  144.                    make it look nice.
  145.  
  146.  
  147. ZOOMING & PANNING
  148.        For not losing tiles at the window border and for  getting
  149.        more workspace, the game has some zooming and panning fea-
  150.        tures to control the view on  your  desk.  They  are  con-
  151.        trolled via the keyboard with the following functionality:
  152.  
  153.          Cursor Keys:       Pan View
  154.          Page-Up or Add:    Zoom in
  155.          Page-Down or Sub:  Zoom out
  156.          Home:              Reset to original size
  157.          End:               Set maximum zooming to view all tiles
  158.  
  159.        The image quality usually suffers from zooming, since gif-
  160.        images  are  usually  dithered  to be viewed best in their
  161.        original size.  This also applies to the size options  -ww
  162.        and -wh.
  163.  
  164.  
  165. Color Allocation
  166.        The  program  was  tested  on  PseudoColor- and TrueColor-
  167.        displays.  On PseudoColor-displays the program  might  run
  168.        out of colors, since colors are very limited and it has to
  169.        share its colors with other clients.  It  tries  to  share
  170.        similar  colors  with other clients.  But if too may color
  171.        consuming clients are running, the image-quality will suf-
  172.        fer.  You  should  stop  other clients in that case or you
  173.        might quantize the image to a fewer number of colors  with
  174.        packages like ImageMagick, xv or netpbm.
  175.  
  176. SEE ALSO
  177.        X(1), convert(1), xv(1), ppmquant(1)
  178.  
  179.  
  180. COPYRIGHT
  181.        Copyright 1996, Helmut Hoenig, Heiligenhaus
  182.  
  183.        email (for any comments):
  184.                Helmut.Hoenig@hub.de
  185.  
  186.        smail (for gifts):
  187.                Helmut Hoenig
  188.                Hopfenstrasse 8a
  189.                65520 Bad Camberg
  190.                GERMANY
  191.  
  192.         ********************************************************
  193.  
  194.            By the way, I am collecting banknotes! If you want
  195.             to join into my collection, get any bill of your
  196.            country, sign it on the backside and send it to me
  197.                    so I will pin it on my world map.
  198.             (Don't forget the exact location for the pin :-)
  199.           But you can also just send me a picture postcard ...
  200.  
  201.         ********************************************************
  202.  
  203.        Permission to use, copy, modify, and distribute this soft-
  204.        ware for any purpose and without fee  is  hereby  granted,
  205.        provided  that  the  above  copyright notice appear in all
  206.        copies.
  207.  
  208.  
  209.    other fancy things from the author
  210.        xcol (1990)    - color selector for editing text-files
  211.        flying (94/95) - pool billard simulation
  212.        xdefmap (1995) - enhanced tool for setting up standard colormaps
  213.        xmemory (95/96)- memory with simultaneous multiplayer action
  214.  
  215.        available at ftp.x.org and its mirrors
  216. S