Add D3D12 GPU backend. #1437
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,66 @@ | ||
| ///////////////////////////////////////////////////////////////////////////////////////////////// | ||
| // | ||
| // Tencent is pleased to support the open source community by making tgfx available. | ||
| // | ||
| // Copyright (C) 2026 Tencent. All rights reserved. | ||
| // | ||
| // Licensed under the BSD 3-Clause License (the "License"); you may not use this file except | ||
| // in compliance with the License. You may obtain a copy of the License at | ||
| // | ||
| // https://opensource.org/licenses/BSD-3-Clause | ||
| // | ||
| // unless required by applicable law or agreed to in writing, software distributed under the | ||
| // license is distributed on an "as is" basis, without warranties or conditions of any kind, | ||
| // either express or implied. see the license for the specific language governing permissions | ||
| // and limitations under the license. | ||
| // | ||
| ///////////////////////////////////////////////////////////////////////////////////////////////// | ||
|
|
||
| #pragma once | ||
|
|
||
| #include "tgfx/gpu/Device.h" | ||
|
|
||
| namespace tgfx { | ||
|
|
||
| /** | ||
| * The D3D12 interface for drawing graphics. | ||
| */ | ||
| class D3D12Device : public Device { | ||
| public: | ||
| /** | ||
| * Creates a new D3D12Device using the default hardware adapter. Returns nullptr if D3D12 is not | ||
| * available. | ||
| */ | ||
| static std::shared_ptr<D3D12Device> Make(); | ||
|
|
||
| /** | ||
| * Creates a new D3D12Device backed by the WARP software rasterizer. WARP is a CPU-based D3D12 | ||
| * implementation that ships with Windows; it is functionally complete (feature level 12_1) but | ||
| * orders of magnitude slower than a real GPU. Intended for headless CI runners and other | ||
| * environments without a usable hardware adapter — do not rely on it for performance work. | ||
| * Returns nullptr if WARP is unavailable on the current system. | ||
| */ | ||
| static std::shared_ptr<D3D12Device> MakeWarp(); | ||
|
|
||
| /** | ||
| * Creates a new D3D12Device from an existing ID3D12Device. The device parameter is a pointer to | ||
| * an ID3D12Device object. Returns nullptr if the device is invalid. | ||
| */ | ||
| static std::shared_ptr<D3D12Device> MakeFrom(void* device); | ||
|
|
||
| ~D3D12Device() override; | ||
|
|
||
| /** | ||
| * Returns the underlying ID3D12Device as a raw pointer. | ||
| */ | ||
| void* d3d12Device() const; | ||
|
|
||
| protected: | ||
| bool onLockContext() override; | ||
| void onUnlockContext() override; | ||
|
|
||
| private: | ||
| explicit D3D12Device(std::unique_ptr<class D3D12GPU> gpu); | ||
| }; | ||
|
|
||
| } // namespace tgfx | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,60 @@ | ||
| ///////////////////////////////////////////////////////////////////////////////////////////////// | ||
| // | ||
| // Tencent is pleased to support the open source community by making tgfx available. | ||
| // | ||
| // Copyright (C) 2026 Tencent. All rights reserved. | ||
| // | ||
| // Licensed under the BSD 3-Clause License (the "License"); you may not use this file except | ||
| // in compliance with the License. You may obtain a copy of the License at | ||
| // | ||
| // https://opensource.org/licenses/BSD-3-Clause | ||
| // | ||
| // unless required by applicable law or agreed to in writing, software distributed under the | ||
| // license is distributed on an "as is" basis, without warranties or conditions of any kind, | ||
| // either express or implied. see the license for the specific language governing permissions | ||
| // and limitations under the license. | ||
| // | ||
| ///////////////////////////////////////////////////////////////////////////////////////////////// | ||
|
|
||
| #pragma once | ||
|
|
||
| #include <cstdint> | ||
| #include <type_traits> | ||
|
|
||
| namespace tgfx { | ||
| /** | ||
| * Types for interacting with D3D12 textures created externally to TGFX. | ||
| */ | ||
| struct D3D12TextureInfo { | ||
| /** | ||
| * Pointer to an ID3D12Resource object representing a texture. | ||
| */ | ||
| const void* resource = nullptr; | ||
|
|
||
| /** | ||
| * The pixel format of this texture (DXGI_FORMAT value). | ||
| */ | ||
| unsigned format = 0; // DXGI_FORMAT_UNKNOWN | ||
| }; | ||
|
|
||
| /** | ||
| * Types for interacting with D3D12 synchronization objects created externally to TGFX. | ||
| */ | ||
| struct D3D12SyncInfo { | ||
| /** | ||
| * Pointer to an ID3D12Fence object. | ||
| */ | ||
| const void* fence = nullptr; | ||
|
|
||
| /** | ||
| * The signal value for the fence. | ||
| */ | ||
| uint64_t value = 0; | ||
| }; | ||
|
Collaborator
There was a problem hiding this comment. 【P14 中】缺少与 证据： static_assert(std::is_trivially_copyable_v<VulkanImageInfo>);
static_assert(std::is_trivially_copyable_v<VulkanSyncInfo>);
static_assert(std::is_standard_layout_v<VulkanImageInfo>);
static_assert(std::is_standard_layout_v<VulkanSyncInfo>);本文件没有等价校验。 影响：未来若有人为 建议：在文件结尾加四条： static_assert(std::is_trivially_copyable_v<D3D12TextureInfo>);
static_assert(std::is_trivially_copyable_v<D3D12SyncInfo>);
static_assert(std::is_standard_layout_v<D3D12TextureInfo>);
static_assert(std::is_standard_layout_v<D3D12SyncInfo>); |
||
|
|
||
| static_assert(std::is_trivially_copyable_v<D3D12TextureInfo>); | ||
| static_assert(std::is_trivially_copyable_v<D3D12SyncInfo>); | ||
| static_assert(std::is_standard_layout_v<D3D12TextureInfo>); | ||
| static_assert(std::is_standard_layout_v<D3D12SyncInfo>); | ||
|
|
||
| } // namespace tgfx | ||
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
注释未说明
device参数的具体类型（ID3D12Device*）和所有权语义。调用者不清楚：1）void*实际指向何种类型；2）tgfx 是否对该对象调用 AddRef，以及何时/是否调用 Release。建议补全，例如：@param device A pointer to an existing ID3D12Device. The caller retains ownership; tgfx internally calls QueryInterface (AddRef) and releases its own reference when the D3D12Device is destroyed.