Auto Vk Toolkit

Auto-VK-Toolkit v1.0

Auto-VK-Toolkit เป็นกรอบสำหรับ Vulkan Graphics API ซึ่งใช้ใน C ++ ที่ทันสมัย มันมีจุดมุ่งหมายที่จะตีจุดที่น่าสนใจระหว่างโปรแกรมเมอร์--ความสามารถในการประชุมและประสิทธิภาพในขณะที่ยังคงสนับสนุนฟังก์ชั่น Vulkan เต็มรูปแบบ เพื่อให้บรรลุเป้าหมายนี้เฟรมเวิร์กนี้ใช้ Auto-VK ความสะดวกสบายและเลเยอร์การผลิตบน Vulkan-HPP

Auto-VK-Toolkit ถูกนำมาใช้อย่างประสบความสำเร็จในการสร้างต้นแบบอย่างรวดเร็วการวิจัย (เช่นขอบเขต meshlet อนุรักษ์นิยมสำหรับการกำจัดที่แข็งแกร่งของตาข่ายที่มีผิวหนังการแสดงผลอย่างรวดเร็วของวัตถุพารามิเตอร์บน GPU ที่ทันสมัย) และการสอน (เช่นอัลกอริธึมสำหรับการแสดงผลจริง)

ภาพนี้นำเสนองานบางอย่างที่ได้รับการพัฒนาโดยใช้ Auto-VK-Toolkit (จากซ้ายไปขวา): การใช้งานในหลักสูตรกราฟิกขั้นสูงสำหรับการสอนแนวคิด GPU ระดับต่ำที่ทันสมัย การสร้างภาพของ 19,600 ฮาร์มอนิกส์ทรงกลมออกมาจากการสแกนสมอง การแบ่งของตาข่ายเป็น meshlets และแสดงผลด้วยการเลือกมุมมองที่ดีและ backface culling ในงานและเฉดสีตาข่าย; Ray Traced Shadows and Reflections โดยใช้อุปกรณ์ติดตามอุปกรณ์เรย์เวลาเรียลไทม์ที่เร่งความเร็วแบบฮาร์ดแวร์ การแสดงผลของเส้นโค้งเส้นใยที่กำหนดพารามิเตอร์ 358K แบบเรียลไทม์

บางส่วนของคุณสมบัติ (นอกเหนือจากคุณสมบัติที่ยอดเยี่ยมของ Auto-VK ) รวมถึง:

• การจัดการหน้าต่างและการจัดการอินพุตผ่าน GLFW
• Render Framework พร้อม update() และ render() การเรียกกลับที่แตกต่างกันหรือแก้ไขเวลาอัปเดต
• Auto -VK ที่ทรงพลัง - avk::root พร้อมการจัดการโซ่แลกเปลี่ยนและการจัดการอายุการใช้งานทรัพยากรอัตโนมัติ
• อัพเดทอเนกประสงค์ที่เปิดใช้งานสันทนาการ Swapchain
• เมื่อใช้ร่วมกับเครื่องมือ สร้างตัวช่วยโพสต์ ที่ทรงพลัง (Windows-only) Updater จะเปิดใช้งานการโหลดซ้ำของ Shader
• การโหลดแบบจำลองของฉาก 3 มิติที่หลากหลายด้วยความช่วยเหลือของ Assimp
• การโหลดไฟล์ .fscene จาก ORCA: Open Research Content Archive
• การโหลดรูปแบบภาพมากมายรวมถึงแผนที่ลูกบาศก์
• การสนับสนุน serializer อเนกประสงค์ที่ช่วยให้ทรัพยากร Vulkan เป็นอนุกรมเช่น avk:buffer หรือ avk::image และประเภทที่กำหนดเอง; ขึ้นอยู่กับซีเรียล
• การสนับสนุนส่วนต่อประสานผู้ใช้ผ่าน IMGUI ด้วยการสนับสนุนสำหรับการแสดงพื้นผิวใน UI
• รองรับการติดตามเรย์แบบเรียลไทม์ (RTX) และการสร้างโครงสร้างการเร่งความเร็วที่สะดวกจากตาข่ายสามเหลี่ยมหรือ AABBS
• การสนับสนุนสำหรับการแบ่งตาข่ายเป็น meshlets ซึ่งสามารถแสดงผลด้วยงานและเฉดสีตาข่าย
• การจัดการลำดับชั้นของกระดูกรองรับภาพเคลื่อนไหวของตาข่ายผิวหนัง

