
Public Types | |
|
typedef ConstBaseIterator < ImageRegistry > | ImageIterator |
| Iterator type for this collection. | |
Public Member Functions | |
| ~Imageset (void) | |
| Destroys Imageset objects. | |
| Texture * | getTexture (void) const |
| return Texture object for this Imageset | |
| const String & | getName (void) const |
| return String object holding the name of the Imageset | |
| uint | getImageCount (void) const |
| return number of images defined for this Imageset | |
| bool | isImageDefined (const String &name) const |
| return true if an Image with the specified name exists. | |
| const Image & | getImage (const String &name) const |
| return a copy of the Image object for the named image | |
| void | undefineImage (const String &name) |
| remove the definition for the Image with the specified name. If no such Image exists, nothing happens. | |
| void | undefineAllImages (void) |
| Removes the definitions for all Image objects currently defined in the Imageset. | |
| Size | getImageSize (const String &name) const |
| return a Size object describing the dimensions of the named image. | |
| float | getImageWidth (const String &name) const |
| return the width of the named image. | |
| float | getImageHeight (const String &name) const |
| return the height of the named image. | |
| Point | getImageOffset (const String &name) const |
| return the rendering offsets applied to the named image. | |
| float | getImageOffsetX (const String &name) const |
| return the x rendering offset for the named image. | |
| float | getImageOffsetY (const String &name) const |
| return the y rendering offset for the named image. | |
| void | defineImage (const String &name, const Point &position, const Size &size, const Point &render_offset) |
| Define a new Image for this Imageset. | |
| void | defineImage (const String &name, const Rect &image_rect, const Point &render_offset) |
| Define a new Image for this Imageset. | |
| void | draw (const Rect &source_rect, const Rect &dest_rect, float z, const Rect &clip_rect, const ColourRect &colours, QuadSplitMode quad_split_mode) const |
| Queues an area of the associated Texture the be drawn on the screen. Low-level routine to be used carefully! | |
| void | draw (const Rect &source_rect, const Rect &dest_rect, float z, const Rect &clip_rect, const colour &top_left_colour=0xFFFFFFFF, const colour &top_right_colour=0xFFFFFFFF, const colour &bottom_left_colour=0xFFFFFFFF, const colour &bottom_right_colour=0xFFFFFFFF, QuadSplitMode quad_split_mode=TopLeftToBottomRight) const |
| Queues an area of the associated Texture the be drawn on the screen. Low-level routine to be used carefully! | |
| bool | isAutoScaled (void) const |
| Return whether this Imageset is auto-scaled. | |
| Size | getNativeResolution (void) const |
| Return the native display size for this Imageset. This is only relevant if the Imageset is being auto-scaled. | |
| void | setAutoScalingEnabled (bool setting) |
| Enable or disable auto-scaling for this Imageset. | |
| void | setNativeResolution (const Size &size) |
| Set the native resolution for this Imageset. | |
| void | notifyScreenResolution (const Size &size) |
| Notify the Imageset of the current (usually new) display resolution. | |
| ImageIterator | getIterator (void) const |
| Return an Imageset::ImageIterator object that can be used to iterate over the Image objects in the Imageset. | |
| void | writeXMLToStream (XMLSerializer &xml_stream) const |
| Writes an xml representation of this Imageset to out_stream. | |
Static Public Member Functions | |
| static void | setDefaultResourceGroup (const String &resourceGroup) |
| Sets the default resource group to be used when loading imageset data. | |
| static const String & | getDefaultResourceGroup () |
| Returns the default resource group currently set for Imagesets. | |
Protected Member Functions | |
| void | load (const String &filename, const String &resourceGroup) |
| Initialise the Imageset with information taken from the specified file. | |
| void | unload (void) |
| Unloads all loaded data and leaves the Imageset in a clean (but un-usable) state. This should be called for cleanup purposes only. | |
| void | setTexture (Texture *texture) |
| set the Texture object to be used by this Imageset. Changing textures on an Imageset that is in use is not a good idea! | |
| void | updateImageScalingFactors (void) |
| Sets the scaling factor for all Images that are a part of this Imageset. | |
Protected Attributes | |
| String | d_name |
| Holds the name of this imageset. | |
| ImageRegistry | d_images |
| Registry of Image objects for the images defined for this Imageset. | |
| Texture * | d_texture |
| Texture object that handles imagery for this Imageset. | |
| String | d_textureFilename |
| String holding the name of the texture filename (if any). | |
| bool | d_autoScale |
| true when auto-scaling is enabled. | |
| float | d_horzScaling |
| current horizontal scaling factor. | |
| float | d_vertScaling |
| current vertical scaling factor. | |
| float | d_nativeHorzRes |
| native horizontal resolution for this Imageset. | |
| float | d_nativeVertRes |
| native vertical resolution for this Imageset. | |
Static Protected Attributes | |
| static const char | ImagesetSchemaName [] = "Imageset.xsd" |
| Filename of the XML schema used for validating Imageset files. | |
| static String | d_defaultResourceGroup |
| Default resource group specifically for Imagesets. | |
Friends | |
| class | Imageset_xmlHandler |
| Imageset * | ImagesetManager::createImageset (const String &name, Texture *texture) |
| Imageset * | ImagesetManager::createImageset (const String &filename, const String &resourceGroup) |
| Imageset * | ImagesetManager::createImagesetFromImageFile (const String &name, const String &filename, const String &resourceGroup) |
| void | ImagesetManager::destroyImageset (const String &name) |
Imageset objects are a means by which a single graphical image (file, Texture, etc), can be split into a number of 'components' which can later be accessed via name. The components of an Imageset can queried for various details, and sent to the Renderer object for drawing.
| void CEGUI::Imageset::defineImage | ( | const String & | name, | |
| const Rect & | image_rect, | |||
| const Point & | render_offset | |||
| ) |
Define a new Image for this Imageset.
| name | String object holding the name that will be assigned to the new Image, which must be unique within the Imageset. | |
| image_rect | Rect object describing the area on the image file / texture associated with this Imageset that will be used for the Image. | |
| render_offset | Point object describing the offsets, in pixels, that are to be applied to the Image when it is drawn. |
| AlreadyExistsException | thrown if an Image named name is already defined for this Imageset |
References d_autoScale, d_horzScaling, d_images, d_name, d_vertScaling, and isImageDefined().
| void CEGUI::Imageset::defineImage | ( | const String & | name, | |
| const Point & | position, | |||
| const Size & | size, | |||
| const Point & | render_offset | |||
| ) | [inline] |
Define a new Image for this Imageset.
| name | String object holding the name that will be assigned to the new Image, which must be unique within the Imageset. | |
| position | Point object describing the pixel location of the Image on the image file / texture associated with this Imageset. | |
| size | Size object describing the dimensions of the Image, in pixels. | |
| render_offset | Point object describing the offsets, in pixels, that are to be applied to the Image when it is drawn. |
| AlreadyExistsException | thrown if an Image named name is already defined for this Imageset |
References CEGUI::Size::d_height, CEGUI::Size::d_width, CEGUI::Vector2::d_x, and CEGUI::Vector2::d_y.
Referenced by CEGUI::FreeTypeFont::rasterize().
| void CEGUI::Imageset::draw | ( | const Rect & | source_rect, | |
| const Rect & | dest_rect, | |||
| float | z, | |||
| const Rect & | clip_rect, | |||
| const colour & | top_left_colour = 0xFFFFFFFF, |
|||
| const colour & | top_right_colour = 0xFFFFFFFF, |
|||
| const colour & | bottom_left_colour = 0xFFFFFFFF, |
|||
| const colour & | bottom_right_colour = 0xFFFFFFFF, |
|||
| QuadSplitMode | quad_split_mode = TopLeftToBottomRight | |||
| ) | const [inline] |
Queues an area of the associated Texture the be drawn on the screen. Low-level routine to be used carefully!
| source_rect | Rect object describing the area of the image file / texture that is to be queued for drawing | |
| dest_rect | Rect describing the area of the screen that will be filled with the imagery from source_rect. | |
| z | float value specifying 'z' order. 0 is topmost with increasing values moving back into the screen. | |
| clip_rect | Rect object describing a 'clipping rectangle' that will be applied when drawing the requested imagery | |
| top_left_colour | colour to be applied to the top left corner of the rendered imagery. | |
| top_right_colour | colour to be applied to the top right corner of the rendered imagery. | |
| bottom_left_colour | colour to be applied to the bottom left corner of the rendered imagery. | |
| bottom_right_colour | colour to be applied to the bottom right corner of the rendered imagery. | |
| quad_split_mode | One of the QuadSplitMode values specifying the way quads are split into triangles |
| void CEGUI::Imageset::draw | ( | const Rect & | source_rect, | |
| const Rect & | dest_rect, | |||
| float | z, | |||
| const Rect & | clip_rect, | |||
| const ColourRect & | colours, | |||
| QuadSplitMode | quad_split_mode | |||
| ) | const |
Queues an area of the associated Texture the be drawn on the screen. Low-level routine to be used carefully!
| source_rect | Rect object describing the area of the image file / texture that is to be queued for drawing | |
| dest_rect | Rect describing the area of the screen that will be filled with the imagery from source_rect. | |
| z | float value specifying 'z' order. 0 is topmost with increasing values moving back into the screen. | |
| clip_rect | Rect object describing a 'clipping rectangle' that will be applied when drawing the requested imagery | |
| colours | ColourRect object holding the ARGB colours to be applied to the four corners of the rendered imagery. | |
| quad_split_mode | One of the QuadSplitMode values specifying the way quads are split into triangles |
References CEGUI::Renderer::addQuad(), CEGUI::Rect::d_bottom, CEGUI::Rect::d_left, CEGUI::Rect::d_right, d_texture, CEGUI::Rect::d_top, CEGUI::Rect::getHeight(), CEGUI::Rect::getIntersection(), CEGUI::Texture::getRenderer(), CEGUI::Rect::getWidth(), CEGUI::Texture::getXScale(), and CEGUI::Texture::getYScale().
Referenced by CEGUI::Image::draw().
| static const String& CEGUI::Imageset::getDefaultResourceGroup | ( | void | ) | [inline, static] |
return a copy of the Image object for the named image
| UnknownObjectException | thrown if no Image named name is defined for the Imageset |
References d_images, and d_name.
Referenced by CEGUI::PixmapFont::defineMapping(), CEGUI::FreeTypeFont::rasterize(), CEGUI::FrameWindow::setEWSizingCursorImage(), CEGUI::ImageryComponent::setImage(), CEGUI::FrameComponent::setImage(), CEGUI::Window::setMouseCursor(), CEGUI::FrameWindow::setNESWSizingCursorImage(), CEGUI::FrameWindow::setNSSizingCursorImage(), and CEGUI::FrameWindow::setNWSESizingCursorImage().
| uint CEGUI::Imageset::getImageCount | ( | void | ) | const [inline] |
| float CEGUI::Imageset::getImageHeight | ( | const String & | name | ) | const [inline] |
| float CEGUI::Imageset::getImageOffsetX | ( | const String & | name | ) | const [inline] |
| float CEGUI::Imageset::getImageOffsetY | ( | const String & | name | ) | const [inline] |
| float CEGUI::Imageset::getImageWidth | ( | const String & | name | ) | const [inline] |
| const String& CEGUI::Imageset::getName | ( | void | ) | const [inline] |
return String object holding the name of the Imageset
Referenced by CEGUI::ImagesetManager::createImageset(), CEGUI::ImagesetManager::destroyImageset(), and CEGUI::Image::getImagesetName().
| Size CEGUI::Imageset::getNativeResolution | ( | void | ) | const [inline] |
| Texture* CEGUI::Imageset::getTexture | ( | void | ) | const [inline] |
| bool CEGUI::Imageset::isAutoScaled | ( | void | ) | const [inline] |
| bool CEGUI::Imageset::isImageDefined | ( | const String & | name | ) | const [inline] |
Initialise the Imageset with information taken from the specified file.
| filename | String object that holds the name of the Imageset data file that is to be processed. | |
| resourceGroup | Resource group identifier to be passed to the resource manager. NB: This affects the imageset xml file only, the texture loaded may have its own group specified in the XML file. |
| FileIOException | thrown if something goes wrong while processing the file filename. |
References d_defaultResourceGroup, CEGUI::String::empty(), CEGUI::Errors, CEGUI::System::getSingleton(), CEGUI::System::getXMLParser(), ImagesetSchemaName, CEGUI::XMLParser::parseXMLFile(), and unload().
| void CEGUI::Imageset::notifyScreenResolution | ( | const Size & | size | ) |
Notify the Imageset of the current (usually new) display resolution.
| size | Size object describing the display resolution |
References d_autoScale, CEGUI::Size::d_height, d_horzScaling, d_nativeHorzRes, d_nativeVertRes, d_vertScaling, CEGUI::Size::d_width, and updateImageScalingFactors().
Referenced by setNativeResolution().
| void CEGUI::Imageset::setAutoScalingEnabled | ( | bool | setting | ) |
Enable or disable auto-scaling for this Imageset.
| setting | true to enable auto-scaling, false to disable auto-scaling. |
References d_autoScale, and updateImageScalingFactors().
Referenced by CEGUI::PixmapFont::updateFont().
| static void CEGUI::Imageset::setDefaultResourceGroup | ( | const String & | resourceGroup | ) | [inline, static] |
Sets the default resource group to be used when loading imageset data.
| resourceGroup | String describing the default resource group identifier to be used. |
| void CEGUI::Imageset::setNativeResolution | ( | const Size & | size | ) |
Set the native resolution for this Imageset.
References CEGUI::Size::d_height, d_nativeHorzRes, d_nativeVertRes, CEGUI::Size::d_width, CEGUI::System::getSingleton(), and notifyScreenResolution().
Referenced by CEGUI::PixmapFont::updateFont().
| void CEGUI::Imageset::setTexture | ( | Texture * | texture | ) | [protected] |
set the Texture object to be used by this Imageset. Changing textures on an Imageset that is in use is not a good idea!
| texture | Texture object to be used by the Imageset. The old texture is NOT disposed of, that is the clients responsibility. |
| NullObjectException | thrown if texture is NULL |
References d_texture.
| void CEGUI::Imageset::undefineAllImages | ( | void | ) |
| void CEGUI::Imageset::undefineImage | ( | const String & | name | ) |
| void CEGUI::Imageset::updateImageScalingFactors | ( | void | ) | [protected] |
Sets the scaling factor for all Images that are a part of this Imageset.
References d_autoScale, d_horzScaling, d_images, and d_vertScaling.
Referenced by notifyScreenResolution(), and setAutoScalingEnabled().
| void CEGUI::Imageset::writeXMLToStream | ( | XMLSerializer & | xml_stream | ) | const |
Writes an xml representation of this Imageset to out_stream.
| out_stream | Stream where xml data should be output. | |
| indentLevel | Current XML indentation level |
References CEGUI::XMLSerializer::attribute(), CEGUI::XMLSerializer::closeTag(), d_autoScale, d_name, d_nativeHorzRes, d_nativeVertRes, d_textureFilename, CEGUI::DefaultNativeHorzRes, CEGUI::DefaultNativeVertRes, CEGUI::ConstBaseIterator< T >::getCurrentValue(), getIterator(), CEGUI::ConstBaseIterator< T >::isAtEnd(), and CEGUI::XMLSerializer::openTag().
Referenced by CEGUI::ImagesetManager::writeImagesetToStream().
1.5.7.1