* @brief Pointer to Dali::NativeImageSource.
* @SINCE_1_0.0
*/
-typedef IntrusivePtr<NativeImageSource> NativeImageSourcePtr;
+typedef Dali::IntrusivePtr<Dali::NativeImageSource> NativeImageSourcePtr;
/**
* @brief Used for displaying native images.
*
* NativeImageSource can be created internally or
* externally by native image source.
+ * NativeImage is a platform specific way of providing pixel data to the GPU for rendering,
+ * for example via an EGL image.
*
* @SINCE_1_1.4
+ * @see NativeImage
*/
class DALI_IMPORT_API NativeImageSource : public NativeImageInterface
{
public:
/**
- * @brief When creating a native image the color depth has to be specified.
+ * @brief Enumeration for the instance when creating a native image, the color depth has to be specified.
* @SINCE_1_0.0
*/
enum ColorDepth
};
/**
- * @brief Create a new NativeImageSource.
+ * @brief Creates a new NativeImageSource.
*
- * Depending on hardware the width and height may have to be a power of two.
+ * Depending on hardware, the width and height may have to be a power of two.
* @SINCE_1_0.0
- * @param[in] width The width of the image.
- * @param[in] height The height of the image.
- * @param[in] depth color depth of the image.
- * @return A smart-pointer to a newly allocated image.
+ * @param[in] width The width of the image
+ * @param[in] height The height of the image
+ * @param[in] depth color depth of the image
+ * @return A smart-pointer to a newly allocated image
*/
static NativeImageSourcePtr New( unsigned int width, unsigned int height, ColorDepth depth );
/**
- * @brief Create a new NativeImageSource from an existing native image source.
+ * @brief Creates a new NativeImageSource from an existing native image source.
*
* @SINCE_1_0.0
- * @param[in] nativeImageSource must be a any handle with native image source
- * @return A smart-pointer to a newly allocated image.
+ * @param[in] nativeImageSource NativeImageSource must be a any handle with native image source
+ * @return A smart-pointer to a newly allocated image
+ * @see NativeImageInterface
*/
static NativeImageSourcePtr New( Any nativeImageSource );
/**
- * @brief Retrieve the internal native image.
+ * @brief Retrieves the internal native image.
*
* @SINCE_1_0.0
- * @return Any object containing the internal native image source.
+ * @return Any object containing the internal native image source
*/
Any GetNativeImageSource();
/**
- * @brief Get a copy of the pixels used by NativeImageSource.
+ * @brief Gets a copy of the pixels used by NativeImageSource.
*
* This is only supported for 24 bit RGB and 32 bit RGBA internal formats
* (COLOR_DEPTH_24 and COLOR_DEPTH_32).
* @SINCE_1_0.0
- * @param[out] pixbuf a vector to store the pixels in
- * @param[out] width width of image
- * @param[out] height height of image
+ * @param[out] pixbuf A vector to store the pixels in
+ * @param[out] width The width of image
+ * @param[out] height The height of image
* @param[out] pixelFormat pixel format used by image
- * @return True if the pixels were gotten, and false otherwise.
+ * @return @c true if the pixels were gotten, and @c false otherwise
*/
bool GetPixels( std::vector<unsigned char>& pixbuf, unsigned int& width, unsigned int& height, Pixel::Format& pixelFormat ) const;
/**
- * @brief Convert the current pixel contents to either a JPEG or PNG format
- * and write that to the filesytem.
+ * @brief Converts the current pixel contents to either a JPEG or PNG format
+ * and write that to the filesystem.
*
* @SINCE_1_0.0
- * @param[in] filename Identify the filesytem location at which to write the
- * encoded image. The extension determines the encoding used.
+ * @param[in] filename Identify the filesystem location at which to write the encoded image.
+ * The extension determines the encoding used.
* The two valid encoding are (".jpeg"|".jpg") and ".png".
- * @return True if the pixels were written, and false otherwise.
+ * @return @c true if the pixels were written, and @c false otherwise
*/
bool EncodeToFile(const std::string& filename) const;
/**
- * @brief Set an existing source
+ * @brief Sets an existing source.
*
* @SINCE_1_1.19
* @param[in] source Any handle with the source
*/
void SetSource( Any source );
+ /**
+ * @brief Checks if the specified color depth is supported.
+ *
+ * @SINCE_1_1.34
+ * @param[in] colorDepth The color depth to check
+ * @return @c true if colorDepth is supported, @c false otherwise
+ */
+ bool IsColorDepthSupported( ColorDepth colorDepth );
+
private: // native image
/**
private:
+ /// @cond internal
/**
- * @brief Private constructor
+ * @brief Private constructor.
* @SINCE_1_0.0
- * @param[in] width The width of the image.
- * @param[in] height The height of the image.
- * @param[in] depth color depth of the image.
+ * @param[in] width The width of the image
+ * @param[in] height The height of the image
+ * @param[in] depth color depth of the image
* @param[in] nativeImageSource contains either: native image source or is empty
*/
DALI_INTERNAL NativeImageSource( unsigned int width, unsigned int height, ColorDepth depth, Any nativeImageSource );
DALI_INTERNAL virtual ~NativeImageSource();
/**
- * @brief Undefined copy constructor
+ * @brief Undefined copy constructor.
*
* This avoids accidental calls to a default copy constructor.
* @SINCE_1_0.0
- * @param[in] nativeImageSource A reference to the object to copy.
+ * @param[in] nativeImageSource A reference to the object to copy
*/
DALI_INTERNAL NativeImageSource( const NativeImageSource& nativeImageSource );
*
* This avoids accidental calls to a default assignment operator.
* @SINCE_1_0.0
- * @param[in] rhs A reference to the object to copy.
+ * @param[in] rhs A reference to the object to copy
*/
DALI_INTERNAL NativeImageSource& operator=(const NativeImageSource& rhs);
+ /// @endcond
private:
+ /// @cond internal
Internal::Adaptor::NativeImageSource* mImpl; ///< Implementation pointer
+ /// @endcond
};
/**