สารบัญ

• การติดตั้ง
  • Visual Studio 2022
    • ความต้องการ
    • การตั้งค่าและสร้างคำแนะนำ
    • ตั้งค่าโครงการของคุณเอง
  • cmake
• ตัวอย่าง
• การสร้างโครงการใหม่
• การจัดการทรัพยากรและการสร้างโพสต์สร้างตัวช่วย
• ความแตกต่างระหว่าง Auto-VK-Toolkit และ Auto-VK คืออะไร?
• เอกสาร
• คำถามที่พบบ่อยปัญหาที่รู้จักการแก้ไขปัญหา

การติดตั้ง

Auto-VK-Toolkit พร้อมที่จะไปกับ Visual Studio หรือ CMake หากระบบของคุณตรงตามข้อกำหนดของระบบทุกอย่างจะถูกตั้งค่าเพื่อสร้างการวิ่งออกจากกล่อง เช่นสำหรับ Visual Studio ให้เปิด visual_studio/auto_vk_toolkit.sln ตั้งค่าหนึ่งในโครงการตัวอย่างเป็นโครงการเริ่มต้นสร้างและเรียกใช้!

คำแนะนำ: เวอร์ชันใน สาขาการพัฒนา อาจเป็นข้อมูลล่าสุดและมีคุณสมบัติและการแก้ไขเพิ่มเติม โปรดพิจารณาใช้เวอร์ชันนั้นโดยเฉพาะถ้าคุณพบปัญหา

หมายเหตุ: ในการรันครั้งแรกเครื่องมือ สร้างโพสต์ จะถูกสร้างขึ้น ดูแท็บ "เอาต์พุต" ของ Visual Studio สำหรับข้อความสถานะและคำแนะนำที่เป็นไปได้

Visual Studio 2022

การตั้งค่าโครงการที่กำหนดค่าไว้ล่วงหน้ามีไว้สำหรับ Visual Studio 2022 บน Windows

ความต้องการ

• Windows 10 หรือ 11
• Visual Studio 2022 พร้อมการติดตั้ง Windows 10 หรือ 11 SDK (สำหรับข้อมูลรายละเอียดเกี่ยวกับการตั้งค่าโครงการและการจัดการทรัพยากรโปรดดูที่ visual_studio/README.md )
• Vulkan 1.3 SDK จาก Lunarg, Vulkan SDK ที่เหมาะสมที่สุด 1.3.250.0 หรือใหม่กว่า

การตั้งค่าและสร้างคำแนะนำ

• โคลนหรือดาวน์โหลดที่เก็บนี้
• ดำเนินการ git submodule update --init เพื่อดึงเฟรมเวิร์ ก Auto-VK ซึ่งเพิ่มเป็น submodule ภายใต้ auto_vk
• ดาวน์โหลดและติดตั้งหนึ่งใน Vulkan SDKS ล่าสุดสำหรับ Windows!
  • เลือก Vulkan Memory Allocator header. ตัวเลือกเพื่อให้มีการติดตั้งไลบรารี Vulkan Memory Allocator (VMA)
  • หมายเหตุ: VMA สามารถติดตั้งได้ผ่านตัวติดตั้ง Vulkan หรือเครื่องมือบำรุงรักษา (เช่น maintenancetool.exe บน Windows) โดยเลือก Vulkan Memory Allocator header. ตัวเลือก.
• ดาวน์โหลดและติดตั้ง Visual Studio Community 2022 หรือรุ่นใหม่กว่า
  • เลือก Desktop development with C++ ในตัวติดตั้ง!
