![]() |
Qt 6.x
The Qt SDK
|
#include <qsgplaintexture_p.h>
Public Member Functions | |
QSGPlainTexture () | |
~QSGPlainTexture () override | |
void | setOwnsTexture (bool owns) |
bool | ownsTexture () const |
void | setTextureSize (const QSize &size) |
QSize | textureSize () const override |
Returns the size of the texture in pixels. | |
void | setHasAlphaChannel (bool alpha) |
bool | hasAlphaChannel () const override |
Returns true if the texture data contains an alpha channel. | |
bool | hasMipmaps () const override |
Returns true if the texture data contains mipmap levels. | |
void | setImage (const QImage &image) |
const QImage & | image () |
qint64 | comparisonKey () const override |
Returns a key suitable for comparing textures. | |
QRhiTexture * | rhiTexture () const override |
void | commitTextureOperations (QRhi *rhi, QRhiResourceUpdateBatch *resourceUpdates) override |
Call this function to enqueue image upload operations to resourceUpdates, in case there are any pending ones. | |
void | setTexture (QRhiTexture *texture) |
void | setTextureFromNativeTexture (QRhi *rhi, quint64 nativeObjectHandle, int nativeLayoutOrState, uint nativeFormat, const QSize &size, QQuickWindow::CreateTextureOptions options, QQuickWindowPrivate::TextureFromNativeTextureFlags flags) |
![]() | |
QSGTexture () | |
Constructs the QSGTexture base class. | |
~QSGTexture () override | |
Destroys the QSGTexture. | |
virtual qint64 | comparisonKey () const =0 |
Returns a key suitable for comparing textures. | |
virtual QRhiTexture * | rhiTexture () const |
virtual QSize | textureSize () const =0 |
Returns the size of the texture in pixels. | |
virtual bool | hasAlphaChannel () const =0 |
Returns true if the texture data contains an alpha channel. | |
virtual bool | hasMipmaps () const =0 |
Returns true if the texture data contains mipmap levels. | |
virtual QRectF | normalizedTextureSubRect () const |
Returns the rectangle inside textureSize() that this texture represents in normalized coordinates. | |
virtual bool | isAtlasTexture () const |
Returns whether this texture is part of an atlas or not. | |
virtual QSGTexture * | removedFromAtlas (QRhiResourceUpdateBatch *resourceUpdates=nullptr) const |
This function returns a copy of the current texture which is removed from its atlas. | |
virtual void | commitTextureOperations (QRhi *rhi, QRhiResourceUpdateBatch *resourceUpdates) |
Call this function to enqueue image upload operations to resourceUpdates, in case there are any pending ones. | |
void | setMipmapFiltering (Filtering filter) |
Sets the mipmap sampling mode to filter. | |
QSGTexture::Filtering | mipmapFiltering () const |
Returns whether mipmapping should be used when sampling from this texture. | |
void | setFiltering (Filtering filter) |
Sets the sampling mode to filter. | |
QSGTexture::Filtering | filtering () const |
Returns the sampling mode to be used for this texture. | |
void | setAnisotropyLevel (AnisotropyLevel level) |
Sets the level of anisotropic filtering to level. | |
QSGTexture::AnisotropyLevel | anisotropyLevel () const |
Returns the anisotropy level in use for filtering this texture. | |
void | setHorizontalWrapMode (WrapMode hwrap) |
Sets the horizontal wrap mode to hwrap. | |
QSGTexture::WrapMode | horizontalWrapMode () const |
Returns the horizontal wrap mode to be used for this texture. | |
void | setVerticalWrapMode (WrapMode vwrap) |
Sets the vertical wrap mode to vwrap. | |
QSGTexture::WrapMode | verticalWrapMode () const |
Returns the vertical wrap mode to be used for this texture. | |
QRectF | convertToNormalizedSourceRect (const QRectF &rect) const |
Returns rect converted to normalized coordinates. | |
![]() | |
Q_INVOKABLE | QObject (QObject *parent=nullptr) |
Constructs an object with parent object parent. | |
virtual | ~QObject () |
Destroys the object, deleting all its child objects. | |
virtual bool | event (QEvent *event) |
This virtual function receives events to an object and should return true if the event e was recognized and processed. | |
virtual bool | eventFilter (QObject *watched, QEvent *event) |
Filters events if this object has been installed as an event filter for the watched object. | |
QString | objectName () const |
Q_WEAK_OVERLOAD void | setObjectName (const QString &name) |
Sets the object's name to name. | |
void | setObjectName (QAnyStringView name) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
QBindable< QString > | bindableObjectName () |
bool | isWidgetType () const |
Returns true if the object is a widget; otherwise returns false . | |
bool | isWindowType () const |
Returns true if the object is a window; otherwise returns false . | |
bool | isQuickItemType () const |
Returns true if the object is a QQuickItem; otherwise returns false . | |
bool | signalsBlocked () const noexcept |
Returns true if signals are blocked; otherwise returns false . | |
bool | blockSignals (bool b) noexcept |
If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). | |
QThread * | thread () const |
Returns the thread in which the object lives. | |
void | moveToThread (QThread *thread) |
Changes the thread affinity for this object and its children. | |
int | startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer) |
This is an overloaded function that will start a timer of type timerType and a timeout of interval milliseconds. | |
int | startTimer (std::chrono::milliseconds time, Qt::TimerType timerType=Qt::CoarseTimer) |
void | killTimer (int id) |
Kills the timer with timer identifier, id. | |
template<typename T > | |
T | findChild (const QString &aName=QString(), Qt::FindChildOptions options=Qt::FindChildrenRecursively) const |
Returns the child of this object that can be cast into type T and that is called name, or \nullptr if there is no such object. | |
template<typename T > | |
QList< T > | findChildren (const QString &aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const |
Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. | |
template<typename T > | |
QList< T > | findChildren (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
const QObjectList & | children () const |
Returns a list of child objects. | |
void | setParent (QObject *parent) |
Makes the object a child of parent. | |
void | installEventFilter (QObject *filterObj) |
Installs an event filter filterObj on this object. | |
void | removeEventFilter (QObject *obj) |
Removes an event filter object obj from this object. | |
QMetaObject::Connection | connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const |
bool | disconnect (const char *signal=nullptr, const QObject *receiver=nullptr, const char *member=nullptr) const |
bool | disconnect (const QObject *receiver, const char *member=nullptr) const |
void | dumpObjectTree () const |
Dumps a tree of children to the debug output. | |
void | dumpObjectInfo () const |
Dumps information about signal connections, etc. | |
bool | setProperty (const char *name, const QVariant &value) |
Sets the value of the object's name property to value. | |
bool | setProperty (const char *name, QVariant &&value) |
QVariant | property (const char *name) const |
Returns the value of the object's name property. | |
QList< QByteArray > | dynamicPropertyNames () const |
QBindingStorage * | bindingStorage () |
const QBindingStorage * | bindingStorage () const |
QObject * | parent () const |
Returns a pointer to the parent object. | |
bool | inherits (const char *classname) const |
Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false . | |
Static Public Member Functions | |
static QSGPlainTexture * | fromImage (const QImage &image) |
![]() | |
static QMetaObject::Connection | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection) |
\threadsafe | |
static QMetaObject::Connection | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection) |
template<typename Func1 , typename Func2 > | |
static QMetaObject::Connection | connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::ContextTypeForFunctor< Func2 >::ContextType *context, Func2 &&slot, Qt::ConnectionType type=Qt::AutoConnection) |
template<typename Func1 , typename Func2 > | |
static QMetaObject::Connection | connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 &&slot) |
static bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member) |
\threadsafe | |
static bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member) |
static bool | disconnect (const QMetaObject::Connection &) |
Disconnect a connection. | |
template<typename Func1 , typename Func2 > | |
static bool | disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object *receiver, Func2 slot) |
template<typename Func1 > | |
static bool | disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const QObject *receiver, void **zero) |
Protected Member Functions | |
QSGPlainTexture (QSGPlainTexturePrivate &dd) | |
![]() | |
QSGTexture (QSGTexturePrivate &dd) | |
![]() | |
QObject * | sender () const |
Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns \nullptr. | |
int | senderSignalIndex () const |
int | receivers (const char *signal) const |
Returns the number of receivers connected to the signal. | |
bool | isSignalConnected (const QMetaMethod &signal) const |
virtual void | timerEvent (QTimerEvent *event) |
This event handler can be reimplemented in a subclass to receive timer events for the object. | |
virtual void | childEvent (QChildEvent *event) |
This event handler can be reimplemented in a subclass to receive child events. | |
virtual void | customEvent (QEvent *event) |
This event handler can be reimplemented in a subclass to receive custom events. | |
virtual void | connectNotify (const QMetaMethod &signal) |
virtual void | disconnectNotify (const QMetaMethod &signal) |
QObject (QObjectPrivate &dd, QObject *parent=nullptr) | |
Protected Attributes | |
QImage | m_image |
QSize | m_texture_size |
QRectF | m_texture_rect |
QRhiTexture * | m_texture |
uint | m_has_alpha: 1 |
uint | m_dirty_texture: 1 |
uint | m_dirty_bind_options: 1 |
uint | m_owns_texture: 1 |
uint | m_mipmaps_generated: 1 |
uint | m_retain_image: 1 |
uint | m_mipmap_warned: 1 |
![]() | |
QScopedPointer< QObjectData > | d_ptr |
Additional Inherited Members | |
![]() | |
enum | WrapMode { Repeat , ClampToEdge , MirroredRepeat } |
Specifies how the sampler should treat texture coordinates. More... | |
enum | Filtering { None , Nearest , Linear } |
Specifies how sampling of texels should filter when texture coordinates are not pixel aligned. More... | |
enum | AnisotropyLevel { AnisotropyNone , Anisotropy2x , Anisotropy4x , Anisotropy8x , Anisotropy16x } |
Specifies the anisotropic filtering level to be used when the texture is not screen aligned. More... | |
![]() | |
void | deleteLater () |
\threadsafe | |
![]() | |
void | destroyed (QObject *=nullptr) |
This signal is emitted immediately before the object obj is destroyed, after any instances of QPointer have been notified, and cannot be blocked. | |
void | objectNameChanged (const QString &objectName, QPrivateSignal) |
This signal is emitted after the object's name has been changed. | |
![]() | |
QString | objectName |
the name of this object | |
![]() | |
template< class T > T | qobject_cast (const QObject *object) |
Returns the given object cast to type T if the object is of type T (or of a subclass); otherwise returns \nullptr. | |
template< typename T > T | qFindChildqFindChildren (const QObject *obj, const QString &name)() |
template< typename T > QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QString &name)() |
QObjectList | |
\macro Q_CLASSINFO(Name, Value) | |
Definition at line 26 of file qsgplaintexture_p.h.
QT_BEGIN_NAMESPACE QSGPlainTexture::QSGPlainTexture | ( | ) |
Definition at line 18 of file qsgplaintexture.cpp.
|
override |
Definition at line 42 of file qsgplaintexture.cpp.
References m_owns_texture, and m_texture.
|
protected |
Definition at line 30 of file qsgplaintexture.cpp.
|
overridevirtual |
Call this function to enqueue image upload operations to resourceUpdates, in case there are any pending ones.
When there is no new data (for example, because there was no setImage() since the last call to this function), the function does nothing.
Materials involving rhi textures are expected to call this function from their \l{QSGMaterialShader::updateSampledImage()}{updateSampledImage()} implementation, typically without any conditions, passing {state.rhi()} and
{state.resourceUpdateBatch()} from the QSGMaterialShader::RenderState.
Reimplemented from QSGTexture.
Definition at line 113 of file qsgplaintexture.cpp.
References QRhiTexture::BGRA8, QImage::bytesPerLine(), QSGTexture::ClampToEdge, QImage::convertToFormat(), QImage::copy(), QRhiTexture::create(), d, QRhiTexture::flags(), QImage::format(), QImage::Format_ARGB32_Premultiplied, QImage::Format_RGB32, QImage::Format_RGBA8888_Premultiplied, QImage::Format_RGBX8888, QRhiResourceUpdateBatch::generateMips(), QImage::height(), QSize::height(), QSGTexture::horizontalWrapMode(), Qt::IgnoreAspectRatio, QRhi::isFeatureSupported(), QImage::isNull(), QRhi::isTextureFormatSupported(), m_dirty_texture, m_has_alpha, m_image, m_mipmap_warned, m_mipmaps_generated, m_owns_texture, m_retain_image, m_texture, m_texture_rect, m_texture_size, QSGTexture::mipmapFiltering(), QRhiTexture::MipMapped, QRhi::newTexture(), QSGTexture::None, QRhi::NPOTTextureRepeat, QRhiTexture::pixelSize(), qMin(), qNextPowerOfTwo(), qWarning, QRhi::resourceLimit(), QRhiTexture::RGBA8, QImage::scaled(), QRhiTexture::setFlags(), QSGTexture::setMipmapFiltering(), QRhiTexture::setPixelSize(), QImage::size(), Qt::SmoothTransformation, QRhi::TextureSizeMax, QRhiResourceUpdateBatch::uploadTexture(), QRhiTexture::UsedWithGenerateMips, QSGTexture::verticalWrapMode(), QImage::width(), and QSize::width().
Referenced by QSGPainterTexture::commitTextureOperations(), and QSGRhiShaderEffectMaterialShader::updateSampledImage().
|
overridevirtual |
Returns a key suitable for comparing textures.
Typically used in QSGMaterial::compare() implementations.
Just comparing QSGTexture pointers is not always sufficient because two QSGTexture instances that refer to the same native texture object underneath should also be considered equal. Hence the need for this function.
Implementations of this function are not expected to, and should not create any graphics resources (native texture objects) in case there are none yet.
A QSGTexture that does not have a native texture object underneath is typically not equal to any other QSGTexture, so the return value has to be crafted accordingly. There are exceptions to this, in particular when atlasing is used (where multiple textures share the same atlas texture under the hood), that is then up to the subclass implementations to deal with as appropriate.
Implements QSGTexture.
Definition at line 99 of file qsgplaintexture.cpp.
References m_texture.
|
inlinestatic |
Definition at line 62 of file qsgplaintexture_p.h.
|
inlineoverridevirtual |
Returns true if the texture data contains an alpha channel.
Implements QSGTexture.
Definition at line 41 of file qsgplaintexture_p.h.
|
inlineoverridevirtual |
Returns true if the texture data contains mipmap levels.
Implements QSGTexture.
Definition at line 43 of file qsgplaintexture_p.h.
References QSGTexture::mipmapFiltering(), and QSGTexture::None.
|
inline |
Definition at line 46 of file qsgplaintexture_p.h.
Referenced by setImage().
|
inline |
Definition at line 35 of file qsgplaintexture_p.h.
|
overridevirtual |
This function is not expected to create a new QRhiTexture in case there is none. It should return null in that case. The expectation towards the renderer is that a null texture leads to using a transparent, dummy texture instead.
Reimplemented from QSGTexture.
Definition at line 108 of file qsgplaintexture.cpp.
References m_texture.
|
inline |
Definition at line 40 of file qsgplaintexture_p.h.
Referenced by QSGRhiAtlasTexture::Texture::removedFromAtlas(), and QSGMapboxGLTextureNode::resize().
Definition at line 48 of file qsgplaintexture.cpp.
References image(), m_dirty_texture, m_has_alpha, m_image, m_mipmaps_generated, and m_texture_size.
Referenced by QSGPainterTexture::commitTextureOperations(), QSGDefaultRenderContext::createTexture(), QQuickShapeGradientCache::get(), QSGDefaultPainterNode::paint(), QSGRhiAtlasTexture::Texture::removedFromAtlas(), and QSGRhiShaderEffectMaterialShader::updateSampledImage().
|
inline |
Definition at line 34 of file qsgplaintexture_p.h.
Referenced by QSGTextMaskMaterial::ensureUpToDate(), QSGRhiAtlasTexture::Texture::removedFromAtlas(), SGFramebufferObjectNode::render(), and QSGDistanceFieldTextMaterial::updateTextureSizeAndWrapper().
void QSGPlainTexture::setTexture | ( | QRhiTexture * | texture | ) |
Definition at line 57 of file qsgplaintexture.cpp.
References m_dirty_texture, m_image, m_mipmaps_generated, m_owns_texture, and m_texture.
Referenced by QSGTextMaskMaterial::ensureUpToDate(), QSGRhiAtlasTexture::Texture::removedFromAtlas(), setTextureFromNativeTexture(), and QSGDistanceFieldTextMaterial::updateTextureSizeAndWrapper().
void QSGPlainTexture::setTextureFromNativeTexture | ( | QRhi * | rhi, |
quint64 | nativeObjectHandle, | ||
int | nativeLayoutOrState, | ||
uint | nativeFormat, | ||
const QSize & | size, | ||
QQuickWindow::CreateTextureOptions | options, | ||
QQuickWindowPrivate::TextureFromNativeTextureFlags | flags | ||
) |
Definition at line 68 of file qsgplaintexture.cpp.
References QRhiTexture::createFrom(), QRhiTexture::ExternalOES, QSGRhiSupport::instance(), QRhiTexture::MipMapped, QQuickWindowPrivate::NativeTextureIsExternalOES, QRhi::newTexture(), QRhiTexture::RGBA8, setTexture(), QSGRhiSupport::toRhiTextureFormat(), QRhiTexture::UnknownFormat, and QRhiTexture::UsedWithGenerateMips.
Referenced by QQuickWindowPrivate::createTextureFromNativeTexture().
Definition at line 37 of file qsgplaintexture_p.h.
Referenced by QSGTextMaskMaterial::ensureUpToDate(), QSGRhiAtlasTexture::Texture::removedFromAtlas(), QSGMapboxGLTextureNode::resize(), and QSGDistanceFieldTextMaterial::updateTextureSizeAndWrapper().
|
inlineoverridevirtual |
Returns the size of the texture in pixels.
Implements QSGTexture.
Definition at line 38 of file qsgplaintexture_p.h.
|
protected |
Definition at line 79 of file qsgplaintexture_p.h.
|
protected |
Definition at line 78 of file qsgplaintexture_p.h.
Referenced by commitTextureOperations(), setImage(), and setTexture().
|
protected |
Definition at line 77 of file qsgplaintexture_p.h.
Referenced by commitTextureOperations(), and setImage().
|
protected |
Definition at line 71 of file qsgplaintexture_p.h.
Referenced by QSGPainterTexture::commitTextureOperations(), commitTextureOperations(), setImage(), and setTexture().
|
protected |
Definition at line 83 of file qsgplaintexture_p.h.
Referenced by commitTextureOperations().
|
protected |
Definition at line 81 of file qsgplaintexture_p.h.
Referenced by commitTextureOperations(), setImage(), and setTexture().
|
protected |
Definition at line 80 of file qsgplaintexture_p.h.
Referenced by ~QSGPlainTexture(), commitTextureOperations(), and setTexture().
|
protected |
Definition at line 82 of file qsgplaintexture_p.h.
Referenced by QSGPainterTexture::QSGPainterTexture(), and commitTextureOperations().
|
protected |
Definition at line 75 of file qsgplaintexture_p.h.
Referenced by ~QSGPlainTexture(), commitTextureOperations(), comparisonKey(), rhiTexture(), setTexture(), and QSGDefaultPainterNode::texture().
|
protected |
Definition at line 74 of file qsgplaintexture_p.h.
Referenced by commitTextureOperations().
|
protected |
Definition at line 73 of file qsgplaintexture_p.h.
Referenced by commitTextureOperations(), and setImage().