CEGUI::StateImagery Class Reference

Class the encapsulates imagery for a given widget state. More...

Inheritance diagram for CEGUI::StateImagery:

Collaboration diagram for CEGUI::StateImagery:

Public Types
typedef ConstVectorIterator< LayersList >	LayerIterator
typedef ConstVectorIterator< LayersList >	LayerIterator

Public Member Functions
	StateImagery ()
	Constructor.
	StateImagery (const String &name)
	Constructor. More...
void	render (Window &srcWindow, const ColourRect *modcols=0, const Rectf *clipper=0) const
	Render imagery for this state. More...
void	render (Window &srcWindow, const Rectf &baseRect, const ColourRect *modcols=0, const Rectf *clipper=0) const
	Render imagery for this state. More...
void	addLayer (const LayerSpecification &layer)
	Add an imagery LayerSpecification to this state. More...
void	clearLayers ()
	Removed all LayerSpecifications from this state. More...
const String &	getName () const
	Return the name of this state. More...
void	setName (const String &name)
	Set the name of this state. More...
bool	isClippedToDisplay () const
	Return whether this state imagery should be clipped to the display rather than the target window. More...
void	setClippedToDisplay (bool setting)
	Set whether this state imagery should be clipped to the display rather than the target window. More...
void	writeXMLToStream (XMLSerializer &xml_stream) const
	Writes an xml representation of this StateImagery to out_stream. More...
LayerIterator	getLayerIterator () const
	StateImagery ()
	Constructor.
	StateImagery (const String &name)
	Constructor. More...
void	render (Window &srcWindow, const ColourRect *modcols=0, const Rectf *clipper=0) const
	Render imagery for this state. More...
void	render (Window &srcWindow, const Rectf &baseRect, const ColourRect *modcols=0, const Rectf *clipper=0) const
	Render imagery for this state. More...
void	addLayer (const LayerSpecification &layer)
	Add an imagery LayerSpecification to this state. More...
void	clearLayers ()
	Removed all LayerSpecifications from this state. More...
const String &	getName () const
	Return the name of this state. More...
void	setName (const String &name)
	Set the name of this state. More...
bool	isClippedToDisplay () const
	Return whether this state imagery should be clipped to the display rather than the target window. More...
void	setClippedToDisplay (bool setting)
	Set whether this state imagery should be clipped to the display rather than the target window. More...
void	writeXMLToStream (XMLSerializer &xml_stream) const
	Writes an xml representation of this StateImagery to out_stream. More...
LayerIterator	getLayerIterator () const

Detailed Description

Class the encapsulates imagery for a given widget state.

Constructor & Destructor Documentation

CEGUI::StateImagery::StateImagery

(

const String &

name

)

Constructor.

Parameters

name	Name of the state

CEGUI::StateImagery::StateImagery

(

const String &

name

)

Constructor.

Parameters

name	Name of the state

Member Function Documentation

void CEGUI::StateImagery::addLayer

(

const LayerSpecification &

layer

)

Add an imagery LayerSpecification to this state.

Parameters

layer

LayerSpecification to be added to this state (will be copied)

Returns

Nothing.

Referenced by CEGUI::Falagard_xmlHandler::elementEndLocal().

void CEGUI::StateImagery::addLayer

(

const LayerSpecification &

layer

)

Add an imagery LayerSpecification to this state.

Parameters

layer

LayerSpecification to be added to this state (will be copied)

Returns

Nothing.

void CEGUI::StateImagery::clearLayers

(

)

Removed all LayerSpecifications from this state.

Returns

Nothing.

void CEGUI::StateImagery::clearLayers

(

)

Removed all LayerSpecifications from this state.

Returns

Nothing.

const String & CEGUI::StateImagery::getName

(

void

)

const

Return the name of this state.

Returns

String object holding the name of the StateImagery object.

Referenced by CEGUI::WidgetLookFeel::addStateSpecification(), and CEGUI::Falagard_xmlHandler::elementEndLocal().

const String& CEGUI::StateImagery::getName

(

)

const

Return the name of this state.

Returns

String object holding the name of the StateImagery object.

bool CEGUI::StateImagery::isClippedToDisplay

(

)

const

Return whether this state imagery should be clipped to the display rather than the target window.

Clipping to the display effectively implies that the imagery should be rendered unclipped.

/return

• true if the imagery will be clipped to the display area.
• false if the imagery will be clipped to the target window area.

bool CEGUI::StateImagery::isClippedToDisplay

(

)

const

Return whether this state imagery should be clipped to the display rather than the target window.

Clipping to the display effectively implies that the imagery should be rendered unclipped.

/return

• true if the imagery will be clipped to the display area.
• false if the imagery will be clipped to the target window area.

void CEGUI::StateImagery::render	(	Window &	srcWindow,
		const ColourRect *	modcols = 0,
		const Rectf *	clipper = 0
	)		const

Render imagery for this state.

Parameters

srcWindow

Window to use when convering BaseDim values to pixels.

Returns

Nothing.

void CEGUI::StateImagery::render	(	Window &	srcWindow,
		const ColourRect *	modcols = 0,
		const Rectf *	clipper = 0
	)		const

Render imagery for this state.

Parameters

srcWindow

Window to use when convering BaseDim values to pixels.

Returns

Nothing.

References CEGUI::Window::getGeometryBuffer(), and CEGUI::GeometryBuffer::setClippingActive().

Referenced by CEGUI::FalagardMultiLineEditbox::cacheEditboxBaseImagery(), CEGUI::FalagardMultiColumnList::cacheListboxBaseImagery(), CEGUI::FalagardListbox::cacheListboxBaseImagery(), CEGUI::InventoryItemRenderer::render(), CEGUI::FalagardTitlebar::render(), CEGUI::FalagardTabButton::render(), CEGUI::FalagardButton::render(), CEGUI::FalagardMenubar::render(), CEGUI::FalagardTooltip::render(), CEGUI::FalagardPopupMenu::render(), CEGUI::FalagardListHeaderSegment::render(), CEGUI::FalagardScrollablePane::render(), CEGUI::FalagardItemEntry::render(), CEGUI::FalagardItemListbox::render(), CEGUI::FalagardListHeader::render(), CEGUI::FalagardFrameWindow::render(), CEGUI::FalagardMenuItem::render(), CEGUI::FalagardTree::render(), CEGUI::FalagardScrollbar::render(), CEGUI::FalagardTabControl::render(), CEGUI::FalagardSlider::render(), CEGUI::FalagardProgressBar::render(), CEGUI::FalagardStaticImage::render(), CEGUI::FalagardStatic::render(), and CEGUI::FalagardEditbox::renderBaseImagery().

void CEGUI::StateImagery::render	(	Window &	srcWindow,
		const Rectf &	baseRect,
		const ColourRect *	modcols = 0,
		const Rectf *	clipper = 0
	)		const

Render imagery for this state.

Parameters

srcWindow	Window to use when convering BaseDim values to pixels.
baseRect	Rect to use when convering BaseDim values to pixels.

Returns

Nothing.

References CEGUI::Window::getGeometryBuffer(), and CEGUI::GeometryBuffer::setClippingActive().

void CEGUI::StateImagery::render	(	Window &	srcWindow,
		const Rectf &	baseRect,
		const ColourRect *	modcols = 0,
		const Rectf *	clipper = 0
	)		const

Render imagery for this state.

Parameters

srcWindow	Window to use when convering BaseDim values to pixels.
baseRect	Rect to use when convering BaseDim values to pixels.

Returns

Nothing.

void CEGUI::StateImagery::setClippedToDisplay

(

bool

setting

)

Set whether this state imagery should be clipped to the display rather than the target window.

Clipping to the display effectively implies that the imagery should be rendered unclipped.

Parameters

setting

true if the imagery should be clipped to the display area. false if the imagery should be clipped to the target window area.

Returns

Nothing.

void CEGUI::StateImagery::setClippedToDisplay

(

bool

setting

)

Set whether this state imagery should be clipped to the display rather than the target window.

Clipping to the display effectively implies that the imagery should be rendered unclipped.

Parameters

setting

true if the imagery should be clipped to the display area. false if the imagery should be clipped to the target window area.

Returns

Nothing.

Referenced by CEGUI::Falagard_xmlHandler::elementEndLocal().

void CEGUI::StateImagery::setName

(

const String &

name

)

Set the name of this state.

Returns

String object holding the name of the StateImagery object.

void CEGUI::StateImagery::setName

(

const String &

name

)

Set the name of this state.

Returns

String object holding the name of the StateImagery object.

void CEGUI::StateImagery::writeXMLToStream

(

XMLSerializer &

xml_stream

)

const

Writes an xml representation of this StateImagery to out_stream.

Parameters

xml_stream

Stream where xml data should be output.

Returns

Nothing.

void CEGUI::StateImagery::writeXMLToStream

(

XMLSerializer &

xml_stream

)

const

Writes an xml representation of this StateImagery to out_stream.

Parameters

xml_stream

Stream where xml data should be output.

Returns

Nothing.

References CEGUI::XMLSerializer::attribute(), CEGUI::Falagard_xmlHandler::ClippedAttribute, CEGUI::XMLSerializer::closeTag(), CEGUI::Falagard_xmlHandler::NameAttribute, CEGUI::XMLSerializer::openTag(), and CEGUI::Falagard_xmlHandler::StateImageryElement.