DirectXTK12ダウンロード - DirectXTK12ソースコードのダウンロード

DirectXTK12

その他のソースコード

October 2024

ダウンロード

DirectX 12 用 DirectX ツールキット

http://go.microsoft.com/fwlink/?LinkID=615561

著作権 (c) Microsoft Corporation.

2024 年 10 月 28 日

このパッケージには、Windows 11 および Windows 10 のユニバーサル Windows プラットフォーム (UWP) アプリ、Xbox Series X|S および Xbox One のゲームタイトル、および Win32 用の Direct3D 12 C++ コードを作成するためのヘルパークラスのコレクションである「DirectX ツールキット」が含まれています。 Windows 11 および Windows 10 用のデスクトップアプリケーション。

このコードは、Visual Studio 2019 (16.11)、Visual Studio 2022、clang for Windows v12 以降、または MinGW 12.2 でビルドするように設計されています。 Visual Studio では、Windows 10 May 2020 Update SDK (19041) 以降を使用する必要があります。

これらのコンポーネントは、従来の DirectX SDK のコンテンツを必要とせずに動作するように設計されています。詳細については、「DirectX SDK はどこにありますか?」を参照してください。

ディレクトリのレイアウト

Inc
- パブリックヘッダーファイル (DirectX C++ 名前空間内):
  - Audio.h - XAudio2 (DirectXTK for Audio パブリックヘッダー) を使用した低レベルのオーディオ API
  - BufferHelpers.h - CPU データから D3D リソースを作成するための C++ ヘルパー
  - CommonStates.h - 一般的な D3D 状態の組み合わせ
  - DDSTextureLoader.h - 軽量の DDS ファイルテクスチャローダー
  - DescriptorHeap.h - DX12 記述子ヒープを管理するためのヘルパー
  - DirectXHelpers.h - D3D プログラミング用のその他の C++ ヘルパー
  - EffectPipelineStateDescription.h - PSO を作成するためのヘルパー
  - Effects.h - 一般的なレンダリングタスク用の組み込みシェーダーのセット
  - GamePad.h - Windows.Gaming.Input または GameInput を使用するゲームパッドコントローラーヘルパー
  - GeometricPrimitive.h - 立方体や球などの基本的な形状を描画します
  - GraphicsMemory.h - 動的グラフィックスメモリ割り当てを管理するためのヘルパー
  - Keyboard.h - キーボード状態追跡ヘルパー
  - Model.h - .CMO、.SDKMESH、または .VBO ファイルからロードされたメッシュを描画します
  - Mouse.h - マウスヘルパー
  - PostProcess.h - 一般的な後処理操作用の組み込みシェーダーのセット
  - PrimitiveBatch.h - ユーザープリミティブを描画するためのシンプルかつ効率的な方法
  - RenderTargetState.h - PSO の作成時にレンダーターゲットの要件を伝達するためのヘルパー
  - ResourceUploadBatch.h - GPU へのテクスチャリソースのアップロードを管理するためのヘルパー
  - ScreenGrab.h - 軽量のスクリーンショットセーバー
  - SimpleMath.h - DirectXMath 用の簡略化された C++ ラッパー
  - SpriteBatch.h - シンプルかつ効率的な 2D スプライトレンダリング
  - SpriteFont.h - ビットマップベースのテキストレンダリング
  - VertexTypes.h - 一般的に使用される頂点データ形式の構造体
  - WICTextureLoader.h - WIC ベースの画像ファイルテクスチャローダー
  - XboxDDSTextureLoader.h - DDSTextureLoader の Xbox 専用アプリのバリアント
Src
- DirectXTK ソースファイルと内部実装ヘッダー
Audio
- オーディオソースファイルおよび内部実装ヘッダー用の DirectXTK
build
- ビルドパイプラインの YAML ファイルと、その他のビルドファイルおよびスクリプトが含まれています。

MakeSpriteFont と XWBTool は、DirectX 11 用の DirectX ツールキットに含まれています。

ドキュメント

ドキュメントは GitHub wiki で入手できます。

お知らせ

このパッケージのすべてのコンテンツとソースコードには、MIT ライセンスの条件が適用されます。

DirectXTK12 の最新バージョンやバグレポートなどについては、GitHub のプロジェクトサイトをご覧ください。

DirectX 11 バージョンとの比較

Visual Studio Directed Graph Shader Language (DGSL) エフェクトシェーダ (つまりDGSLEffect ) はサポートされていません。 CMO ファイルは、BasicEffect または SkinnedEffect マテリアルを使用してロードされます。
VertexTypes には、DGSL パイプラインでの使用を目的とした VertexPositionNormalTangentColorTexture または VertexPositionNormalTangentColorTextureSkinning は含まれていません。
DirectX 11 用の DirectX ツールキットは機能レベル 9.x をサポートしますが、DirectX 12 には Direct3D 機能レベル 11.0 が必要です。下位機能レベルのデバイス用に予期される DirectX 12 ドライバーはありません。
このライブラリは、Windows 10 (別名_WIN32_WINNT=0x0A00 ) 用にビルドされていることを前提としているため、XAudio 2.9 と WIC2、および DirectX 12 を利用します。
オーディオ、ゲームパッド、キーボード、マウス、SimpleMath 用の DirectX ツールキットは、DirectX 11 バージョンと同じです。

