.\" Hey, EMACS: -*- nroff -*- .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) .TH OPENUNIVERSE 1 "abril 1, 2001" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: .\" .nh disable hyphenation .\" .hy enable hyphenation .\" .ad l left justify .\" .ad b justify to both left and right margins .\" .nf disable filling .\" .fi enable filling .\" .br insert line break .\" .sp insert n+1 empty lines .\" for manpage-specific macros, see man(7) .SH NAME openuniverse \- 3D space simulation .SH SYNOPSIS .B openuniverse .RI [ -bench ] [ -fullscreen [ mode_string ] ] [ -logfile [filename] ] .SH DESCRIPTION This manual page documents briefly the .B openuniverse command. .PP OpenUniverse (also called OU) is a fun, fast and free OpenGL space simulator. It currently focusses on the Solar System and lets you visit all of its planets, most major moons and a vast collection of smaller bodies in colorful, glorious and realtime 3D. If you've ever had a chance to visit Mercury or asteroid Geographos, here you'll find them looking exactly the same way, following exactly the same path as when you've left them. .PP This program \fBreally\fP benefits of a 3D accelerator graphic card. It's the only way to ensure a decent framerate (speed). OU has been tested on the following 3D chipsets: Voodoo 1/2/3, nVidia GeForce2 MX/MX 400 (with nVidia's binary drivers). . .PP When OpenUniverse starts up we suggest to simply lay back for a few seconds. Because you have just reached Earth! OU's main screen with it's helpful information shows up now and the blue planet will slowly rotate in front of you, while you have a moment to enjoy it's beauty and fragility. .PP To view the Help press the 'H' key, you can swith on and off the demo mode with the 'd' key. For other commands and functions see OU's manual. .PP This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page. Instead, it has documentation in the GNU Info format; see below. .PP .\" TeX users may be more comfortable with the \fB\fP and .\" \fI\fP escape sequences to invode bold face and italics, .\" respectively. .SH OPTIONS A summary of options is included below. For a complete description, see OU's manual. .TP .B \-h, \-\-help Show summary of options. .TP .B \-bench Do a benchmark of your system. .TP .B \-fullscren mode_screen Launch openuniverse fullscren. The value .I mode_screen defines the screen resolution, colordepth and refresh rate. For example the command line .B openuniverse -fullscreen 640x480:32@70 will run OpenUniverse in an resolution of 640x480 pixels, a colordeph of 32 bit (truecolor) and at a refresh rate of 70Hz. Please note that the characters 'x' and ':' are important and can't be removed (you don't have to suppy refresh rate if you don't want as it'll use default refresh rate for the supplied resolution). Note as well that a lot of 3D cards are only capable of resolutions up to 800x600 and colordepths up to 16bit. .TP .B \-logfile filename Creates a logfile that describes the program operations. If no filename is provided the logfile will default to .I log.txt and it will be created in the current working directory. .SH ABOUT .br The programs are documented in the manual pages (not quite complete yet) available in /usr/share/doc/openuniverse/manual. Also go away and check the screenshots (not available in this package) that can be seen in www.openuniverse.org .SH FILES .TP .B /usr/share/openuniverse/textures Textures used for planets. .TP .B /usr/share/openuniverse/fonts Fonts used by the program. .TP .B /usr/share/openuniverse/3dmodels Three dimensional models of the objects (satellites and space station). .TP .B /usr/share/openuniverse/data Stellar data sets, it includes a few objects from the Messier catalog and a basic set of bright stars derived from the yale bright star catalog (it includes only those entries Bayer and/or Flamsteed number and provides common names which were overlayed by closes postition match from a hand-edited list) .B /etc/openuniverse/ Location of the configuration of openuniverse (\fBou.conf\fR) .TP .B /usr/share/openuniverse/events .TP .B /var/games/openuniverse/scrshots As a Debian specific change, the Debian version of \fBopenuniverse\fR will write its screenshots to \fB/var/games/openuniverse/srcshots\fR, instead of \fB/usr/share/openuniverse/scrshots\fR. Notice, however, that users are not given full permissions to this directory (can only be written by root or the \fBgames\fR group). If you want to make screenschots you need to add yourself to the \fBgames\fR group, or explicitly grant write permissions to all users in that directory (preferabily adding also the sticky bit as is usually done for shared temporary directories like \fB/tmp\fR or \fB/var/tmp\fR). .TP .B /usr/share/doc/openuniverse Additional documentation. .SH BUGS .\" See http://sourceforge.net/tracker/index.php?func=detail&aid=225766&group_id=910&atid=100910 OpenUniverse is affected by the year 2038 bug if running in a 32-bit platform. The time definition used in OpenUniverse is based on a 32-bit variable and can only hold values up to 9th January 2038 (3:14:07 GMT). If time in OU is accelerated past this value it will behave unexpectedly as time goes back to the past (to January 1901). .SH AUTHOR This manual page was written by Javier Fernandez-Sanguino for the Debian GNU/Linux system (but may be used by others).