Qt
Internal/Contributor docs for the Qt SDK. <b>Note:</b> These are NOT official API docs; those are found <a href='https://doc.qt.io/'>here</a>.
Loading...
Searching...
No Matches
Public Member Functions | Public Attributes | Friends | List of all members
QD3D11Texture Struct Reference

#include <qrhid3d11_p.h>

+ Inheritance diagram for QD3D11Texture:
+ Collaboration diagram for QD3D11Texture:

Public Member Functions

 QD3D11Texture (QRhiImplementation *rhi, Format format, const QSize &pixelSize, int depth, int arraySize, int sampleCount, Flags flags)
 
 ~QD3D11Texture ()
 
void destroy () override
 Releases (or requests deferred releasing of) the underlying native graphics resources.
 
bool create () override
 Creates the corresponding native graphics resources.
 
bool createFrom (NativeTexture src) override
 Similar to create(), except that no new native textures are created.
 
NativeTexture nativeTexture () override
 
bool prepareCreate (QSize *adjustedSize=nullptr)
 
bool finishCreate ()
 
ID3D11UnorderedAccessView * unorderedAccessViewForLevel (int level)
 
ID3D11Resource * textureResource () const
 
- Public Member Functions inherited from QRhiTexture
QRhiResource::Type resourceType () const override
 
Format format () const
 
void setFormat (Format fmt)
 Sets the requested texture format to fmt.
 
QSize pixelSize () const
 
void setPixelSize (const QSize &sz)
 Sets the texture size, specified in pixels, to sz.
 
int depth () const
 
void setDepth (int depth)
 Sets the depth for a 3D texture.
 
int arraySize () const
 
void setArraySize (int arraySize)
 Sets the texture arraySize.
 
int arrayRangeStart () const
 
int arrayRangeLength () const
 
void setArrayRange (int startIndex, int count)
 Normally all array layers are exposed and it is up to the shader to select the layer via the third coordinate passed to the {texture()} GLSL function when sampling the sampler2DArray.
 
Flags flags () const
 
void setFlags (Flags f)
 Sets the texture flags to f.
 
int sampleCount () const
 
void setSampleCount (int s)
 Sets the sample count to s.
 
ViewFormat readViewFormat () const
 \variable QRhiTexture::ViewFormat::format
 
void setReadViewFormat (const ViewFormat &fmt)
 
ViewFormat writeViewFormat () const
 
void setWriteViewFormat (const ViewFormat &fmt)
 
virtual void setNativeLayout (int layout)
 With some graphics APIs, such as Vulkan, integrating custom rendering code that uses the graphics API directly needs special care when it comes to image layouts.
 
- Public Member Functions inherited from QRhiResource
virtual ~QRhiResource ()
 Destructor.
 
void deleteLater ()
 When called without a frame being recorded, this function is equivalent to deleting the object.
 
QByteArray name () const
 
void setName (const QByteArray &name)
 Sets a name for the object.
 
quint64 globalResourceId () const
 
QRhi * rhi () const
 

Public Attributes

ID3D11Texture2D * tex = nullptr
 
ID3D11Texture3D * tex3D = nullptr
 
ID3D11Texture1D * tex1D = nullptr
 
bool owns = true
 
ID3D11ShaderResourceView * srv = nullptr
 
DXGI_FORMAT dxgiFormat
 
uint mipLevelCount = 0
 
DXGI_SAMPLE_DESC sampleDesc
 
ID3D11UnorderedAccessView * perLevelViews [QRhi::MAX_MIP_LEVELS]
 
uint generation = 0
 

Friends

class QRhiD3D11
 

Additional Inherited Members

- Public Types inherited from QRhiTexture
enum  Flag {
  RenderTarget = 1 << 0 , CubeMap = 1 << 2 , MipMapped = 1 << 3 , sRGB = 1 << 4 ,
  UsedAsTransferSource = 1 << 5 , UsedWithGenerateMips = 1 << 6 , UsedWithLoadStore = 1 << 7 , UsedAsCompressedAtlas = 1 << 8 ,
  ExternalOES = 1 << 9 , ThreeDimensional = 1 << 10 , TextureRectangleGL = 1 << 11 , TextureArray = 1 << 12 ,
  OneDimensional = 1 << 13
}
 Flag values to specify how the texture is going to be used. More...
 
