This is the proxy class for placing and manipulating a set of 2D billboards in the scene. More...
#include <billboardsetproxy.h>
Inheritance diagram for Mezzanine::Graphics::BillboardSetProxy:
Collaboration diagram for Mezzanine::Graphics::BillboardSetProxy: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 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 Boolean | GetAccurateFacing () const |
| Gets whether direction vectors are being calculated using a more expensive but more accurate algorithm. More... | |
| virtual Boolean | 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 | ProtoDeSerialize (const XML::Node &SelfRoot) |
| Take the data stored in an XML Node and overwrite this object with it. 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 | ProtoSerialize (XML::Node &ParentNode) const |
| Convert this class to an XML::Node ready for serialization. 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 Boolean AccFace) |
| Sets whether direction vectors will be calculated using a more expensive but more accurate algorithm. More... | |
| virtual void | SetAutoExtend (const Boolean 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) | |
| Class 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 Boolean | GetCastShadows () const |
| Gets whether or not this proxy can cast a shadow. More... | |
| virtual WorldManager * | GetCreator () const |
| 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 Boolean | 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 Boolean | GetVisible () const |
| Gets whether or not this proxy is visible. More... | |
| virtual Boolean | 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 Boolean 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 Boolean 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 () | |
| Class constructor. | |
| 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... | |
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... | |
Protected Attributes | |
| BillboardContainer | Billboards |
| Container storing all of the Billboard instances created by this manager. 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... | |
| Boolean | 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... | |
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 | InitialPoolSize, |
| SceneManager * | Creator | ||
| ) |
Class constructor.
| 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 491 of file billboardsetproxy.cpp.
|
virtual |
Accessor for the internal billboard set.
Definition at line 488 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 206 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 178 of file billboardsetproxy.cpp.
|
virtual |
Deletes a Billboard.
| ToBeDestroyed | A pointer to the Billboard you want deleted. |
Definition at line 230 of file billboardsetproxy.cpp.
|
protectedvirtual |
Destroys the internal BillboardSet in use by this proxy.
Definition at line 187 of file billboardsetproxy.cpp.
|
virtual |
Gets whether direction vectors are being calculated using a more expensive but more accurate algorithm.
Definition at line 266 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 260 of file billboardsetproxy.cpp.
Gets a Billboard instance by index.
| Index | The index of the Billboard to be retrieved. |
Definition at line 213 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 278 of file billboardsetproxy.cpp.
|
virtual |
Gets the type of rotation to apply when a rotation is made to a billboard.
Definition at line 284 of file billboardsetproxy.cpp.
|
virtual |
Gets the type of BillboardSetProxy this is.
Definition at line 290 of file billboardsetproxy.cpp.
|
virtual |
Gets the common facing direction for all billboards in this set.
Definition at line 311 of file billboardsetproxy.cpp.
|
virtual |
Gets the common up direction for all billboards in this set.
Definition at line 317 of file billboardsetproxy.cpp.
|
virtual |
Gets the default height all billboards in this set are constructed with.
Definition at line 305 of file billboardsetproxy.cpp.
|
virtual |
Gets the default width all billboards in this set are constructed with.
Definition at line 299 of file billboardsetproxy.cpp.
|
virtual |
Gets the most derived serializable name of this WorldProxy.
Reimplemented from Mezzanine::Graphics::RenderableProxy.
Definition at line 479 of file billboardsetproxy.cpp.
|
virtual |
Gets the name of the material being used by this set.
Definition at line 323 of file billboardsetproxy.cpp.
|
virtual |
Gets the number of Billboard instances in this set.
Definition at line 225 of file billboardsetproxy.cpp.
|
virtual |
Gets the current size of the billboard pool in this set.
Definition at line 272 of file billboardsetproxy.cpp.
|
virtual |
Accessor for the type of proxy.
Implements Mezzanine::WorldProxy.
Definition at line 198 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 482 of file billboardsetproxy.cpp.
|
virtual |
Take the data stored in an XML Node and overwrite 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 |
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 464 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 400 of file billboardsetproxy.cpp.
|
virtual |
Convert this class to an XML::Node ready for serialization.
| ParentNode | The point in the XML hierarchy that all this renderable should be appended to. |
Reimplemented from Mezzanine::Graphics::RenderableProxy.
Definition at line 329 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 368 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 340 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 263 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 bool indicating whether or not this proxy is allowed to resize it's own billboard pool. |
Definition at line 257 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 275 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 281 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 287 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 308 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 314 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 293 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 302 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 296 of file billboardsetproxy.cpp.
|
virtual |
Sets a material for this set by name.
| MatName | The name of the material to apply. |
Definition at line 320 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 269 of file billboardsetproxy.cpp.
|
protected |
Container storing all of the Billboard instances created by this manager.
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.
1.8.4