Environment Lights provide background illumination from outside the scene.
Environment lights illuminate the scene from a virtual hemisphere (or sphere) that is beyond that farthest geometry objects in the scene. Environment lights can be rotated to orient directional illumination, but they cannot be translated.
An environment light may use a texture map to provide HDRI illumination from an environment map. With no rotation, the environment map is oriented so that the top face aligns with the positive Y axis.
The left menu chooses the order in which transforms are applied (for example, scale, then rotate, then translate). This can change the position and orientation of the object, in the same way that going a block and turning east takes you to a different place than turning east and then going a block.
The right menu chooses the order in which to rotate around the X, Y, and Z axes. Certain orders can make character joint transforms easier to use, depending on the character.
Degrees rotation about XYZ axes.
Whether or not this object is displayed. Turn on the checkbox to have Houdini use this parameter, then set the value to 0 to hide the object, or 1 to show the object. If the checkbox is off, Houdini ignores the value.
Scales the viewport geometry. This parameter is only for display purposes.
|Cache Object Transform|
Caches object transforms once Houdini calculates them. This is especially useful for objects whose world space position is expensive to calculate (such as Sticky objects), and objects at the end of long parenting chains (such as Bones). This option is turned on by default for Sticky and Bone objects.
See the OBJ Caching section of the Houdini Preferences window for how to control the size of the object transform cache.
|Viewport Selecting Enabled|
Object is capable of being picked in viewport.
Script to run when the object is picked in the viewport. See select scripts .
Object to point to. Constrains an object so its
|Look At Up Vector|
When specifying a look at, it is possible to specify an up vector for the look at. This controls the roll of this object when looking at the look at object.
The environment color or environment map tint if a map is used.
A scale on the color. If the intensity is 0, the light is disabled. The light will only be sent to the renderer if the object is included in the Force Lights parameter of the output driver.
Environment map to control the color and intensity of light arriving from different directions. The color from the environment map will be tinted by the light color.
This parameter will be disabled if Enable Sky Environment Map (on the Sky Environment Map tab) is on.
Turning this toggle off is equivalent to setting the light intensity to 0.
|Enable Light In Viewport|
Turning this off removes the light from consideration in the viewport. This is useful for lights which only make sense at render time.
The light will contribute to diffuse illumination when illuminating a surface.
The light will provide specular highlights on the surface when illuminating a surface.
|Render Light Geometry|
Display the light as a geometry object in the render. Environment lights will appear as a background image in the render when this toggle is enabled.
|Clip To Positive Y Hemisphere|
Forces the environment lighting to only emit light from the +Y hemisphere. When lighting a scene that occludes most illumination in the -Y hemisphere (eg. a scene with a large ground plane), turning on this toggle can improve rendering quality.
Options that affect how light is produced by the environment light.
The sampling style for environment illumination. Environment lighting is computed with raytracing by sending rays out into the hemisphere above the shaded surface to analyze the amount of light arriving at the surface from different directions.
Which rendering mode you choose to use will depend on the type of environment illumination as well as the geometry in your scene.
The sampling quality multiplier for the light. A value of 1 will use the ray sampling parameters (Min Ray Samples) from the output driver directly. Other values will proportionally increase or decrease the sampling quality.
Specifies a geometry object that can be used to optimize sampling of environment lights in enclosed scenes. The portal geometry describes to the renderer where light can enter the enclosed scene, so that the sampling algorithm can concentrate on the parts of the environment that actually contribute lighting to a pixel. Normally, the portal geometry should be a geometry object that is not rendered, so that it does not cast shadows on the scene, and that has only a single layer of surface visible from any point in the scene - so that illumination is not multiply counted.
A correctly configured portal should produce the same rendered result as when the portal is disabled, but with much less noise. Portals should normally not be used in outdoor scenes where the environment map is fully visible, or when the environment map contains sharp variations in intensity - since in these cases the standard direct lighting algorithm may produce better results.
Using an environment light with a portal is equivalent to creating a standard geometry light with physically correct attenuation, no intensity normalization, and transform into this object enabled.
Maximum distance from the sample point to consider geometry for irradiance/occlusion.
Half-angle over which to send rays for irradiance/occlusion. 90 degrees is a full hemisphere.
Turns on an automatic optimization that will reduce the number of samples when there is little variation in occlusion above the sample point. This can improve performance at the expense of some possible flickering or additional noise. Adaptive sampling will only take effect with more than 64 samples.
Sky Environment Map
Options to automatically create a “sky and ground” environment map for the light.
|Enable Sky Environment Map|
Automatically create a “sky and ground” environment map. When this parameter is on, the Environment Map parameter (on the Environment tab) will be disabled.
The resolution (in pixels per cube side) of the environment map.
The other parameters on this tab are identical to the parameters of the Sky Environment Map compositing node.
The type of direction to calculate. Either Away from Sun or Towards the Sun.
The direction vector for the sun.
The Euler rotation angles to align -Z axis with the Calculated Vector.
A mask of objects which will be considered occluders for the light source. When ray-traced shadows are used, only these objects will be intersected by shadow rays. When depth map shadows are used, only these objects will appear in the depth map.
It is possible to use categories by adding the shadowcategories rendering parameter.
A scale on how much light is blocked by occluders. By decreasing the shadow intensity, the occluders will not block all the light, allowing some illumination through.
When this option is turned on, the surface shader of occluders will be evaluated to determine the opacity. Turning this option on will cause deep shadow maps to be used when shadowing using Depth Map Shadows.
|PortalBox||Load | Launch|
This example shows how to create a portal light using window geometry. A box is modeled and then split into 2 SOPs - one representing windows and the other walls. The walls are rendered, while the windows are used to specify the portal for an environment light. Toggle on and off the portal to see the render quality difference while rendering in the Render View.
Examples that use this node
|Example for||Example name|
|Indirect Light||TubeCaustic||Load | Launch|
|Mantra||Ambient Occlusion||Load | Launch|
|Iso Offset||Brickify||Load | Launch|