Crazy Eddie's GUI System
0.8.7
|
Class that represents a surface that can have geometry based imagery drawn to it. More...
Inherits CEGUI::EventSet, and CEGUI::AllocatedObject< RenderingSurface >.
Inherited by CEGUI::GUIContext, and CEGUI::RenderingWindow.
Public Member Functions | |
RenderingSurface (RenderTarget &target) | |
Constructor for RenderingSurface objects. More... | |
virtual | ~RenderingSurface () |
Destructor for RenderingSurface objects. | |
void | addGeometryBuffer (const RenderQueueID queue, const GeometryBuffer &buffer) |
Add the specified GeometryBuffer to the specified queue for rendering when the RenderingSurface is drawn. More... | |
void | removeGeometryBuffer (const RenderQueueID queue, const GeometryBuffer &buffer) |
Remove the specified GeometryBuffer from the specified queue. More... | |
void | clearGeometry (const RenderQueueID queue) |
Clears all GeometryBuffers from the specified rendering queue. More... | |
void | clearGeometry () |
Clears all GeometryBuffers from all rendering queues. More... | |
virtual void | draw () |
Draw the GeometryBuffers for all rendering queues to the RenderTarget that this RenderingSurface is targetting. More... | |
virtual void | invalidate () |
Marks the RenderingSurface as invalid, causing the geometry to be rerendered to the RenderTarget next time draw is called. More... | |
bool | isInvalidated () const |
Return whether this RenderingSurface is invalidated. More... | |
virtual bool | isRenderingWindow () const |
Return whether this RenderingSurface is actually an instance of the RenderingWindow subclass. More... | |
virtual RenderingWindow & | createRenderingWindow (TextureTarget &target) |
Create and return a reference to a child RenderingWindow object that will render back onto this RenderingSurface when it's draw member function is called. More... | |
virtual void | destroyRenderingWindow (RenderingWindow &window) |
Destroy a RenderingWindow we own. If we are not the present owner of the given RenderingWindow, nothing happens. More... | |
virtual void | transferRenderingWindow (RenderingWindow &window) |
transfer ownership of the RenderingWindow to this RenderingSurface. More... | |
const RenderTarget & | getRenderTarget () const |
Return the RenderTarget object that this RenderingSurface is drawing to. More... | |
RenderTarget & | getRenderTarget () |
Public Member Functions inherited from CEGUI::EventSet | |
EventSet () | |
Constructor for EventSet objects. | |
virtual | ~EventSet (void) |
Destructor for EventSet objects. | |
void | addEvent (const String &name) |
Creates a new Event object with the given name and adds it to the EventSet. More... | |
void | addEvent (Event &event) |
Adds the given Event object to the EventSet. Ownership of the object passes to EventSet and it will be deleted when it is removed from the EventSet - whether explicitly via removeEvent or when the EventSet is destroyed. More... | |
void | removeEvent (const String &name) |
Removes the Event with the given name. All connections to the event are disconnected, and the underlying Event object is destroyed. More... | |
void | removeEvent (Event &event) |
Removes the given event from the EventSet. All connections to the event are disconnected, and the event object is destroyed. More... | |
void | removeAllEvents (void) |
Remove all Event objects from the EventSet. Add connections will be disconnected, and all Event objects destroyed. | |
bool | isEventPresent (const String &name) |
Checks to see if an Event with the given name is present in this EventSet. More... | |
virtual Event::Connection | subscribeEvent (const String &name, Event::Subscriber subscriber) |
Subscribes a handler to the named Event. If the named Event is not yet present in the EventSet, it is created and added. More... | |
virtual Event::Connection | subscribeEvent (const String &name, Event::Group group, Event::Subscriber subscriber) |
Subscribes a handler to the specified group of the named Event. If the named Event is not yet present in the EventSet, it is created and added. More... | |
template<typename Arg1 , typename Arg2 > | |
Event::Connection | subscribeEvent (const String &name, Arg1 arg1, Arg2 arg2) |
Subscribes a handler to the named Event. If the named Event is not yet present in the EventSet, it is created and added. More... | |
template<typename Arg1 , typename Arg2 > | |
Event::Connection | subscribeEvent (const String &name, Event::Group group, Arg1 arg1, Arg2 arg2) |
Subscribes a handler to the named Event. If the named Event is not yet present in the EventSet, it is created and added. More... | |
virtual Event::Connection | subscribeScriptedEvent (const String &name, const String &subscriber_name) |
Subscribes the named Event to a scripted funtion. More... | |
virtual Event::Connection | subscribeScriptedEvent (const String &name, Event::Group group, const String &subscriber_name) |
Subscribes the specified group of the named Event to a scripted funtion. More... | |
virtual void | fireEvent (const String &name, EventArgs &args, const String &eventNamespace="") |
Fires the named event passing the given EventArgs object. More... | |
bool | isMuted (void) const |
Return whether the EventSet is muted or not. More... | |
void | setMutedState (bool setting) |
Set the mute state for this EventSet. More... | |
Event * | getEventObject (const String &name, bool autoAdd=false) |
Return a pointer to the Event object with the given name, optionally adding such an Event object to the EventSet if it does not already exist. More... | |
EventIterator | getEventIterator (void) const |
Return a EventSet::EventIterator object to iterate over the events currently added to the EventSet. | |
Static Public Attributes | |
static const String | EventNamespace |
Namespace for global events from RenderingSurface objects. | |
static const String | EventRenderQueueStarted |
static const String | EventRenderQueueEnded |
Protected Types | |
typedef std::map< RenderQueueID, RenderQueue > | RenderQueueList |
collection type for the queues | |
typedef std::vector< RenderingWindow *CEGUI_VECTOR_ALLOC(RenderingWindow *)> | RenderingWindowList |
collection type for created RenderingWindow objects | |
Protected Types inherited from CEGUI::EventSet | |
typedef std::map< String, Event *, StringFastLessCompare CEGUI_MAP_ALLOC(String, Event *)> | EventMap |
Protected Member Functions | |
virtual void | drawContent () |
void | draw (const RenderQueue &queue, RenderQueueEventArgs &args) |
draw a rendering queue, firing events before and after. | |
void | detatchWindow (RenderingWindow &w) |
detatch ReneringWindow from this RenderingSurface | |
void | attachWindow (RenderingWindow &w) |
attach ReneringWindow from this RenderingSurface | |
Protected Member Functions inherited from CEGUI::EventSet | |
void | fireEvent_impl (const String &name, EventArgs &args) |
Implementation event firing member. | |
ScriptModule * | getScriptModule () const |
Helper to return the script module pointer or throw. | |
EventSet (EventSet &) | |
EventSet (const EventSet &) | |
EventSet & | operator= (EventSet &) |
EventSet & | operator= (const EventSet &) |
Protected Attributes | |
RenderQueueList | d_queues |
the collection of RenderQueue objects. | |
RenderingWindowList | d_windows |
collection of RenderingWindow object we own | |
RenderTarget * | d_target |
RenderTarget that this surface actually draws to. | |
bool | d_invalidated |
holds invalidated state of target (as far as we are concerned) | |
Protected Attributes inherited from CEGUI::EventSet | |
EventMap | d_events |
bool | d_muted |
true if events for this EventSet have been muted. | |
Additional Inherited Members | |
Public Types inherited from CEGUI::EventSet | |
typedef ConstMapIterator< EventMap > | EventIterator |
Class that represents a surface that can have geometry based imagery drawn to it.
A RenderingSurface has a number of queues that can be used for rendering; normal window rendering will typically be done on RQ_BASE queue, things that are overlaid everything else are rendered to RQ_OVERLAY.
CEGUI::RenderingSurface::RenderingSurface | ( | RenderTarget & | target | ) |
Constructor for RenderingSurface objects.
target | RenderTarget object that will receive rendered output from the RenderingSurface being created. |
void CEGUI::RenderingSurface::addGeometryBuffer | ( | const RenderQueueID | queue, |
const GeometryBuffer & | buffer | ||
) |
Add the specified GeometryBuffer to the specified queue for rendering when the RenderingSurface is drawn.
queue | One of the RenderQueueID enumerated values indicating which prioritised queue the GeometryBuffer should be added to. |
buffer | GeometryBuffer object to be added to the specified rendering queue. |
void CEGUI::RenderingSurface::clearGeometry | ( | const RenderQueueID | queue | ) |
Clears all GeometryBuffers from the specified rendering queue.
queue | One of the RenderQueueID enumerated values indicating which prioritised queue is to to be cleared. |
void CEGUI::RenderingSurface::clearGeometry | ( | ) |
Clears all GeometryBuffers from all rendering queues.
|
virtual |
Create and return a reference to a child RenderingWindow object that will render back onto this RenderingSurface when it's draw member function is called.
The RenderingWindow returned is initially owned by the RenderingSurface that created it.
target | TextureTarget object that will receive rendered output from the RenderingWindow being creatd. |
|
virtual |
Destroy a RenderingWindow we own. If we are not the present owner of the given RenderingWindow, nothing happens.
window | RenderingWindow object that is to be destroyed. |
|
virtual |
Draw the GeometryBuffers for all rendering queues to the RenderTarget that this RenderingSurface is targetting.
The GeometryBuffers remain in the rendering queues after the draw operation is complete. This allows the next draw operation to occur without needing to requeue all the GeometryBuffers (if for instance the sequence of buffers to be drawn remains unchanged).
Reimplemented in CEGUI::GUIContext, and CEGUI::RenderingWindow.
|
protectedvirtual |
draw the surface content. Default impl draws the render queues. NB: Called between RenderTarget activate and deactivate calls.
Reimplemented in CEGUI::GUIContext.
const RenderTarget& CEGUI::RenderingSurface::getRenderTarget | ( | ) | const |
Return the RenderTarget object that this RenderingSurface is drawing to.
|
virtual |
Marks the RenderingSurface as invalid, causing the geometry to be rerendered to the RenderTarget next time draw is called.
Note that some surface types can never be in a 'valid' state and so rerendering occurs whenever draw is called. This function mainly exists as a means to hint to other surface types - those that physically cache the rendered output - that geometry content has changed and the cached imagery should be cleared and redrawn.
Reimplemented in CEGUI::RenderingWindow.
bool CEGUI::RenderingSurface::isInvalidated | ( | ) | const |
Return whether this RenderingSurface is invalidated.
Note that some surface types can never be in a 'valid' state and so will always return true.
|
virtual |
Return whether this RenderingSurface is actually an instance of the RenderingWindow subclass.
Reimplemented in CEGUI::RenderingWindow.
void CEGUI::RenderingSurface::removeGeometryBuffer | ( | const RenderQueueID | queue, |
const GeometryBuffer & | buffer | ||
) |
Remove the specified GeometryBuffer from the specified queue.
queue | One of the RenderQueueID enumerated values indicating which prioritised queue the GeometryBuffer should be removed from. |
buffer | GeometryBuffer object to be removed from the specified rendering queue. |
|
virtual |
transfer ownership of the RenderingWindow to this RenderingSurface.
Transfer ownership of the given RenderingWindow to this RenderingSurface. The result is generally the same as if this RenderingSurface had created the RenderingWindow in the first place.
window | RenderingWindow object that this RenderingSurface is to take ownership of. |
|
static |
Event fired when rendering of a RenderQueue completes for the RenderingSurface. Handlers are passed a const RenderQueueEventArgs reference with RenderQueueEventArgs::queueID set to one of the RenderQueueID enumerated values indicating the queue that has completed rendering.
|
static |
Event fired when rendering of a RenderQueue begins for the RenderingSurface. Handlers are passed a const RenderQueueEventArgs reference with RenderQueueEventArgs::queueID set to one of the RenderQueueID enumerated values indicating the queue that is about to start rendering.