enum  Format {
  UnknownFormat , RGBA8 , BGRA8 , R8 ,
  RG8 , R16 , RG16 , RED_OR_ALPHA8 ,
  RGBA16F , RGBA32F , R16F , R32F ,
  RGB10A2 , D16 , D24 , D24S8 ,
  D32F , BC1 , BC2 , BC3 ,
  BC4 , BC5 , BC6H , BC7 ,
  ETC2_RGB8 , ETC2_RGB8A1 , ETC2_RGBA8 , ASTC_4x4 ,
  ASTC_5x4 , ASTC_5x5 , ASTC_6x5 , ASTC_6x6 ,
  ASTC_8x5 , ASTC_8x6 , ASTC_8x8 , ASTC_10x5 ,
  ASTC_10x6 , ASTC_10x8 , ASTC_10x10 , ASTC_12x10 ,
  ASTC_12x12
}
 Specifies the texture format. More...
 
- Public Types inherited from QRhiResource
enum  Type {
  Buffer , Texture , Sampler , RenderBuffer ,
  RenderPassDescriptor , SwapChainRenderTarget , TextureRenderTarget , ShaderResourceBindings ,
  GraphicsPipeline , SwapChain , ComputePipeline , CommandBuffer
}
 Specifies type of the resource. More...
 
- Protected Member Functions inherited from QRhiTexture
 QRhiTexture (QRhiImplementation *rhi, Format format_, const QSize &pixelSize_, int depth_, int arraySize_, int sampleCount_, Flags flags_)
 \variable QRhiTexture::NativeTexture::object
 
- Protected Member Functions inherited from QRhiResource
 QRhiResource (QRhiImplementation *rhi)
 
- Protected Attributes inherited from QRhiTexture
Format m_format
 
QSize m_pixelSize
 
int m_depth
 
int m_arraySize
 
int m_sampleCount
 
Flags m_flags
 
int m_arrayRangeStart = -1
 
int m_arrayRangeLength = -1
 
ViewFormat m_readViewFormat = { UnknownFormat, false }
 
ViewFormat m_writeViewFormat = { UnknownFormat, false }
 
- Protected Attributes inherited from QRhiResource
QRhiImplementation * m_rhi = nullptr
 
quint64 m_id
 
QByteArray m_objectName
 

Detailed Description

Definition at line 69 of file qrhid3d11_p.h.

Constructor & Destructor Documentation

◆ QD3D11Texture()

QD3D11Texture::QD3D11Texture ( QRhiImplementation * rhi,
Format format,
const QSize & pixelSize,
int depth,
int arraySize,
int sampleCount,
Flags flags )

Definition at line 3199 of file qrhid3d11.cpp.

References i, QRhi::MAX_MIP_LEVELS, and perLevelViews.

◆ ~QD3D11Texture()

QD3D11Texture::~QD3D11Texture ( )

Definition at line 3207 of file qrhid3d11.cpp.

References destroy().

+ Here is the call graph for this function:

Member Function Documentation

◆ create()

bool QD3D11Texture::create ( )
overridevirtual

Creates the corresponding native graphics resources.

If there are already resources present due to an earlier create() with no corresponding destroy(), then destroy() is called implicitly first.

Returns
true when successful, false when a graphics operation failed. Regardless of the return value, calling destroy() is always safe.

Implements QRhiTexture.

Definition at line 3428 of file qrhid3d11.cpp.

References QByteArray::constData(), QRhiTexture::CubeMap, dxgiFormat, finishCreate(), isDepthTextureFormat(), QByteArray::isEmpty(), QRhiTexture::m_arraySize, QRhiTexture::m_depth, QRhiTexture::m_flags, QRhiTexture::m_format, QRhiResource::m_objectName, mipLevelCount, QRhiTexture::OneDimensional, owns, prepareCreate(), qMax(), qPrintable, QRHI_RES_RHI, qWarning, QRhiTexture::RenderTarget, sampleDesc, QByteArray::size(), tex, tex1D, tex3D, QRhiTexture::TextureArray, QRhiTexture::ThreeDimensional, QRhiTexture::UsedWithGenerateMips, and QRhiTexture::UsedWithLoadStore.

