neuray API Programmer's Manual

mi::neuraylib::IMaterial_instance Class Reference

[MDL-related elements]

Description

This interface represents a material instance. This interface is almost obsolete. The only remaining purpose is the method create_compiled_material() and the associated enum Compilation_options. Use mi::neuraylib::IFunction_call for all other purposes.

mi::base::Interface_declare\< ..., neuraylib::IScene_element \>Mixin class template for deriving new interface declarations. Common base interface for all scene elements.Common base interface for all scene elements. mi::base::Interface_declare\< ..., neuraylib::IAttribute_set \>Mixin class template for deriving new interface declarations. The attribute set comprises all attributes attached to a database element.The attribute set comprises all attributes attached to a database element. mi::base::Interface_declare\< ... \>Mixin class template for deriving new interface declarations. The basic extensible interface.The basic extensible interface.

Public Enumerations

enum Compilation_options{ DEFAULT_OPTIONS = 0, CLASS_COMPILATION = 1, COMPILATION_OPTIONS_FORCE_32_BIT = 0xffffffffU}
Various options for the creation of compiled materials. More...

Public Member Functions

virtual ICompiled_material* create_compiled_material( Uint32 flags, IMdl_execution_context* context = 0) const =0
Creates a compiled material. More...

Enums

enum mi::​neuraylib::​IMaterial_instance::Compilation_options

Various options for the creation of compiled materials.

See also:

create_compiled_material()

Enumerator:

DEFAULT_OPTIONS = 0
Default compilation options (e.g., instance compilation).
CLASS_COMPILATION = 1
Selects class compilation instead of instance compilation.
COMPILATION_OPTIONS_FORCE_32_BIT = 0xffffffffU

Member Functions

virtual ICompiled_material* mi::​neuraylib::​IMaterial_instance::create_compiled_material( Uint32 flags, IMdl_execution_context* context = 0) const [pure virtual]

Creates a compiled material.

Parameters

flags
A bitmask of flags of type Compilation_options.
context

Returns

The corresponding compiled material, or NULL in case of failure.