1 #ifndef __DALI_INTERNAL_NINE_PATCH_IMAGE_H__
2 #define __DALI_INTERNAL_NINE_PATCH_IMAGE_H__
5 * Copyright (c) 2014 Samsung Electronics Co., Ltd.
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
22 #include <dali/devel-api/images/nine-patch-image.h>
23 #include <dali/internal/event/images/resource-image-impl.h>
24 #include <dali/internal/event/images/buffer-image-impl.h>
33 typedef IntrusivePtr<NinePatchImage> NinePatchImagePtr;
36 class ResourceManager;
44 * NinePatchImage represents an image resource that can be added to actors etc.
45 * It's image data has a border which determines stretch and fill areas
46 * Its pixel buffer data is loaded synchronously from file.
48 class NinePatchImage : public ResourceImage
51 typedef Dali::Vector< Uint16Pair > StretchRanges;
56 * Create a new NinePatchImage.
57 * Also a pixel buffer for image data is allocated.
58 * Dali has ownership of the buffer.
59 * @param [in] filename File to load synchronously into buffer
61 static NinePatchImagePtr New( const std::string& filename );
64 * Create a new NinePatchImage
65 * For better performance and portability use power of two dimensions.
66 * The maximum size of the image is limited by GL_MAX_TEXTURE_SIZE.
67 * @param [in] filename File to load synchronously into buffer
69 NinePatchImage( const std::string& filename );
72 * Convert Image object to a 9 patch image object if possible.
73 * @param[in] image The image to convert
74 * @return A pointer to the 9 patch image object, or NULL
75 * if the conversion is not possible.
77 static NinePatchImage* DownCast( Image* image);
82 * A reference counted object may only be deleted by calling Unreference()
84 virtual ~NinePatchImage();
88 * @copydoc Dali::NinePatchImage::GetStretchPixelsX
90 const StretchRanges& GetStretchPixelsX();
93 * @copydoc Dali::NinePatchImage::GetStretchPixelsY
95 const StretchRanges& GetStretchPixelsY();
98 * Get the child rectangle
99 * @return the position and size of the child rectangle
101 Rect<int> GetChildRectangle();
104 * @brief Create a cropped image from the bitmap with the 1 pixel border cropped off.
105 * This does not change the internal bitmap.
107 * @return the cropped bitmap.
109 BufferImagePtr CreateCroppedBufferImage();
113 * @copydoc Dali::NinePatchImage::
115 static bool IsNinePatchUrl( const std::string& url );
118 protected: // From Resource
120 * @copydoc Dali::Internal::Image::Connect
122 virtual void Connect();
125 * @copydoc Dali::Internal::Image::Disconnect
127 virtual void Disconnect();
131 * Read the borders of the bitmap and determine the child area
132 * and stretch borders
136 Uint16Pair ParseRange( unsigned int& index, unsigned int width, const PixelBuffer* & pixel, unsigned int pixelStride, int testByte, int testBits, int testValue );
139 ResourceClient* mResourceClient;
140 Integration::BitmapPtr mBitmap;
141 StretchRanges mStretchPixelsX; //< The horizontal stretchable pixels in the cropped image space
142 StretchRanges mStretchPixelsY; //< The vertical stretchable pixels in the cropped image space
143 Rect<int> mChildRectangle;
147 } // namespace Internal
150 * Helper methods for public API.
152 inline Internal::NinePatchImage& GetImplementation(Dali::NinePatchImage& handle)
154 DALI_ASSERT_ALWAYS( handle && "NinePatchImage handle is empty" );
156 BaseObject& image = handle.GetBaseObject();
158 return static_cast<Internal::NinePatchImage&>(image);
161 inline const Internal::NinePatchImage& GetImplementation(const Dali::NinePatchImage& handle)
163 DALI_ASSERT_ALWAYS( handle && "NinePatchImage handle is empty" );
165 const BaseObject& image = handle.GetBaseObject();
167 return static_cast<const Internal::NinePatchImage&>(image);
172 #endif // __DALI_INTERNAL_NINE_PATCH_IMAGE_H__