View source for BuildingANARI

{{TOCright}}
Instructions for how to build ANARI on Linux.
This is the basic ANARI, independent of VR capabilities, which will be documented separately.

==Building ANARI on Linux==
The generic ANARI SDK has minimal system requirements to build.
However, for the GPU-accelerated backends, there generally will be additional
required features (such as Cuda or Optix).

When building ANARI, there is a choice between downloading/cloning the reference ANARI-SDK, and separately obtaining the GPU accelerated backends, or it is possible to download the pseudo-Superbuild that will download selected backends, and do a complete build.

===Prerequisites===
ANARI makes use of the CMake build system.  You should have at least version ?? of CMake.


===Cloning ANARI===
Clone from the Khronos github reposoitory:
<syntaxhighlight>
% git clone https://github.com/KhronosGroup/ANARI-SDK.git
</syntaxhighlight>

===Configuring the Build and Installing ===
Configuring and compiling the build:
<syntaxhighlight>
% mkdir ANARI-SDK/Build
% cd ANARI-SDK/Build
% cmake -DCMAKE_INSTALL_PREFIX=... -DCMAKE_BUILD_TYPE:STRING=Debug -DBUILD_TESTING:BOOL=OFF -DBUILD_VIEWER:BOOL=ON ..
% make
% make install
</syntaxhighlight>

==Running ANARI==
The ANARI build process includes a simple tutorial application that will render a scene
consisting of a pair of triangles into two image files (one with the first pass of the
render, and one with a later pass).
An optional "anariViewer" may also be built which contains a handful of reference scenes,
along with an OBJ viewer.

===Running the ANARI tutorial example===
<syntaxhighlight>
% bin/anariTutorial
% display *.ppm
</syntaxhighlight>
===Running the ANARI viewer example===
<syntaxhighlight>
% bin/anariViewer
</syntaxhighlight>