Immersive Visualization / IQ-Station Wiki
This site hosts information on virtual reality systems that are geared toward scientific visualization, and as such often toward VR on Linux-based systems. Thus, pages here cover various software (and sometimes hardware) technologies that enable virtual reality operation on Linux.
The original IQ-station effort was to create low-cost (for the time) VR systems making use of 3DTV displays to produce CAVE/Fishtank-style VR displays. That effort pre-dated the rise of the consumer HMD VR systems, however, the realm of midrange-cost large-fishtank systems is still important, and has transitioned from 3DTV-based systems to short-throw projectors.
Difference between revisions of "BuildingANARI"
m (Some minor tweaks while using this to guide a new build.) |
m (More minor tweaks (I should have waited to do them together)) |
||
| Line 29: | Line 29: | ||
% make install | % make install | ||
</syntaxhighlight> | </syntaxhighlight> | ||
* NOTE: As of ANARI version 0.8.0, I've had to modify the file "imgui_impl_glfw.cpp" to remove three GLFW function calls that are not part of my version of that library: | |||
** <TT>glfwGetError</TT> | |||
** <TT>glfwGetMonitorWorkarea</TT> | |||
** <TT>glfwGetMonitorContentScale</TT> | |||
==Running ANARI== | ==Running ANARI== | ||
| Line 36: | Line 41: | ||
An optional "anariViewer" may also be built which contains a handful of reference scenes, | An optional "anariViewer" may also be built which contains a handful of reference scenes, | ||
along with an OBJ viewer. | along with an OBJ viewer. | ||
===Running the ANARI backend info tool=== | |||
<syntaxhighlight> | |||
% ./anariInfo -helide | |||
</syntaxhighlight> | |||
This will then output a slew of information about the backend, including what version of | |||
ANARI it was built for, and what Parameters and Extensions it handles. | |||
===Running the ANARI tutorial example=== | ===Running the ANARI tutorial example=== | ||
<syntaxhighlight> | <syntaxhighlight> | ||
% | % ./anariTutorial | ||
% display *.ppm | % display *.ppm | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===Running the ANARI viewer example=== | ===Running the ANARI viewer example=== | ||
<syntaxhighlight> | <syntaxhighlight> | ||
% | % ./anariViewer | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==Suggestions for improving the ANARI build process== | |||
I have a few things that I need to pass along to the ANARI working group that could/should | |||
be fixed in future versions -- especially by the time we get to version 1.0.0. | |||
* <TT>anariViewer</TT> should be copied to <TT>INSTALL_PREFIX/bin</TT> | |||
* CMake should be fixed to not produce an erroneous GLFW library for <TT>anariViewer</TT> | |||
* Running <TT>anariTutorial</TT> shouldn't seg-fault | |||
Revision as of 18:23, 9 January 2024
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 3.11 of CMake.
Cloning ANARI
Clone from the Khronos Github ANARI reposoitory:
% git clone https://github.com/KhronosGroup/ANARI-SDK.gitConfiguring the Build and Installing
Configuring and compiling the build:
% mkdir ANARI-SDK/Build
% cd ANARI-SDK/Build
% cmake -DCMAKE_INSTALL_PREFIX=... -DCMAKE_BUILD_TYPE:STRING=Debug -DBUILD_CTS:BOOL=OFF -DBUILD_TESTING:BOOL=OFF -DBUILD_VIEWER:BOOL=ON ..
% make
% make install- NOTE: As of ANARI version 0.8.0, I've had to modify the file "imgui_impl_glfw.cpp" to remove three GLFW function calls that are not part of my version of that library:
- glfwGetError
- glfwGetMonitorWorkarea
- glfwGetMonitorContentScale
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 backend info tool
% ./anariInfo -helideThis will then output a slew of information about the backend, including what version of ANARI it was built for, and what Parameters and Extensions it handles.
Running the ANARI tutorial example
% ./anariTutorial
% display *.ppmRunning the ANARI viewer example
% ./anariViewerSuggestions for improving the ANARI build process
I have a few things that I need to pass along to the ANARI working group that could/should be fixed in future versions -- especially by the time we get to version 1.0.0.
- anariViewer should be copied to INSTALL_PREFIX/bin
- CMake should be fixed to not produce an erroneous GLFW library for anariViewer
- Running anariTutorial shouldn't seg-fault