Add CMakeLists.txt files for new (experimental) code.

This includes the filament, toolbox, and studio projects.

Adds a MUJOCO_BUILD_STUDIO option to enable building of the `studio` app (disabled by default).

Adds a MUJOCO_USE_FILAMENT to allow the studio app to use the filament rendering backend. A separate MUJOCO_USE_FILAMENT_VULKAN flag can be used to enable vulkan rendering.

PiperOrigin-RevId: 824602367
Change-Id: I26d46c16211ae2118f96c163c4194fea5b5a15a9
This commit is contained in:
Haroon Qureshi
2025-10-27 11:25:25 -07:00
committed by Copybara-Service
parent be055840b4
commit a16805f8ee
4 changed files with 288 additions and 2 deletions
+136
View File
@@ -0,0 +1,136 @@
# Copyright 2025 DeepMind Technologies Limited
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
cmake_minimum_required(VERSION 3.16)
set(MUJOCO_FILAMENT_TARGET_NAME mujoco_filament)
add_library(${MUJOCO_FILAMENT_TARGET_NAME} STATIC)
target_sources(${MUJOCO_FILAMENT_TARGET_NAME}
PUBLIC
stubs.cc
render_context_filament.h
render_context_filament.cc
filament/buffer_util.cc
filament/buffer_util.h
filament/builtins.cc
filament/builtins.h
filament/color_grading_options.cc
filament/color_grading_options.h
filament/drawable.cc
filament/drawable.h
filament/filament_context.cc
filament/filament_context.h
filament/geom_util.cc
filament/geom_util.h
filament/gui_view.cc
filament/gui_view.h
filament/imgui_editor.cc
filament/imgui_editor.h
filament/light.cc
filament/light.h
filament/material.cc
filament/material.h
filament/math_util.h
filament/model_util.cc
filament/model_util.h
filament/object_manager.cc
filament/object_manager.h
filament/renderables.cc
filament/renderables.h
filament/scene_view.cc
filament/scene_view.h
filament/texture_util.cc
filament/texture_util.h
filament/vertex_util.cc
filament/vertex_util.h
)
target_include_directories(${MUJOCO_FILAMENT_TARGET_NAME}
PUBLIC
${PROJECT_SOURCE_DIR}/include
${PROJECT_SOURCE_DIR}/src
)
include(third_party_deps/dear_imgui)
include(third_party_deps/filament)
target_link_libraries(${MUJOCO_FILAMENT_TARGET_NAME}
dear_imgui
filament
image # provided by filament
ktxreader # provided by filament
)
add_library(mujoco::filament ALIAS ${MUJOCO_FILAMENT_TARGET_NAME})
# The "mujoco::filament" library needs access to some assets (e.g. filament
# material shaders) in order to do rendering. As such, you must also include
# the assets under MUJOCO_FILAMENT_ASSETS_DIR in your project. As part of
# the filament library configuration, you will provide a function that the
# library will use to load these assets.
set(ASSETS_DIR "${CMAKE_CURRENT_SOURCE_DIR}/assets")
set(OUTPUT_ASSETS_DIR "${CMAKE_CURRENT_BINARY_DIR}/assets")
file(MAKE_DIRECTORY ${OUTPUT_ASSETS_DIR})
file(COPY
"${ASSETS_DIR}/ibl.ktx"
DESTINATION ${OUTPUT_ASSETS_DIR}
)
set(MATC_EXECUTABLE matc)
set(MATERIAL_FILES
pbr.mat
pbr_packed.mat
phong_2d_fade.mat
phong_2d.mat
phong_2d_uv_fade.mat
phong_2d_uv.mat
phong_color_fade.mat
phong_color.mat
phong_cube_fade.mat
phong_cube.mat
unlit_depth.mat
unlit_line.mat
unlit_segmentation.mat
unlit_ui.mat
)
foreach(MATERIAL_FILE ${MATERIAL_FILES})
get_filename_component(MATERIAL_NAME ${MATERIAL_FILE} NAME_WE)
set(INPUT_FILE "${ASSETS_DIR}/${MATERIAL_FILE}")
set(OUTPUT_FILE "${OUTPUT_ASSETS_DIR}/${MATERIAL_NAME}.filamat")
add_custom_command(
OUTPUT ${OUTPUT_FILE}
COMMAND ${MATC_EXECUTABLE}
--platform=all
--api=vulkan
--api=opengl
--variant-filter skinning
--optimize-size
--output ${OUTPUT_FILE}
${INPUT_FILE}
DEPENDS ${INPUT_FILE}
DEPENDS matc
COMMENT "Compiling ${MATERIAL_FILE}"
)
list(APPEND MUJOCO_FILAMENT_ASSET_FILES ${OUTPUT_FILE})
endforeach()
list(APPEND MUJOCO_FILAMENT_ASSET_FILES "${OUTPUT_ASSETS_DIR}/ibl.ktx")
add_custom_target(mujoco_filament_assets DEPENDS ${MUJOCO_FILAMENT_ASSET_FILES})
add_dependencies(${MUJOCO_FILAMENT_TARGET_NAME} mujoco_filament_assets)
set(MUJOCO_FILAMENT_ASSETS_DIR ${OUTPUT_ASSETS_DIR})
+75
View File
@@ -0,0 +1,75 @@
# Copyright 2025 DeepMind Technologies Limited
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
cmake_minimum_required(VERSION 3.16)
# Determine the render configuration and dependencies based options.
if(MUJOCO_USE_FILAMENT AND MUJOCO_USE_FILAMENT_VULKAN)
set(MUJOCO_STUDIO_RENDER_CONFIG "USE_FILAMENT_VULKAN")
set(MUJOCO_STUDIO_RENDER_DEPS "mujoco::filament")
elseif(MUJOCO_USE_FILAMENT)
set(MUJOCO_STUDIO_RENDER_CONFIG "USE_FILAMENT_OPENGL")
set(MUJOCO_STUDIO_RENDER_DEPS "mujoco::filament")
else()
set(MUJOCO_STUDIO_RENDER_CONFIG "USE_CLASSIC_OPENGL")
endif()
set(MUJOCO_STUDIO_TARGET_NAME mujoco_studio)
add_executable(${MUJOCO_STUDIO_TARGET_NAME})
target_sources(${MUJOCO_STUDIO_TARGET_NAME}
PRIVATE
app.cc
app.h
main.cc
)
target_include_directories(${MUJOCO_STUDIO_TARGET_NAME}
PUBLIC
${PROJECT_SOURCE_DIR}/include
${PROJECT_SOURCE_DIR}/src
)
target_compile_definitions(${MUJOCO_STUDIO_TARGET_NAME}
PRIVATE
-D${MUJOCO_STUDIO_RENDER_CONFIG}
)
include(third_party_deps/dear_imgui)
include(third_party_deps/implot)
target_link_libraries(${MUJOCO_STUDIO_TARGET_NAME}
PRIVATE
${MUJOCO_STUDIO_RENDER_DEPS}
absl::flags
dear_imgui
dear_imgui_OpenGL3
dear_imgui_SDL2
implot
mujoco::mujoco
mujoco::toolbox
)
# Filament backend requires additional files to be copied into an "assets" folder.
if(MUJOCO_USE_FILAMENT)
add_custom_command(
TARGET ${MUJOCO_STUDIO_TARGET_NAME}
POST_BUILD
COMMAND ${CMAKE_COMMAND}
-E create_symlink
${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/../src/experimental/filament/assets
${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/assets
COMMENT "Copying Filament assets to build directory"
)
endif()
+56
View File
@@ -0,0 +1,56 @@
# Copyright 2025 DeepMind Technologies Limited
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
cmake_minimum_required(VERSION 3.16)
set(MUJOCO_TOOLBOX_TARGET_NAME mujoco_toolbox)
add_library(${MUJOCO_TOOLBOX_TARGET_NAME} STATIC)
target_sources(${MUJOCO_TOOLBOX_TARGET_NAME}
PUBLIC
helpers.cc
helpers.h
imgui_widgets.cc
imgui_widgets.h
interaction.cc
interaction.h
physics.cc
physics.h
renderer.cc
renderer.h
step_control.cc
step_control.h
window.cc
window.h
)
target_include_directories(${MUJOCO_TOOLBOX_TARGET_NAME}
PUBLIC
${PROJECT_SOURCE_DIR}/include
${PROJECT_SOURCE_DIR}/src
)
include(third_party_deps/dear_imgui)
include(third_party_deps/implot)
include(third_party_deps/sdl2)
include(third_party_deps/libwebp)
target_link_libraries(${MUJOCO_TOOLBOX_TARGET_NAME}
dear_imgui
implot
webp
SDL2::SDL2-static
)
add_library(mujoco::toolbox ALIAS ${MUJOCO_TOOLBOX_TARGET_NAME})