claude_code/procedural-3d-engine
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
procedural-3d-engine/apple/README_MoltenVK_Examples.md
SRSaunders ba927eab6c
Add updated iOS App support to the Vulkan examples (#1119) 
* Fix clang Objective-C++ flags for macOS command line builds

* Fix getAssetPath() and getShaderBasePath() for macOS command line builds

* Protect debugUtilsMessageCallback() from failing when pMessageIdName is NULL

* Fix a few clang function override and mismatched type warnings

* Fix validation layer warnings on exit for computeraytracing example

* Fix regression in text visibility toggle for textOverlay example

* Support VK_USE_PLATFORM_METAL_EXT vs. deprecated VK_USE_PLATFORM_MACOS_MVK / DVK_USE_PLATFORM_IOS_MVK

* Check dynamic state features before enabling capabilities in dynamicstate example

* Fix vkCmdDraw() vertexCount argument (PARTICLE_COUNT) in particlesystem example

* Update examples list and restore benchmarking script (to top level)

* Fix validation warning in descriptorindexing example

* Fix device max recursion depth validation warnings in ray tracing examples

* Fix OpenMP build settings for texture3d example on all platforms

* Update and simplify build instructions for macOS

* Update CI script with correct library path for libomp on macOS x86_64

* Update CI scipt to install libomp prior to macOS builds

* Trying one more time to get the CI script working for macOS libomp

* Fix vertexCount argument using calculated size in particlesystem example

* Fix combined image descriptor offset calculation in descriptorbuffer example

* Add iOS App support for Vulkan examples on simulator and physical devices

* Add continuous integration (CI) script for iOS

* Update CI script to build iOS using Xcode 14 via macos-12 runner-image

* Update iOS project docs for Xcode 14 and rename ios folder to apple

* Update macOS docs and CI script to use LIBOMP_PREFIX for OpenMP library path

* Delete benchmark-all-validate.py

Delete benchmark script as per feedback from Sascha Willems

* Update debugprintf example documentation in examples.h
2024-05-22 21:07:27 +02:00

3.8 KiB
Executable file
Raw Blame History

MoltenVK Home

#MoltenVK Vulkan Examples

Copyright (c) 2016-2024 The Brenwill Workshop Ltd.. This document is licensed under the MIT license (MIT) (http://opensource.org/licenses/MIT)

This document is written in Markdown format. For best results, use a Markdown reader.

Introduction

The Xcode project in this folder builds and runs the Vulkan examples in this repository on iOS, the iOS Simulator, and macOS, using the MoltenVK Vulkan driver.

Installing MoltenVK

These examples require Vulkan SDK 1.3.275.0 or later.

Follow these instructions to install the latest Vulkan SDK containing MoltenVK:

  1. Download the latest Vulkan SDK for macOS. This includes the required MoltenVK library frameworks for iOS, the iOS Simulator, and macOS. The latest getting started information can be found at Getting Started.

  2. Install the downloaded vulkansdk-macos-version.dmg package to the default location.

  3. Open a Terminal session and navigate to the directory containing this document, remove the existing MoltenVK.xcframework symbolic link in this directory, and create a new symbolic link pointing to MoltenVK.xcframework within the Vulkan SDK:

     cd path-to-this-directory
 rm MoltenVK.xcframework
 ln -s path-to-VulkanSDK/macOS/lib/MoltenVK.xcframework

Running the Vulkan Examples

The single examples.xcodeproj Xcode project can be used to run any of the examples in this repository on iOS, the iOS Simulator, or macOS. To do so, follow these instructions:

  1. Open the examples.xcodeproj Xcode project using Xcode 14 or later. Earlier versions of Xcode are not supported and will not successfully build this project.

  2. Specify which of the many examples within this respository you wish to run, by opening the examples.h file within Xcode, and following the instructions in the comments within that file to indicate which of the examples you wish to run. Some examples may not be supported on iOS or macOS - please see the comments.

  3. Run either the examples-iOS or examples-macOS Xcode Scheme to run the example in iOS, the iOS Simulator, or macOS respectively.

  4. Many of the examples include an option to press keys to control the display of features and scene components:

    • On iOS, use one- and/or two-finger gestures to rotate, translate, or zoom the scene. On macOS, use the left/center/right mouse buttons or mouse wheel to rotate, translate, or zoom the scene.
    • On the iOS Simulator, use the left mouse button to select or rotate the scene, Shift + Option + click and drag for translation, or Option + click and drag for zoom.
    • On iOS, double tap on the scene to display the keyboard. Double tap again on the scene to hide the keyboard. On the iOS Simulator double click to show and hide the virtual keyboard (note: you may need to press ⌘(command) + ⇧(shift) + K to switch from the hardware keyboard to the virtual keyboard).
    • On both iOS and macOS, use the numeric keys (1, 2, 3...) instead of function keys (F1, F2, F3...).
    • On both iOS and macOS, use the regular keyboard + and - keys instead of the numpad + and - keys.
    • On both iOS and macOS, use the keyboard p key to pause and resume animation.
    • On both iOS and macOS, use the delete key instead of the escape key.