Skip to content

Latest commit

 

History

History
90 lines (63 loc) · 2.82 KB

BUILDING.md

File metadata and controls

90 lines (63 loc) · 2.82 KB

Building

Tested platforms

ImGUi Hydra has been developed on MacOS Sonora 14.5 (Macbook Air 2022 - M2).

Dependencies

Required:

Embedded:

Getting Started

Install dependencies

Make sure gcc and cmake are installed

gcc --version
cmake --version

If some version and info are printed after running the previous commands, gcc and cmake are installed. If you get command not found error, please be sure to install them first.

Download OpenUSD

The easy way to get a pre-built version of USD is to download the one from the Nvidia website.

To build USD manually, go to the OpenUSD release page, download the last release available and build it (build info in the OpenUSD README.md).

Don't forget to add the --embree flag to the build command if you wish to have access to the Embree renderer from ImGui Hydra Editor. embree enabled in ImGui Hydra Editor

python3 USD/build_scripts/build_usd.py --embree /path/to/install

Clone ImGuiHydraEditor

Clone the git project using the following command:

git clone --recurse-submodules https://github.com/raph080/ImGuiHydraEditor.git

The recursive flag will automatically include the following projects: glew, glfw, imgui, ImGuiColorTextEdit, ImGuiFileDialog, ImGuizmo

Build ImGuiHydraEditor

Within the cloned ImGuiHydraEditor, create a build folder and run cmake from this newly created folder by specifying the root path to OpenUSD build:

mkdir build
cd build
cmake -Dpxr_DIR=/path/to/OpenUSD/build/folder -DCMAKE_INSTALL_PREFIX=/path/to/install/folder ..
make
make install

Run ImGuiHydraEditor

if everything went well, 3 new folders are created in your /path/to/install/folder: bin, include and lib.

You can then run the ImGuiHydraEditor application as follow:

Linux:

export LD_LIBRARY_PATH=/path/to/OpenUSD/build/folder/lib:/path/to/OpenUSD/build/folder/lib64:$LD_LIBRARY_PATH
./ImGuiHydraEditor

MacOS:

export DYLD_LIBRARY_PATH=/path/to/OpenUSD/build/folder/lib:$DYLD_LIBRARY_PATH
./ImGuiHydraEditor

You can optionally load a USD file directly using the following command:

./ImGuiHydraEditor /input/file.usd