povscript‎ > ‎

usage

Quick download:

Source
(v. 2.20)
complete source
source rpm

How do I download/install/use it?

The instructions here only pertain to v. 2.0 and above, and apply to any platform:

to install from the source tarball, just extract the file, cd into the created directory and use the following:
./configure
make
make install # (as root)
as of version 2.0 and above, you'll need both gts (version 0.7.2 or greater recommended) and glib (at least version 1.2.10) available if you want to compile from scratch.

or, if you'd rather rebuild the rpm file from the source tarball, just use:
./configure
rpmbuild -ba molscript.spec # (as root)
after cd'ing into the new directory.

or, to install from the .src.rpm:
rpm -ivh molscript-2.1.2pov2.19.src.rpm
cd /path/to/spec/files
rpmbuild -ba molscript.spec

Fedora Linux specifics

with Fedora, you can just download the appropriate RPM file above and simply do (as root):

yum localinstall --nogpgcheck molscript-2.1.2pov2.19-3.fc7.i386.rpm
and it will pull in all the dependencies for you.

Windows specifics

as of the windows version 2.16, all the library files are included with the software. Just extract the files wherever you'd like and go!

MacOSX specifics

The OSX binaries after version 2.02-2 fix most of the problems related to OSX (including having to declare the full PATH of all files).

To actually build the program from scratch, you may need the following configure flag:

./configure --with-apple-opengl-framework=yes
and since I've seen some odd problems with libtool, you may also need:
./configure --with-apple-opengl-framework=yes --build=powerpc-apple-darwin<insert kernel version here>
This is due to OS X handling certain library calls differently to accommodate OS X specifics (such as hardware acceleration). Since some people may have both the OSX GLUT and MesaGL installed, the apple-opengl-framework flag was introduced (in a manner similar to Braden McDaniel's AX_CHECK_GL(UT) m4 macros)

How do I use the povray output mode?

Simple. There is a new command line switch: "-povray". Just be sure to redirect the output (using "-out") to a file for the povray rendering engine to read. If you don't have povray, snag a local RPM copy (see above) otherwise download the appropriate version from www.povray.org.

Simple, my ass! Now what do I do with the output???

Right - sorry. Assuming you have the desired molscript input in foo.inp, you would do something like the following:
molscript -in foo.inp -povray -out foo.pov
povray <other commandline goodies> +Ifoo
For a quick primer on povray, click here - its a brief set of hints/tips for rendering/animations.

Aiigh! It broke!

Chances are, I screwed up somewhere. The code is relatively untested so far, so if you see something like a segfault or weird output, email me the problem, and I'll do my best to fix it (I accept diff patches as well, of course ;) ). You could also try checking the Povscript+ FAQ to see if your problem is mentioned there...

Jubilation! It worked!

If this program actually generates something of use to you, feel free to reference this page or this citation, if you'd like. If you think your image is of exceptional quality, email me a copy - I'll add it to the website gallery (full credit will, of course, be given).


Go back to the povscript+ home page
Comments