QOpenGLPixelTransferOptions Class
The QOpenGLPixelTransferOptions class describes the pixel storage modes that affect the unpacking of pixels during texture upload. More...
Header: | #include <QOpenGLPixelTransferOptions> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS OpenGL) target_link_libraries(mytarget PRIVATE Qt6::OpenGL) |
qmake: | QT += opengl |
Public Functions
QOpenGLPixelTransferOptions() | |
~QOpenGLPixelTransferOptions() | |
int | alignment() const |
int | imageHeight() const |
bool | isLeastSignificantBitFirst() const |
bool | isSwapBytesEnabled() const |
int | rowLength() const |
void | setAlignment(int alignment) |
void | setImageHeight(int imageHeight) |
void | setLeastSignificantByteFirst(bool lsbFirst) |
void | setRowLength(int rowLength) |
void | setSkipImages(int skipImages) |
void | setSkipPixels(int skipPixels) |
void | setSkipRows(int skipRows) |
void | setSwapBytesEnabled(bool swapBytes) |
int | skipImages() const |
int | skipPixels() const |
int | skipRows() const |
void | swap(QOpenGLPixelTransferOptions &other) |
Member Function Documentation
QOpenGLPixelTransferOptions::QOpenGLPixelTransferOptions()
Constructs a new QOpenGLPixelTransferOptions instance with the default settings.
[noexcept]
QOpenGLPixelTransferOptions::~QOpenGLPixelTransferOptions()
Destructor.
int QOpenGLPixelTransferOptions::alignment() const
Returns the current alignment requirement for each pixel row.
See also setAlignment().
int QOpenGLPixelTransferOptions::imageHeight() const
Returns the currently set image height.
See also setImageHeight().
bool QOpenGLPixelTransferOptions::isLeastSignificantBitFirst() const
Returns true
if bits within a byte are ordered from least to most significant.
bool QOpenGLPixelTransferOptions::isSwapBytesEnabled() const
Returns true
if the byte ordering for multibyte components is reversed.
int QOpenGLPixelTransferOptions::rowLength() const
Returns the currently set row length.
See also setRowLength().
void QOpenGLPixelTransferOptions::setAlignment(int alignment)
Sets the alignment requirements for each pixel row. Corresponds to GL_UNPACK_ALIGNMENT
. The default value is 4, as specified by OpenGL.
See also alignment().
void QOpenGLPixelTransferOptions::setImageHeight(int imageHeight)
Sets the image height for 3D textures to imageHeight. Corresponds to GL_UNPACK_IMAGE_HEIGHT
. The default value is 0.
See also imageHeight().
void QOpenGLPixelTransferOptions::setLeastSignificantByteFirst(bool lsbFirst)
lsbFirst specifies if bits within a byte are ordered from least to most significat. The default value is false
, meaning that the first bit in each byte is the most significant one. This is significant for bitmap data only. Corresponds to GL_UNPACK_LSB_FIRST
.
void QOpenGLPixelTransferOptions::setRowLength(int rowLength)
Sets the number of pixels in a row to rowLength. Corresponds to GL_UNPACK_ROW_LENGTH
. The default value is 0.
See also rowLength().
void QOpenGLPixelTransferOptions::setSkipImages(int skipImages)
Sets the number of images that are skipped to skipImages. Corresponds to GL_UNPACK_SKIP_IMAGES
. Equivalent to incrementing the pointer passed to QOpenGLTexture::setData(). The default value is 0.
See also skipImages().
void QOpenGLPixelTransferOptions::setSkipPixels(int skipPixels)
Sets the number of pixels that are skipped to skipPixels. Corresponds to GL_UNPACK_SKIP_PIXELS
. Equivalent to incrementing the pointer passed to QOpenGLTexture::setData(). The default value is 0.
See also skipPixels().
void QOpenGLPixelTransferOptions::setSkipRows(int skipRows)
Sets the number of rows that are skipped to skipRows. Corresponds to GL_UNPACK_SKIP_ROWS
. Equivalent to incrementing the pointer passed to QOpenGLTexture::setData(). The default value is 0.
See also skipRows().
void QOpenGLPixelTransferOptions::setSwapBytesEnabled(bool swapBytes)
swapBytes specifies if the byte ordering for multibyte components is reversed. The default value is false
. Corresponds to GL_UNPACK_SWAP_BYTES
.
See also isSwapBytesEnabled().
int QOpenGLPixelTransferOptions::skipImages() const
Returns the number of images that are skipped.
See also setSkipImages().
int QOpenGLPixelTransferOptions::skipPixels() const
Returns the number of pixels that are skipped.
See also setSkipPixels().
int QOpenGLPixelTransferOptions::skipRows() const
Returns the number of rows that are skipped.
See also setSkipRows().
[noexcept]
void QOpenGLPixelTransferOptions::swap(QOpenGLPixelTransferOptions &other)
Swaps this options with other. This operation is very fast and never fails.
© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.