|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.media.j3d.IndexedObject
javax.media.j3d.SceneGraphObjectRetained
javax.media.j3d.NodeRetained
javax.media.j3d.LeafRetained
javax.media.j3d.SoundRetained
javax.media.j3d.PointSoundRetained
javax.media.j3d.ConeSoundRetained
class ConeSoundRetained
A ConeSoundRetained node defines a point sound source located at some location in space whose amplitude is constrained not only by maximum and minimum amplitude spheres but by two concentric cone volumes directed down an vector radiating from the sound's location.
Field Summary | |
---|---|
(package private) float[] |
angularDistance
|
(package private) float[] |
angularGain
|
(package private) float[] |
backAttenuationDistance
|
(package private) float[] |
backAttenuationGain
|
(package private) Vector3f |
direction
The Cone Sound's direction vector. |
(package private) int |
filterType
|
(package private) float[] |
frequencyCutoff
|
(package private) static int |
LOW_PASS
|
(package private) static int |
NO_FILTERING
|
(package private) Vector3f |
xformDirection
|
Fields inherited from class javax.media.j3d.PointSoundRetained |
---|
attenuationDistance, attenuationGain, position, trans, xformPosition |
Fields inherited from class javax.media.j3d.LeafRetained |
---|
boundsDirty, switchState |
Fields inherited from class javax.media.j3d.SceneGraphObjectRetained |
---|
DONT_MERGE, inBackgroundGroup, inSetLive, MERGE, MERGE_DONE, mergeFlag, onUpdateList, source |
Fields inherited from class javax.media.j3d.IndexedObject |
---|
listIdx |
Constructor Summary | |
---|---|
ConeSoundRetained()
|
Method Summary | |
---|---|
(package private) void |
getAngularAttenuation(float[] distance,
float[] gain,
float[] filter)
Retrieves angular attenuation including gain and filter returned as separate arrays |
(package private) void |
getAngularAttenuation(Point3f[] attenuation)
Retrieves angular attenuation including gain and filter in a single array |
(package private) int |
getAngularAttenuationLength()
Retrieves angular attenuation array length. |
(package private) void |
getBackDistanceGain(float[] distance,
float[] gain)
Retieves this sound's back attenuation distance and gain arrays, returned in separate arrays. |
(package private) void |
getBackDistanceGain(Point2f[] attenuation)
Retieves sound's back distance attenuation Put the contents of the two separate distance and gain arrays into an array of Point2f. |
(package private) void |
getDirection(Vector3f direction)
Retrieves this sound's direction and places it in the vector provided. |
(package private) void |
getDistanceGain(float[] frontDistance,
float[] frontGain,
float[] backDistance,
float[] backGain)
Gets this sound's elliptical distance gain attenuation values in separate arrays |
(package private) void |
getDistanceGain(Point2f[] frontAttenuation,
Point2f[] backAttenuation)
Gets this sound's elliptical distance attenuation |
(package private) void |
getXformDirection(Vector3f direction)
|
(package private) void |
initMirrorObject(ConeSoundRetained ms)
|
(package private) void |
mergeTransform(TransformGroupRetained xform)
|
(package private) void |
setAngularAttenuation(float[] distance,
float[] gain,
float[] filter)
Sets angular attenuation including gain and filter using separate arrays |
(package private) void |
setAngularAttenuation(Point2f[] attenuation)
Sets this sound's angular gain attenuation (not including filter) |
(package private) void |
setAngularAttenuation(Point3f[] attenuation)
Sets this sound's angular attenuation including both gain and filter. |
(package private) void |
setBackDistanceGain(float[] distance,
float[] gain)
Sets this sound's back distance gain attenuation as an array of Point2fs. |
(package private) void |
setBackDistanceGain(Point2f[] attenuation)
Sets this sound's back distance gain attenuation - where gain scale factor is applied to sound based on distance listener along the negative sound direction axis from sound source. |
(package private) void |
setDirection(float x,
float y,
float z)
Sets this sound's direction from the three values provided. |
(package private) void |
setDirection(Vector3f direction)
Sets this sound's direction from the vector provided. |
(package private) void |
setDistanceGain(float[] frontDistance,
float[] frontGain,
float[] backDistance,
float[] backGain)
Sets this sound's distance gain attenuation as an array of Point2fs. |
(package private) void |
setDistanceGain(Point2f[] frontAttenuation,
Point2f[] backAttenuation)
Sets this sound's distance gain elliptical attenuation - where gain scale factor is applied to sound based on distance listener is from sound source. |
(package private) void |
updateMirrorObject(java.lang.Object[] objs)
This updates the Direction fields of cone sound. |
(package private) void |
updateTransformChange()
|
Methods inherited from class javax.media.j3d.PointSoundRetained |
---|
getDistanceGain, getDistanceGain, getDistanceGainLength, getPosition, getXformPosition, initMirrorObject, setDistanceGain, setDistanceGain, setPosition, setPosition |
Methods inherited from class javax.media.j3d.LeafRetained |
---|
clone, updateBoundingLeaf, updateBounds |
Methods inherited from class javax.media.j3d.SceneGraphObjectRetained |
---|
clearLive, clearLive, clone, compile, doSetLive, getSource, handleFrequencyChange, isInSetLive, markAsLive, setCompiled, setLive, setSource, traverse |
Methods inherited from class javax.media.j3d.IndexedObject |
---|
getIdxUsed, incIdxUsed |
Methods inherited from class java.lang.Object |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
Vector3f direction
Vector3f xformDirection
static final int NO_FILTERING
static final int LOW_PASS
float[] backAttenuationDistance
float[] backAttenuationGain
float[] angularDistance
float[] angularGain
int filterType
float[] frequencyCutoff
Constructor Detail |
---|
ConeSoundRetained()
Method Detail |
---|
void setDistanceGain(Point2f[] frontAttenuation, Point2f[] backAttenuation)
frontAttenuation
- defined by pairs of (distance,gain-scale-factor)backAttenuation
- defined by pairs of (distance,gain-scale-factor)
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphvoid setDistanceGain(float[] frontDistance, float[] frontGain, float[] backDistance, float[] backGain)
frontDistance
- array of monotonically-increasing floatsfrontGain
- array of non-negative scale factorsbackDistance
- array of monotonically-increasing floatsbackGain
- array of non-negative scale factors
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphvoid setBackDistanceGain(Point2f[] attenuation)
attenuation
- defined by pairs of (distance,gain-scale-factor)
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphvoid setBackDistanceGain(float[] distance, float[] gain)
distance
- array of monotonically-increasing floatsgain
- array of non-negative scale factors
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphvoid getDistanceGain(Point2f[] frontAttenuation, Point2f[] backAttenuation)
frontAttenuation
- arrays containing forward distances attenuation pairsbackAttenuation
- arrays containing backward distances attenuation pairs
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphvoid getDistanceGain(float[] frontDistance, float[] frontGain, float[] backDistance, float[] backGain)
frontDistance
- array of float distances along the sound axisfronGain
- array of non-negative scale factors associated with front distancesbackDistance
- array of float negative distances along the sound axisbackGain
- array of non-negative scale factors associated with back distances
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphvoid getBackDistanceGain(Point2f[] attenuation)
attenuation
- containing distance attenuation pairsvoid getBackDistanceGain(float[] distance, float[] gain)
distance
- array of monotonically-increasing floats.gain
- array of amplitude scale factors associated with distances.void setDirection(Vector3f direction)
direction
- the new directionvoid setDirection(float x, float y, float z)
x
- the new x directiony
- the new y directionz
- the new z directionvoid getDirection(Vector3f direction)
void getXformDirection(Vector3f direction)
void setAngularAttenuation(Point2f[] attenuation)
attenuation
- array containing angular distance and gainvoid setAngularAttenuation(Point3f[] attenuation)
attenuation
- array containing angular distance, gain and filtervoid setAngularAttenuation(float[] distance, float[] gain, float[] filter)
distance
- array containing angular distancefilter
- array containing angular low-pass frequency cutoff valuesint getAngularAttenuationLength()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphvoid getAngularAttenuation(Point3f[] attenuation)
attenuation
- applied to gain when listener is between conesvoid getAngularAttenuation(float[] distance, float[] gain, float[] filter)
distance
- array containing angular distancegain
- array containing angular gain attenuationfilter
- array containing angular low-pass frequency cutoff valuesvoid updateMirrorObject(java.lang.Object[] objs)
updateMirrorObject
in class PointSoundRetained
void initMirrorObject(ConeSoundRetained ms)
void updateTransformChange()
updateTransformChange
in class PointSoundRetained
void mergeTransform(TransformGroupRetained xform)
mergeTransform
in class PointSoundRetained
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |