Revision control

++ // Copyright (C) 2025 The Qt Company Ltd.
++ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
++
++ #ifndef QWINDOWSD3D11TESTDEVICECONTEXT_P_H
++ #define QWINDOWSD3D11TESTDEVICECONTEXT_P_H
++
++ //
++ // W A R N I N G
++ // -------------
++ //
++ // This file is not part of the Qt API. It exists purely as an
++ // implementation detail. This header file may change from version to
++ // version without notice, or even be removed.
++ //
++ // We mean it.
++ //
++
++ #include <QtCore/qbytearray.h>
++ #include <QtCore/qbytearrayview.h>
++ #include <QtCore/qsize.h>
++ #include <QtCore/private/qcomptr_p.h>
++ #include <QtCore/private/qexpected_p.h>
++ #include <QtGui/qcolor.h>
++
++ #include <vector>
++
++ #include <d3d11_1.h>
++
++ QT_BEGIN_NAMESPACE
++ class QRhi;
++ QT_END_NAMESPACE
++
++ template <typename T>
++ using ComResult = q23::expected<T, HRESULT>;
++
++ // Shared D3D11 device fixture for Windows-only multimedia unit tests.
++ struct QWindowsD3D11TestDeviceContext
++ {
++ ComPtr<ID3D11Device1> device;
++ ComPtr<ID3D11DeviceContext> context;
++
++ ComResult<QColor> getFirstPixelColor(const ComPtr<ID3D11Texture2D> &texture) const;
++
++ // Like getFirstPixelColor, but interprets the pixel bytes in B,G,R,A order (for
++ // DXGI_FORMAT_B8G8R8A8_UNORM textures).
++ ComResult<QColor> getFirstPixelColorBGRA(const ComPtr<ID3D11Texture2D> &texture) const;
++
++ ComResult<ComPtr<ID3D11Texture2D>> createTextureArray(QSize size,
++ const std::vector<QColor> &colors) const;
++
++ bool isTextureFormatSupported(DXGI_FORMAT format) const;
++
++ // Creates an uninitialized single-plane NV12 texture, e.g. for structural (plane
++ // count/size/format) tests that don't need to verify pixel contents.
++ ComResult<ComPtr<ID3D11Texture2D>> createNV12Texture(QSize size) const;
++
++ // Fills an NV12 texture's luma plane with lumaValue and its interleaved chroma plane with
++ // (chromaUValue, chromaVValue), e.g. for pixel round-trip tests. If texture is a texture
++ // array (e.g. a pooled decoder surface), arraySlice selects which slice to fill.
++ HRESULT fillNV12Texture(const ComPtr<ID3D11Texture2D> &texture, QSize size, quint8 lumaValue,
++ quint8 chromaUValue, quint8 chromaVValue, UINT arraySlice = 0) const;
++
++ // Creates a single-plane NV12 texture with a uniform luma/chroma value, for tests that
++ // verify actual color conversion.
++ ComResult<ComPtr<ID3D11Texture2D>>
++ createFilledNV12Texture(QSize size, quint8 lumaValue, quint8 chromaU, quint8 chromaV) const;
++
++ // Same as createNV12Texture, but for a 10-bit P010 surface.
++ ComResult<ComPtr<ID3D11Texture2D>> createP010Texture(QSize size) const;
++
++ // Same as fillNV12Texture, but for a 10-bit P010 surface: each 16-bit sample holds its value
++ // left-shifted into the high bits (FFmpeg's P010 convention).
++ HRESULT fillP010Texture(const ComPtr<ID3D11Texture2D> &texture, QSize size, quint16 lumaValue,
++ quint16 chromaUValue, quint16 chromaVValue, UINT arraySlice = 0) const;
++
++ // Creates an uninitialized single-plane texture in the given (non-planar) format, e.g. for
++ // structural tests of a packed hw pixel format.
++ ComResult<ComPtr<ID3D11Texture2D>> createSinglePlaneTexture(QSize size,
++ DXGI_FORMAT format) const;
++
++ // Fills a single-plane texture uniformly by repeating texel across every pixel.
++ HRESULT fillSinglePlaneTexture(const ComPtr<ID3D11Texture2D> &texture, QSize size,
++ QByteArrayView texel, UINT arraySlice = 0) const;
++
++ // Reads back "height" rows of "width" texels ("texelSize" bytes each), tightly packed (row
++ // padding from the texture's native row pitch is stripped), starting "rowOffset" rows into
++ // the given array slice. Suitable for verifying any plane of any pixel format, e.g. the
++ // second (chroma) plane of a planar format by passing rowOffset = the first plane's height.
++ ComResult<QByteArray> readPlaneRows(const ComPtr<ID3D11Texture2D> &texture, int rowOffset,
++ int width, int height, int texelSize,
++ UINT arraySlice = 0) const;
++
++ private:
++ // Function to set the pixels of an ID3D11Texture2D texture to red
++ HRESULT fillTextureWithColors(const ComPtr<ID3D11Texture2D> &texture,
++ const std::vector<QColor> &colors) const;
++
++ // Creates a single-slice staging texture with the given CPU access, holding a copy of
++ // 'arraySlice' of 'texture'. Only that slice is copied: copying a whole multi-slice planar
++ // texture array created with D3D11_BIND_DECODER, like FFmpeg's decoder pool, removes the
++ // device on some drivers (seen on AMD).
++ ComResult<ComPtr<ID3D11Texture2D>>
++ createStagingSliceCopy(const ComPtr<ID3D11Texture2D> &texture, UINT arraySlice,
++ UINT cpuAccessFlags) const;
++ };
++
++ // Creates a device context using a hardware D3D11 adapter.
++ ComResult<QWindowsD3D11TestDeviceContext> createD3D11TestDeviceContext();
++
++ // Creates a device context using the software (WARP) D3D11 adapter, e.g. to test behavior
++ // with a QRhi that reports QRhiDriverInfo::CpuDevice.
++ ComResult<QWindowsD3D11TestDeviceContext> createWarpD3D11TestDeviceContext();
++
++ // Get QWindowsD3D11TestDeviceContext from QRhi instance
++ ComResult<QWindowsD3D11TestDeviceContext> wrapRhiD3D11Device(QRhi &rhi);
++
++ #endif // QWINDOWSD3D11TESTDEVICECONTEXT_P_H