• แนะนำ: ติดตั้งส่วนขยายการรวมภาษา GLSL สำหรับการไฮไลต์ไวยากรณ์ในไฟล์ shader!
  • คำแนะนำ: ไปที่ Tools -> Options -> GLSL language integration สำหรับการพัฒนา Vulkan Shader ไม่ว่าจะเป็นการ Live compiling เป็น False (การไฮไลต์ไวยากรณ์เท่านั้น) หรือตั้ง External compiler executable file เป็นเช่นเส้นทางไปยัง glslangValidator.exe !
• เปิดไฟล์ Visual Studio Solution visual_studio/auto_vk_toolkit.sln และสร้างโซลูชัน
• ในระหว่างการสร้างคุณจะรับรู้ข้อความจาก โพสต์บิลด์เครื่องมือตัวช่วย ใน Output ของ Visual Studio, ข้อความป๊อปอัปและไอคอนในถาดระบบ โปรดดูที่การจัดการทรัพยากรส่วนและตัวช่วยสร้างโพสต์สำหรับข้อมูลเพิ่มเติม
• แอปพลิเคชันตัวอย่างหลายตัวอย่างมีอยู่ในไฟล์โซลูชัน ตั้งหนึ่งในนั้นเป็นโครงการเริ่มต้นและเรียกใช้

ตั้งค่าโครงการของคุณเอง

• ในการเพิ่ม Auto-VK-Toolkit ให้กับหนึ่งในที่เก็บที่กำหนดเองของคุณคุณอาจต้องการเพิ่มเป็น submodule Git คุณสามารถเรียกใช้ git submodule add https://github.com/cg-tuwien/Auto-Vk-Toolkit.git auto_vk_toolkit เพื่อเพิ่ม auto-vk-toolkit เป็น submodule ในไดเรกทอรี auto_vk_toolkit
• ดำเนินการ git submodule update --init --recursive เพื่อดึงทั้งสอง Auto-VK-Toolkit และ Auto-VK
• ขั้นตอนที่อธิบายไว้ภายใต้ส่วนการสร้างโครงการใหม่อาจเป็นประโยชน์สำหรับการตั้งค่าโครงการ Visual Studio ที่กำหนดเองซึ่งเชื่อมโยงกับ Auto-VK-Toolkit
• วิธีที่สะดวกที่สุดในการตั้งค่าโครงการของคุณเองอาจเป็นหนึ่งในเทมเพลตเริ่มต้น:
  • เทมเพลตเริ่มต้นสำหรับโครงการที่ใช้ Visual Studio: Auto-VK-Toolkit-VS-Starter
  • เทมเพลตเริ่มต้นสำหรับโครงการที่ใช้ CMake: Auto-VK-Toolkit-Starter

cmake

โปรดดู docs/cmake.md!

ตัวอย่าง

สวัสดีโลก	หลายคิว	คำนวณการประมวลผลภาพ	orca loader

แอปพลิเคชันตัวอย่างหลายตัวอย่างรวมอยู่ในที่เก็บนี้:

