如何为DirectX-Graphics-Samples做贡献：新手参与开源项目的完整指南
项目地址: https://gitcode.com/gh_mirrors/di/DirectX-Graphics-Samples DirectX-Graphics-Samples是一个展示如何在Windows上构建图形密集型应用程序的开源项目，包含丰富的DirectX图形示例。本指南将帮助新手轻松入门并参与到这个项目的贡献中，无论你是编程新手还是有一定经验的开发者，都能在这里找到适合自己的贡献方式。
了解项目结构与核心功能
DirectX-Graphics-Samples项目结构清晰，包含多个重要部分。其中，Libraries目录下的D3D12RaytracingFallback是一个在没有原生驱动/硬件支持的设备上模拟DirectX光线追踪（DXR）API的库，它作为DirectX 12 API的包装器，具有与DXR API相似的接口，当存在驱动程序支持时，还会重定向到DXR API，方便开发者无需分支代码即可同时支持DXR API。
如图所示，这是MiniEngine中加速结构的可视化效果，展示了项目在图形渲染方面的核心功能和技术实现。
贡献前的准备工作
环境搭建
要构建和运行Fallback Layer，你需要满足以下条件：
- Windows 10 秋季创意者更新或更高版本。
- Visual Studio 2017 版本 15.8.4 或更高。
- Windows 10 秋季创意者更新 SDK 或更高。
- 具有零售DXIL功能的显卡。
- 从最新的Windows SDK中获取DXIL.dll以伴随编译器或启用开发者模式。
- 下载DXR Fallback Compiler，可从项目发布页面获取DirectXRaytracingBinariesV1.5.zip。
获取项目代码
首先，你需要克隆项目仓库，在命令行中执行以下命令：
git clone https://gitcode.com/gh_mirrors/di/DirectX-Graphics-Samples
贡献的多种方式
提供一般反馈和参与讨论
如果你有一般的反馈或想参与项目讨论，可以通过访问http://www.directxtech.com/来与项目团队和其他开发者交流。
报告错误和提出功能请求
当你遇到bug或有功能需求时，可以在项目的issue页面提交问题，地址为：https://github.com/Microsoft/DirectX-Graphics-Samples/issues。在提交issue时，尽量详细地描述问题或需求，包括重现步骤、预期结果等，以便开发团队更好地理解和解决问题。
贡献代码和内容
这是参与项目贡献的重要方式，大多数贡献都需要你同意贡献者许可协议（CLA），声明你有权并且确实授予项目使用你的贡献的权利。详细信息可访问https://cla.microsoft.com。
当你提交拉取请求时，CLA机器人会自动确定你是否需要提供CLA，并对PR进行适当的标记和评论。你只需按照机器人提供的说明操作即可，并且在所有使用该CLA的仓库中，你只需执行一次此操作。
此外，该项目采用了Microsoft Open Source Code of Conduct，如有其他问题或意见，可联系opencode@microsoft.com。
开发与提交贡献的流程
开发前的学习
在开始开发前，建议查阅项目的开发者指南，了解使用Fallback Layer开发应用程序的详细信息，这将帮助你更好地理解项目的开发规范和要求。
代码开发与测试
根据自己的兴趣和能力，选择合适的功能模块或bug进行开发。在开发过程中，要遵循项目的编码规范和最佳实践，确保代码的质量和可维护性。完成代码编写后，进行充分的测试，确保代码能够正常运行，并且不会引入新的问题。
提交拉取请求
当你完成代码开发和测试后，就可以提交拉取请求了。在提交前，确保你的代码已经同步了项目的最新代码，以避免冲突。提交拉取请求时，清晰地描述你的贡献内容，包括实现的功能、解决的问题等，方便项目维护者进行审核。
贡献中的注意事项
遵循代码规范
项目有其特定的编码规范，在贡献代码时，要严格遵循这些规范，包括代码风格、命名约定等，以保证项目代码的一致性。
关注驱动要求
项目对驱动有一定的要求，包括零售支持DXIL和资源绑定层级3，在开发和测试过程中要确保你的环境满足这些要求，以避免出现兼容性问题。
如图所示，这是Fallback Layer加速结构构建原始缓冲区的相关信息，展示了项目在底层实现中的细节，有助于你更好地理解项目的技术架构。
通过以上步骤，你就可以顺利地为DirectX-Graphics-Samples项目做出贡献了。无论你是提供反馈、报告问题还是贡献代码，都将对项目的发展起到重要的作用。赶快行动起来，加入到这个开源项目的贡献者行列吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
