Related Scripting Object: ArrayParameter
An ArrayParameter is a specialization of a Parameter. More...
#include <xsi_arrayparameter.h>
Inheritance diagram for ArrayParameter:
Public Member Functions |
|
| ArrayParameter () | |
| ~ArrayParameter () | |
| ArrayParameter (const CRef &in_ref) | |
| ArrayParameter (const ArrayParameter &in_obj) | |
| bool | IsA (siClassID in_ClassID) const |
| siClassID | GetClassID () const |
| ArrayParameter & | operator= (const ArrayParameter &in_obj) |
| ArrayParameter & | operator= (const CRef &in_ref) |
| Parameter | operator[] (LONG in_index) |
| LONG | GetCount (void) const |
| Parameter | Add (void) |
| CStatus | Remove (LONG in_lIndex) |
| CStatus | Remove (const Parameter &in_parameter) |
| CStatus | Move (LONG in_lIndex, LONG in_lUpDown) |
| CStatus | Move (const Parameter &in_parameter, LONG in_lUpDown) |
| Parameter | Add (const CValue &) |
It can contain any number of sub-parameters, all of the same type. Its contents can be moved around, new parameters added and old ones removed.
| ArrayParameter | ( | ) |
Constructs an ArrayParameter object.
| ~ArrayParameter | ( | ) |
Destroys an ArrayParameter object.
| ArrayParameter | ( | const CRef & | in_ref | ) |
Constructs an ArrayParameter object from a reference to another ArrayParameter object.
| in_ref | A reference to a group. |
| ArrayParameter | ( | const ArrayParameter & | in_obj | ) |
Constructs a new ArrayParameter object from an existing ArrayParameter object.
| bool IsA | ( | siClassID | in_ClassID | ) | const [virtual] |
Returns true if this object supports the functionality of a specified class. For example, an ArrayParameter is a type of Parameter, so an ArrayParameter object supports Parameter functionality.
| in_ClassID | Test if this object supports this class. |
Reimplemented from Parameter.
| siClassID GetClassID | ( | ) | const [virtual] |
Returns the class ID for this object.
Reimplemented from Parameter.
| ArrayParameter& operator= | ( | const ArrayParameter & | in_obj | ) |
Assigns an ArrayParameter object to an existing ArrayParameter object.
| in_obj | An ArrayParameter object to be copied into this object. |
| ArrayParameter& operator= | ( | const CRef & | in_ref | ) |
Assigns a CRef to this ArrayParameter object. The ArrayParameter object is cleared if the CRef is not a reference to an object that supports the ArrayParameter class.
| in_ref | A reference to an object that supports the ArrayParameter class. |
Reimplemented from Parameter.
| Parameter operator[] | ( | LONG | in_index | ) |
Returns the parameter at a given index. If the index is out of bounds, this operator returns an empty, invalid Parameter object.
| in_index | Integer index of the parameter to get. |
Empty parameter if the index is out of bounds
| LONG GetCount | ( | void | ) | const |
Returns the size of the array. If the array is empty or invalid, GetCount returns 0.
| Parameter Add | ( | void | ) |
Appends a new parameter to this array. The type of the new parameter is determined by the SPDL definition of the array parameter.
| CStatus Remove | ( | LONG | in_lIndex | ) |
Removes a parameter from the array given its index.
| in_lIndex | The index of the parameter to remove. |
CStatus::Fail if the index is out of bounds.
Removes a parameter from the array.
| in_parameter | Index of the parameter to remove. |
CStatus::Fail if the parameter is not a member of the array.
| CStatus Move | ( | LONG | in_lIndex, | |
| LONG | in_lUpDown | |||
| ) |
Moves a parameter up or down in the array relative to its current position. The new position of the parameter is calculated by adding in_lUpDown to the current index and clamping the result to the array boundaries (0 to ArrayParameter::GetCount - 1).
| in_lIndex | The index of the parameter to move. | |
| in_lUpDown | Positive or negative amount to move the parameter. |
CStatus::Fail if the index is out of bounds.
Moves a given parameter up or down in the array relative to its current position. The new position of the parameter is calculated by adding in_lUpDown to the current index and clamping the result to the array boundaries (0 to ArrayParameter::GetCount - 1).
| in_parameter | The parameter to move. | |
| in_lUpDown | Positive or negative amount to move the parameter. |
CStatus::Fail if the given parameter is not a member of the array.
Appends a new parameter to the array. The parameter is initialized with the specified value. The parameter type is determined by the SPDL definition of the array. If the specified value does not match the type specified in the SPDL, Add returns an invalid Parameter object. Use this function to add items to shaders such as the camera lens flare shader, which have object and light lists.