• สวัสดีโลก: วิธีแสดงสามเหลี่ยมเดี่ยว
• บัฟเฟอร์จุดสุดยอด: วิธีใช้บัฟเฟอร์จุดสุดยอดกับท่อกราฟิก
• FrameBuffer: วิธีการสร้างและใช้ Framebuffers
• การเรนเดอร์หลายรายการ: วิธีใช้หลายครั้ง
• หลาย Qeues: วิธีใช้หลายคิว (การถ่ายโอนสองครั้งและคิวกราฟิกหนึ่งคิว)
• การคำนวณการประมวลผลภาพ: วิธีการใช้ Shaders Compute สำหรับการประมวลผลภาพบางอย่าง
• นำเสนอจากการคำนวณ: วิธีการนำเสนอไปยังห่วงโซ่แลกเปลี่ยนจากคิวการคำนวณ
• โมเดลโหลดเดอร์: วิธีโหลดโมเดล 3 มิติจากไฟล์และแสดงผล
• Orca Loader: วิธีโหลดไฟล์ orca .fscene และแสดงผล นอกจากนี้วิธีการใช้ serializer
• meshlets แบบคงที่: วิธีแบ่งโมเดล 3 มิติเป็น meshlets ขนาดเล็กและแสดงผลโดยใช้งานและเฉดสีตาข่าย
• Meshlets Skinned: วิธีแบ่งโมเดล 3 มิติที่มีภาพเคลื่อนไหวและสกินออกเป็น meshlets ขนาดเล็กและวิธีการเคลื่อนไหวและแสดงผลที่ใช้งานและ Shaders ตาข่าย
• การติดตามเรย์ด้วยเงาและ AO: วิธีการสร้างโครงสร้างการเร่งความเร็วจากตาข่ายสามเหลี่ยมและสร้างภาพเรย์ นอกจากนี้ยังเพิ่มเงาเรย์ที่ติดตามและรุ่นที่ง่ายมาก (และน่าเกลียด) ของการอุดตันโดยรอบไปยังผลลัพธ์ที่แสดงผลโดยการติดตามเรย์แบบเรียกซ้ำจาก Shaders ที่ใกล้เคียงที่สุด
• การสืบค้นเรย์ในเรย์เรย์สแรนเดอร์: คล้ายกับตัวอย่าง "การติดตามเรย์กับเงาและ AO" แต่แทนที่จะติดตามเรย์เรย์แบบเรียกซ้ำด้วยตารางการผูกมัด shader ฯลฯ มันใช้การสืบค้นเรย์จาก shaders ฮิตที่ใกล้เคียงที่สุด
• การติดตามการแยกแบบกำหนดเองของเรย์: วิธีการสร้างโครงสร้างการเร่งความเร็วจาก AABBS และจากตาข่ายสามเหลี่ยม
• พื้นผิว cubemap: วิธีการโหลดและใช้แผนที่ลูกบาศก์

meshlets ผิวหนัง	Ray Query และการติดตามเรย์	ทางแยกที่กำหนดเอง RTX	พื้นผิว cubemap

การสร้างโครงการใหม่

สำหรับโครงการ Visual Studio มีเครื่องมือความสะดวกสบายภายใต้ visual_studio/tools/executables/ ที่สามารถช่วยในการตั้งค่าโครงการใหม่ได้อย่างรวดเร็วโดยการคัดลอกโครงการที่มีอยู่ (เช่นหนึ่งในแอปพลิเคชันตัวอย่าง): create_new_project.exe

ใช้มันเหมือนติดตามเพื่อสร้างสำเนาของโครงการที่มีอยู่:

• เปิด create_new_project.exe และเลือกหนึ่งในแอปพลิเคชันตัวอย่างหรือป้อนเส้นทางไปยังโครงการเพื่อคัดลอกด้วยตนเอง
• ป้อนตำแหน่งเป้าหมายชื่อโครงการเป้าหมายและกด [สร้างมัน!] -Button
• โครงการถูกคัดลอกไปยังโฟลเดอร์เป้าหมายและเส้นทางที่สัมพันธ์กันทั้งหมดจะถูกปรับให้เข้ากับตำแหน่งใหม่หากโฟลเดอร์เป้าหมายอยู่ในไดรฟ์เดียวกับโครงการต้นทาง (ถ้าไม่ใช่เส้นทางที่สมบูรณ์จะถูกตั้งค่า)
• การอ้างอิงสินทรัพย์และการอ้างอิง Shader จะถูกเก็บรักษาไว้และเส้นทางของพวกเขาจะถูกปรับ
  ความสนใจ: ตรวจสอบให้แน่ใจว่าได้ลบการอ้างอิงที่มีอยู่หากคุณกำลังจะแก้ไขสินทรัพย์/shaders ที่อ้างอิง! คุณจะต้องสร้างสำเนาของไฟล์เหล่านี้ด้วยตนเองและเพิ่มการอ้างอิงไปยังสำเนาแทน หากคุณล้มเหลวในการทำเช่นนั้นคุณจะต้องแก้ไขสินทรัพย์สต็อกหรือไฟล์ shader ของตัวอย่าง
