A scene element that stores measured BSDF data. More...
Public Member Functions | |
virtual Sint32 | reset_file (const char *filename)=0 |
Resets the underlying file to a new file given by filename . More... |
|
virtual const char * | get_filename () const =0 |
Returns the resolved file name of the file containing the BSDF measurement. More... |
|
virtual const char * | get_original_filename () const =0 |
Returns the unresolved file name as passed to reset_file(). More... |
|
virtual Sint32 | set_reflection (const IBsdf_isotropic_data *bsdf_data)=0 |
Sets the BSDF data for the reflection. More... |
|
virtual const base::IInterface * | get_reflection () const =0 |
Returns the BSDF data for the reflection. More... |
|
template<class T > | |
const T * | get_reflection () const |
Returns the BSDF data for reflection. More... |
|
virtual Sint32 | set_transmission (const IBsdf_isotropic_data *bsdf_data)=0 |
Sets the BSDF data for transmission. More... |
|
virtual const base::IInterface * | get_transmission () const =0 |
Returns the BSDF data for transmission. More... |
|
template<class T > | |
const T * | get_transmission () const |
Returns the BSDF data for transmission. More... |
|
Additional Inherited Members | |
Public Types inherited from mi::base::Interface_declare< 0xa05e5a42, 0x3f74, 0x4ad9, 0x8e, 0xa9, 0x17, 0x4f, 0x97, 0x52, 0x39, 0x8a, neuraylib::IScene_element > | |
typedef Interface_declare< id1, id2, id3, id4, id5, id6, id7, id8, id9, id10, id11, neuraylib::IScene_element > |
Self |
Own type. More... |
|
typedef Uuid_t< id1, id2, id3, id4, id5, id6, id7, id8, id9, id10, id11 > |
IID |
Declares the interface ID (IID) of this interface. More... |
|
Static Public Member Functions inherited from mi::base::Interface_declare< 0xa05e5a42, 0x3f74, 0x4ad9, 0x8e, 0xa9, 0x17, 0x4f, 0x97, 0x52, 0x39, 0x8a, neuraylib::IScene_element > | |
static bool | compare_iid (const Uuid &iid) |
Compares the interface ID iid against the interface ID of this interface and of its ancestors. More... |
|
A scene element that stores measured BSDF data.
The measured BSDF is split into the two components for reflection and transmission. Currently, only isotropic data is supported (see the abstract interface mi::neuraylib::IBsdf_isotropic_data). The data can be imported from file or can be passed via the API.
A BSDF measurement appears in the scene as an argument of an MDL function call (see mi::neuraylib::IMdl_function_call) or default argument of an MDL function definition (see mi::neuraylib::IMdl_function_definition). The type of such an argument is "Attachable<Ref<Bsdf_measurement>>"
(see mi::IRef and mi::IAttachable).
|
pure virtual |
Returns the resolved file name of the file containing the BSDF measurement.
The method returns NULL
if there is no file associated with the BSDF measurement, e.g., after default construction, calls to set_reflection() or set_transmission(), or failures to resolves the file name passed to reset_file().
|
pure virtual |
Returns the unresolved file name as passed to reset_file().
The method returns NULL
after default construction or calls to set_reflection() or set_transmission().
|
pure virtual |
Returns the BSDF data for the reflection.
Note that it is not possible to manipulate the BSDF data.
NULL
if there is none.
|
inline |
Returns the BSDF data for reflection.
Note that it is not possible to manipulate the BSDF data.
This templated member function is a wrapper of the non-template variant for the user's convenience. It eliminates the need to call mi::base::IInterface::get_interface(const Uuid &) on the returned pointer, since the return type already is a const pointer to the type T
specified as template parameter.
T | The interface type of the requested element. |
NULL
on failure (no BSDF data available or if T
does not match the element's type).
|
pure virtual |
Returns the BSDF data for transmission.
Note that it is not possible to manipulate the BSDF data.
NULL
if there is none.
|
inline |
Returns the BSDF data for transmission.
Note that it is not possible to manipulate the BSDF data.
This templated member function is a wrapper of the non-template variant for the user's convenience. It eliminates the need to call mi::base::IInterface::get_interface(const Uuid &) on the returned pointer, since the return type already is a const pointer to the type T
specified as template parameter.
T | The interface type of the requested element. |
NULL
on failure (no BSDF data available or if T
does not match the element's type).
|
pure virtual |
Resets the underlying file to a new file given by filename
.
NULL
pointer).
.mbsdf is supported).
|
pure virtual |
Sets the BSDF data for the reflection.
bsdf_data | The BSDF data to be used by this BSDF measurement. The value NULL can be used to remove the BSDF data for reflection. |
bsdf_data
is invalid.
|
pure virtual |
Sets the BSDF data for transmission.
bsdf_data | The BSDF data to be used by this BSDF measurement. The value NULL can be used to remove the BSDF data for transmission. |
bsdf_data
is invalid.