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 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.
1.8.9.1. Thanks to the
Open Icon Library
for help with some of the icons.