DistantLightKit
- class HPS.DistantLightKit : public HPS.Kit
The DistantLightKit class is a user space object. It is a kit analog to a DistantLightKey.
Public Functions
- void Consume (HPS.DistantLightKit in_kit)
Copies the source DistantLightKit into this DistantLightKit and resets the source kit.
- Param in_kit
The source DistantLightKit to consume.
- override void Dispose ()
- DistantLightKit ()
The default constructor creates an empty DistantLightKit object.
- DistantLightKit (HPS.DistantLightKit in_kit)
The copy constructor creates a new DistantLightKit object that contains the same settings as the source DistantLightKit.
- Param in_kit
The source DistantLightKit to copy.
- override bool Empty ()
Indicates whether this DistantLightKit has any values set on it.
- Return
true if no values are set on this DistantLightKit, false otherwise.
- bool Equals (HPS.DistantLightKit in_kit)
Check if the source DistantLightKit is equivalent to this DistantLightKit.
- Param in_kit
The source DistantLightKit to compare to this DistantLightKit.
- Return
true if the objects are equivalent, false otherwise.
- override bool Equals (Object obj)
- override int GetHashCode ()
- override HPS.Type ObjectType ()
This function returns the type the object, as declared (if the object is derived, this does not give the true type of the derived object).
- Return
The declared type of the object in question, which may differ from the true, underlying type.
- void Set (HPS.DistantLightKit in_kit)
Copies the source DistantLightKit into this DistantLightKit.
- Param in_kit
The source DistantLightKit to copy.
- HPS.DistantLightKit SetCameraRelative (bool in_state)
Sets the camera-relative setting for this DistantLightKit.
- See
- See
Default value
- Param in_state
Whether the direction of this DistantLightKit is treated as being in object space or camera-relative space.
- Return
A reference to this DistantLightKit.
- HPS.DistantLightKit SetColor (HPS.RGBAColor in_rgba_color)
Sets the RGBA color to use for this DistantLightKit.
- Param in_rgba_color
The RGBA color to use for this DistantLightKit.
- Return
A reference to this DistantLightKit.
- HPS.DistantLightKit SetColorByIndex (float in_index)
Sets the color index to use for this DistantLightKit.
- Param in_index
The color index to use for this DistantLightKit.
- Return
A reference to this DistantLightKit.
- HPS.DistantLightKit SetDirection (HPS.Vector in_vector)
Sets the direction in which this DistantLightKit lies. The rays emitted by this light will travel in the opposite direction of this vector.
- See
- See
Default value
- Param in_vector
The direction in which this DistantLightKit lies. The vector will either be treated as being in object space or in camera-relative units depending on the setting passed SetCameraRelative.
- Return
A reference to this DistantLightKit.
- HPS.DistantLightKit SetPriority (int in_priority)
Assigns a specific drawing priority value to the DistantLightKit. It affects the order in which the contents of the owning segment are drawn if and only if the rendering algorithm is set to Priority.
- See
SubwindowKit.SetPriority()
- See
- Param in_priority
The drawing priority, higher priority items are drawn on top of lower priority items.
- Return
A reference to this object.
- HPS.DistantLightKit SetUserData (IntPtr in_index, byte[] in_data)
Sets user data on this kit.
- Param in_index
The index of the user data to set.
- Param in_data
The bytes of user data to set.
- Return
A reference to this kit.
- HPS.DistantLightKit SetUserData (IntPtr in_index, ulong in_bytes, byte[] in_data)
Sets user data on this kit.
- Param in_index
The index of the user data to set.
- Param in_bytes
The number of bytes of user data to set.
- Param in_data
The bytes of user data to set.
- Return
A reference to this kit.
- HPS.DistantLightKit SetUserData (IntPtr[] in_indices, byte[][] in_data)
Sets user data on this kit.
- Param in_indices
An array of user data indices to set.
- Param in_data
An array of bytes of user data to set.
- Return
A reference to this kit.
- void Show (out HPS.DistantLightKit out_kit)
Copies this DistantLightKit into the given DistantLightKit.
- Param out_kit
The DistantLightKit to populate with the contents of this DistantLightKit.
- bool ShowCameraRelative (out bool out_state)
Shows the camera-relative setting for this DistantLightKit.
- Param out_state
Whether the direction of this DistantLightKit is treated as being in object space or camera-relative space.
- Return
true if a camera-relative setting was specified, false otherwise.
- bool ShowColor (out HPS.Material.Type out_type, out HPS.RGBAColor out_rgba_color, out float out_index)
Shows the color for this DistantLightKit.
- Param out_type
The type of color for the distant light.
- Param out_rgba_color
The RGBA color for the distant light. This is only valid if out_type is Material.Type.RGBAColor.
- Param out_index
The material index for the distant light. This is only valid if out_type is Material.Type.MaterialIndex.
- Return
true if a color was set, false otherwise.
- bool ShowDirection (out HPS.Vector out_vector)
Shows the direction in which this DistantLightKit lies.
- Param out_vector
The direction in which this DistantLightKit lies.
- Return
true if a direction was set, false otherwise.
- bool ShowPriority (out int out_priority)
Shows the drawing priority for this DistantLightKit.
- Param out_priority
The drawing priority, higher priority items are drawn on top of lower priority items.
- Return
true if drawing priority was specified, false otherwise.
- bool ShowUserData (IntPtr in_index, out byte[] out_data)
Shows the user data at a given index for this kit.
- Param in_index
The index of the user data to show.
- Param out_data
The user data at the given index.
- Return
true if there is user data at the given index, false otherwise.
- bool ShowUserData (out IntPtr[] out_indices, out byte[][] out_data)
Shows all user data for this kit.
- Param out_indices
An array of all user data indices set on this kit.
- Param out_data
An array of all user data set on this kit.
- Return
true if there is user data on this kit, false otherwise.
- ulong ShowUserDataCount ()
Get the number of user data indices set on this kit.
- bool ShowUserDataIndices (out IntPtr[] out_indices)
Shows the indices of all user data set on this kit.
- Param out_indices
The user data indices set on this kit.
- Return
The number of user data indices set on this kit.
- HPS.DistantLightKit UnsetAllUserData ()
Removes all user data from this kit.
- Return
A reference to this kit.
- HPS.DistantLightKit UnsetCameraRelative ()
Removes the camera-relative setting on this DistantLightKit.
- Return
A reference to this DistantLightKit.
- HPS.DistantLightKit UnsetColor ()
Removes the color (RGBA or material index) set on this DistantLightKit.
- Return
A reference to this DistantLightKit.
- HPS.DistantLightKit UnsetDirection ()
Removes the direction set on this DistantLightKit.
- Return
A reference to this DistantLightKit.
- HPS.DistantLightKit UnsetEverything ()
Removes all settings from the DistantLightKit.
- Return
A reference to this DistantLightKit.
- HPS.DistantLightKit UnsetPriority ()
Removes the drawing priority setting.
- Return
A reference to this object.
- HPS.DistantLightKit UnsetUserData (IntPtr in_index)
Removes the user data at the given index from this kit.
- Param in_index
The index of the user data to remove.
- Return
A reference to this kit.
- HPS.DistantLightKit UnsetUserData (IntPtr[] in_indices)
Removes the user data at the given indices from this kit.
- Param in_indices
The indices of the user data to remove.
- Return
A reference to this kit.
Public Static Functions
- bool operator!= (HPS.DistantLightKit a, HPS.DistantLightKit b)
- bool operator== (HPS.DistantLightKit a, HPS.DistantLightKit b)