• ส่วนหัวที่คอมไพล์ Precompiled ถูกปิดใช้งานในสำเนาโครงการที่สร้างขึ้นใหม่ หากคุณต้องการใช้คุณสมบัตินี้คุณจะต้องเปิดใช้งานด้วยตนเองในการตั้งค่าโครงการของ Visual Studio
• เพิ่มการอ้างอิงด้วยตนเองไปยัง Auto-VK-Toolkit Library Project auto_vk_toolkit.vxcproj ไปยังโซลูชัน Visual Studio ของคุณและตรวจสอบให้แน่ใจว่าการคัดลอกโครงการที่สร้างขึ้นใหม่
• แหล่งที่มาและการอ้างอิงไฟล์ทั้งหมดจะถูกลบออกจากสำเนาโครงการที่สร้างขึ้นใหม่ คุณจะต้องเพิ่มไฟล์ .cpp อย่างน้อยที่มีฟังก์ชั่น main()
• เพิ่ม #include <auto_vk_toolkit.hpp> เพื่อใช้ auto-vk-toolkit
• หลังจากขั้นตอนเหล่านี้คุณควรจะสามารถเชื่อมโยงกับ Auto-VK-Toolkit สร้างโครงการที่สร้างขึ้นใหม่ได้สำเร็จ

กลยุทธ์ที่ดีคือการเพิ่ม Auto-VK-Toolkit เป็น git submodule ไปยังที่เก็บของของคุณและใช้ create_new_project.exe และขั้นตอนข้างต้นเพื่อสร้างโครงการที่กำหนดค่าไว้อย่างเหมาะสมในไดเรกทอรีด้านนอกของ submodule ตรวจสอบให้แน่ใจว่าได้อัปเดต submodule บ่อยครั้งโดยดึงจากสาขา master ของ Auto-VK-Toolkit เพื่อรับการอัปเดตล่าสุด

การจัดการทรัพยากรและการสร้างโพสต์สร้างตัวช่วย

โครงการ Visual Studio ของ Auto-VK-Toolkit ได้รับการกำหนดค่าเพื่อให้ Visual Studio สามารถใช้อย่างหรูหราสำหรับการจัดการทรัพยากร นั่นหมายความว่าสินทรัพย์ที่จำเป็น (รุ่น 3D, รูปภาพ, ไฟล์ฉาก ORCA) และไฟล์ shader สามารถเพิ่มลงในตัวกรองของ Visual Studio ในมุมมอง "Solution Explorer" และเครื่องมือ สร้างตัวช่วยการสร้างสมาร์ทโพสต์ ทำให้มั่นใจได้ว่าทรัพยากรเหล่านั้นจะถูกปรับใช้กับไดเรกทอรีเป้าหมายของแอปพลิเคชัน

ในระยะสั้น/ tl; DR :

• เพิ่มโมเดล 3 มิติรูปภาพและฉาก ORCA ลงในตัวกรอง assets และ
• เพิ่มไฟล์ shader ที่ต้องการลงในตัวกรอง shaders โดยตรงใน Visual Studio จากนั้นสร้างแอปพลิเคชันรอ ตัวช่วยสร้างโพสต์ เพื่อปรับใช้ทรัพยากรเหล่านี้ไปยังไดเรกทอรีเป้าหมายและเรียกใช้แอปพลิเคชันของคุณ!

สิ่งนี้สามารถมีลักษณะดังต่อไปนี้โดยที่ assets และ shaders มีความหมายพิเศษดังที่ได้กล่าวไว้ข้างต้น:

คำอธิบายโดยละเอียดเพิ่มเติมและคำแนะนำเพิ่มเติมได้รับใน visual_studio/README.md

คุณจะสังเกตเห็น โพสต์สร้างกิจกรรมผู้ช่วย ผ่านไอคอนถาด: - เครื่องมือจะยังคงทำงานหลังจากการปรับใช้เสร็จสิ้นด้วยเหตุผลหลักสองประการ:

• ช่วยให้สามารถตรวจสอบบันทึกจากเหตุการณ์การสร้างก่อนหน้าและเปลี่ยนการตั้งค่า
• มันยังคงตรวจสอบไฟล์ทรัพยากรซึ่งเป็นสิ่งสำคัญอย่างยิ่งในการเปิดใช้ งานการโหลดซ้ำของ Shader

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ ตัวช่วยการสร้างโพสต์ โปรดดูส่วนการสร้างโพสต์ตัวช่วยและสำหรับข้อมูลเพิ่มเติมเกี่ยวกับการโหลดซ้ำของ Shader Hot โปรดดูส่วนการอัปเดตทรัพยากรอัตโนมัติด้านล่าง

