Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XOCT(6) 			  Games Manual				 XOCT(6)

NAME
     xoct - Octahedron X widget

SYNOPSIS
     /usr/games/xoct   [-geometry  [{width}][x{height}][{+-}{xoff}[{+-}{yoff}]]]
     [-display	 [{host}]:[{vs}]]   [-[no]mono]   [-[no]{reverse|rv}]	[-{fore-
     ground|fg}   {color}]  [-{background|bg}  {color}]  [-{border|bd}	{color}]
     [-face{0|1|2|3|4|5|6|7}   {color}]   [-frame   {color}]   [-delay	  msecs]
     [-[no]sound]  [-moveSound {filename}] [-{font|fn} {fontname}] [-view {int}]
     [-{size {int} | sticky}] [-{mode {int} | both}]  [-[no]orient]  [-[no]prac-
     tice] [-userName {string}] [-scoreFile {filename}] [-scores] [-version]

DESCRIPTION
     The  original  puzzle  has 9 triangles per face (size = 3) and has period 4
     turning (i.e. the face or points turn with 90 degree intervals).  The  puz-
     zle  was  designed  by Uwe Meffert and called the Magic Octahedron (or Star
     Puzzler).	The puzzle was not widely  distributed	but  not  exactly  rare.
     This  puzzle  has	some analogies to the Rubik's Cube and the solving tech-
     niques are the same to that of the Pyraminx.  Christoph's	Magic  Jewel  is
     similar except there are no trivial corners to solve.  This has 2^22*12! or
     2,009,078,326,886,400 different combinations.

     Uwe  Meffert also noticed that there could be an alternate twisting for the
     octahedron where it has period 3 turning (i.e. faces turn with  120  degree
     intervals).

     One is able to simulate a Trajber's Octahedron (period 3 turning and sticky
     mode).   Also  one  is  able to simulate one with variant turning (period 4
     turning and sticky mode).

FEATURES
     Press "mouse-left" button to move a piece.  Release "mouse-left" button  on
     a	piece on the same face and in the same row (but not an adjacent piece or
     the move is ambiguous).  The pieces will then turn towards where the  mouse
     button was released.

     Click  "mouse-center", or press "P" or "p" keys to toggle the practice mode
     (in practice mode the record should say  "practice").   This  is  good  for
     learning moves and experimenting.

     Click  "mouse-right",  or	press  "Z"  or "z" keys, to randomize the puzzle
     (this must be done first to set a new record).

     Press "G" or "g" keys to read (get) a saved puzzle.

     Press "W" or "w" keys to save (write) a puzzle.

     Press "U" or "u" keys to undo a move.

     Press "R" or "r" keys to redo a move.

     Press "C" or "c" keys to clear the puzzle.

     Press"S" or "s" keys to start auto-solver.  Only works where size <  4  (or
     sticky mode set) in Period 3 mode or size < 5 in Period 4 mode.

     Press  "O"  or  "o"  keys to toggle the orient mode.  One has to orient the
     faces in orient mode, besides getting all the faces to be the  same  color.
     To  do  this one has to get the lines to be oriented in the same direction,
     this only matters with center pieces, if at all (i.e.  those pieces not  on
     a	corner	or  edge).   This  does  add  complexity  so there are 2 sets of
     records.

     Press "3", "4", "B", or "b" keys (not the keypad 3, 4) to change  modes  to
     Period 3, Period 4, or Both.

     Press  "Y" or "y" keys to toggle sticky mode (increase/decrease is disabled
     here if sticky mode is on).
     "Sticky" and "Period 3" turning allows only the faces to turn, it is as  if
     the middle cut of the three cuts did not exist.
     "Sticky" and "Period 4" turning allows only the points to turn, it is as if
     the middle cut of the three cuts did not exist.
     Beware,  the  "Sticky" mode is a hack and much could be done to improve its
     look.

     Press "I" or "i" keys to increase the number of pieces.

     Press "D" or "d" keys to decrease the number of pieces.

     Press "V" or "v" keys to change the view of the puzzle.

     Press ">" or "." keys to speed up the movement of pieces.

     Press "<" or "," keys to slow down the movement of pieces.

     Press "@" key to toggle the sound.

     Press "Esc" key to hide program.

     Press "Q", "q", or "CTRL-C" keys to kill program.

     Use the key pad or arrow keys to move without the mouse.
     Key pad is defined for Oct as:
       /     Counterclockwise

     7 8 9   Upper Left, Up, Upper Right
       ^
     4<5>6   Left, Clockwise, Right
       v
     1 2 3   Lower Left, Down, Lower Right

     Use the shift keys to access "Period 4" turns from "Both"	mode,  otherwise
     it assumes "Period 3" turning.  Points turn in "Period 4" and faces turn in
     "Period 3".

     Use  the  control	key  and the left mouse button, keypad, or arrow keys to
     move the whole octahedron.  This is not recorded as a turn.

     The title is in the following format (non-motif version):
	    xoct.{3|4|both<turning modes>}: {1|2|3|4|5|6|sticky<number of pieces
	    per edge>} @ (<Number of  moves>/{<Record  number  of  moves>  <user
	    name>|"NEVER noaccess"|"practice"}) - <Comment>
     If there is no record of the current puzzle, it displays "NEVER noaccess".

