- All Implemented Interfaces:
Icon
,IconSource
,Light
,Scattering
,Shader
,ChannelMap
,ColorMap
,Manageable
,PersistenceCapable
,Shareable
,RenderedIcon
,Emitter
,Light
,Scattering
,Shader
,UserFields
,XObject
,Map
,Serializable
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class de.grogra.graph.impl.Node
Node.AccessorBridge, Node.FieldAttributeAccessor, Node.NType
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final Node.NType
static final Node.NType.Field
static final Node.NType.Field
static final Node.NType.Field
static final Node.NType.Field
static final Node.NType.Field
Fields inherited from class de.grogra.imp3d.shading.ChannelMapNode
AMBIENT, COLOR, COLOR_2, DIFFUSE_TRANSPARENCY, DISPLACEMENT, EMISSIVE, FIRST_OP, INPUT, input$FIELD, MIN_UNUSED_SPECIAL_OF_TARGET, SECOND_OP, SHININESS, SPECULAR, TRANSPARENCY, TRANSPARENCY_SHININESS
Fields inherited from class de.grogra.graph.impl.Node
ADDITIONAL_FIELDS, bits, DELETED, EXTENT_BIT, EXTENT_MASK, extentIndex$FIELD, extentTail$FIELD, HAS_OBSERVERS, IS_INTERPRETIVE, isInterpretive$FIELD, LAST_EXTENT_INDEX, layer$FIELD, MARK, mark$FIELD, MAX_RESOLUTION, MIME_TYPE, MIN_RESOLUTION, MIN_UNUSED_SPECIAL_OF_SOURCE, name$FIELD, RESOLUTION_BIT, RESOLUTION_MASK, resolution$FIELD, USED_BITS
Fields inherited from interface de.grogra.ray.physics.Light
AMBIENT, AREA, DIRECTIONAL, NO_LIGHT, POINT, SKY
Fields inherited from interface de.grogra.util.Map
DEFAULT_VALUE, EMPTY_MAP
Fields inherited from interface de.grogra.ray.physics.Scattering
DELTA_FACTOR, IS_NON_OPAQUE, MIN_UNUSED_FLAG, NEEDS_NORMAL, NEEDS_POINT, NEEDS_TANGENTS, NEEDS_TRANSFORMATION, NEEDS_UV, RANDOM_RAYS_GENERATE_ORIGINS
Fields inherited from interface de.grogra.ray.physics.Shader
LAMBERTIAN_VARIANCE
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
accept
(ChannelMapNodeVisitor visitor) void
accept
(LightVisitor visitor) void
accept
(ShaderVisitor visitor) double
completeRay
(Environment env, Point3d vertex, Ray out) float
computeBSDF
(Environment env, Vector3f in, Spectrum specIn, Vector3f out, boolean adjoint, Spectrum bsdf) Evaluates bidirectional scattering distribution function for given input.double
computeExitance
(Environment env, Spectrum exitance) Evaluates the exitance function for given input.void
computeMaxRays
(Environment env, Vector3f in, Spectrum specIn, Ray reflected, Tuple3f refVariance, Ray transmitted, Tuple3f transVariance) Computes, for the given input, the reflected and transmitted importance rays for which the reflection/transmission probability densities (integrated over the spectrum) attain a maximum.void
generateRandomOrigins
(Environment env, RayList out, Random random) Pseudorandomly generates, for the given input, a set of origins for this emitter.void
generateRandomRays
(Environment env, Vector3f out, Spectrum specOut, RayList rays, boolean adjoint, Random random) Pseudorandomly generates, for the given input, a set of scattered rays.int
Returns an average color for the scattering entity.int
getFlags()
int
Determines the type of light source which is represented by this light.protected Node.NType
This method returns theNode.NType
which describes the managed fields of the class of this node.float
getSun()
double
getTotalPower
(Environment env) Computes the total power of this light source which is emitted to the region defined byenv.bounds
.float
boolean
boolean
boolean
Determines whether the light source shall be ignored when a shot ray happens to hit the geometry of the light source.boolean
Determines whether the light source casts shadows or not.boolean
protected Node
This method returns a new instance of the class of this node.void
setDisableLight
(boolean value) void
setDisableSun
(boolean value) void
setRadianceFactor
(float value) void
void
setTurbidity
(float value) void
Computes color of outgoing light ray for given input.Methods inherited from class de.grogra.imp3d.shading.Material
renderLine, renderLine
Methods inherited from class de.grogra.imp3d.shading.ColorMapNode
drawImage, getIcon, getIconBounds, getIconSource, getImage, getImage, getImageSource, getInputData, getPreferredIconSize, getRenderedImage, getSizeRatio, isMutable, paintIcon, prepareIcon, renderImage
Methods inherited from class de.grogra.imp3d.shading.ChannelMapNode
accept, getFloatValue, getInput, getObjectValue, setInput
Methods inherited from class de.grogra.graph.impl.Node
addEdgeBitsTo, addReference, appendBranchNode, appendBranchNode, appendReferencesTo, clone, clone, cloneGraph, dump, dumpTree, dup, dupFrom, dupnew, dupUnmanagedFields, edgeChanged, fieldModified, findAdjacent, findRefinementType, get, getAccessor, getAccessor, getAttributes, getAxisParent, getBoolean, getBranch, getBranchLength, getBranchNode, getBranchTail, getByte, getChar, getCommonAncestor, getCurrentGraphState, getDirectChildCount, getDouble, getEdgeAttributeAccessor, getEdgeAttributes, getEdgeBitsTo, getEdgeTo, getExtentIndex, getFirst, getFirstEdge, getFloat, getGraph, getId, getIgnored, getIndex, getInstantiator, getInt, getLayer, getLong, getManageableType, getName, getNeighbor, getNext, getNType, getObject, getOrCreateEdgeTo, getOrNull, getPersistenceManager, getPredecessor, getProvider, getResolution, getShort, getSource, getStamp, getSuccessor, getSymbol, getSymbolColor, getTarget, getTransaction, getUserField, getUserFieldCount, getXClass, getXData, hasName, initProvider, initXClass, insertBranchNode, insertBranchNode, instantiateGraph, isAncestorOf, isDirection, isEncoarseOf, isManagingInstance, isMarked, isRoot, isSource, isTarget, manageableReadResolve, manageableWriteReplace, paramString, removeAll, removeEdgeBitsTo, removeFromChain, removeFromChain, removeReference, setBranch, setBranch, setExtentIndex, setGraphForDeserialization, setIgnored, setLayer, setMark, setName, setResolution, setSuccessor, setSuccessor, specialEdgeAdded, specialEdgeRefModified, specialEdgeRemoved, toString, writeReplace
Methods inherited from class de.grogra.graph.impl.Edge
addEdgeBits, getBitMark, getEdgeBits, getEdgeKeys, getObjectMark, getSpecialEdgeDescriptor, parseEdgeKeys, remove, removeEdgeBits, setBitMark, setEdgeBits, setObjectMark, testEdgeBits
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface de.grogra.math.ChannelMap
accept, getFloatValue, getObjectValue, getStamp
Methods inherited from interface de.grogra.persistence.PersistenceCapable
getBitMark, getObjectMark, setBitMark, setObjectMark
Methods inherited from interface de.grogra.pf.ui.RenderedIcon
getStamp
-
Field Details
-
$TYPE
-
sun$FIELD
-
turbidity$FIELD
-
radianceFactor$FIELD
-
disableLight$FIELD
-
disableSun$FIELD
-
-
Constructor Details
-
SunSkyLight
public SunSkyLight()
-
-
Method Details
-
generateRandomRays
public void generateRandomRays(Environment env, Vector3f out, Spectrum specOut, RayList rays, boolean adjoint, Random random) Description copied from interface:Scattering
Pseudorandomly generates, for the given input, a set of scattered rays. The scattered rays are generated such that they can be used for a Monte Carlo integration of a function f(ω;ν) over cos θ BSDF(ωi, νi; ωo, νo) in the following way:-
If
adjoint
isfalse
,out
= ωo describes the direction of an outgoing light ray. In this case, the integration is with respect to ωi. Let g(ω, ν;out
, μ) = BSDF(ω, ν;out
, μ) -
Otherwise,
adjoint
istrue
. In this case,out
= ωi describes the direction of an outgoing importance ray (an inverse light ray). Now the integration is with respect to ωo. Let g(ω, ν;out
, μ) = BSDF(out
, μ; ω, ν)
rays.size
). Then, for every frequency ν the sum1 / N ∑i si(ν) f(di; ν) is an unbiased estimate for the integral∫ cos θ f(ω; ν) g(ω, ν; θ is the angle between the surface normal and ω. The domain of integration is the whole sphere, since the bidirectional scattering distribution includes both reflection and transmission (BSDF = BRDF + BTDF).out
, μ)specOut
(μ) dμ dωIf this
Scattering
instance is in fact aLight
source,adjoint
istrue
, and the BSDF is defined as BSDF(out
, μ; ω, ν) = L1(ω, ν) δ(μ - ν), i.e., the directional distribution of the emitted radiance atenv.point
, seeEmitter
. In this case,out
is not used.If this
Scattering
instance is in fact aSensor
,adjoint
isfalse
, and the BSDF is defined as BSDF(ω, ν;out
, μ) = W1(ω, ν) δ(μ - ν), i.e., the directional distribution of the emitted importance atenv.point
, seeEmitter
. In this case,out
is not used.Let pω be the probability density used for the ray direction (measured with respect to solid angle ω), then the field
directionDensity
of the ray i is set to pω(di). For ideal specular reflection or transmission, or for directional lights or sensors, pω is not a regular function, the valuedirectionDensity
will be set to a multiple ofScattering.DELTA_FACTOR
.The ray properties which are not mentioned in the given formulas are neither used nor modified. These are the origin and its density.
- Specified by:
generateRandomRays
in interfaceScattering
- Parameters:
env
- the environment for scatteringout
- the direction unit vector of the outgoing ray (i.e., pointing away from the surface)specOut
- the spectrum of the outgoing rayrays
- the rays to be generatedadjoint
- representsout
a light ray or an importance ray?random
- pseudorandom generator- See Also:
-
If
-
computeBSDF
public float computeBSDF(Environment env, Vector3f in, Spectrum specIn, Vector3f out, boolean adjoint, Spectrum bsdf) Description copied from interface:Scattering
Evaluates bidirectional scattering distribution function for given input.The computed spectrum is an integral over the spectrum of the following product:
|cos θ| BSDF(ωi, νi; ωo, νo) where BSDF is the bidirectional scattering distribution function (= BRDF + BTDF) at the pointenv.point
, ωi the (negated) direction of the incoming light ray, νi the frequency where the incoming ray is sampled, ωo the direction of the outgoing light ray, νo the frequency where the outgoing ray is sampled, and θ the angle between the surface normal andout
.If
adjoint
isfalse
,in
andout
describe true light rays from light sources to sensors. In this case, ωi =in
, ωo =out
, and the integral isbsdf
(ν) = |cos θ| ∫ BSDF(in
, νi;out
, ν)specIn
(νi) dνiadjoint
istrue
.in
andout
then describe importance rays (inverse light rays from sensors to light sources). In this case, ωi =out
, ωo =in
, and the integral isbsdf
(ν) = |cos θ| ∫ BSDF(out
, ν;in
, νo)specIn
(νo) dνoIf this
Scattering
instance is in fact aLight
source,adjoint
isfalse
, and the BSDF is defined as BSDF(in
, μ; ω, ν) = L1(ω, ν) δ(μ - ν), i.e., the directional distribution of the emitted radiance atenv.point
, seeEmitter
. In this case,in
is not used.If this
Scattering
instance is in fact aSensor
,adjoint
istrue
, and the BSDF is defined as BSDF(ω, ν;in
, μ) = W1(ω, ν) δ(μ - ν), i.e., the directional distribution of the emitted importance atenv.point
, seeEmitter
. In this case,in
is not used.The computation should be physically valid. This excludes, e.g., ambient or emissive light contributions.
The returned value is the value of the probability density pω that would be calculated by
Scattering.generateRandomRays(de.grogra.ray.physics.Environment, javax.vecmath.Vector3f, de.grogra.ray.physics.Spectrum, de.grogra.ray.util.RayList, boolean, java.util.Random)
if the ray happened to be one of the randomly generated rays.- Specified by:
computeBSDF
in interfaceScattering
- Parameters:
env
- the environment for scatteringin
- the (negated) direction unit vector of the incoming ray (i.e., pointing away from the surface)specIn
- the spectrum of the incoming rayout
- the direction unit vector of the outgoing ray (i.e., pointing away from the surface)adjoint
- light ray or importance ray?bsdf
- the computed spectrum of the outgoing ray will be placed in here- Returns:
- the value of the probability density for the ray direction
-
completeRay
- Specified by:
completeRay
in interfaceEmitter
-
getAverageColor
public int getAverageColor()Description copied from interface:Scattering
Returns an average color for the scattering entity. This color is used for simplified graphical representations of the corresponding objects.- Specified by:
getAverageColor
in interfaceColorMap
- Specified by:
getAverageColor
in interfaceScattering
- Returns:
- an average color in Java's default sRGB color space, encoded as an int (0xAARRGGBB).
-
getFlags
public int getFlags()- Specified by:
getFlags
in interfaceScattering
-
computeMaxRays
public void computeMaxRays(Environment env, Vector3f in, Spectrum specIn, Ray reflected, Tuple3f refVariance, Ray transmitted, Tuple3f transVariance) Description copied from interface:Shader
Computes, for the given input, the reflected and transmitted importance rays for which the reflection/transmission probability densities (integrated over the spectrum) attain a maximum. The reflection probability density (measured with respect to solid angle) for the outgoing importance direction (i.e., incoming light direction) ω, given a fixed incident directionin
, ispr(ω) = cos θ BRDF(ω, where BRDF is the bidirectional reflectivity distribution function, θ the angle between the surface normal and ω, and R the total reflectivity for the incident direction, i.e., the integral over cos θ BRDF(ω,in
) / Rin
). The transmission probability density is defined correspondingly.The
color
-fields are set to the total reflectivity/transparency for the incident direction for each color component R, G, B. Thus, for physically plausible BRDF/BTDF, the component-wise sum ofreflected.color
andtransmitted.color
lies in the interval [0, 1], and the difference to 1 is the amount absorbed.The
color
may be zero if there is no reflected or transmitted ray, respectively, i.e., if the surface is fully transparent, opaque, or absorbing. The origin-fields of the rays will never be set.The computed variances are defined to be, for each color component, (approximations for) the angular mean quadratic deviations of the densities from the returned maximal ray directions. E.g., for perfect reflection/transmission, these variances are zero, whereas for a perfect lambertian reflector, the variance of reflection is ∫ cos θ (1 / π) θ2 dω = (π2 - 4) / 8. This is the value of
Shader.LAMBERTIAN_VARIANCE
.The ray properties which are not mentioned are neither used nor modified. These are the origin and its density, and the direction density.
- Specified by:
computeMaxRays
in interfaceShader
- Parameters:
env
- the environment for scatteringin
- the (negated) direction unit vector of the incoming ray (i.e., pointing away from the surface)specIn
- spectrum of incoming rayreflected
- the reflected ray with maximal probabilityrefVariance
- the angular mean quadratic deviation fromreflected
transmitted
- the transmitted ray with maximal probabilitytransVariance
- the angular mean quadratic deviation fromtransmitted
-
isTransparent
public boolean isTransparent()- Specified by:
isTransparent
in interfaceShader
-
shade
Description copied from interface:Shader
Computes color of outgoing light ray for given input. The computed value is, for each color component j = R, G, B, the following sum over all incident rays k:∑k |cos θk| BSDFj(ωk, where BSDFj is the bidirectional scattering distribution function (= BRDF + BTDF) at the pointout
) ck,jenv.point
, ωk and ck the direction and color of ray k, and θk the angle between the surface normal and ωk.The computation may include physically invalid contributions, which may not fit into the formula above, e.g., ambient or emissive light contributions.
-
getLightType
public int getLightType()Description copied from interface:Light
Determines the type of light source which is represented by this light.- Specified by:
getLightType
in interfaceLight
- Returns:
- one of
Light.NO_LIGHT
,Light.POINT
,Light.AREA
,Light.DIRECTIONAL
,Light.SKY
,Light.AMBIENT
.
-
getTotalPower
Description copied from interface:Light
Computes the total power of this light source which is emitted to the region defined byenv.bounds
. Note that the computed value is not necessarily exact: It should be used just as a hint, e.g., when one of a set of lights has to be chosen randomly on the basis of their relative power.- Specified by:
getTotalPower
in interfaceLight
- Parameters:
env
- environment which defines the bounds of the scene- Returns:
- total power emitted to the region
env.bounds
-
isShadowless
public boolean isShadowless()Description copied from interface:Light
Determines whether the light source casts shadows or not.- Specified by:
isShadowless
in interfaceLight
- Returns:
true
iff the light source does not cast shadows
-
isIgnoredWhenHit
public boolean isIgnoredWhenHit()Description copied from interface:Light
Determines whether the light source shall be ignored when a shot ray happens to hit the geometry of the light source.- Specified by:
isIgnoredWhenHit
in interfaceLight
- Returns:
true
iff the light source shall be ignored
-
computeExitance
Description copied from interface:Emitter
Evaluates the exitance function for given input. The computed value is the spectrum of the radiant exitance (emitted power per area) L0j(x, ν) at the pointenv.point
in case of light sources, or the corresponding function W0j(x, ν) in case of sensors.The returned value is the value of the probability density px that would be calculated by
Emitter.generateRandomOrigins(de.grogra.ray.physics.Environment, de.grogra.ray.util.RayList, java.util.Random)
ifenv.point
happened to be one of the randomly generated origins.- Specified by:
computeExitance
in interfaceEmitter
- Parameters:
env
- the environment for scatteringexitance
- the exitance values will be placed in here- Returns:
- the value of the probability density for the ray origin
-
generateRandomOrigins
Description copied from interface:Emitter
Pseudorandomly generates, for the given input, a set of origins for this emitter. They are generated such that they can be used for Monte Carlo-based photon tracing algorithms in the following way.At first, we consider the case where the emitter is in fact a light source. Let L(x, ω, ν) be the emitted spectral radiance for the frequency ν at the light's surface point x in direction ω. The radiant exitance (emitted spectral power per area) at x is defined as
L0(x, ν) = ∫ cos θ L(x, ω, ν) dω where θ is the angle between the surface normal and ω. Now the directional distribution of the emitted radiance at x can be described by the densityL1(x, ω, ν) = L(x, ω, ν) / L0(x, ν) so that the radiance is split intoL(x, ω, ν) = L0(x, ν) L1(x, ω, ν) Let oi and si denote the origins and spectra of the N generated rays (N =rays.size
). Then for a function f(x, ν) which is to be integrated over the light surface, the sum1 / N ∑i si(ν) f(oi, ν) is an unbiased estimate for the integral∫ L0(x, ν) f(x, ν) dA The integral ranges over the whole surface A of the light source. As a consequence, the spectrum of a ray is to be considered as the ray's radiant spectral power.Now if the emitter is a sensor, let W(x, ω, ν) be the emitted spectral importance for frequency ν at the sensors's surface point x in direction ω. The quantities W0(x, ν) and W1(x, ω, ν) are defined similarly to the case of light sources:
W0(x, ν) = ∫ cos θ W(x, ω, ν) dω The formulas for light sources are valid for sensors if the L-quantites are replaced by the corresponding W-quantities.
W(x, ω, ν) = W0(x) W1(x, ω, ν)Let px be the probability density used for the ray origin, then the field
originDensity
is set to px(oi) for each ray. For emitters which are concentrated at a single point (e.g., point lights) px is not a regular function, the valueoriginDensity
will be set to a multiple ofScattering.DELTA_FACTOR
.The ray properties which are not mentioned in the given formulas are neither used nor modified. These are the direction and its density.
- Specified by:
generateRandomOrigins
in interfaceEmitter
- Parameters:
env
- the environmentout
- the outgoing rays to be generatedrandom
- pseudorandom generator
-
getNTypeImpl
Description copied from class:Node
This method returns theNode.NType
which describes the managed fields of the class of this node. This method has to be implemented in every concrete subclass.- Overrides:
getNTypeImpl
in classNode
- Returns:
- type describing the managed fields of the class of this node
-
newInstance
Description copied from class:Node
This method returns a new instance of the class of this node. This method has to be implemented in every concrete subclass.- Overrides:
newInstance
in classNode
- Returns:
- new instance of class of this node
-
isDisableLight
public boolean isDisableLight() -
setDisableLight
public void setDisableLight(boolean value) -
isDisableSun
public boolean isDisableSun() -
setDisableSun
public void setDisableSun(boolean value) -
getTurbidity
public float getTurbidity() -
setTurbidity
public void setTurbidity(float value) -
getRadianceFactor
public float getRadianceFactor() -
setRadianceFactor
public void setRadianceFactor(float value) -
getSun
-
setSun
-
accept
-
accept
- Overrides:
accept
in classChannelMapNode
-
accept
-
resolveLight
- Specified by:
resolveLight
in interfaceLight
-