macOS: Additional improvements and fixes for embedded window support

[stuartcarnie]

This PR includes the following PR feedback and improvements for #105884

• Disables embedded support in single-window mode, as it won't work properly, given the macOS window server composites the embedded layer over the Godot rendered content.
• Fixes for mouse capture, particularly when debugging
• Improves the launch arguments, so --embedded is all that is required, and works like an alias to --display-server embedded.

[Calinou]

Tested locally, it works as expected. Code looks good to me.

I can confirm the mouse capture issues I mentioned in the original PR are gone. I've also checked that the single window mode makes the warning message appear correctly (and disables the feature).

Note that I still can't close the game by pressing the X button when game embedding in a floating window is enabled though. I can do that when game embedding is disabled.

[Repiteo]

Thanks!

[stuartcarnie]

Thanks @Calinou. I'm working on the following items, which weren't included in this:

• Clicking the X button to close the floating game window has no effect.
• Closing the editor using Ctrl + C in the terminal won't always stop the running project
• In Compatibility, using window embedding will break V-Sync (FPS will be uncapped).
• When using Metal in Truck Town (Forward+/Mobile), the sky takes the background color of the game window

[danielgpinheiro]

Hi @stuartcarnie,
I compiled Godot from the master branch (with your changes), and the game window looks like this. I’m not sure if this is specific to my personal project or due to some window configuration I set up earlier, resulting in this behavior.

Screen.Recording.2025-05-07.at.18.42.39.mov

[stuartcarnie]

Are you running any special settings for your display? Is it a high-DPI display?

I have been unable to reproduce that – though it was an issue in much earlier builds. If you can create an MRP, that would help.

[danielgpinheiro]

My display is 2560x1080 ultrawide. Would sending you my personal Project.godot help?

[stuartcarnie]

My display is 2560x1080 ultrawide. Would sending you my personal Project.godot help?

Yes, your personal project.godot would work.