OPTIONS
     -geometry {+|-}X{+|-}Y
	     This option sets the initial position of the octahedron window (re-
	     source name "geometry").

     -display host:dpy
	     This option specifies the X server to contact.

     -[no]mono
	     This  option allows you to display the octahedron window on a color
	     screen as if it were monochrome (resource name "mono").

     -[no]{reverse|rv}
	     This option allows you to see  the  octahedron  window  in  reverse
	     video (resource name "reverseVideo").

     -{foreground|fg} color
	     This  option specifies the foreground of the octahedron window (re-
	     source name "foreground").

     -{background|bg} color
	     This option specifies the background of the octahedron window  (re-
	     source name "background").

     -{border|bd} color
	     This option specifies the border color of the pieces in the octahe-
	     dron window (resource name "borderColor").

     -face{0|1|2|3|4|5|6|7} <color>
	     This option allows you to change the color of a face (resource name
	     "faceColorN"). In mono-mode, color is represented as the first let-
	     ter of the color name. The faces are ordered top to bottom and left
	     to  right.   If  you has two colors that begin with the same letter
	     you should have one in uppercase and one in  lowercase  to  distin-
	     guish  them in mono-mode. You can change the colors of the faces to
	     make a stupid octahedron (i.e. all White or in mono-mode all  "W").
	     Unfortunately, it will not normally say its solved when its random-
	     ized.  This would be cheating.

     -frame color
	     This option specifies the color of the frame (resource name "frame-
	     Color").

     -delay msecs
	     This  option  specifies the number of milliseconds it takes to move
	     pieces (1-50) (resource name "delay").

     -[no]sound
	     This option specifies if sliding pieces should make a sound or  not
	     (resource name "sound").

     -moveSound filename
	     This  option specifies the file for the move sound for the twisting
	     of the puzzle (resource name "moveSound").

     -{font|fn} ontname
	     This option specifies the font that will  be  used  (resource  name
	     "font").

     -size <int>
	     This  option  allows  you	to change the number of pieces on a edge
	     (resource name "size").

     -sticky
	     This option allows you  to  set  the  sticky  mode  (resource  name
	     "sticky").

     -mode <int>
	     This  option  allows  you	to  set  the turning mode (resource name
	     "mode").

     -both   This option allows you to set the turning mode to both period 3 and
	     period 4 (resource name "mode" set at 5).

     -[no]orient
	     This option allows you to access the oriented mode  (resource  name
	     "orient").

     -[no]practice
	     This  option  allows you to access the practice mode (resource name
	     "practice").

     -userName string
	     This option specifies the user name for any records made or else it
	     will get your login name (resource name "userName").

     -scoreFile filename
	     Specify an alternative score file (resource name "scoreFile").

     -scores
	     This option lists all the recorded scores and then exits.

     -version
	     This option tells you what version of xoct you have.

RECORDS
     You must randomize the puzzle before a record is set, otherwise an  assump-
     tion of cheating is made if it is solved after a get or an auto-solve.

SAVE FORMAT
     Here  is  the format for the xoct configuration, starting position, and the
     movement of its pieces.

     Octahedron with default colors, not randomized:
       0       R     Red
     3	 1   M	 B   Magenta, Blue
       2       W     White
       4       O     Orange
     7	 5   Y	 P   Yellow, Pink
       6       G     Green

	    size: 1-6 <number of triangles in the same orientation as  the  face
	    per row>
	    mode: 3-5 <period 3 turning, period 4 turning, or both (5)>
	    orient:  0-1  <0 false, 1 true; if 1 then lines on pieces to be ori-
	    ented>
	    sticky: 0-1 <0 false, 1 true; if 1 then some pieces move together>
	    practice: 0-1 <0 false, 1 true>
	    moves: 0-MAXINT <total number of moves>

	    startingPosition: <2 dimensional array of face piece position,  each
	    face  has size * size pieces, if orient mode then orientation number
	    follows face number numbered clockwise from 0 to 11, where 0 is up>

     This is then followed by the moves, starting from 1.
	    move #: <direction> <control> <face> <position>
     Each turn is with respect to a face and position.
     Position is 0 to size * size - 1.	Position 0 is the triangle furthest from
     the center, increasing clockwise.
     Direction is represented as 0 up, 1 upper right, 2 right, 3 lower right,  4
     down, 5 lower left, 6 left, 7 upper left, 9 clockwise, and 15 counterclock-
     wise.
     Control  is  represented  as  0 or 1, 1 if the whole octahedron is moved at
     once (here position does not matter), 0 if not.   The  xoct  record  keeper
     does not count a control move as a move, but here we do.

REFERENCES
     Beyond  Rubik's  Cube:  spheres, pyramids, dodecahedrons and God knows what
     else by Douglas R. Hofstadter, Scientific American, July 1982, pp 16-31.

     Magic Cubes 1996 Catalog of Dr. Christoph Bandelow.

SEE ALSO
     X(1),  xcubes(6),	xtriangles(6),	xhexagons(6),	xmlink(6),   xbarrel(6),
     xpanex(6),   xmball(6),   xpyraminx(6),   xrubik(6),  xskewb(6),  xdino(6),
     xbevel(6), xabacus(6)

COPYRIGHTS
     (R) Copyright 1994-2024, David A. Bagley

BUG REPORTS AND PROGRAM UPDATES
     Send bugs (or their reports, or fixes) to the author:
	    David A. Bagley, <bagleyd AT verizon.net>

     The latest version is currently at:
	    https://www.sillycycle.com/puzzles.html
	    http://www.ibiblio.org/pub/Linux/games/strategy/

V8.8.4				   15 Aug 2024				 XOCT(6)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xoct&sektion=6&manpath=FreeBSD+Ports+15.1.quarterly>

home | help