| /**************************************************************************** |
| ** |
| ** Copyright (C) 2013 Klaralvdalens Datakonsult AB (KDAB). |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the QtGui module of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:LGPL$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://www.qt.io/contact-us. |
| ** |
| ** GNU Lesser General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU Lesser |
| ** General Public License version 3 as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.LGPL3 included in the |
| ** packaging of this file. Please review the following information to |
| ** ensure the GNU Lesser General Public License version 3 requirements |
| ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. |
| ** |
| ** GNU General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU |
| ** General Public License version 2.0 or (at your option) the GNU General |
| ** Public license version 3 or any later version approved by the KDE Free |
| ** Qt Foundation. The licenses are as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 |
| ** included in the packaging of this file. Please review the following |
| ** information to ensure the GNU General Public License requirements will |
| ** be met: https://www.gnu.org/licenses/gpl-2.0.html and |
| ** https://www.gnu.org/licenses/gpl-3.0.html. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| #include "qopenglpixeltransferoptions.h" |
| #include <QSharedData> |
| |
| QT_BEGIN_NAMESPACE |
| |
| /*! |
| * \class QOpenGLPixelTransferOptions |
| * |
| * \brief The QOpenGLPixelTransferOptions class describes the pixel storage |
| * modes that affect the unpacking of pixels during texture upload. |
| */ |
| |
| /*! |
| * \fn QOpenGLPixelTransferOptions & QOpenGLPixelTransferOptions::operator=(QOpenGLPixelTransferOptions &&other) |
| * \internal |
| */ |
| |
| /*! |
| * \fn void QOpenGLPixelTransferOptions::swap(QOpenGLPixelTransferOptions &other) |
| * \internal |
| */ |
| |
| class QOpenGLPixelTransferOptionsData : public QSharedData |
| { |
| public: |
| QOpenGLPixelTransferOptionsData() |
| : alignment(4) |
| , skipImages(0) |
| , skipRows(0) |
| , skipPixels(0) |
| , imageHeight(0) |
| , rowLength(0) |
| , lsbFirst(false) |
| , swapBytes(false) |
| {} |
| |
| int alignment; |
| int skipImages; |
| int skipRows; |
| int skipPixels; |
| int imageHeight; |
| int rowLength; |
| bool lsbFirst; |
| bool swapBytes; |
| }; |
| |
| /*! |
| * Constructs a new QOpenGLPixelTransferOptions instance with the default settings. |
| */ |
| QOpenGLPixelTransferOptions::QOpenGLPixelTransferOptions() |
| : data(new QOpenGLPixelTransferOptionsData) |
| { |
| } |
| |
| /*! |
| * \internal |
| */ |
| QOpenGLPixelTransferOptions::QOpenGLPixelTransferOptions(const QOpenGLPixelTransferOptions &rhs) |
| : data(rhs.data) |
| { |
| } |
| |
| /*! |
| * \internal |
| */ |
| QOpenGLPixelTransferOptions &QOpenGLPixelTransferOptions::operator=(const QOpenGLPixelTransferOptions &rhs) |
| { |
| if (this != &rhs) |
| data.operator=(rhs.data); |
| return *this; |
| } |
| |
| /*! |
| * Destructor. |
| */ |
| QOpenGLPixelTransferOptions::~QOpenGLPixelTransferOptions() |
| { |
| } |
| |
| /*! |
| * Sets the \a alignment requirements for each pixel row. Corresponds to \c GL_UNPACK_ALIGNMENT. |
| * The default value is 4, as specified by OpenGL. |
| */ |
| void QOpenGLPixelTransferOptions::setAlignment(int alignment) |
| { |
| data->alignment = alignment; |
| } |
| |
| /*! |
| * \return the current alignment requirement for each pixel row. |
| */ |
| int QOpenGLPixelTransferOptions::alignment() const |
| { |
| return data->alignment; |
| } |
| |
| /*! |
| * Sets the number of images that are skipped to \a skipImages. |
| * Corresponds to \c GL_UNPACK_SKIP_IMAGES. Equivalent to incrementing the pointer |
| * passed to QOpenGLTexture::setData(). The default value is 0. |
| */ |
| void QOpenGLPixelTransferOptions::setSkipImages(int skipImages) |
| { |
| data->skipImages = skipImages; |
| } |
| |
| /*! |
| * \return the number of images that are skipped. |
| */ |
| int QOpenGLPixelTransferOptions::skipImages() const |
| { |
| return data->skipImages; |
| } |
| |
| /*! |
| * Sets the number of rows that are skipped to \a skipRows. |
| * Corresponds to \c GL_UNPACK_SKIP_ROWS. Equivalent to incrementing the pointer |
| * passed to QOpenGLTexture::setData(). The default value is 0. |
| */ |
| void QOpenGLPixelTransferOptions::setSkipRows(int skipRows) |
| { |
| data->skipRows = skipRows; |
| } |
| |
| /*! |
| * \return the number of rows that are skipped. |
| */ |
| int QOpenGLPixelTransferOptions::skipRows() const |
| { |
| return data->skipRows; |
| } |
| |
| /*! |
| * Sets the number of pixels that are skipped to \a skipPixels. |
| * Corresponds to \c GL_UNPACK_SKIP_PIXELS. Equivalent to incrementing the pointer |
| * passed to QOpenGLTexture::setData(). The default value is 0. |
| */ |
| void QOpenGLPixelTransferOptions::setSkipPixels(int skipPixels) |
| { |
| data->skipPixels = skipPixels; |
| } |
| |
| /*! |
| * \return the number of pixels that are skipped. |
| */ |
| int QOpenGLPixelTransferOptions::skipPixels() const |
| { |
| return data->skipPixels; |
| } |
| |
| /*! |
| * Sets the image height for 3D textures to \a imageHeight. |
| * Corresponds to \c GL_UNPACK_IMAGE_HEIGHT. |
| * The default value is 0. |
| */ |
| void QOpenGLPixelTransferOptions::setImageHeight(int imageHeight) |
| { |
| data->imageHeight = imageHeight; |
| } |
| |
| /*! |
| * \return the currently set image height. |
| */ |
| int QOpenGLPixelTransferOptions::imageHeight() const |
| { |
| return data->imageHeight; |
| } |
| |
| /*! |
| * Sets the number of pixels in a row to \a rowLength. |
| * Corresponds to \c GL_UNPACK_ROW_LENGTH. |
| * The default value is 0. |
| */ |
| void QOpenGLPixelTransferOptions::setRowLength(int rowLength) |
| { |
| data->rowLength = rowLength; |
| } |
| |
| /*! |
| * \return the currently set row length. |
| */ |
| int QOpenGLPixelTransferOptions::rowLength() const |
| { |
| return data->rowLength; |
| } |
| |
| /*! |
| * \a lsbFirst specifies if bits within a byte are ordered from least to most significat. |
| * The default value is \c false, meaning that the first bit in each byte is the |
| * most significant one. This is significant for bitmap data only. |
| * Corresponds to \c GL_UNPACK_LSB_FIRST. |
| */ |
| void QOpenGLPixelTransferOptions::setLeastSignificantByteFirst(bool lsbFirst) |
| { |
| data->lsbFirst = lsbFirst; |
| } |
| |
| /*! |
| * \return \c true if bits within a byte are ordered from least to most significant. |
| */ |
| bool QOpenGLPixelTransferOptions::isLeastSignificantBitFirst() const |
| { |
| return data->lsbFirst; |
| } |
| |
| /*! |
| * \a swapBytes specifies if the byte ordering for multibyte components is reversed. |
| * The default value is \c false. |
| * Corresponds to \c GL_UNPACK_SWAP_BYTES. |
| */ |
| void QOpenGLPixelTransferOptions::setSwapBytesEnabled(bool swapBytes) |
| { |
| data->swapBytes = swapBytes; |
| } |
| |
| /*! |
| * \return \c true if the byte ordering for multibyte components is reversed. |
| */ |
| bool QOpenGLPixelTransferOptions::isSwapBytesEnabled() const |
| { |
| return data->swapBytes; |
| } |
| |
| QT_END_NAMESPACE |