diff --git a/src/BufferImage.h b/src/BufferImage.h index fbc472d64..d92d62ef5 100644 --- a/src/BufferImage.h +++ b/src/BufferImage.h @@ -26,7 +26,7 @@ #ifndef MAGNUM_TARGET_GLES2 /** @file - * @brief Class Magnum::BufferImage, typedef Magnum::BufferImage1D, Magnum::BufferImage2D, Magnum::BufferImage3D + * @brief Class @ref Magnum::BufferImage, typedef @ref Magnum::BufferImage1D, @ref Magnum::BufferImage2D, @ref Magnum::BufferImage3D */ #endif @@ -41,9 +41,9 @@ namespace Magnum { /** @brief %Buffer image -Stores image data in GPU memory. Interchangeable with Image, ImageReference or -Trade::ImageData. -@see BufferImage1D, BufferImage2D, BufferImage3D, Buffer +Stores image data in GPU memory. Interchangeable with @ref Image, +@ref ImageReference or @ref Trade::ImageData. +@see @ref BufferImage1D, @ref BufferImage2D, @ref BufferImage3D, @ref Buffer @requires_gles30 Pixel buffer objects are not available in OpenGL ES 2.0. */ template class MAGNUM_EXPORT BufferImage: public AbstractImage { @@ -55,8 +55,8 @@ template class MAGNUM_EXPORT BufferImage: public Abstrac * @param format Format of pixel data * @param type Data type of pixel data * - * Dimensions and buffer are empty, call setData() to fill the image - * with data. + * Dimensions and buffer are empty, call @ref setData() to fill the + * image with data. */ explicit BufferImage(ColorFormat format, ColorType type): AbstractImage(format, type) { _buffer.setTargetHint(Buffer::Target::PixelPack); @@ -78,8 +78,7 @@ template class MAGNUM_EXPORT BufferImage: public Abstrac * * Updates the image buffer with given data. The data are not deleted * after filling the buffer. - * - * @see Buffer::setData() + * @see @ref Buffer::setData() */ void setData(const typename DimensionTraits::VectorType& size, ColorFormat format, ColorType type, const void* data, BufferUsage usage); diff --git a/src/Image.h b/src/Image.h index 18dcd3b9b..c66291ba0 100644 --- a/src/Image.h +++ b/src/Image.h @@ -25,7 +25,7 @@ */ /** @file - * @brief Class Magnum::Image, typedef Magnum::Image1D, Magnum::Image2D, Magnum::Image3D + * @brief Class @ref Magnum::Image, typedef @ref Magnum::Image1D, @ref Magnum::Image2D, @ref Magnum::Image3D */ #include "ImageReference.h" @@ -35,9 +35,9 @@ namespace Magnum { /** @brief %Image -Stores image data on client memory. Interchangeable with ImageReference, -BufferImage or Trade::ImageData. -@see Image1D, Image2D, Image3D +Stores image data on client memory. Interchangeable with @ref ImageReference, +@ref BufferImage or @ref Trade::ImageData. +@see @ref Image1D, @ref Image2D, @ref Image3D */ template class Image: public AbstractImage { public: @@ -60,8 +60,8 @@ template class Image: public AbstractImage { * @param format Format of pixel data * @param type Data type of pixel data * - * Dimensions and data pointer are set to zero, call setData() to fill - * the image with data. + * Dimensions are set to zero and data pointer to `nullptr`, call + * @ref setData() to fill the image with data. */ explicit Image(ColorFormat format, ColorType type): AbstractImage(format, type), _data(nullptr) {} diff --git a/src/ImageReference.h b/src/ImageReference.h index 7532c103e..d2f754e16 100644 --- a/src/ImageReference.h +++ b/src/ImageReference.h @@ -25,7 +25,7 @@ */ /** @file - * @brief Class Magnum::ImageReference + * @brief Class @ref Magnum::ImageReference, typedef @ref Magnum::ImageReference1D, @ref Magnum::ImageReference2D, @ref Magnum::ImageReference3D */ #include "Math/Vector3.h" @@ -40,14 +40,14 @@ namespace Magnum { Adds information about dimensions, color components and component type to some data in memory. -Unlike Image, this class doesn't delete the data on destruction, so it is +Unlike @ref Image, this class doesn't delete the data on destruction, so it is targeted for wrapping data which are either stored in stack/constant memory (and shouldn't be deleted) or they are managed by someone else and have the same properties for each frame, such as video stream. Thus it is not possible to change image properties, only data pointer. -Interchangeable with Image, BufferImage or Trade::ImageData. -@see ImageReference1D, ImageReference2D, ImageReference3D +Interchangeable with @ref Image, @ref BufferImage or @ref Trade::ImageData. +@see @ref ImageReference1D, @ref ImageReference2D, @ref ImageReference3D */ template class ImageReference: public AbstractImage { public: @@ -68,8 +68,8 @@ template class ImageReference: public AbstractImage { * @param type Data type of pixel data * @param size %Image size * - * Data pointer is set to zero, call setData() to fill the image with - * data. + * Data pointer is set to `nullptr`, call @ref setData() to fill the + * image with data. */ constexpr explicit ImageReference(ColorFormat format, ColorType type, const typename DimensionTraits::VectorType& size): AbstractImage(format, type), _size(size), _data(nullptr) {} diff --git a/src/Trade/ImageData.h b/src/Trade/ImageData.h index e06f973f0..2c3652b26 100644 --- a/src/Trade/ImageData.h +++ b/src/Trade/ImageData.h @@ -25,7 +25,7 @@ */ /** @file - * @brief Class Magnum::Trade::ImageData + * @brief Class @ref Magnum::Trade::ImageData, typedef @ref Magnum::Trade::ImageData1D, @ref Magnum::Trade::ImageData2D, @ref Magnum::Trade::ImageData3D */ #include "ImageReference.h" @@ -35,9 +35,9 @@ namespace Magnum { namespace Trade { /** @brief %Image data -Access to image data provided by AbstractImporter subclasses. Interchangeable -with Image, ImageReference or BufferImage. -@see ImageData1D, ImageData2D, ImageData3D +Access to image data provided by @ref AbstractImporter subclasses. +Interchangeable with @ref Image, @ref ImageReference or @ref BufferImage. +@see @ref ImageData1D, @ref ImageData2D, @ref ImageData3D */ template class ImageData: public AbstractImage { public: