<!-- This file copyright Persistence of Vision Raytracer Pty. Ltd. 2003-2004 -->
<html>
<head>
<!-- NOTE: In order to users to help find information about POV-Ray using -->
<!-- web search engines, we ask you to *not* let them index documentation -->
<!-- mirrors because effectively, when searching, users will get hundreds -->
<!-- of results containing the same information! For this reason, the two -->
<!-- meta tags below disable archiving and indexing of this page by all -->
<!-- search engines that support these meta tags. -->
<meta content="noarchive" name="robots">
<meta content="noindex" name="robots">
<meta content="no-cache" http-equiv="Pragma">
<meta content="0" http-equiv="expires">
<title>2.5.4 What to do if you don't have POV-Ray</title>
<link href="povray35.css" rel="stylesheet" type="text/css">
</head>
<body>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_89.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_89.html">2.5.3 The POV-Team</a>
</td>
<td align="center" valign="middle">
<strong class="NavBar">POV-Ray 3.6 for UNIX documentation</strong><br> <strong>2.5.4
What to do if you don't have POV-Ray</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_91.html">2.5.5 Suggested Reading</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_91.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
<h3><a name="s02_05_04">2.5.4 </a>What to do if you don't have POV-Ray</h3>
<p>
This documentation assumes you already have POV-Ray installed and running however the POV-Team does distribute this
file by itself in various formats including online on the internet. If you do not have POV-Ray or are not sure you
have the official version or the latest version, then the following sections will tell you what to get and where to
get it.
</p>
<h4><a name="s02_05_04_01">2.5.4.1 </a>Which Version of POV-Ray should you use?</h4>
<p>
POV-Ray can be used under Windows 9x/NT/2000, Apple Power PC, x86 Linux, UNIX and other platforms. The latest
versions of the necessary files are available on <a href="http://www.povray.org/" target="new">our web site</a> and
through various CD distributions. See section "<a href="s_90.html#s02_05_04_02">Where to Find POV-Ray Files</a>"
for more info. Dos, Windows 3.1, Windows for Workgroups, SunOS and Amiga are no longer supported. If your platform is
not supported and you are proficient in compiling source code programs written in C/C++, then you may like to retrieve
the source for POV-Ray from our website and attempt to built it yourself. Note that the POV-Team provides absolutely
no support for building POV-Ray from the source code, especially on platforms that we do not officially support.
</p>
<h5><a name="s02_05_04_01_01">2.5.4.1.1 </a>Microsoft Windows 9x/NT/2000/XP</h5>
<p>
The 32-bit Windows version runs under Windows 95, Windows 98, NT, 2000 and XP or newer. Required hardware and
software: Minimum - 486/100 with 32mb RAM and Windows 95. Disk space - 20 megabytes. Recommended - Pentium 4 or
equivalent with at least 256mb of RAM running Windows 2000 or XP, equipped with an XGA display (or better) running in
true color mode.
</p>
<p>
The forthcoming 64-bit Windows version will initially run under Windows XP 64-bit edition on AMD64-based machines,
or those compatibile with them. The recommended configuration has not yet been determined but as a rule of thumb we
would suggest at least 256mb RAM (512mb preferred).
</p>
<p class="Note">
<strong>Note:</strong> accelerated graphics hardware will not improve performance. Nor will MMX or 3D
Now. These technologies are not aimed at raytracing. SSE2-equipped CPU's (such as the Pentium 4) will enhance
performance if and only if an SSE2-enabled version of POV-Ray for Windows is installed. If we make such a version
available it will be provided on our website and FTP server using a different name than that mentioned below.
</p>
<p>
Required POV-Ray files: User archive POVWIN36.EXE - a self-extracting archive containing the program, sample
scenes, standard include files and documentation.
</p>
<p>
Optional: The source code is not needed to use POV-Ray. It is provided for the curious and adventurous.
POVWIN_S.ZIP --- The C/C++ source code for POV-Ray for Windows, contains generic parts and Windows specific parts. It
does not include sample scenes, standard include files and documentation so you should also get the executable archive
as well. POV-Ray can only be compiled using C/C++ compilers that create 32-bit Windows applications.
</p>
<p>
We currently support VC++ v7 (v6 will <strong>not</strong> work due to compiler issues with certain C++ features),
Borland C++, Open Watcom, MinGW, and DJGPP (BJGPP 2.04 or later), and the Intel C++ Compiler version 8. Support for
both Intel and Microsoft's C++ compiler for AMD64 is also in the works and will be forthcoming in a later source code
release (once we release an official 64-bit version of POV-Ray for Windows).
</p>
<p>
Note that no matter which compiler you use, you will need to obtain the HTML Help API toolkit from Microsoft's web
site (unless you already have it installed). This toolkit contains header files and libraries required to compile
POV-Ray for Windows.
</p>
<p class="Note">
<strong>Note:</strong> while we know for certain that the code will work with VC++ v7 and the Intel
compiler v8, the others mentioned above may need some tweaking since we do not regularly test with them and it is
possible some later code changes may have broken the build.
</p>
<h5><a name="s02_05_04_01_02">2.5.4.1.2 </a>Linux for Intel x86</h5>
<p>
The PC-Linux version should run on any GNU/Linux distribution based on the kernel 2.2 series or above using the ELF
32-bit format for executables. The binary is fully static, meaning that it has no external dependencies to system or
third-party libraries. It includes support for two kinds of display: the standard text-based display and the graphics
display using either the X Window System or the SVGA library.
</p>
<p>
Required hardware and software: An Intel Pentium-compatible CPU (i586 or better) and at least 32 MB of RAM. About
20 MB of disk space to install the program, its documentation, scenes and standard include files. A text editor
capable of editing plain ASCII text files. Graphic file viewer capable of viewing image formats such as PNG, TIFF, PPM
or TGA.
</p>
<p>
Required POV-Ray files: povlinux-3.6.tgz or povlinux-3.6.tar.gz - archive containing an official binary combining
text, SVGALib and X Window displays. Also contains sample scenes, standard include files and documentation in HTML and
plain ASCII text.
</p>
<p>
Recommended: Intel Pentium 4 or AMD Athlon XP (faster the better) with 128 MB (text console) / 256 MB (X Window
running a window manager) or more RAM. A recent GNU/Linux distribution with kernel 2.4.x or above running KDE 3.x for
full POV-Ray integration in the window manager. Alternatively, SVGA display preferably with VESA interface and high
color or true color ability.
</p>
<p class="Note">
<strong>Note:</strong> accelerated graphics hardware will not improve performance.
</p>
<p>
Optional: povray-3.6.tgz or povray-3.6.tar.gz - archive containing the generic UNIX/Linux C++ source code of
POV-Ray for UNIX. The source code is not needed to use POV-Ray. It is provided for the curious and adventurous. The
archive contains generic Unix parts and Linux specific parts (namely: support for SVGAlib). This package does also
include sample scenes, standard include files and documentation. For displaying purposes, the SVGAlib and X11 (X
Window) includes and libraries can be used by the source code of POV-Ray for UNIX. See the section related to the <a href="s_90.html#s02_05_04_01_04">generic
Unix source code package</a> for further details.
</p>
<h5><a name="s02_05_04_01_03">2.5.4.1.3 </a>Apple Macintosh</h5>
<p>
The Macintosh version runs under Apple's Mac OS operating system version 8.6 (it may run on 8.1 and 8.5 as well,
but we do not support POV-Ray 3.6 running on Mac OS 8.1 and 8.5) or newer with CarbonLib 1.0.4 or newer installed.
Note that we no longer support 68K based Macintosh computers. POV-Ray 3.6 requires a Power Macintosh!
</p>
<p>
A Power Macintosh is any iMac, iBook, Mac G3, Mac G4, Mac G5, Cube, any older Mac with a four digit model number
(i.e. 5200, 6300, 7200, 8100, 9600) and any third party computer running Mac OS 8.1 or later. Mac OS X 10.2 or later
are supported but for maximum render speed it is not recommended to use Mac OS X.
</p>
<p>
Required hardware and software: Power Macintosh computer with at least 16 MB of free RAM. Mac OS 8.6 or newer with
CarbonLib 1.0.4 or newer installed CarbonLib 1.0.4. About 20 MB free disk space to install and an additional 5-10 MB
free space for your own creations (scenes and images). Graphic file viewer utility capable of viewing Mac PICT, GIF
and perhaps TGA and PNG formats (the shareware GraphicConverter applications is good.)
</p>
<p>
Required POV-Ray files: POVPMAC.SIT or POVPMAC.HQX - a StuffIt archive containing the native Power Macintosh
application, sample scenes, standard include files and documentation.
</p>
<p>
Recommended: Power Macintosh G3 with 64 MB or more of free RAM. Mac OS 9.0.4 or newer with CarbonLib 1.6 (works
with Mac OS 8.6 or newer) to access all features of the Mac frontend. CarbonLib 1.6 is available for free download
from Apple in the software update section of the Apple website. Color monitor with millions of colors.
</p>
<p>
Optional: The source code is not needed to use POV-Ray. It is provided for the curious and adventurous. POV-Ray can
be compiled using Metrowerks CodeWarrior Pro 7.2 (for other compilers no project or make files are provided). Read the
file "How to compile!" before compiling. There is no other support or help for compiling the source code!
POVMACS.SIT or POVMACS.HQX - The full C source code for POV-Ray for Macintosh. Contains generic parts and Macintosh
specific parts. It does not include sample scenes, standard include files and documentation so you should also get the
executable archive as well.
</p>
<h5><a name="s02_05_04_01_04">2.5.4.1.4 </a>Generic Unix</h5>
<p>
Because Unix runs on a wide variety of hardware and CPUs, the POV-Team cannot provide executable versions for every
kind of Unix systems. We distribute a generic, portable C++ source code suitable for running on Unix or Unix-like
platforms. You will need a recent C++ compiler which follows the ISO C++ standard as close as possible, and
(optionally) the X11 and/or SVGA include files and libraries (SVGAlib is for GNU/Linux based systems). Although we
provide source code for generic Unix systems, we do not provide technical support on how to compile the program.
Support may be obtained from the POV-Ray user community on the dedicated POV-Ray newsgroups (povray.unix at
news.povray.org).
</p>
<p>
Required hardware and software: A UNIX operating system with 32 MB of RAM. A recent C++ compiler, a working make
utility and Bourne-compatible shell; see the INSTALL file in the package for details. Graphic file viewer capable of
viewing e.g. PNG, TIFF, PPM or TGA formats. A text editor capable of editing plain ASCII text files.
</p>
<p>
Required POV-Ray files: povray-3.6.tgz or povray-3.6.tar.gz - the C++ source code of POV-Ray for UNIX. Contains
generic parts and UNIX/Linux specific parts. The package includes sample scenes, standard include files and
documentation in HTML and plain text ASCII format.
</p>
<p>
Recommended: Math co-processor. 128 MB (text console) / 256 MB (X Window running a window manager) or more RAM.
</p>
<p>
Optional: The X Window System (e.g. XFree86) to be able to display the image while rendering. The X Window System
is available on most UNIX platforms nowadays. On GNU/Linux platforms, the SVGAlib library can be an alternative to the
X Window System, as it allows to display the rendered image directly on the console screen.
</p>
<h5><a name="s02_05_04_01_05">2.5.4.1.5 </a>All Versions</h5>
<p>
Each executable archive includes full documentation for POV-Ray itself as well as specific instructions for using
POV-Ray with your type of platform. All versions of the program share the same ray-tracing features like shapes,
lighting and textures. In other words, an MS-Dos-PC can create the same pictures as a Cray supercomputer as long as it
has enough memory. The user will want to get the executable that best matches their computer hardware. In addition to
the files listed above, the POV-Team also distributes the user documentation in two alternate forms. Note this is the
same documentation distributed in other archives but in a different format. This may be especially useful for MS-Dos
or Unix users because their documentation is plain ASCII text only. POVUSER.PDF - Tutorial and Reference documentation
in Adobe Acrobat PDF format. Requires Adobe Acrobat Reader available for Windows 3.x, Windows 95/98/NT, Mac and some
Unix systems. POVHTML.ZIP - Archive containing Tutorial and Reference documentation in HTML for viewing with any
internet browser.
</p>
<p>
See the section "<a href="s_90.html#s02_05_04_02">Where to Find POV-Ray Files</a>" for where to find
these files. You can contact those sources to find out what the best version is for you and your computer.
</p>
<h4><a name="s02_05_04_02">2.5.4.2 </a>Where to Find POV-Ray Files</h4>
<p>
The latest versions of the POV-Ray software are available from the following sources.
</p>
<h5><a name="s02_05_04_02_01">2.5.4.2.1 </a>World Wide Website www.povray.org</h5>
<p>
The internet home of POV-Ray is reachable on the World Wide Web via the address <a href="http://www.povray.org/" target="new">http://www.povray.org/</a>
and via ftp as <a href="ftp://ftp.povray.org/" target="new">ftp://ftp.povray.org/</a>. Please stop by often for the
latest files, utilities, news and images from the official POV-Ray internet site. The POV-Team operates its <a href="http://www.povray.org/groups.html" target="new">own
news server</a> on the internet with several news groups related to POV-Ray and other interesting programs.
</p>
<h5><a name="s02_05_04_02_02">2.5.4.2.2 </a>Books, Magazines and CD-ROMs</h5>
<p>
If you would like to print our documentation, it is available in a number of formats that are designed for
printing. In particular, PDF, postscript, and TeX. See the POV-Ray website for more details.
</p>
<p>
Unfortunately all English language books on POV-Ray are out of print and there are no plans to reprint them.
However there are now several POV-Ray books available in Japanese. Many popular computer magazines have been
authorized to distribute POV-Ray on cover CD's. From time to time we, the makers of POV-Ray, will ourselves make
CDROM's available, either direct from our website or from authorized distributors. See the <a href="http://www.povray.org/" target="new">our
website</a> for more information, as that location will always contain the most up-to-date details.
</p>
<br>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_89.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_89.html">2.5.3 The POV-Team</a>
</td>
<td align="center" valign="middle">
<strong>2.5.4 What to do if you don't have POV-Ray</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_91.html">2.5.5 Suggested Reading</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_91.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
</body> </html>