+ Here is the call graph for this function:

◆ createFrom()

bool QD3D11Texture::createFrom ( QRhiTexture::NativeTexture src)
overridevirtual

Similar to create(), except that no new native textures are created.

Instead, the native texture resources specified by src is used.

This allows importing an existing native texture object (which must belong to the same device or sharing context, depending on the graphics API) from an external graphics engine.

Returns
true if the specified existing native texture object has been successfully wrapped as a non-owning QRhiTexture.
Note
format(), pixelSize(), sampleCount(), and flags() must still be set correctly. Passing incorrect sizes and other values to QRhi::newTexture() and then following it with a createFrom() expecting that the native texture object alone is sufficient to deduce such values is wrong and will lead to problems.
QRhiTexture does not take ownership of the texture object. destroy() does not free the object or any associated memory.

The opposite of this operation, exposing a QRhiTexture-created native texture object to a foreign engine, is possible via nativeTexture().

Note
When importing a 3D texture, or a texture array object, or, with OpenGL ES, an external texture, it is then especially important to set the corresponding flags (ThreeDimensional, TextureArray, ExternalOES) via setFlags() before calling this function.

Reimplemented from QRhiTexture.

Definition at line 3528 of file qrhid3d11.cpp.

References finishCreate(), QRhiTexture::m_flags, QRhiTexture::OneDimensional, owns, prepareCreate(), QRHI_RES_RHI, tex, tex1D, tex3D, and QRhiTexture::ThreeDimensional.

+ Here is the call graph for this function:

◆ destroy()

void QD3D11Texture::destroy ( )
overridevirtual

Releases (or requests deferred releasing of) the underlying native graphics resources.

Safe to call multiple times, subsequent invocations will be a no-op then.

Once destroy() is called, the QRhiResource instance can be reused, by calling create() again. That will then result in creating new native graphics resources underneath.

Note
Resources referenced by commands for the current frame should not be released until the frame is submitted by QRhi::endFrame().

The QRhiResource destructor also performs the same task, so calling this function is not necessary before deleting a QRhiResource.

See also
deleteLater()

Implements QRhiResource.

Definition at line 3212 of file qrhid3d11.cpp.

References i, QRhi::MAX_MIP_LEVELS, owns, perLevelViews, QRHI_RES_RHI, srv, tex, tex1D, and tex3D.

Referenced by ~QD3D11Texture(), and prepareCreate().

+ Here is the caller graph for this function:

◆ finishCreate()

bool QD3D11Texture::finishCreate ( )

Definition at line 3353 of file qrhid3d11.cpp.

References QRhiTexture::CubeMap, dxgiFormat, generation, isDepthTextureFormat(), QRhiTexture::m_arrayRangeLength, QRhiTexture::m_arrayRangeStart, QRhiTexture::m_arraySize, QRhiTexture::m_flags, QRhiTexture::m_format, mipLevelCount, QRhiTexture::OneDimensional, qMax(), qPrintable, QRHI_RES_RHI, qWarning, sampleDesc, srv, QRhiTexture::TextureArray, textureResource(), QRhiTexture::ThreeDimensional, and toD3DDepthTextureSRVFormat().

Referenced by create(), and createFrom().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ nativeTexture()

QRhiTexture::NativeTexture QD3D11Texture::nativeTexture ( )
overridevirtual
Returns
the underlying native resources for this texture. The returned value will be empty if exposing the underlying native resources is not supported by the backend.
See also
createFrom()

Reimplemented from QRhiTexture.

Definition at line 3552 of file qrhid3d11.cpp.

References textureResource().

+ Here is the call graph for this function:

◆ prepareCreate()

bool QD3D11Texture::prepareCreate ( QSize * adjustedSize = nullptr)

Definition at line 3281 of file qrhid3d11.cpp.

