/** * Retrieve Attribute Gain (amplitude). * @return gain amplitude scale factor * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph */ public float getAttributeGain() { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_ATTRIBUTE_GAIN_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes1")); return ((AuralAttributesRetained)this.retained).getAttributeGain(); }
/** * Retrieve Attribute Gain Rolloff. * @return rolloff atmospheric gain scale factor (changing speed of sound) * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph */ public float getRolloff() { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_ROLLOFF_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes3")); return ((AuralAttributesRetained)this.retained).getRolloff(); }
/** * Set Attribute Gain Rolloff. * @param rolloff atmospheric gain scale factor (changing speed of sound) * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph */ public void setRolloff(float rolloff) { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_ROLLOFF_WRITE)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes2")); ((AuralAttributesRetained)this.retained).setRolloff(rolloff); }
/** * Retrieve Reflective Coefficient. * @return reflection coeff reflection/absorption factor * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph */ public float getReflectionCoefficient() { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_REFLECTION_COEFFICIENT_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes21")); return ((AuralAttributesRetained)this.retained).getReflectionCoefficient(); }
/** * Retrieve Frequency Scale Factor. * @return scaleFactor factor applied to change of frequency * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph */ public float getFrequencyScaleFactor() { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_FREQUENCY_SCALE_FACTOR_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes17")); return ((AuralAttributesRetained)this.retained).getFrequencyScaleFactor(); }
/** * Set Attribute Gain (amplitude) scale factor. * @param gain scale factor applied to amplitude of direct and reflected sound * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph */ public void setAttributeGain(float gain) { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_ATTRIBUTE_GAIN_WRITE)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes0")); ((AuralAttributesRetained)this.retained).setAttributeGain(gain); }
/** * Retrieve Reverberation Delay Time. * @return reverb delay time * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph */ public float getReverbDelay() { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_REVERB_DELAY_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes7")); return ((AuralAttributesRetained)this.retained).getReverbDelay(); }
/** * @deprecated As of Java 3D version 1.2, replaced by * <code>setReverbBounds(Bounds)</code> */ public void setReverbDelay(Bounds reverbVolume) { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_REVERB_DELAY_WRITE)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes5")); ((AuralAttributesRetained)this.retained).setReverbBounds(reverbVolume); }
/** * Retrieve Reverberation Order * @return reverb order * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph */ public int getReverbOrder() { if (!this.getCapability(ALLOW_REVERB_ORDER_READ)) if (isLiveOrCompiled()) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes9")); return ((AuralAttributesRetained)this.retained).getReverbOrder(); }
/** * Retrieve Velocity Scale Factor used to calculate Doppler Effect. * @return scale factor applied to Doppler velocity of sound * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph */ public float getVelocityScaleFactor() { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_VELOCITY_SCALE_FACTOR_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes20")); return ((AuralAttributesRetained)this.retained).getVelocityScaleFactor(); }
/** * Retrieve Decay Time. * @return reverb decay time * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph * @since Java 3D 1.3 */ public float getDecayTime() { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_DECAY_TIME_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes29")); return ((AuralAttributesRetained)this.retained).getDecayTime(); }
/** * Retrieve Diffusion. * @return reverb diffusion ratio * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph * @since Java 3D 1.3 */ public float getDiffusion() { if (isLiveOrCompiled()) if(!this.getCapability(ALLOW_DIFFUSION_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes33")); return ((AuralAttributesRetained)this.retained).getDiffusion(); }
/** * Set Reflective Coefficient. * Scales the amplitude of the early reflections of reverberated sounds * @param coefficient reflection/absorption factor applied to reflections * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph */ public void setReflectionCoefficient(float coefficient) { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_REFLECTION_COEFFICIENT_WRITE)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes4")); ((AuralAttributesRetained)this.retained).setReflectionCoefficient(coefficient); }
/** * Retrieve Reflection Delay Time. * @return reflection delay time * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph * @since Java 3D 1.3 */ public float getReflectionDelay() { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_REFLECTION_DELAY_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes23")); return ((AuralAttributesRetained)this.retained).getReflectionDelay(); }
/** * Retrieve Reverb Coefficient. * @return late reflection coeff. reflection/absorption factor * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph * @since Java 3D 1.3 */ public float getReverbCoefficient() { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_REVERB_COEFFICIENT_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes25")); return ((AuralAttributesRetained)this.retained).getReverbCoefficient(); }
/** * Set Distance Filter using a single array containing distances and * frequency cutoff as pairs of values as a single array of Point2f. * @param attenuation array of pairs of distance and frequency cutoff * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph */ public void setDistanceFilter(Point2f[] attenuation) { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_DISTANCE_FILTER_WRITE)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes10")); ((AuralAttributesRetained)this.retained).setDistanceFilter(attenuation); }
/** * Retrieve Distance Filter array length. * @return attenuation array length * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph */ public int getDistanceFilterLength() { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_DISTANCE_FILTER_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes12")); return (((AuralAttributesRetained)this.retained).getDistanceFilterLength()); } /**
/** * Retrieve Decay Filter. * @return reverb decay filter cutoff frequency * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph * @since Java 3D 1.3 */ public float getDecayFilter() { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_DECAY_FILTER_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes31")); return ((AuralAttributesRetained)this.retained).getDecayFilter(); }
/** * Retrieve Density. * @return reverb density * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph * @since Java 3D 1.3 */ public float getDensity() { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_DENSITY_READ)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes35")); return ((AuralAttributesRetained)this.retained).getDensity(); }
/** * Set Reverb Coefficient. * Scale the amplitude of the late reflections including the decaying tail * of reverberated sound. * @param coefficient reflective/absorptive factor applied to late reflections * @exception CapabilityNotSetException if appropriate capability is * not set and this object is part of live or compiled scene graph * @since Java 3D 1.3 */ public void setReverbCoefficient(float coefficient) { if (isLiveOrCompiled()) if (!this.getCapability(ALLOW_REVERB_COEFFICIENT_WRITE)) throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes24")); ((AuralAttributesRetained)this.retained).setReverbCoefficient(coefficient); }