1gnubik(6)                  GNU Utility Documentation                 gnubik(6)
2
3
4

NAME

6       gnubik -  an interactive, graphic Magic cube program.
7

SYNOPSIS

9       gnubik [window_system_options] [-hvs]  [-z n[,m[,p]]]  [-a m]
10
11

DESCRIPTION

13       This is a program which displays a 3 dimensional image of a magic cube,
14       as introduced to the world by its Hungarian inventor, Erno Rubik.   The
15       user  rotates the blocks of the cube, and attempts to solve the puzzle,
16       by moving all the blocks to their correct positions  and  orientations,
17       resulting in a cube with a single colour on each face.
18

OPERATION

20       The user interacts with the program in the following ways:
21
22   Viewing the Cube
23       The  viewing  position  may be altered using the arrow keys or by using
24       the mouse.  The left and right arrow keys rotate  the  cube  about  the
25       vertical axis.  The up and down keys rotate the cube about the horizon‐
26       tal axis.  Holding down the shift key  whilst  pressing  the  left  and
27       right arrow keys rotates the cube about the z axis.
28
29       To  rotate  the  cube  using the mouse, hold down button 1 and move the
30       mouse anywhere on the window.  If your mouse has a  scroll  wheel,  you
31       can use this to rotate the cube about the z axis.
32
33
34   Performing Rotations
35       Rotations are performed using the mouse.  To manipulate the cube, place
36       the mouse cursor on a square in the cube, against the edge  facing  the
37       direction you want to move, and click button 1.
38
39       The mouse cursor will indicate the direction of rotation.
40
41

OPTIONS

43       The  following  options may be specified on the command line at invoca‐
44       tion.
45
46       -z n,m,p
47              Draws a cube of size n x m x p, where n,m and  p  are  positive.
48              The default size is 3 x 3 x 3.
49
50       -a m   When  rotating parts of the cube, show m intermediate positions.
51              The default for this value is 2.  Setting  to  a  higher  value,
52              will  give smoother animations, but will result in a slower pro‐
53              gram.
54
55       -s     Starts with the cube already solved.  By default, it starts in a
56              random position.
57
58       -h     Display a help message and exit.
59
60       -v     Display version number and then exit.
61
62

IMPLEMENTATION

64       The code for gnubik is written in C and Scheme. It uses the Mesa/OpenGL
65       graphics library, and the Gtk+ library and Guile.  As such,  it  should
66       be easy to generate a version for any system complying with these stan‐
67       dards.
68

BUGS

70       The rendering process is slower than it could be, since  display  lists
71       aren't  currently  used.   The entire image is re-rendered, during each
72       refresh, regardless of which components have changed their appearance.
73

75       Copyright (C) 1998, 2011 John Darrington.
76
77       This program is free software; you can redistribute it and/or modify it
78       under  the  terms of the GNU General Public License as published by the
79       Free Software Foundation; either version 3 of the License, or (at  your
80       option) any later version.
81
82       This  program  is  distributed  in the hope that it will be useful, but
83       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
84       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
85       Public License for more details.
86
87       You should have received a copy of the GNU General Public License along
88       with this program.  If not, see <http://www.gnu.org/licenses/>.
89
90
91
92JMD                             01 January 2011                      gnubik(6)
Impressum