threeD.raytracer.engine
Class ReflectionShader

java.lang.Object
  java.util.AbstractCollection
      java.util.AbstractSet
          java.util.HashSet
              threeD.raytracer.engine.ShaderSet
                  threeD.raytracer.engine.ReflectionShader

All Implemented Interfaces:

Cloneable, Collection, ColorProducer, Editable, Producer, Serializable, Set, Shader

public class ReflectionShader

extends ShaderSet

implements Shader, Editable

A ReflectionShader object provides a shading method for reflective surfaces. The ReflectionShader class uses a shading algorithm based on Shlick's approximation to the Fresnel equations.

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class threeD.raytracer.util.Editable

Editable.Selection

Constructor Summary

ReflectionShader()
Constructs a new ReflectionShader object with a reflectivity of 0.0 and white as a reflective color.

ReflectionShader(double reflectivity, ColorProducer reflectiveColor)
Constructs a new ReflectionShader object with the specified reflectivity and reflective color.

Method Summary

RGB	evaluate(Object[] args) Produces a color using the specified arguments.
Producer[]	getInputPropertyValues()
String[]	getPropertyDescriptions() Returns an array of String objects with descriptions for each editable property of this ReflectionShader object.
String[]	getPropertyNames() Returns an array of String objects with names for each editable property of this ReflectionShader object.
Class[]	getPropertyTypes() Returns an array of Class objects representing the class types of each editable property of this ReflectionShader object.
Object[]	getPropertyValues() Returns the values of the properties of this ReflectionShader object as an Object array.
ColorProducer	getReflectiveColor() Returns the reflective color used by this ReflectionShader object as an RGB object.
double	getReflectivity() Returns the reflectivity value used by this ReflectionShader object.
void	setInputPropertyValue(int index, Producer p) Sets the values of properties of this HighlightShader object to those specified.
void	setPropertyValue(Object value, int index) Sets the value of the property of this ReflectionShader object at the specified index to the specified value.
void	setPropertyValues(Object[] values) Sets the values of editable properties of this ReflectionShader object to those specified.
void	setReflectiveColor(ColorProducer color) Sets the reflective color used by this ReflectionShader object to the color represented by the specified ColorProducer object.
void	setReflectivity(double reflectivity) Sets the reflectivity value used by this ReflectionShader object.
RGB	shade(ShaderParameters p) Method specified by the Shader interface.
String	toString() Returns "Reflection Shader".

Methods inherited from class threeD.raytracer.engine.ShaderSet

add, addAll

Methods inherited from class java.util.HashSet

clear, clone, contains, isEmpty, iterator, remove, size

Methods inherited from class java.util.AbstractSet

equals, hashCode, removeAll

Methods inherited from class java.util.AbstractCollection

containsAll, retainAll, toArray, toArray

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Set

containsAll, equals, hashCode, removeAll, retainAll, toArray, toArray

Constructor Detail

ReflectionShader

public ReflectionShader()

Constructs a new ReflectionShader object with a reflectivity of 0.0 and white as a reflective color.

ReflectionShader

public ReflectionShader(double reflectivity,
                        ColorProducer reflectiveColor)

Constructs a new ReflectionShader object with the specified reflectivity and reflective color.

Method Detail

shade

public RGB shade(ShaderParameters p)

Method specified by the Shader interface.

Specified by:

shade in interface Shader

Overrides:

shade in class ShaderSet

Returns:

The sum of the values given by the shade method for each Shader object stored by this ShaderSet object.

evaluate

public RGB evaluate(Object[] args)

Description copied from interface: ColorProducer

Produces a color using the specified arguments.

Specified by:

evaluate in interface ColorProducer

Overrides:

evaluate in class ShaderSet

Returns:

this.shade(args[0]).

Throws:

IllegalArgumentException - If args[0] is not a ShaderParameters object.

setReflectivity

public void setReflectivity(double reflectivity)

Sets the reflectivity value used by this ReflectionShader object.

setReflectiveColor

public void setReflectiveColor(ColorProducer color)

Sets the reflective color used by this ReflectionShader object to the color represented by the specified ColorProducer object.

getReflectivity

public double getReflectivity()

Returns the reflectivity value used by this ReflectionShader object.

getReflectiveColor

public ColorProducer getReflectiveColor()

Returns the reflective color used by this ReflectionShader object as an RGB object.

getPropertyNames

public String[] getPropertyNames()

Returns an array of String objects with names for each editable property of this ReflectionShader object.

Specified by:

getPropertyNames in interface Editable

getPropertyDescriptions

public String[] getPropertyDescriptions()

Returns an array of String objects with descriptions for each editable property of this ReflectionShader object.

Specified by:

getPropertyDescriptions in interface Editable

getPropertyTypes

public Class[] getPropertyTypes()

Returns an array of Class objects representing the class types of each editable property of this ReflectionShader object.

Specified by:

getPropertyTypes in interface Editable

getPropertyValues

public Object[] getPropertyValues()

Returns the values of the properties of this ReflectionShader object as an Object array.

Specified by:

getPropertyValues in interface Editable

setPropertyValue

public void setPropertyValue(Object value,
                             int index)

Sets the value of the property of this ReflectionShader object at the specified index to the specified value.

Specified by:

setPropertyValue in interface Editable

Throws:

IllegalArgumentException - If the object specified is not of the correct type.

IndexOutOfBoundsException - If the index specified does not correspond to an editable property of this ReflectionShader object.

setPropertyValues

public void setPropertyValues(Object[] values)

Sets the values of editable properties of this ReflectionShader object to those specified.

Specified by:

setPropertyValues in interface Editable

Throws:

IllegalArgumentException - If one of the objects specified is not of the correct type. (Note: none of the values after the erroneous value will be set)

IndexOutOfBoundsException - If the length of the specified array is longer than permitted.

getInputPropertyValues

public Producer[] getInputPropertyValues()

Specified by:

getInputPropertyValues in interface Editable

Returns:

{reflective color}.

setInputPropertyValue

public void setInputPropertyValue(int index,
                                  Producer p)

Sets the values of properties of this HighlightShader object to those specified.

Specified by:

setInputPropertyValue in interface Editable

Parameters:

index - Index of input property (array index from this.getInputPropertyValue).

p - Producer object to use for input property.

Throws:

IllegalArgumentException - If the Producer object specified is not of the correct type.

IndexOutOfBoundsException - If the lindex != 0;

toString

public String toString()

Returns "Reflection Shader".

Overrides:

toString in class ShaderSet

Returns:

"ShaderSet".