classHAttrProperty 02

Member Function Documentation

HFloatProperty * HAttrProperty::GetAmbiance (   )

	Retrieves a pointer to the HFloatProperty which contains the current Ambiance brightness of the surface at hit point. Ambiance is the value that determines the brightness of an object when no light is hitting it.

HColorProperty * HAttrProperty::GetAmbianceColor (   )

Retrieves a pointer to the HColorProperty which contains the current Ambiance Color of the surface at hit point. If the ambiance color is "Not Set", then the ambiance color will match the diffuse color even if that color ultimately comes from a decal.

HColorProperty * HAttrProperty::GetAmbianceColorForRead (   )

If you call GetAmbianceColor you will get those actual properties just like it always use to be. If the user leaves the ambiance color marked as "Not Set" in the PWS then when the render is invoked it will use the diffuse color for ambiance Color. So the GetAmbianceColorForRead will return one of two properties : If Ambiance color is marked as "not set" it will actually return the Diffuse Color property, not the Ambiance Color Property. So with that being said you should only use this property for read purposes, because if you call StoreValue on it you will actually be changing the Diffuse Color not the Ambiance color property.

HAttrProperty * HAttrProperty::GetBaseAttr (   )

	HAttrProperty always points to the attribute value for the object you are on, never any other. But if you are on a HGroup you may call GetBaseAttr to retrieve the HAttrProperty on the HModelCache.

HFloatProperty * HAttrProperty::GetDensity (   )

Retrieves a pointer to the HFloatProperty which contains the current Density of the surface at hit point. As a material thickens, it eventually becomes opaque, and most water becomes opaque when only a few feet deep. Density is affected by size and is calibrated to the suggested scale used by Animation:Master (in increments of .001/cm), so transparent objects must be built to the correct scale. Colored glass has a density of "2", while seawater has a density of "5",

HColorProperty * HAttrProperty::GetDiffuseColor (   )

	Retrieves a pointer to the HColorProperty which contains the current Diffuse color of the surface at hit point.

HFloatProperty * HAttrProperty::GetDiffuseFallOff (   )

Retrieves a pointer to the HFloatProperty which contains the current Diffuse falloff value of the surface at hit point. Diffuse Falloff controls the transition from light to dark in shaded areas on a model.

HBoolProperty * HAttrProperty::GetGlow (   )

	Retrieves a pointer to the HBoolProperty indicating if the surface should glow. Glow is a post effect. But this could bu used by a shader to decide how to shade. The glow color is the diffuse color of the base attribute of the model. The intensity of the glow is controlled by the Ambiance value, and the radius of the glow is a property of the Choreography.

HMaterial* HAttrProperty::GetMaterialHead (   )

HFloatProperty * HAttrProperty::GetRadiance (   )

Retrieves a pointer to the HFloatProperty which contains the current Radiance of the surface at hit point. Radiance is used by Radiosity. Normally radiance is determined from diffuse color. But the user may change it to get special effects.

HPercentProperty * HAttrProperty::GetReflectiveBlend (   )

Retrieves a pointer to the HPercentProperty which contains the current Reflection Blending of the surface at hit point. Reflective Blend indicates how reflections are combined with surface color. 0 indicates reflections are additive, 100% indicates the reflections are blended.

HFloatProperty * HAttrProperty::GetReflectivity (   )

	Retrieves a pointer to the HFloatProperty which contains the current Reflectivity of the surface at hit point.

HFloatProperty * HAttrProperty::GetReflectivityFallOff (   )

Retrieves a pointer to the HFloatProperty which contains the current Reflectivity Falloff of the surface at hit point. Reflection Falloff indicates at which distance reflections are no longer visible. It is specified as the distance measured from the ray’s intersection to the reflecting surface.

HFloatProperty * HAttrProperty::GetRefraction (