References QRhiTexture::CubeMap, destroy(), dxgiFormat, isDepthTextureFormat(), QSize::isEmpty(), QRhiTexture::m_arraySize, QRhiTexture::m_depth, QRhiTexture::m_flags, QRhiTexture::m_format, QRhiTexture::m_pixelSize, QRhiTexture::m_sampleCount, mipLevelCount, QRhiTexture::MipMapped, QRhiTexture::OneDimensional, qMax(), QRHI_RES_RHI, qWarning, sampleDesc, tex, tex1D, tex3D, QRhiTexture::TextureArray, QRhiTexture::ThreeDimensional, toD3DTextureFormat(), and QSize::width().

Referenced by create(), and createFrom().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ textureResource()

ID3D11Resource * QD3D11Texture::textureResource ( ) const
inline

Definition at line 82 of file qrhid3d11_p.h.

References tex, tex1D, and tex3D.

Referenced by finishCreate(), nativeTexture(), and unorderedAccessViewForLevel().

+ Here is the caller graph for this function:

◆ unorderedAccessViewForLevel()

ID3D11UnorderedAccessView * QD3D11Texture::unorderedAccessViewForLevel ( int level)

Definition at line 3557 of file qrhid3d11.cpp.

References QRhiTexture::CubeMap, dxgiFormat, QRhiTexture::m_arraySize, QRhiTexture::m_flags, perLevelViews, qMax(), qPrintable, QRHI_RES_RHI, qWarning, QRhiTexture::TextureArray, textureResource(), and QRhiTexture::ThreeDimensional.

+ Here is the call graph for this function:

Friends And Related Symbol Documentation

◆ QRhiD3D11

friend class QRhiD3D11
friend

Definition at line 101 of file qrhid3d11_p.h.

Member Data Documentation

◆ dxgiFormat

DXGI_FORMAT QD3D11Texture::dxgiFormat

Definition at line 96 of file qrhid3d11_p.h.

Referenced by create(), finishCreate(), prepareCreate(), and unorderedAccessViewForLevel().

◆ generation

uint QD3D11Texture::generation = 0

Definition at line 100 of file qrhid3d11_p.h.

Referenced by finishCreate().

◆ mipLevelCount

uint QD3D11Texture::mipLevelCount = 0

Definition at line 97 of file qrhid3d11_p.h.

Referenced by create(), finishCreate(), and prepareCreate().

◆ owns

bool QD3D11Texture::owns = true

Definition at line 94 of file qrhid3d11_p.h.

Referenced by create(), createFrom(), and destroy().

◆ perLevelViews

ID3D11UnorderedAccessView* QD3D11Texture::perLevelViews[QRhi::MAX_MIP_LEVELS]

Definition at line 99 of file qrhid3d11_p.h.

Referenced by QD3D11Texture(), destroy(), and unorderedAccessViewForLevel().

◆ sampleDesc

DXGI_SAMPLE_DESC QD3D11Texture::sampleDesc

Definition at line 98 of file qrhid3d11_p.h.

Referenced by create(), finishCreate(), and prepareCreate().

◆ srv

ID3D11ShaderResourceView* QD3D11Texture::srv = nullptr

Definition at line 95 of file qrhid3d11_p.h.

Referenced by destroy(), and finishCreate().

◆ tex

ID3D11Texture2D* QD3D11Texture::tex = nullptr

Definition at line 91 of file qrhid3d11_p.h.

Referenced by create(), createFrom(), destroy(), prepareCreate(), QRhiD3D11::setShaderResources(), textureResource(), and QRhiD3D11::updateShaderResourceBindings().

◆ tex1D

ID3D11Texture1D* QD3D11Texture::tex1D = nullptr

Definition at line 93 of file qrhid3d11_p.h.

Referenced by create(), createFrom(), destroy(), prepareCreate(), and textureResource().

◆ tex3D

ID3D11Texture3D* QD3D11Texture::tex3D = nullptr

Definition at line 92 of file qrhid3d11_p.h.

Referenced by create(), createFrom(), destroy(), prepareCreate(), and textureResource().

The documentation for this struct was generated from the following files: