This is the proxy class for placing and manipulating a set of 2D billboards in the scene. More...
#include <billboardsetproxy.h>
Public Types | |
typedef std::list< Billboard * > | BillboardContainer |
Basic container type for Billboard storage by this class. | |
typedef BillboardContainer::iterator | BillboardIterator |
Iterator type for Billboard instances stored by this class. | |
typedef BillboardContainer::const_iterator | ConstBillboardIterator |
Const Iterator type for Billboard instances stored by this class. | |
Public Member Functions | |
BillboardSetProxy (const UInt32 ID, const UInt32 InitialPoolSize, SceneManager *Creator) | |
Class constructor. More... | |
BillboardSetProxy (const XML::Node &SelfRoot, SceneManager *Creator) | |
XML constructor. More... | |
virtual | ~BillboardSetProxy () |
Class destructor. | |
virtual Ogre::MovableObject * | _GetBaseGraphicsObject () const |
Accessor for the internal graphics object. More... | |
virtual Ogre::BillboardSet * | _GetGraphicsObject () const |
Accessor for the internal billboard set. More... | |
virtual Billboard * | CreateBillboard (const Vector3 &Location, const ColourValue &Colour=ColourValue::White()) |
Creates a new Billboard for this set. More... | |
virtual void | DestroyAllBillboards () |
Deletes all stored Billboard instances. | |
virtual void | DestroyBillboard (Billboard *ToBeDestroyed) |
Deletes a Billboard. More... | |
virtual Boole | GetAccurateFacing () const |
Gets whether direction vectors are being calculated using a more expensive but more accurate algorithm. More... | |
virtual Boole | GetAutoExtend () const |
Gets whether or not this BillboardSetProxy will increase the size of it's billboard pool automatically when it's limit is reached. More... | |
virtual Billboard * | GetBillboard (UInt32 Index) |
Gets a Billboard instance by index. More... | |
virtual Graphics::BillboardOrigin | GetBillboardOrigin () const |
Gets the part of the billboard that is currently being treated as the origin for all children of this set. More... | |
virtual Graphics::BillboardRotation | GetBillboardRotation () const |
Gets the type of rotation to apply when a rotation is made to a billboard. More... | |
virtual Graphics::BillboardType | GetBillboardType () const |
Gets the type of BillboardSetProxy this is. More... | |
virtual Vector3 | GetCommonDirection () const |
Gets the common facing direction for all billboards in this set. More... | |
virtual Vector3 | GetCommonUpVector () const |
Gets the common up direction for all billboards in this set. More... | |
virtual Real | GetDefaultHeight () const |
Gets the default height all billboards in this set are constructed with. More... | |
virtual Real | GetDefaultWidth () const |
Gets the default width all billboards in this set are constructed with. More... | |
virtual String | GetDerivedSerializableName () const |
Gets the most derived serializable name of this WorldProxy. More... | |
virtual String | GetMaterialName () const |
Gets the name of the material being used by this set. More... | |
virtual UInt32 | GetNumBillboards () const |
Gets the number of Billboard instances in this set. More... | |
virtual UInt32 | GetPoolSize () const |
Gets the current size of the billboard pool in this set. More... | |
virtual Mezzanine::ProxyType | GetProxyType () const |
Accessor for the type of proxy. More... | |
virtual void | ProtoDeSerializeBillboards (const XML::Node &SelfRoot) |
Take the data stored in an XML Node and overwrite the Billboards of this object with it. More... | |
virtual void | ProtoDeSerializeProperties (const XML::Node &SelfRoot) |
Take the data stored in an XML Node and overwrite the properties of this object with it. More... | |
virtual void | ProtoSerializeBillboards (XML::Node &SelfRoot) const |
Convert the Billboards of this class to an XML::Node ready for serialization. More... | |
virtual void | ProtoSerializeProperties (XML::Node &SelfRoot) const |
Convert the properties of this class to an XML::Node ready for serialization. More... | |
virtual void | SetAccurateFacing (const Boole AccFace) |
Sets whether direction vectors will be calculated using a more expensive but more accurate algorithm. More... | |
virtual void | SetAutoExtend (const Boole AutoExtend) |
Sets whether or not this BillboardSetProxy will increase the size of it's billboard pool automatically when it's limit is reached. More... | |
virtual void | SetBillboardOrigin (const Graphics::BillboardOrigin Origin) |
Sets the part of the billboard that will be treated as the origin for all children of this set. More... | |
virtual void | SetBillboardRotation (const Graphics::BillboardRotation Rotation) |
Sets the type of rotation to apply when a rotation is made to a billboard. More... | |
virtual void | SetBillboardType (const Graphics::BillboardType Type) |
Sets the type of BillboardSetProxy this is. More... | |
virtual void | SetCommonDirection (const Vector3 &Dir) |
Sets the common facing direction for all billboards in this set. More... | |
virtual void | SetCommonUpVector (const Vector3 &UpDir) |
Sets the common up direction for all billboards in this set. More... | |
virtual void | SetDefaultDimensions (const Real Width, const Real Height) |
Sets the default width and height all billboards in this set are to be configured with when constructed. More... | |
virtual void | SetDefaultHeight (const Real Height) |
Sets the default height all billboards in this set are to be configured with when constructed. More... | |
virtual void | SetDefaultWidth (const Real Width) |
Sets the default width all billboards in this set are to be configured with when constructed. More... | |
virtual void | SetMaterialName (const String &MatName) |
Sets a material for this set by name. More... | |
virtual void | SetPoolSize (const UInt32 Size) |
Sets a new size of the billboard pool in this set. More... | |
Public Member Functions inherited from Mezzanine::Graphics::RenderableProxy | |
RenderableProxy (SceneManager *Creator) | |
XML-assist Constructor. More... | |
RenderableProxy (const UInt32 ID, SceneManager *Creator) | |
Normal Constructor. More... | |
virtual | ~RenderableProxy () |
Class destructor. | |
virtual Ogre::SceneNode * | _GetGraphicsNode () const |
Accessor for the internal node in the scenegraph for this proxy. More... | |
virtual void | AddToWorld () |
Performs all the necessary task to ensure this object is connected to it's respective world and ready for use. More... | |
virtual AxisAlignedBox | GetAABB () const |
Gets this proxies AABB. More... | |
virtual Boole | GetCastShadows () const |
Gets whether or not this proxy can cast a shadow. More... | |
virtual WorldManager * | GetCreator () const |
Gets a pointer to this proxies creator. More... | |
virtual UInt32 | GetLightMask () const |
Gets which types of lights will affect this proxy. More... | |
virtual Vector3 | GetLocation () const |
Gets this objects current location. More... | |
virtual Quaternion | GetOrientation () const |
Gets this objects current orientation. More... | |
virtual UInt32 | GetQueryMask () const |
Gets the bitmask that will be used to determine if this object should be counted in scene queries. More... | |
virtual Boole | GetReceiveShadows () const |
Gets whether or not this proxy can be rendered with a shadow casted on it. More... | |
virtual Real | GetRenderDistance () const |
Gets the distance at which the proxy will stop rendering. More... | |
virtual Vector3 | GetScale () const |
Gets the scaling currently being applied to this object. More... | |
virtual UInt32 | GetVisibilityMask () const |
Gets the bitmask that will be used to determine if this object should be visible when rendering. More... | |
virtual Boole | GetVisible () const |
Gets whether or not this proxy is visible. More... | |
virtual Boole | IsInWorld () const |
Gets whether or not this object is inside of it's world. More... | |
virtual void | Pitch (const Real Angle) |
Rotate the object around the X axis. More... | |
virtual void | RemoveFromWorld () |
Unhooks this proxy from it's respective world. More... | |
virtual void | Roll (const Real Angle) |
Rotate the object around the Z axis. More... | |
virtual void | Rotate (const Vector3 &Axis, const Real Angle) |
Rotates the object from it's existing rotation. More... | |
virtual void | Rotate (const Quaternion &Rotation) |
Rotates the object from it's existing rotation. More... | |
virtual void | Scale (const Vector3 &Scale) |
Scales the object from it's current size. More... | |
virtual void | Scale (const Real X, const Real Y, const Real Z) |
Scales the object from it's current size. More... | |
virtual void | SetCastShadows (const Boole CastShadows) |
Sets whether or not this proxy can cast a shadow. More... | |
virtual void | SetLightMask (const UInt32 Mask) |
Sets which types of lights will affect this proxy. More... | |
virtual void | SetLocation (const Vector3 &Loc) |
Sets the location of this object in parent space. More... | |
virtual void | SetLocation (const Real X, const Real Y, const Real Z) |
Sets the location of this object in parent space via Reals. More... | |
virtual void | SetOrientation (const Quaternion &Ori) |
Sets the orientation of this object in parent space. More... | |
virtual void | SetOrientation (const Real X, const Real Y, const Real Z, const Real W) |
Sets the orientation of this object in parent space via Reals. More... | |
virtual void | SetQueryMask (const UInt32 Mask) |
Sets the bitmesk that will be used to determine if this object should be counted in scene queries. More... | |
virtual void | SetRenderDistance (const Real Distance) |
Sets the distance at which the proxy will stop rendering. More... | |
virtual void | SetScale (const Vector3 &Sc) |
Sets the scaling to be applied to this object. More... | |
virtual void | SetScale (const Real X, const Real Y, const Real Z) |
Sets the scaling to be applied to this object via Reals. More... | |
virtual void | SetVisibilityMask (const UInt32 Mask) |
Sets the bitmask that will be used to determine if this object should be visible when rendering. More... | |
virtual void | SetVisible (const Boole Visible) |
Sets whether or not this proxy is visible. More... | |
virtual void | Translate (const Vector3 &Trans) |
Moves this object from it's current location. More... | |
virtual void | Translate (const Real X, const Real Y, const Real Z) |
Moves this object from it's current location. More... | |
virtual void | Yaw (const Real Angle) |
Rotate the object around the Y axis. More... | |
Public Member Functions inherited from Mezzanine::WorldProxy | |
WorldProxy () | |
Blank constructor. | |
WorldProxy (const UInt32 ID) | |
Normal/ID constructor. More... | |
virtual | ~WorldProxy () |
Class destructor. | |
void | _Bind (WorldObject *NewParent) |
Binds this proxy to a WorldObject. More... | |
virtual WorldObject * | GetParentObject () const |
Gets a pointer to the parent object controlling this proxy. More... | |
virtual UInt32 | GetProxyID () const |
Gets the unique ID of this proxy. More... | |
virtual void | ProtoDeSerialize (const XML::Node &SelfRoot) |
Take the data stored in an XML Node and overwrite this object with it. More... | |
virtual void | ProtoSerialize (XML::Node &ParentNode) const |
Convert this class to an XML::Node ready for serialization. More... | |
Public Member Functions inherited from Mezzanine::TransformableObject | |
virtual | ~TransformableObject () |
Class Destructor. | |
virtual Vector3 | ConvertGlobalToLocal (const Vector3 &Location) const |
Converts a point in global space to the same point in local space. More... | |
virtual Quaternion | ConvertGlobalToLocal (const Quaternion &Orientation) const |
Converts a rotation in global space to the same rotation in local space. More... | |
virtual Vector3 | ConvertLocalToGlobal (const Vector3 &Location) const |
Converts a point in local space to the same point in global space. More... | |
virtual Quaternion | ConvertLocalToGlobal (const Quaternion &Orientation) const |
Converts a rotation in local space to the same rotation in global space. More... | |
Static Public Member Functions | |
static String | GetSerializableName () |
Get the name of the the XML tag the proxy class will leave behind as its instances are serialized. More... | |
Static Public Member Functions inherited from Mezzanine::Graphics::RenderableProxy | |
static String | GetSerializableName () |
Get the name of the the XML tag the proxy class will leave behind as its instances are serialized. More... | |
Static Public Member Functions inherited from Mezzanine::WorldProxy | |
static String | GetSerializableName () |
Get the name of the the XML tag the proxy class will leave behind as its instances are serialized. More... | |
Protected Member Functions | |
virtual void | CreateBillboardSet (const UInt32 InitialPoolSize) |
Creates an internal BillboardSet to be used by the calling instance. More... | |
virtual void | DestroyBillboardSet () |
Destroys the internal BillboardSet in use by this proxy. More... | |
virtual void | ProtoDeSerializeImpl (const XML::Node &SelfRoot) |
Implementation method for deseriailizing additional sets of data. More... | |
virtual void | ProtoSerializeImpl (XML::Node &SelfRoot) const |
Implementation method for serializing additional sets of data. More... | |
Protected Attributes | |
BillboardContainer | Billboards |
Container storing all of the Billboard instances created by this proxy. More... | |
Ogre::BillboardSet * | GraphicsBillboardSet |
A pointer to the internal BillboardSet this proxy is based on. More... | |
Protected Attributes inherited from Mezzanine::Graphics::RenderableProxy | |
Ogre::SceneNode * | GraphicsNode |
A pointer to the internal object storing the proxy transform. More... | |
Boole | InWorld |
This stores whether the proxy is currently in the graphics world or not. More... | |
SceneManager * | Manager |
This is a pointer to the scene manager that created and owns this proxy. More... | |
UInt32 | QueryMask |
This is a bitmask identifying this objects type when being queried. Used for advanced query configuration. More... | |
UInt32 | VisibilityMask |
This is a bitmask identifying this objects type when being rendered. Used for advanced visibility configuration. More... | |
Protected Attributes inherited from Mezzanine::WorldProxy | |
WorldObject * | ParentObject |
Pointer to the Object this proxy belongs to. More... | |
UInt32 | ProxyID |
The unique ID assigned to the type of proxy an instance is. More... | |
This is the proxy class for placing and manipulating a set of 2D billboards in the scene.
Definition at line 64 of file billboardsetproxy.h.
Mezzanine::Graphics::BillboardSetProxy::BillboardSetProxy | ( | const UInt32 | ID, |
const UInt32 | InitialPoolSize, | ||
SceneManager * | Creator | ||
) |
Class constructor.
ID | The unique ID assigned to this BillboardSetProxy. |
InitialPoolSize | The number of billboards to reserve space for. |
Creator | A pointer to the manager that created this proxy. |
Definition at line 164 of file billboardsetproxy.cpp.
Mezzanine::Graphics::BillboardSetProxy::BillboardSetProxy | ( | const XML::Node & | SelfRoot, |
SceneManager * | Creator | ||
) |
XML constructor.
SelfRoot | An XML::Node containing the data to populate this class with. |
Creator | A pointer to the manager that created this proxy. |
Definition at line 168 of file billboardsetproxy.cpp.
|
virtual |
Accessor for the internal graphics object.
Implements Mezzanine::Graphics::RenderableProxy.
Definition at line 476 of file billboardsetproxy.cpp.
|
virtual |
Accessor for the internal billboard set.
Definition at line 473 of file billboardsetproxy.cpp.
|
virtual |
Creates a new Billboard for this set.
Location | The position relative to the center of the set where this billboard will be placed. |
Colour | The base colour to give to the created billboard. |
Definition at line 218 of file billboardsetproxy.cpp.
|
protectedvirtual |
Creates an internal BillboardSet to be used by the calling instance.
InitialPoolSize | The number of billboards to reserve space for. |
Definition at line 190 of file billboardsetproxy.cpp.
|
virtual |
Deletes a Billboard.
ToBeDestroyed | A pointer to the Billboard you want deleted. |
Definition at line 242 of file billboardsetproxy.cpp.
|
protectedvirtual |
Destroys the internal BillboardSet in use by this proxy.
Definition at line 199 of file billboardsetproxy.cpp.
|
virtual |
Gets whether direction vectors are being calculated using a more expensive but more accurate algorithm.
Definition at line 278 of file billboardsetproxy.cpp.
|
virtual |
Gets whether or not this BillboardSetProxy will increase the size of it's billboard pool automatically when it's limit is reached.
Definition at line 272 of file billboardsetproxy.cpp.
Gets a Billboard instance by index.
Index | The index of the Billboard to be retrieved. |
Definition at line 225 of file billboardsetproxy.cpp.
|
virtual |
Gets the part of the billboard that is currently being treated as the origin for all children of this set.
Definition at line 290 of file billboardsetproxy.cpp.
|
virtual |
Gets the type of rotation to apply when a rotation is made to a billboard.
Definition at line 296 of file billboardsetproxy.cpp.
|
virtual |
Gets the type of BillboardSetProxy this is.
Definition at line 302 of file billboardsetproxy.cpp.
|
virtual |
Gets the common facing direction for all billboards in this set.
Definition at line 323 of file billboardsetproxy.cpp.
|
virtual |
Gets the common up direction for all billboards in this set.
Definition at line 329 of file billboardsetproxy.cpp.
|
virtual |
Gets the default height all billboards in this set are constructed with.
Definition at line 317 of file billboardsetproxy.cpp.
|
virtual |
Gets the default width all billboards in this set are constructed with.
Definition at line 311 of file billboardsetproxy.cpp.
|
virtual |
Gets the most derived serializable name of this WorldProxy.
Reimplemented from Mezzanine::Graphics::RenderableProxy.
Definition at line 464 of file billboardsetproxy.cpp.
|
virtual |
Gets the name of the material being used by this set.
Definition at line 335 of file billboardsetproxy.cpp.
|
virtual |
Gets the number of Billboard instances in this set.
Definition at line 237 of file billboardsetproxy.cpp.
|
virtual |
Gets the current size of the billboard pool in this set.
Definition at line 284 of file billboardsetproxy.cpp.
|
virtual |
Accessor for the type of proxy.
Implements Mezzanine::WorldProxy.
Definition at line 210 of file billboardsetproxy.cpp.
|
static |
Get the name of the the XML tag the proxy class will leave behind as its instances are serialized.
Definition at line 467 of file billboardsetproxy.cpp.
|
virtual |
Take the data stored in an XML Node and overwrite the Billboards of this object with it.
SelfRoot | An XML::Node containing the data to populate this class with. |
Definition at line 447 of file billboardsetproxy.cpp.
|
protectedvirtual |
Implementation method for deseriailizing additional sets of data.
SelfRoot | An XML::Node containing the data to populate this class with. |
Reimplemented from Mezzanine::WorldProxy.
Definition at line 184 of file billboardsetproxy.cpp.
|
virtual |
Take the data stored in an XML Node and overwrite the properties of this object with it.
SelfRoot | An XML::Node containing the data to populate this class with. |
Reimplemented from Mezzanine::Graphics::RenderableProxy.
Definition at line 383 of file billboardsetproxy.cpp.
|
virtual |
Convert the Billboards of this class to an XML::Node ready for serialization.
SelfRoot | The root node containing all the serialized data for this instance. |
Definition at line 369 of file billboardsetproxy.cpp.
|
protectedvirtual |
Implementation method for serializing additional sets of data.
SelfRoot | The root node containing all the serialized data for this instance. |
Reimplemented from Mezzanine::WorldProxy.
Definition at line 178 of file billboardsetproxy.cpp.
|
virtual |
Convert the properties of this class to an XML::Node ready for serialization.
SelfRoot | The root node containing all the serialized data for this instance. |
Reimplemented from Mezzanine::Graphics::RenderableProxy.
Definition at line 341 of file billboardsetproxy.cpp.
|
virtual |
Sets whether direction vectors will be calculated using a more expensive but more accurate algorithm.
AccFace | True to increase accuracy of billboard directions, false for the more efficient method. |
Definition at line 275 of file billboardsetproxy.cpp.
|
virtual |
Sets whether or not this BillboardSetProxy will increase the size of it's billboard pool automatically when it's limit is reached.
AutoExtend | A Boole indicating whether or not this proxy is allowed to resize it's own billboard pool. |
Definition at line 269 of file billboardsetproxy.cpp.
|
virtual |
Sets the part of the billboard that will be treated as the origin for all children of this set.
Origin | A BillboardOrigin enum value expressing which part of the billboard will be considered the origin for all billboards in this set. |
Definition at line 287 of file billboardsetproxy.cpp.
|
virtual |
Sets the type of rotation to apply when a rotation is made to a billboard.
Rotation | A BillboardRotation enum value expressing the underlying method for rotation in billboards belonging to this set. |
Definition at line 293 of file billboardsetproxy.cpp.
|
virtual |
Sets the type of BillboardSetProxy this is.
Type | A BillboardType enum value expressing how billboards in this set are to be oriented. |
Definition at line 299 of file billboardsetproxy.cpp.
|
virtual |
Sets the common facing direction for all billboards in this set.
Dir | The facing axis for all billboards in this set. |
Definition at line 320 of file billboardsetproxy.cpp.
|
virtual |
Sets the common up direction for all billboards in this set.
UpDir | The up axis for all billboards in this set. |
Definition at line 326 of file billboardsetproxy.cpp.
|
virtual |
Sets the default width and height all billboards in this set are to be configured with when constructed.
Width | The default width in world units. |
Height | The default height in world units. |
Definition at line 305 of file billboardsetproxy.cpp.
|
virtual |
Sets the default height all billboards in this set are to be configured with when constructed.
Height | The default height in world units. |
Definition at line 314 of file billboardsetproxy.cpp.
|
virtual |
Sets the default width all billboards in this set are to be configured with when constructed.
Width | The default width in world units. |
Definition at line 308 of file billboardsetproxy.cpp.
|
virtual |
Sets a material for this set by name.
MatName | The name of the material to apply. |
Definition at line 332 of file billboardsetproxy.cpp.
|
virtual |
Sets a new size of the billboard pool in this set.
Size | The size the billboard pool in this set should be resized to. |
Definition at line 281 of file billboardsetproxy.cpp.
|
protected |
Container storing all of the Billboard instances created by this proxy.
Definition at line 76 of file billboardsetproxy.h.
|
protected |
A pointer to the internal BillboardSet this proxy is based on.
Definition at line 79 of file billboardsetproxy.h.