Iray Programmer's Manual

Preface
Getting started
- Release overview
- Example programs
- How to compile a program
- How to run a program
- Starting and shutting down the Iray API
- A first image
Library design
- API modules
- Shared library
- Naming conventions
- Include files
- Include file compile-time configuration
- Main API access point
- Version numbers and compatibility
- Interfaces
- Reference counting
- Handle class
- Resources
- Strings
- Error handling
- Database, transactions and scopes
  - Transactions
  - Database scopes
- Runtime configuration
Rendering
- Rendering overview
- Rendering and canvases
- Render mode selection
- Progressive rendering of a scene
- Own canvas class
- Asynchronous rendering
- Multiple render contexts
Iray Photoreal
- Introduction
- System requirements
- Limitations
- Matte objects and matte lights
- Refractive objects and IOR handling
- Progressive rendering
- Caustic sampler
- Architectural sampler
- Light portals
- Rendering options
- Mixed mode rendering and load balancing
- Timeout prevention
- Integrated noise reduction
- Integrated bloom
Iray Interactive
- Introduction
- System requirements
- Limitations
- Progressive rendering
- Lighting
- Rendering options
- Path space filtering
- Output format
- Global performance settings
- Comparison with Iray Photoreal
Iray Realtime
- Introduction
- System requirements
- Limitations
- Rendering options
Iray Blend
- Introduction
- Rendering options
Scene database
- Overview of the scene database elements
- Creating a scene programmatically
Geometry
- Creating triangle meshes
- Creating polygon meshes
- Creating on-demand meshes
- Creating subdivision surfaces
- Creating freeform surfaces
Materials
- Material Definition Language
- Measured materials
- Editing and creating materials
Decals
Sources of light
- Emission distribution functions
- Light distribution from scene elements
Environment dome and implicit groundplane
- Environment function
- Environment dome
- Implicit groundplane
Camera
- Tonemapping
  - Photographic tonemapper
  - Custom tonemapper
- Depth of field
- Virtual backplate
- Motion blur
Physically plausible scene setup
- Recommendations for geometry preparation
- Recommendations for lights
  - Using photometric lights
  - Using environment and sunlight
- Recommendations for materials
- Recommendations for cameras
Networking
- Networking overview
- Networking modes
- Iray Bridge
Delivering an image from server-based rendering
- Running an HTTP server
- RTMP server
- RTMP client
- Running an RTMP and HTTP server with mouse interaction
Customization
- Extending the database with user-defined classes
- Extending neuray with plugins
- Extending supported file formats with plugins
Appendix
- Supported file formats and URI schemes
- Result canvas names
- Light path expression grammar
Bibliography

System requirements

The current system requirements for Iray Interactive:

The plugin libirt needs to be loaded in neuray before this render mode is available. See the mi::neuraylib::IPlugin_configuration interface for methods to load plugins.
Available on Windows x86 64 bit, Linux 64 bit, and Mac OS X 64 bit.
GPUs of the Fermi and Kepler generations are supported by Iray Interactive, i.e., with CUDA Compute Capability 2.0 and higher. The following device configurations are supported:
- Arbitrary combinations of Compute Capability 2.x devices
- Compute Capability 3.0 devices only
- Compute Capability 3.5 devices only
Note:
The following device configurations are not supported:
- Mixing Fermi- and Kepler-based devices
- Combining Compute Capability 3.0 and Compute Capability 3.5 devices
- Switching at runtime between different GPU generations, for example, switching from a Compute Capability 3.0 to a Compute Capability 2.0 device.
Driver requirements: The driver needs to support CUDA 6.0.