Skip to content

Align window controls with DexSim defaults#291

Merged
yuecideng merged 2 commits into
mainfrom
docs/dexsim-window-controls
Jun 4, 2026
Merged

Align window controls with DexSim defaults#291
yuecideng merged 2 commits into
mainfrom
docs/dexsim-window-controls

Conversation

@yuecideng
Copy link
Copy Markdown
Contributor

Description

This PR removes redundant EmbodiChain default window control registration and updates the window interaction documentation to reflect DexSim's built-in viewer controls.

DexSim now provides the main visualization window with ORBIT camera controls, object selection/focus shortcuts, and selection logging. The previous EmbodiChain _register_default_window_control() hook only added a custom C-key raycast printout, which overlaps with DexSim's L selection log and is no longer needed.

Changes:

  • Remove _register_default_window_control() and related state from SimulationManager
  • Document DexSim mouse/keyboard/selection controls in window.md
  • Keep EmbodiChain-specific viewer recording hotkey (r) documentation

Dependencies: Requires a DexSim build with default ORBIT viewer controls (F focus, L selection log, Ctrl+WASD/QE translate).

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • Enhancement (non-breaking change which improves an existing functionality)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (existing functionality will not work without user modification)
  • Documentation update

Screenshots

N/A

Checklist

  • I have run the black . command to format the code base.
  • I have made corresponding changes to the documentation
  • I have added tests that prove my fix is effective or that my feature works
  • Dependencies have been updated, if applicable.

🤖 Generated with Claude Code

Made with Cursor

yuecideng and others added 2 commits June 4, 2026 13:07
Remove redundant EmbodiChain default window control registration now
that DexSim provides camera, selection, and focus shortcuts natively.
Update window interaction docs to document DexSim controls and keep
EmbodiChain-specific viewer recording hotkey guidance.

Co-authored-by: Cursor <cursoragent@cursor.com>
Copilot AI review requested due to automatic review settings June 4, 2026 05:08
@yuecideng yuecideng added docs Improvements or additions to documentation enhancement New feature or request interaction The interaction simulation features dexsim Things related to dexsim visualization Features or functions for visualization with the simulation labels Jun 4, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR aligns EmbodiChain’s window interaction behavior and documentation with DexSim’s built-in ORBIT viewer controls by removing EmbodiChain’s redundant default window control registration and updating the interaction docs accordingly.

Changes:

  • Removed SimulationManager._register_default_window_control() and its registration state.
  • Updated docs/source/features/interaction/window.md to describe DexSim’s default ORBIT mouse/keyboard/selection controls and kept EmbodiChain’s viewer recording hotkey documentation.
  • Updated the PourWater gym config to remove semantic-mask observation entries and disable mask/depth on certain cameras.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
embodichain/lab/sim/sim_manager.py Removes EmbodiChain’s redundant default window control registration hook/state.
docs/source/features/interaction/window.md Documents DexSim ORBIT viewer controls and keeps EmbodiChain recording hotkey guidance.
configs/gym/pour_water/gym_config.json Removes semantic mask observation config and disables mask/depth outputs for some cameras.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

This section describes the default window interaction controls available in the simulation. These controls allow users to interact with the simulation environment using keyboard, mouse, and customizable input events.

## Default Window Events
The main visualization window is provided by **DexSim**. When `SimConfig.headless=False` or `SimulationManager.open_window()` is called, DexSim creates the viewer with **ORBIT** camera control by default.
Comment on lines 215 to 222
"cup_pose": {
"func": "get_rigid_object_pose",
"mode": "add",
"name": "cup_pose",
"params": {
"entity_cfg": {"uid": "cup"}
}
},
"cam_high_semantic_mask_l": {
"func": "compute_semantic_mask",
"mode": "add",
"name": "sensor/cam_high/semantic_mask_l",
"params": {
"entity_cfg": {"uid": "cam_high"},
"foreground_uids": ["bottle", "cup"]
}
},
"cam_high_semantic_mask_r": {
"func": "compute_semantic_mask",
"mode": "add",
"name": "sensor/cam_high/semantic_mask_r",
"params": {
"entity_cfg": {"uid": "cam_high"},
"foreground_uids": ["bottle", "cup"],
"is_right": true
}
},
"cam_left_semantic_mask": {
"func": "compute_semantic_mask",
"mode": "add",
"name": "sensor/cam_left_wrist/semantic_mask_l",
"params": {
"entity_cfg": {"uid": "cam_left_wrist"},
"foreground_uids": ["bottle", "cup"]
}
},
"cam_right_semantic_mask": {
"func": "compute_semantic_mask",
"mode": "add",
"name": "sensor/cam_right_wrist/semantic_mask_l",
"params": {
"entity_cfg": {"uid": "cam_right_wrist"},
"foreground_uids": ["bottle", "cup"]
}
}
@yuecideng yuecideng merged commit 1b86641 into main Jun 4, 2026
7 checks passed
@yuecideng yuecideng deleted the docs/dexsim-window-controls branch June 4, 2026 05:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dexsim Things related to dexsim docs Improvements or additions to documentation enhancement New feature or request interaction The interaction simulation features visualization Features or functions for visualization with the simulation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants