Module gpuFlux

Package de.grogra.gpuflux.imp3d.objects

Class LightDistribution

java.lang.Object

de.grogra.persistence.ShareableBase

de.grogra.gpuflux.imp3d.objects.LightDistribution

All Implemented Interfaces:

LightDistributionIF, LightDistributionIF, Manageable, Shareable

Direct Known Subclasses:

LightDistributionResource

public class LightDistribution
extends ShareableBase
implements LightDistributionIF

Author:

Dietger van Antwerpen This object holds a discretized 2D light distribution over unit hemisphere It is used for computing the cumulative probability distribution for importance sampling The object uses the following mapping from 2D (u,v) coordinates in the discetized unit square [0,1]^2 to spherical coordinates (theta,phi) theta = u * PI phi = v * 2 * PI - PI

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	LightDistribution.Type

Field Summary

Fields

Modifier and Type	Field	Description
static final LightDistribution.Type	$TYPE
static final SCOType.Field	height$FIELD
static final SCOType.Field	licdf$FIELD
static final SCOType.Field	lipdf$FIELD
static final SCOType.Field	width$FIELD

Constructor Summary

Constructors

Constructor	Description
LightDistribution()
LightDistribution(double[][] lipdf)

Method Summary

Modifier and Type	Method	Description
static Vector2f	cartesian2map(Vector3f direction)
double	getDensityAt(Vector3f direction)	Returns the probability density for emitting light in the given direction (in local coordinates).
double[][]	getDistribution()
int	getHeight()
double[]	getLinearCDF()
ManageableType	getManageableType()
double	getPower()
int	getWidth()
static Vector3f	map2cartesian(float r1, float r2)
static void	map2cartesian(Tuple3f out, float r1, float r2)
double	map2direction(Vector3f outDirection, Tuple2d inPoint)	Importance-samples an emission direction from this distribution.
void	setDistribution(double[][] lipdf)
void	setDistributionEx(double[][] lipdf)
void	setPower(double power)

Methods inherited from class de.grogra.persistence.ShareableBase

addReference, appendReferencesTo, fieldModified, getProvider, getStamp, initProvider, manageableReadResolve, manageableWriteReplace, removeReference

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

$TYPE

public static final LightDistribution.Type $TYPE

width$FIELD

public static final SCOType.Field width$FIELD

height$FIELD

public static final SCOType.Field height$FIELD

lipdf$FIELD

public static final SCOType.Field lipdf$FIELD

licdf$FIELD

public static final SCOType.Field licdf$FIELD

Constructor Details

LightDistribution

public LightDistribution()

LightDistribution

public LightDistribution(double[][] lipdf)

Method Details

getManageableType

public ManageableType getManageableType()

Specified by:

getManageableType in interface Manageable

getWidth

public int getWidth()

Specified by:

getWidth in interface LightDistributionIF

getHeight

public int getHeight()

Specified by:

getHeight in interface LightDistributionIF

getDistribution

public double[][] getDistribution()

Specified by:

getDistribution in interface LightDistributionIF

getLinearCDF

public double[] getLinearCDF()

Specified by:

getLinearCDF in interface LightDistributionIF

setDistribution

public void setDistribution(double[][] lipdf)

Specified by:

setDistribution in interface LightDistributionIF

setDistributionEx

public void setDistributionEx(double[][] lipdf)

Specified by:

setDistributionEx in interface LightDistributionIF

getPower

public double getPower()

Specified by:

getPower in interface LightDistributionIF

setPower

public void setPower(double power)

Specified by:

setPower in interface LightDistributionIF

getDensityAt

public double getDensityAt(Vector3f direction)

Description copied from interface: LightDistributionIF

Returns the probability density for emitting light in the given direction (in local coordinates).

Specified by:

getDensityAt in interface LightDistributionIF

Parameters:

direction - normalised emission direction in local space

Returns:

density value ≥ 0

map2direction

public double map2direction(Vector3f outDirection,
 Tuple2d inPoint)

Description copied from interface: LightDistributionIF

Importance-samples an emission direction from this distribution.

Specified by:

map2direction in interface LightDistributionIF

Parameters:

outDirection - receives the sampled direction in local space

inPoint - two uniform random numbers in [0,1)²

Returns:

the PDF of the sampled direction

map2cartesian

public static Vector3f map2cartesian(float r1,
 float r2)

map2cartesian

public static void map2cartesian(Tuple3f out,
 float r1,
 float r2)

cartesian2map

public static Vector2f cartesian2map(Vector3f direction)