Package org.sunflow.core.primitive
Class CornellBox
- java.lang.Object
-
- org.sunflow.core.primitive.CornellBox
-
- All Implemented Interfaces:
LightSource
,PrimitiveList
,RenderObject
,Shader
public class CornellBox extends java.lang.Object implements PrimitiveList, Shader, LightSource
-
-
Field Summary
Fields Modifier and Type Field Description private float
area
private Color
back
private Color
bottom
private Color
left
private BoundingBox
lightBounds
private float
lxmax
private float
lxmin
private float
lymax
private float
lymin
private float
maxX
private float
maxY
private float
maxZ
private float
minX
private float
minY
private float
minZ
private Color
radiance
private Color
right
private int
samples
private Color
top
-
Constructor Summary
Constructors Constructor Description CornellBox()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Instance
createInstance()
Create an instance which represents the geometry of this light source.PrimitiveList
getBakingPrimitives()
Create a newPrimitiveList
object suitable for baking lightmaps.float
getBound(int i)
BoundingBox
getBounds()
int
getNumPrimitives()
Returns the number of individual primtives in this aggregate object.int
getNumSamples()
Get the maximum number of samples that can be taken from this light source.void
getPhoton(double randX1, double randY1, double randX2, double randY2, Point3 p, Vector3 dir, Color power)
Gets a photon to emit from this light source by setting each of the arguments.float
getPower()
Get the total power emitted by this light source.float
getPrimitiveBound(int primID, int i)
Retrieve the bounding box component of a particular primitive in object space.Color
getRadiance(ShadingState state)
Gets the radiance for a specified rendering state.void
getSamples(ShadingState state)
Samples the light source to compute direct illumination.BoundingBox
getWorldBounds(Matrix4 o2w)
Compute a bounding box of this object in world space, using the specified object-to-world transformation matrix.void
intersectPrimitive(Ray r, int primID, IntersectionState state)
Intersect the specified primitive in local space.boolean
intersects(BoundingBox box)
void
prepareShadingState(ShadingState state)
Prepare the specifiedShadingState
by setting all of its internal parameters.void
scatterPhoton(ShadingState state, Color power)
Scatter a photon with the specied power.boolean
update(ParameterList pl, SunflowAPI api)
Update this object given a list of parameters.private void
updateGeometry(Point3 c0, Point3 c1)
-
-
-
Field Detail
-
minX
private float minX
-
minY
private float minY
-
minZ
private float minZ
-
maxX
private float maxX
-
maxY
private float maxY
-
maxZ
private float maxZ
-
left
private Color left
-
right
private Color right
-
top
private Color top
-
bottom
private Color bottom
-
back
private Color back
-
radiance
private Color radiance
-
samples
private int samples
-
lxmin
private float lxmin
-
lymin
private float lymin
-
lxmax
private float lxmax
-
lymax
private float lymax
-
area
private float area
-
lightBounds
private BoundingBox lightBounds
-
-
Method Detail
-
update
public boolean update(ParameterList pl, SunflowAPI api)
Description copied from interface:RenderObject
Update this object given a list of parameters. This method is guarenteed to be called at least once on every object, but it should correctly handle empty parameter lists. This means that the object should be in a valid state from the time it is constructed. This method should also return true or false depending on whether the update was succesfull or not.- Specified by:
update
in interfaceRenderObject
- Parameters:
pl
- list of parameters to read fromapi
- reference to the current scene- Returns:
true
if the update is succesfull,false
otherwise
-
getBounds
public BoundingBox getBounds()
-
getBound
public float getBound(int i)
-
intersects
public boolean intersects(BoundingBox box)
-
prepareShadingState
public void prepareShadingState(ShadingState state)
Description copied from interface:PrimitiveList
Prepare the specifiedShadingState
by setting all of its internal parameters.- Specified by:
prepareShadingState
in interfacePrimitiveList
- Parameters:
state
- shading state to fill in
-
intersectPrimitive
public void intersectPrimitive(Ray r, int primID, IntersectionState state)
Description copied from interface:PrimitiveList
Intersect the specified primitive in local space.- Specified by:
intersectPrimitive
in interfacePrimitiveList
- Parameters:
r
- ray in the object's local spaceprimID
- primitive index to intersectstate
- intersection state- See Also:
Ray.setMax(float)
,IntersectionState.setIntersection(int, float, float)
-
getRadiance
public Color getRadiance(ShadingState state)
Description copied from interface:Shader
Gets the radiance for a specified rendering state. When this method is called, you can assume that a hit has been registered in the state and that the hit surface information has been computed.- Specified by:
getRadiance
in interfaceShader
- Parameters:
state
- current render state- Returns:
- color emitted or reflected by the shader
-
scatterPhoton
public void scatterPhoton(ShadingState state, Color power)
Description copied from interface:Shader
Scatter a photon with the specied power. Incoming photon direction is specified by the ray attached to the current render state. This method can safely do nothing if photon scattering is not supported or relevant for the shader type.- Specified by:
scatterPhoton
in interfaceShader
- Parameters:
state
- current statepower
- power of the incoming photon.
-
getNumSamples
public int getNumSamples()
Description copied from interface:LightSource
Get the maximum number of samples that can be taken from this light source. This is currently only used for statistics reporting.- Specified by:
getNumSamples
in interfaceLightSource
- Returns:
- maximum number of samples to be taken from this light source
-
getSamples
public void getSamples(ShadingState state)
Description copied from interface:LightSource
Samples the light source to compute direct illumination. Light samples can be created using theLightSample
class and added to the currentShadingState
. This method is responsible for the shooting of shadow rays which allows for non-physical lights that don't cast shadows. It is recommended that only a single shadow ray be shot ifShadingState.getDiffuseDepth()
is greater than 0. This avoids an exponential number of shadow rays from being traced.- Specified by:
getSamples
in interfaceLightSource
- Parameters:
state
- current state, including point to be shaded- See Also:
LightSample
-
getPhoton
public void getPhoton(double randX1, double randY1, double randX2, double randY2, Point3 p, Vector3 dir, Color power)
Description copied from interface:LightSource
Gets a photon to emit from this light source by setting each of the arguments. The two sampling parameters are points on the unit square that can be used to sample a position and/or direction for the emitted photon.- Specified by:
getPhoton
in interfaceLightSource
- Parameters:
randX1
- sampling parameterrandY1
- sampling parameterrandX2
- sampling parameterrandY2
- sampling parameterp
- position to shoot the photon fromdir
- direction to shoot the photon inpower
- power of the photon
-
getPower
public float getPower()
Description copied from interface:LightSource
Get the total power emitted by this light source. Lights that have 0 power will not emit any photons.- Specified by:
getPower
in interfaceLightSource
- Returns:
- light source power
-
getNumPrimitives
public int getNumPrimitives()
Description copied from interface:PrimitiveList
Returns the number of individual primtives in this aggregate object.- Specified by:
getNumPrimitives
in interfacePrimitiveList
- Returns:
- number of primitives
-
getPrimitiveBound
public float getPrimitiveBound(int primID, int i)
Description copied from interface:PrimitiveList
Retrieve the bounding box component of a particular primitive in object space. Even indexes get minimum values, while odd indexes get the maximum values for each axis.- Specified by:
getPrimitiveBound
in interfacePrimitiveList
- Parameters:
primID
- primitive indexi
- bounding box side index- Returns:
- value of the request bound
-
getWorldBounds
public BoundingBox getWorldBounds(Matrix4 o2w)
Description copied from interface:PrimitiveList
Compute a bounding box of this object in world space, using the specified object-to-world transformation matrix. The bounds should be as exact as possible, if they are difficult or expensive to compute exactly, you may useMatrix4.transform(BoundingBox)
. If the matrix isnull
no transformation is needed, and object space is equivalent to world space.- Specified by:
getWorldBounds
in interfacePrimitiveList
- Parameters:
o2w
- object to world transformation matrix- Returns:
- object bounding box in world space
-
getBakingPrimitives
public PrimitiveList getBakingPrimitives()
Description copied from interface:PrimitiveList
Create a newPrimitiveList
object suitable for baking lightmaps. This means a set of primitives laid out in the unit square UV space. This method is optional, objects which do not support it should simply returnnull
.- Specified by:
getBakingPrimitives
in interfacePrimitiveList
- Returns:
- a list of baking primitives
-
createInstance
public Instance createInstance()
Description copied from interface:LightSource
Create an instance which represents the geometry of this light source. This instance will be created just before and removed immediately after rendering. Non-area light sources can returnnull
to indicate that no geometry needs to be created.- Specified by:
createInstance
in interfaceLightSource
- Returns:
- an instance describing the light source
-
-