b3ef7a8c2f
This change removes the ViewerMode enum and instead infers whether to launch the Web Viewer or Native Viewer based on the graphics mode (gfx) setting. Specifically, setting gfx to "web" or "webgl" will now launch the Web Viewer (in future "webgpu" would also launch the Web Viewer). Additionally, this unifies command-line flags across studio scripts and samples by replacing the --mjcf flag with --model (with positional argument fallback) and standardizing absl flags usage. --model is a better name since formats like .mjz and .mjb are also supported by this argument. PiperOrigin-RevId: 959058940 Change-Id: If4e0ace664ddc6e45cb681d168679148e8c4901d
76 lines
2.5 KiB
Python
76 lines
2.5 KiB
Python
# Copyright 2026 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.
|
|
"""Interactive Studio GUI viewer for MuJoCo."""
|
|
|
|
from absl import app as _app
|
|
from absl import flags as _flags
|
|
from mujoco.experimental.studio import launch_passive
|
|
from mujoco.experimental.studio import messages
|
|
from mujoco.experimental.studio import parser
|
|
from mujoco.experimental.studio import sim
|
|
from mujoco.experimental.studio import viewer_app
|
|
from mujoco.experimental.studio import viewer_protocol
|
|
|
|
vp = viewer_protocol
|
|
|
|
_MODEL = _flags.DEFINE_string('model', None, 'Path to model file.')
|
|
_GFX = _flags.DEFINE_enum(
|
|
'gfx', None, vp.GFX_MODES, 'Graphics mode ("web" launches Web Viewer).'
|
|
)
|
|
_PORT = _flags.DEFINE_integer(
|
|
'port', 0, 'Web Viewer port (0 picks first free port >= 8080).'
|
|
)
|
|
_WIDTH = _flags.DEFINE_integer('width', 1200, 'Width of the output image.')
|
|
_HEIGHT = _flags.DEFINE_integer('height', 800, 'Height of the output image')
|
|
|
|
|
|
def main(argv: list[str]) -> None:
|
|
config = vp.ViewerConfig(
|
|
width=_WIDTH.value,
|
|
height=_HEIGHT.value,
|
|
gfx=_GFX.value or '',
|
|
http_port=_PORT.value,
|
|
)
|
|
|
|
# Resolve model path, if provided.
|
|
model_path = _MODEL.value or (
|
|
argv[1] if len(argv) > 1 and not argv[1].startswith('--') else None
|
|
)
|
|
|
|
# Load model if path was provided.
|
|
data, model = None, None
|
|
if model_path and (data := parser.parse(model_path)):
|
|
model = data.model
|
|
|
|
with launch_passive.launch_passive(
|
|
config,
|
|
viewer_handlers=[viewer_app.ViewerApp()],
|
|
) as handle:
|
|
# Send the model to the viewer, if we have a model.
|
|
if model is not None:
|
|
handle.send_to_viewer(messages.ModelEvent(model=model, path=model_path))
|
|
|
|
# Run the simulation.
|
|
step_control = sim.StepControl()
|
|
try:
|
|
while handle.is_running():
|
|
step_control.advance(model, data)
|
|
model, data, step_control = handle.sync(model, data, step_control)
|
|
except KeyboardInterrupt:
|
|
# Ctrl+C is the documented way to quit; exit cleanly, no traceback.
|
|
print('\nShutting down.', flush=True)
|
|
|
|
|
|
_app.run(main)
|