ความแตกต่างระหว่าง Auto-VK-Toolkit และ Auto-VK คืออะไร?

Auto-VK เป็นความสะดวกสบายของแพลตฟอร์มและเลเยอร์ผลผลิตบน Vulkan-HPP

Auto-VK-Toolkit สร้างลิงก์ที่ขาดหายไปไปยังระบบปฏิบัติการเช่นการจัดการหน้าต่างและเพิ่มฟังก์ชั่นเพิ่มเติม:

• การกำหนดค่าสภาพแวดล้อมการเรนเดอร์เช่นการเปิดใช้งานส่วนขยาย Vulkan (เช่นถ้า VK_KHR_ray_tracing_pipeline จะใช้จะเลือกอุปกรณ์ทางกายภาพที่เหมาะสมและเปิดใช้งานสถานะและส่วนขยายที่จำเป็น)
• การจัดการหน้าต่าง (ผ่าน GLFW)
• การจัดการ Game-Loop/Render-Loop ที่สะดวกในการใช้วิธีการโทรกลับผ่าน avk::invokee (เช่น initialize() , update() , render() , ที่อดีตเรียกเพียงครั้งเดียวและสองหลังจะถูกเรียกใช้แต่ละเฟรม)
• การจัดการอินพุตของผู้ใช้
• A พร้อมใช้คลาสพื้นฐานสำหรับลำดับชั้นของวัตถุ: avk::transform
• พร้อมที่จะใช้คลาสกล้องที่ควบคุมได้ผู้ใช้ avk::quake_camera และ avk::orbit_camera (มาจากทั้งสอง, avk::transform and avk::invokee )
• สนับสนุนการโหลดทรัพยากรสำหรับ:
  • ภาพ
  • รุ่น 3 มิติ
  • ฉากในรูปแบบ orca ดู: orca: Open Research Content Archive
• การโหลดวัสดุและการแปลงเป็นรูปแบบ GPU-Suitable ( avk::material และ a vk::material_gpu_data )
• การโหลดและการแปลง LightSource เป็นรูปแบบ GPU-Suitable ( avk::lightsource และ avk::lightsource_gpu_data )
• การจัดการทรัพยากรผ่านตัวกรองของ Visual Studio เช่นเพียงแค่ลากและวางสินทรัพย์และ shaders ที่คุณต้องการใช้โดยตรงในลำดับชั้นของตัวกรองของ Visual Studio และนำไปใช้กับไดเรกทอรีเป้าหมาย
• เครื่องมือสร้างโพสต์ที่ทรงพลังซึ่งถูกเรียกใช้เป็นขั้นตอนการสร้างที่กำหนดเอง
  • มันปรับใช้สินทรัพย์และเฉดสีให้กับไดเรกทอรีเป้าหมาย
  • Shaders ถูกรวบรวมเป็น SPIR-V
  • หากไฟล์ shader มีข้อผิดพลาดข้อความป๊อปอัพจะถูกสร้างขึ้นแสดงข้อผิดพลาดและให้ปุ่ม [->VS] เพื่อนำทางไปยังบรรทัดที่มีข้อผิดพลาด ภายใน Visual Studio
  • โดยค่าเริ่มต้น "การดีบัก" และ "รีลีส" สร้างทรัพยากรการกำหนดค่า Symlink เพื่อประหยัดพื้นที่ แต่ "เผยแพร่" การกำหนดค่าการกำหนดค่าทั้งหมดที่กำหนดไว้ในไดเรกทอรีเป้าหมายเพื่อให้สามารถถ่ายโอนโปรแกรมที่สร้างขึ้นไปยังพีซีเครื่องอื่นได้อย่างง่ายดาย ไม่จำเป็นต้องมีการรวบรวมทรัพยากรที่น่าเบื่ออีกต่อไปในสถานการณ์เช่นนี้เนื่องจากได้รับการจัดการโดยผู้ช่วยสร้างโพสต์