リリースノート

セキュリティアドバイザリについては、GitHub を参照してください。

完全な変更履歴については、CHANGELOG.md を参照してください。

2024 年 6 月のリリースでは、 BufferHelpersのCreateUploadBuffer関数のデフォルトのパラメーターinitialStateが削除されました。 DirectX 12 検証レイヤーごとに、アップロードバッファーの有効な初期状態はD3D12_RESOURCE_STATE_GENERIC_READのみです。
2023 年 2 月のリリース以降、相対的なマウス移動の Mouse クラスの実装が更新され、 GetStateの呼び出し間の変更が蓄積されました。デフォルトでは、 GetState呼び出すたびにデルタがリセットされます。これは、相対移動を使用するがフレームごとにメソッドを 1 回だけ呼び出すシナリオで機能します。フレームごとに複数回呼び出す場合は、明示的な呼び出しをEndOfInputFrameに追加して、代わりに明示的なリセットモデルを使用します。
2022 年 9 月リリースの時点で、ライブラリは、 DirectX ツールキットの DirectX 11 および DirectX 12 バージョンで同じ名前を持つさまざまな型に対して C++11 インライン名前空間を使用します。これにより、リンカー出力メッセージに表示されるDirectX::DX12::SpriteBatchなどのリンク固有の名前が提供されます。ただし、ほとんどの使用例では、クライアントコードに明示的なDX12名前空間解決を追加する必要はありません。
2021 年 6 月のリリース以降、このライブラリは DXC 経由で Shader Model 6 を使用して HLSL シェーダーを構築します。詳細については、この Wiki ページを参照してください。 Microsoft GDK プロジェクトは常に Shader Model 6 を使用してきました。
2020 年 6 月のリリース以降、このライブラリは、 C++ 標準セクション17.5.2.1.3 ビットマスクタイプの推奨に従って、型付き列挙型ビットマスクフラグを使用します。これにより、クライアントコードに重大な変更が影響する可能性があります。
- フラグ値として0リテラルを渡すことはできません。代わりに、適切なデフォルト列挙値 ( AudioEngine_Default 、 SoundEffectInstance_Default 、 ModelLoader_Clockwise 、 DDS_LOADER_DEFAULT 、またはWIC_LOADER_DEFAULTを使用する必要があります。
- ビットマスク操作を使用してローカルでフラグ値を構築する場合は、 DWORDの代わりに列挙型を使用します。たとえば、 WIC_LOADER_FLAGS flags = WIC_LOADER_DEFAULT; if (...) flags |= WIC_LOADER_FORCE_SRGB;
UWP プロジェクトと Win10 クラシックデスクトッププロジェクトには、ARM64 プラットフォームの構成が含まれています。これらを構築するには、ARM64 ツールセットをインストールする必要があります。
ARM64/AArch64 開発の場合は、VS 2019 ツールセットよりも VS 2022 コンパイラーを強く推奨します。 Windows SDK (26100 以降) は、ARM64 開発における Win32 用の VS 2019 と互換性がありません。 ARM32/AArch32 プラットフォームは非推奨であることに注意してください。
ARM64/AArch64 プラットフォームで Clang/LLVM を使用する場合は、Windows 11 SDK (22000) 以降が必要です。
CompileShaders.cmdスクリプトには Windows スタイル (CRLF) の行末が必要です。 Linux スタイル (LF) の行末に変更すると、必要なシェーダーをすべてビルドできない可能性があります。

サポート

質問がある場合は、 directxtkタグを使用した Stack Overflow の使用、またはdx12-developersチャネルの DirectX Discord Server の使用を検討してください。

バグレポートや機能リクエストについては、このプロジェクトの GitHub 問題を使用してください。

貢献する

このプロジェクトは貢献と提案を歓迎します。ほとんどの投稿では、投稿を使用する権利をお客様が有しており、実際に当社に付与することを宣言する投稿者ライセンス契約 (CLA) に同意する必要があります。詳細については、https://cla.opensource.microsoft.com をご覧ください。

プルリクエストを送信すると、CLA ボットが CLA を提供する必要があるかどうかを自動的に判断し、PR を適切に装飾します (ステータスチェック、コメントなど)。ボットが提供する指示に従ってください。 CLA を使用するすべてのリポジトリでこれを 1 回行うだけで済みます。

新機能のテストも PR としてテストスイートリポジトリに送信する必要があります。

行動規範

このプロジェクトはマイクロソフトのオープンソース行動規範を採用しています。詳細については、「行動規範に関するよくある質問」を参照するか、追加の質問やコメントがあれば [email protected] までお問い合わせください。

商標

このプロジェクトには、プロジェクト、製品、またはサービスの商標またはロゴが含まれている場合があります。 Microsoft の商標またはロゴの許可された使用には、Microsoft の商標およびブランドガイドラインが適用され、それに従わなければなりません。このプロジェクトの修正バージョンで Microsoft の商標またはロゴを使用することは、混乱を引き起こしたり、Microsoft のスポンサーであることを暗示したりしてはなりません。第三者の商標またはロゴの使用には、それらの第三者のポリシーが適用されます。