NVIDIA Iray API Home  Up
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
mi::neuraylib::ILight Class Referenceabstract

Point, spot, directional and area lighting. More...

Inheritance diagram for mi::neuraylib::ILight:
Inheritance graph
[legend]

Public Member Functions

virtual Light_type  get_type () const =0
  Returns the light type. More...
 
virtual void  set_type (Light_type type)=0
  Sets the light type. More...
 
virtual Light_area_shape  get_area_shape () const =0
  Returns the area light shape. More...
 
virtual void  set_area_shape (Light_area_shape light_area_shape)=0
  Sets the area light shape. More...
 
virtual Float64  get_area_radius () const =0
  Returns the radius of the area for area lights. More...
 
virtual void  set_area_radius (Float64 radius)=0
  Sets the radius of the area for area lights. More...
 
virtual Float64  get_area_size_x () const =0
  Returns the size of the area in x direction for area lights. More...
 
virtual void  set_area_size_x (Float64 size_x)=0
  Sets the size of the area in x direction for area lights. More...
 
virtual Float64  get_area_size_y () const =0
  Returns the size of the area in y direction for area lights. More...
 
virtual void  set_area_size_y (Float64 size_y)=0
  Sets the size of the area in y direction for area light types. More...
 

Additional Inherited Members

- Public Types inherited from mi::base::Interface_declare< 0xc9a437cf, 0x6d47, 0x4666, 0x9c, 0xf6, 0xa4, 0x3f, 0x50, 0xe8, 0x0b, 0x90, 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< 0xc9a437cf, 0x6d47, 0x4666, 0x9c, 0xf6, 0xa4, 0x3f, 0x50, 0xe8, 0x0b, 0x90, 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...
 

Detailed Description

Point, spot, directional and area lighting.

All lights are positioned at the origin of the local light space and point down the negative z -axis, like the camera. This differs from some traditional scene description formats, in which a light can have an origin, a direction, and possibly other orientation vectors. Instead, Iray uses transformations to express these properties.

Spot lights are modeled by using the spot_edf distribution function on a point light.

For directional lights, the (transformed) position is irrelevant. The traditional use of a directional light is as an approximation of the rays of the sun, which is at such a great distance to the earth that at human scale the light rays are effectively parallel.

In addition, Iray provides the ability to specify an emission distribution function in a material. In this way, any object can be a source of light emission, but may also have reflective and transmissive properties as well.

See also Environment dome and implicit groundplane.

See Also
mi::neuraylib::Light_type, mi::neuraylib::Light_area_shape

Member Function Documentation

virtual Float64 mi::neuraylib::ILight::get_area_radius ( ) const
pure virtual

Returns the radius of the area for area lights.

This value is only meaningful for lights of type mi::neuraylib::AREA_DISC, mi::neuraylib::AREA_SPHERE, and mi::neuraylib::AREA_CYLINDER.

virtual Light_area_shape mi::neuraylib::ILight::get_area_shape ( ) const
pure virtual

Returns the area light shape.

virtual Float64 mi::neuraylib::ILight::get_area_size_x ( ) const
pure virtual

Returns the size of the area in x direction for area lights.

This value is only meaningful for lights of type mi::neuraylib::AREA_RECTANGLE and mi::neuraylib::AREA_CYLINDER. For cylindrical area lights, this value is half of the height of the cylinder.

virtual Float64 mi::neuraylib::ILight::get_area_size_y ( ) const
pure virtual

Returns the size of the area in y direction for area lights.

This value is only meaningful for lights of type mi::neuraylib::AREA_RECTANGLE.

virtual Light_type mi::neuraylib::ILight::get_type ( ) const
pure virtual

Returns the light type.

virtual void mi::neuraylib::ILight::set_area_radius ( Float64  radius)
pure virtual

Sets the radius of the area for area lights.

This value is only meaningful for lights of type mi::neuraylib::AREA_DISC, mi::neuraylib::AREA_SPHERE, and mi::neuraylib::AREA_CYLINDER.

virtual void mi::neuraylib::ILight::set_area_shape ( Light_area_shape  light_area_shape)
pure virtual

Sets the area light shape.

virtual void mi::neuraylib::ILight::set_area_size_x ( Float64  size_x)
pure virtual

Sets the size of the area in x direction for area lights.

This value is only meaningful for lights of type mi::neuraylib::AREA_RECTANGLE and mi::neuraylib::AREA_CYLINDER. For cylindrical area lights, this value is half of the height of the cylinder.

virtual void mi::neuraylib::ILight::set_area_size_y ( Float64  size_y)
pure virtual

Sets the size of the area in y direction for area light types.

This value is only meaningful for lights of type mi::neuraylib::AREA_RECTANGLE.

virtual void mi::neuraylib::ILight::set_type ( Light_type  type)
pure virtual

Sets the light type.