Skip to content

Disable unsupported SSR, SSS, DoF on transparent viewports #108206

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

Calinou
Copy link
Member

@Calinou Calinou commented Jul 2, 2025

For technical reasons, transparent viewports cannot support screen-space reflections, subsurface scattering and depth of field. Previously, enabling any of these would turn transparent viewports invisible.

Preview

image

For technical reasons, transparent viewports cannot support
screen-space reflections, subsurface scattering and depth of field.
Previously, enabling any of these would turn transparent viewports
invisible.
@Calinou Calinou added this to the 4.5 milestone Jul 2, 2025
@Calinou Calinou requested review from a team as code owners July 2, 2025 15:58
@Calinou Calinou added bug topic:rendering documentation topic:3d cherrypick:4.4 Considered for cherry-picking into a future 4.4.x release labels Jul 2, 2025
WARN_PRINT_ONCE("Sub-surface scattering is not supported in viewports with a transparent background. Disabling SSS in transparent viewport.");
using_sss = false;
}

if ((using_sss || ce_needs_separate_specular) && !using_separate_specular) {
Copy link
Member Author

@Calinou Calinou Jul 2, 2025

Choose a reason for hiding this comment

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

This check makes me curious: are all compositor effects that need separate specular broken when using a transparent background? If so, we should add a dedicated warning here when such an effect is used.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug cherrypick:4.4 Considered for cherry-picking into a future 4.4.x release documentation topic:rendering topic:3d
Projects
None yet
Development

Successfully merging this pull request may close these issues.

SSR causes opaque meshes inside a subviewport with transparent bg to get invisible
1 participant