Skip to content

Angle using Vulkan backend

Eli Aloni edited this page May 16, 2020 · 1 revision

This Wiki describes how to compile Urho3D with Angle Vulkan/MoltenVK support enabled.

Getting the source code

git clone -b angle-vulkan https://github.com/elix22/Urho3D.git

Windows

Preliminary requirements

  1. Windows 10
  2. Visual Studio 2017
  3. CMake version 3.10.2 (might work with other version but have 't been verified)
  4. Vulkan Run Time Libraries installed on your PC

How to compile

There are 2 ready made scripts that will create for you the Visual Studio projects

cmake_vs2017_vulkan.bat - will create an Visual Studio project using the new Vulkan backend

cmake_vs2017_gl.bat - will create an Visual Studio project using the default legacy OpenGL backend

cmake-gui can also be used , URHO3D_ANGLE_VULKAN should be checked in order to enable the Vulkan backend.

MAC

Preliminary requirements

  1. Mac OS minimal version 10.13.6 (High Sierra)
  2. Xcode minimal version 10.1
  3. CMake version 3.10.2 (might work with other version but have 't been verified)
  4. Valid Apple iOS development account if you wish to compile for iOS.

How to compile

There are 4 ready made scripts that will create for you the Xcode projects

cmake_ios-metal.sh - will create an iOS Xcode project using the new Metal backend

cmake_xcode-metal.sh - will create an Mac Xcode project using the new Metal backend

cmake_ios-gles.sh - will create an iOS Xcode project using the default legacy OpenGL-ES backend

cmake_xcode-gl.sh - will create an Mac Xcode project using the default legacy OpenGL-ES backend

All the scripts will generate Xcode projects configured as debug builds with Metal API validation enabled.

The Xcode project can be reconfigured to a release build configuration

  1. Choose Legacy Build System .

Menu : File -> Project Settings … -> Build System : Legacy Build System

  1. Edit the project Scheme , choose the run action.

Menu : Product -> Scheme -> Edit Scheme -> Run

  1. Select the Info tab , set build configuration to Release.

Info -> Build Configuration : Release

  1. Still in the Info tab , Debug executable checkbox should be unchecked.

Info -> Debug executable : unchecked

  1. Select Options tab and disable Metal API Validation.

Options -> Metal API Validation : Disabled