เอกสาร

มีบางหน้าเอกสารที่มีข้อมูลเพิ่มเติม:

• การใช้ Imgui สำหรับส่วนต่อประสานผู้ใช้อธิบายวิธีการใช้ Dear Imgui ในโครงการ Auto-VK-Toolkit
• การตั้งค่า CMAKE และคำแนะนำในการสร้าง
• ฟังก์ชั่น Meshlets-specfic สำหรับการหารเรขาคณิตเป็นกลุ่มเล็ก ๆ และใช้สำหรับการแสดงผลในท่อตาข่ายกราฟิก (ผู้ที่มีงานและเฉดสีตาข่าย)
• ฟังก์ชั่น serializer สำหรับการจัดเก็บและโหลดทรัพยากรไปยัง/จากไฟล์เช่นรุ่น 3 มิติรูปภาพหรือโครงสร้างที่กำหนดเอง
• การอัปเดตทรัพยากรอัตโนมัติผ่านคลาส avk::updater ทำให้ SHWAPCHAIN ​​Recreation และ Shader Hot Reloading
• การเรนเดอร์แบบไดนามิก: วิธีใช้การเรนเดอร์แบบไดนามิกใน Auto-VK-Toolkit

คำถามที่พบบ่อยปัญหาที่รู้จักการแก้ไขปัญหา

ถาม: สามารถใช้ Auto-VK-Toolkit บน Linux ได้หรือไม่?
ก. ใช่. โปรดดูเอกสาร CMAKE ที่ DOCS/CMAKE.MD!

ถาม: สามารถใช้ Auto-VK-Toolkit ได้โดยไม่ต้องใช้ ตัวช่วยสร้างโพสต์ได้ หรือไม่?
ก. ใช่. Post Build Helper เป็นเครื่องมือสะดวกซื้อที่จัดการการปรับใช้ทรัพยากรการพึ่งพาสินทรัพย์และการอัปเดตไฟล์ (มีประโยชน์สำหรับการโหลดซ้ำของ Shader ขึ้นอยู่กับโครงสร้างโครงการ) หากคุณไม่ได้ใช้มันคุณจะต้องจัดการการปรับใช้ทรัพยากรและการรวบรวมไฟล์ shader ลงใน SPIR-V ด้วยตนเอง

ถาม: ฉันมีปัญหากับการจัดการสินทรัพย์ใน Visual Studio คำแนะนำใด ๆ ?
ตอบ: ตรวจสอบปัญหาที่รู้จักและการแก้ไขปัญหาการจัดการสินทรัพย์ WRT ซึ่งเสนอแนวทางสำหรับกรณีต่อไปนี้:

• สร้างข้อผิดพลาดเมื่อเพิ่มสินทรัพย์
• สินทรัพย์ไม่ได้ถูกนำไปใช้เนื่องจากไม่ได้บันทึกไว้ในไฟล์ฟิลเตอร์ของ Visual Studio

ถาม: มีการปรับใช้ทรัพยากรเพิ่มเติมมากกว่าที่ฉันได้เพิ่มลงในตัวกรองของ Visual Studio เกิดอะไรขึ้น?
ตอบ: สินทรัพย์บางส่วนอ้างอิงสินทรัพย์อื่น ๆ ภายใน ตัวอย่างเช่นโมเดล 3 มิติมักจะอ้างอิงรูปภาพหรือไฟล์วัสดุ (ในกรณีของโมเดล .obj ) "สินทรัพย์ที่พึ่งพา" เหล่านี้จะถูกนำไปใช้กับไดเรกทอรีเป้าหมายโดย ผู้ช่วยสร้างโพสต์ โปรดดูการปรับใช้สินทรัพย์ที่ขึ้นอยู่กับสำหรับรายละเอียดเพิ่มเติม

