Skip to content

Document the visionOS platform - #12342

Open
oPinon wants to merge 1 commit into
godotengine:masterfrom
oPinon:visionos
Open

Document the visionOS platform#12342
oPinon wants to merge 1 commit into
godotengine:masterfrom
oPinon:visionos

Conversation

@oPinon

@oPinon oPinon commented Sep 3, 2026

Copy link
Copy Markdown

This adds documentation for the visionOS platform (for Apple Vision Pro) that was recently added to Godot 4.8 (see PRs here and here).

Here is a preview of each page:

@oPinon
oPinon requested review from a team as code owners September 3, 2026 23:24
Comment thread tutorials/export/exporting_for_visionos.rst Outdated
Comment thread tutorials/export/exporting_for_visionos.rst Outdated
Comment thread tutorials/xr/visionos_intro.rst Outdated
Comment thread tutorials/xr/visionos_intro.rst Outdated
Comment thread tutorials/xr/visionos_intro.rst Outdated
Transparent background
~~~~~~~~~~~~~~~~~~~~~~

When using **Mixed** immersion, the game is displayed as alpha-premultiplied on top of passthrough.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

"of passthrough" doesn't sound grammatical

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

I re-used the term from this page: https://developer.apple.com/design/human-interface-guidelines/immersive-experiences

I just changed it to:

as alpha-premultiplied on top of your physical surroundings

But let me know if you have other suggestions.

Comment thread tutorials/xr/visionos_intro.rst Outdated
Comment thread tutorials/xr/visionos_intro.rst Outdated
Comment thread tutorials/xr/visionos_intro.rst Outdated
Comment thread tutorials/xr/visionos_intro.rst Outdated

The first time you launch your Godot game, you will see an empty
background for 20-30 seconds. This is expected, as Godot compiles all its shaders.
It only happens the first time and shaders will be cached for any subsequent launch.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This doesn't feel relevant here as it applies always

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Are you referring to the whole paragraph? I removed it.

Comment thread tutorials/xr/visionos_intro.rst Outdated
@Calinou Calinou added enhancement topic:platforms platform:visionos area:manual Issues and PRs related to the Manual/Tutorials section of the documentation labels Sep 4, 2026
@oPinon

oPinon commented Sep 4, 2026

Copy link
Copy Markdown
Author

@AThousandShips thank you for the review!

I applied all your suggestions. I left some conversations unresolved when I wasn't sure of the way that I resolved them.

@skyace65 skyace65 added this to the 4.8 milestone Sep 5, 2026
@AThousandShips

Copy link
Copy Markdown
Member

I'll give this a new pass today!

@AThousandShips AThousandShips left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Style looks good now can't comment on the correctness

@oPinon

oPinon commented Sep 7, 2026

Copy link
Copy Markdown
Author

Thank you! @rsanchezsaez (from Apple) has already reviewed it for correctness. And @BastiaanOlij @stuartcarnie did too.

@AThousandShips

Copy link
Copy Markdown
Member

Would like to have their approvals here to make sure it's all correct and verified

@stuartcarnie
stuartcarnie self-requested a review September 7, 2026 20:37

@stuartcarnie stuartcarnie left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Looks great, thanks @oPinon!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:manual Issues and PRs related to the Manual/Tutorials section of the documentation enhancement platform:visionos topic:platforms

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants