ElementImage.h

00001 /*
00002  * This source file is part of libRocket, the HTML/CSS Interface Middleware
00003  *
00004  * For the latest information, see http://www.librocket.com
00005  *
00006  * Copyright (c) 2008-2010 CodePoint Ltd, Shift Technology Ltd
00007  *
00008  * Permission is hereby granted, free of charge, to any person obtaining a copy
00009  * of this software and associated documentation files (the "Software"), to deal
00010  * in the Software without restriction, including without limitation the rights
00011  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
00012  * copies of the Software, and to permit persons to whom the Software is
00013  * furnished to do so, subject to the following conditions:
00014  *
00015  * The above copyright notice and this permission notice shall be included in
00016  * all copies or substantial portions of the Software.
00017  * 
00018  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
00019  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
00020  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
00021  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
00022  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
00023  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
00024  * THE SOFTWARE.
00025  *
00026  */
00027 
00028 #ifndef ROCKETCOREELEMENTIMAGE_H
00029 #define ROCKETCOREELEMENTIMAGE_H
00030 
00031 #include <Rocket/Core/Header.h>
00032 #include <Rocket/Core/Element.h>
00033 #include <Rocket/Core/Geometry.h>
00034 #include <Rocket/Core/Texture.h>
00035 
00036 namespace Rocket {
00037 namespace Core {
00038 
00039 class TextureResource;
00040 
00066 class ROCKETCORE_API ElementImage : public Element
00067 {
00068 public:
00071         ElementImage(const String& tag);
00072         virtual ~ElementImage();
00073 
00077         bool GetIntrinsicDimensions(Vector2f& dimensions);
00078 
00079 protected:
00081         virtual void OnRender();
00082 
00085         virtual void OnAttributeChange(const AttributeNameList& changed_attributes);
00086 
00089         virtual void ProcessEvent(Event& event);
00090 
00091 private:
00092         // Generates the element's geometry.
00093         void GenerateGeometry();
00094         // Loads the element's texture, as specified by the 'src' attribute.
00095         bool LoadTexture();
00096         // Resets the values of the 'coords' attribute to mark them as unused.
00097         void ResetCoords();
00098 
00099         // The texture this element is rendering from.
00100         Texture texture;
00101         // True if we need to refetch the texture's source from the element's attributes.
00102         bool texture_dirty;
00103         // The element's computed intrinsic dimensions. If either of these values are set to -1, then
00104         // that dimension has not been computed yet.
00105         Vector2f dimensions;
00106 
00107         // The integer coords extracted from the 'coords' attribute. using_coords will be false if
00108         // these have not been specified or are invalid.
00109         int coords[4];
00110         bool using_coords;
00111 
00112         // The geometry used to render this element.
00113         Geometry geometry;
00114         bool geometry_dirty;
00115 };
00116 
00117 }
00118 }
00119 
00120 #endif