ถาม: อะไรคือความแตกต่างระหว่าง การดีบัก การเปิดตัว และ เผยแพร่ การกำหนดค่าการสร้าง?
ตอบ: ในแง่ของการตั้งค่าการรวบรวม การเปิดตัว และ การเผยแพร่ การกำหนดค่าจะเหมือนกัน พวกเขาเชื่อมโยงกับการ สร้าง การสร้างห้องสมุด การกำหนดค่า การดีบัก มีการตั้งค่าการดีบักแบบคลาสสิกที่กำหนดค่าไว้สำหรับโครงการ Visual Studio และลิงก์กับการ ดีบัก Builds of Libraries อย่างไรก็ตามมีความแตกต่างระหว่างการ เผยแพร่ การสร้างและการสร้างที่ไม่ เผยแพร่ WRT การปรับใช้ทรัพยากร โปรดดูลิงค์/สำเนาสัญลักษณ์ขึ้นอยู่กับการกำหนดค่าการสร้างสำหรับรายละเอียดเพิ่มเติม

ถาม: ฉันมีปัญหากับ ผู้ช่วยสร้างโพสต์ จะทำอย่างไร?
ตอบ: ตรวจสอบ Post Build Helper ซึ่งเสนอแนวทางสำหรับกรณีต่อไปนี้:

• Build ติดอยู่ที่ขั้นตอน "ไปที่" ... ] msbuild.exe "ขั้นตอนแสดงในแท็บเอาต์พุตของ Visual Studio
• Post Build Helper ไม่สามารถสร้างได้โดยอัตโนมัติ/ผ่าน msbuild.exe
• มีการปรับใช้ทรัพยากรน้อยเกินไป
• แอปพลิเคชันไม่สามารถเริ่มต้นได้ในตอนแรกลอง (อาจเป็นเพราะสินทรัพย์หรือ DLL ที่หายไป)
• ข้อความแสดงข้อผิดพลาดเกี่ยวกับการปฏิเสธการเข้าถึงไฟล์ DLL (DLL ไม่ได้ถูกปรับใช้ใหม่)
• ประสิทธิภาพช้าเมื่อแสดงรายการภายในตัวช่วยสร้างโพสต์
• ข้อความแสดงข้อผิดพลาดใน UI ของ Post Build Helper: "ไม่พบส่วนหนึ่งของเส้นทาง '... '"
• ข้อความแสดงข้อผิดพลาดในคอนโซล: can't fopen หรือ !RUNTIME ERROR! Couldn't load image from '...' หรือคล้ายกัน

ถาม: แอปพลิเคชันใช้เวลานานในการโหลดสินทรัพย์เช่นรุ่น 3 มิติและรูปภาพ สามารถเร่งความเร็วได้หรือไม่?
ตอบ: หากคุณอ้างถึงการดีบัก บิ๊ก คุณสามารถกำหนดค่า โพสต์บิลด์ตัวช่วย เพื่อให้สามารถใช้ งาน DLL ของการพึ่งพาภายนอกบางอย่างแม้กระทั่งสำหรับการ ดีบัก บิลด์ พวกเขาควรเร่งการโหลดสินทรัพย์เป็นจำนวนมาก หากต้องการเปิดใช้งานการ ปรับใช้ DLLS โปรดเปิดการตั้งค่า Post Build Helper และเปิดใช้งานตัวเลือก "ปรับใช้ DLLS" เสมอ "

ถาม: การรับ cereal::Exception ใน cereal::loadBinary หรือ Unhandled exception at 0x00007FFE82204FD9 in ...exe: Microsoft C++ exception: cereal::Exception at memory location ...
ตอบ: ไฟล์แคชอนุกรมของคุณ (เช่นสำหรับ sponza_and_terrain.fscene นี่อาจเป็น sponza_and_terrain.fscene.cache ) ได้รับความเสียหาย (อาจเป็นเพราะมันไม่ได้เขียนอย่างสมบูรณ์เนื่องจากข้อผิดพลาดที่เกิดขึ้นก่อนหน้านี้ในแอปพลิเคชันหรือเพราะการดำเนินการถูกยกเลิก) ลบไฟล์แคช (เช่น sponza_and_terrain.fscene.cache ) และปล่อยให้ไฟล์ใหม่ถูกสร้างขึ้น!