#include <RixGeometricLight.h>

Inherits RixLight.

Public Types
enum	Type { k_RixLocal, k_RixInfinite }

enum	LightProperty { k_LightGroupName, k_EnableShadows, k_ShadowColor, k_ShadowDistance, k_ShadowFalloff, k_ShadowFalloffGamma, k_ShadowSubset, k_ShadowExcludeSubset, k_TraceLightPaths, k_ThinShadow, k_VisibleInRefractionPath, k_FixedSampleCount, k_RixIES, k_Importance, k_LightNormal, k_ApproxFocus, k_LightName, k_numLightProperties }

Public Member Functions
	RixGeometricLight (RixLightFactory const *factory)

virtual void	ComputeEmission (RixShadingContext const sCtx, RtColorRGB emission)=0

bool	IsLocal () const

bool	IsInfinite () const

virtual RixSCDetail	GetProperty (LightProperty prop, void const **result) const =0

virtual void	GetBounds (int &nPoints, RtPoint3 const *&points) const =0

virtual bool	Intersect (bool isTransmissionRay, float const rayTime, RtPoint3 const &rayOrigin, RtVector3 const &rayDirection, float &hitDistance, float &u, float &v, float &w, RtPoint3 &hitP, RtNormal3 &hitNn) const =0

virtual float	GetIncidentRadianceEstimate (RtPoint3 const &P, RtMatrix4x4 const &lightToCurrent, RtMatrix4x4 const &currentToLight) const =0
	GetIncidentRadianceEstimate Returns an estimate of the radiance this light will return for a shading point. More...

virtual float	GetIncidentRadianceEstimate (RtPoint3 const &segmentOrigin, RtVector3 const &segmentDir, float segmentLen, RtMatrix4x4 const &lightToCurrent, RtMatrix4x4 const &currentToLight, RtFloat &minT, RtFloat &maxT) const =0
	GetIncidentRadiancEstimate Returns an estimate of the radiance this light will return for a segment, along with a min and max t that represent the subsection of the segment that intersects the light's frustum, if it has one. More...

virtual float	GetPowerEstimate (RtMatrix4x4 const &xform) const =0
	GetPowerEstimate Returns an estimate of the power emitted by this light. More...

virtual void	GenerateSamples (RixLightContext const &lCtx, RixScatterPoint const &scatter, GenerateSamplesResults &results) const =0

virtual void	EvaluateSamples (RixLightContext const &lCtx, RixSamplePoint const &sample, RixScatterPoint const &scatter, EvaluateSamplesResults &results) const =0

virtual void	GenerateEmission (RixLightContext const &lCtx, GenerateEmissionResults &results) const =0

virtual void	EvaluateEmissionForCamera (RixLightContext const &lCtx, RixSamplePoint const &sample, RixScatterPoint const &scatter, EvaluateEmissionForCameraResults &results) const =0

virtual RixLight *	Edit (RixContext &ctx, RtUString const name, RixParameterList const pList, void instanceData)=0

Protected Member Functions
virtual	~RixGeometricLight ()

Protected Attributes
RixLightFactory const *	m_lightFactory

Member Enumeration Documentation

enum RixLight::LightProperty

inherited

Enumerator
k_LightGroupName
k_EnableShadows
k_ShadowColor
k_ShadowDistance
k_ShadowFalloff
k_ShadowFalloffGamma
k_ShadowSubset
k_ShadowExcludeSubset
k_TraceLightPaths
k_ThinShadow
k_VisibleInRefractionPath
k_FixedSampleCount
k_RixIES
k_Importance
k_LightNormal
k_ApproxFocus
k_LightName
k_numLightProperties

enum RixLight::Type

inherited

Enumerator
k_RixLocal
k_RixInfinite

Constructor & Destructor Documentation

RixGeometricLight::RixGeometricLight ( RixLightFactory const * factory)

inline

virtual RixGeometricLight::~RixGeometricLight ( )

inlineprotectedvirtual

Member Function Documentation

virtual void RixGeometricLight::ComputeEmission	(	RixShadingContext const *	sCtx,
		RtColorRGB *	emission
	)

pure virtual

virtual RixLight* RixLight::Edit	(	RixContext &	ctx,
		RtUString const	name,
		RixParameterList const *	pList,
		void *	instanceData
	)

pure virtualinherited

virtual void RixLight::EvaluateEmissionForCamera	(	RixLightContext const &	lCtx,
		RixSamplePoint const &	sample,
		RixScatterPoint const &	scatter,
		EvaluateEmissionForCameraResults &	results
	)		const

pure virtualinherited

virtual void RixLight::EvaluateSamples	(	RixLightContext const &	lCtx,
		RixSamplePoint const &	sample,
		RixScatterPoint const &	scatter,
		EvaluateSamplesResults &	results
	)		const

pure virtualinherited

virtual void RixLight::GenerateEmission	(	RixLightContext const &	lCtx,
		GenerateEmissionResults &	results
	)		const

pure virtualinherited

virtual void RixLight::GenerateSamples	(	RixLightContext const &	lCtx,
		RixScatterPoint const &	scatter,
		GenerateSamplesResults &	results
	)		const

pure virtualinherited

virtual void RixLight::GetBounds	(	int &	nPoints,
		RtPoint3 const *&	points
	)		const

pure virtualinherited

virtual float RixLight::GetIncidentRadianceEstimate	(	RtPoint3 const &	P,
		RtMatrix4x4 const &	lightToCurrent,
		RtMatrix4x4 const &	currentToLight
	)		const

pure virtualinherited

GetIncidentRadianceEstimate Returns an estimate of the radiance this light will return for a shading point.

This is used by localisation schemes to optionally adjust the importance associated with the light source relative to other light sources. As such, it should be an estimate that is very quick to compute.

virtual float RixLight::GetIncidentRadianceEstimate	(	RtPoint3 const &	segmentOrigin,
		RtVector3 const &	segmentDir,
		float	segmentLen,
		RtMatrix4x4 const &	lightToCurrent,
		RtMatrix4x4 const &	currentToLight,
		RtFloat &	minT,
		RtFloat &	maxT
	)		const

pure virtualinherited

GetIncidentRadiancEstimate Returns an estimate of the radiance this light will return for a segment, along with a min and max t that represent the subsection of the segment that intersects the light's frustum, if it has one.

Dir and segmentLen are normalized direction and segment length This case is used during volume integration.

virtual float RixLight::GetPowerEstimate ( RtMatrix4x4 const & xform) const

pure virtualinherited

GetPowerEstimate Returns an estimate of the power emitted by this light.

This is used by localisation schemes to optionally adjust the importance associated with the light source relative to other light sources. As such, it should be an estimate that is very quick to compute.

virtual RixSCDetail RixLight::GetProperty	(	LightProperty	prop,
		void const **	result
	)		const

pure virtualinherited

virtual bool RixLight::Intersect	(	bool	isTransmissionRay,
		float const	rayTime,
		RtPoint3 const &	rayOrigin,
		RtVector3 const &	rayDirection,
		float &	hitDistance,
		float &	u,
		float &	v,
		float &	w,
		RtPoint3 &	hitP,
		RtNormal3 &	hitNn
	)		const