Skip to content

Add manual page for premultiplied alpha blending#12151

Closed
Jordyfel wants to merge 1 commit into
godotengine:masterfrom
Jordyfel:premul-alpha-docs
Closed

Add manual page for premultiplied alpha blending#12151
Jordyfel wants to merge 1 commit into
godotengine:masterfrom
Jordyfel:premul-alpha-docs

Conversation

@Jordyfel

@Jordyfel Jordyfel commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

The engine has options called premultiplied alpha in materials, shader blend modes and texture import settings, but the docs do not do a good job of explaining what they do and how to effectively utilize them. I was very confused when trying to use them at first so I'd like to add a documentation page in the manual.

I didn't manage to build the docs to preview the page for now, I will try again later.

@Jordyfel
Jordyfel requested review from a team as code owners July 16, 2026 09:09
@Jordyfel
Jordyfel force-pushed the premul-alpha-docs branch 2 times, most recently from de91c9b to 287ff1e Compare July 16, 2026 09:16
Comment thread tutorials/rendering/premultiplied_alpha_blending.rst Outdated
Comment thread tutorials/rendering/premultiplied_alpha_blending.rst Outdated
Comment thread tutorials/rendering/premultiplied_alpha_blending.rst Outdated
Comment thread tutorials/rendering/premultiplied_alpha_blending.rst Outdated
Comment thread tutorials/rendering/premultiplied_alpha_blending.rst Outdated
Comment thread tutorials/rendering/premultiplied_alpha_blending.rst Outdated
Comment thread tutorials/rendering/img/non-premul-alpha.png Outdated
Comment thread tutorials/rendering/premultiplied_alpha_blending.rst Outdated
Comment thread tutorials/rendering/premultiplied_alpha_blending.rst Outdated
@Jordyfel
Jordyfel force-pushed the premul-alpha-docs branch 2 times, most recently from 5a22ade to 8b53cf6 Compare July 16, 2026 09:30
@Jordyfel

Copy link
Copy Markdown
Contributor Author

Thanks for the review, will do the images later.

@Jordyfel
Jordyfel force-pushed the premul-alpha-docs branch from 8b53cf6 to ed88d73 Compare July 16, 2026 09:33
@Jordyfel
Jordyfel force-pushed the premul-alpha-docs branch from ed88d73 to d0686d7 Compare July 16, 2026 20:11
@Jordyfel

Copy link
Copy Markdown
Contributor Author

Converted the images and reworded a little at the end.

@Calinou Calinou added content:new page Issues and PRs related to creation of new documentation pages for new or undocumented features topic:rendering area:manual Issues and PRs related to the Manual/Tutorials section of the documentation labels Jul 17, 2026
@skyace65

Copy link
Copy Markdown
Member

Hi Jordyfel, I've talked to some other maintainers and unfortunately this PR falls out of scope for what we want to have in the documentation.

Generally speaking we try to keep explanations for concepts that aren't Godot specific to a minimum. For example, we don't have a dedicated page breaking down how PBR materials work in a 3D scene, all major engines use them not just Godot. And it's the same with pre-multiplied alpha, that's not a Godot specific technology or way of doing things.

Putting that aside, a lot of the text in this PR is an over explanation for how this works. We generally strive to keep descriptions brief and accurate, if a page is filled with unnecessary information that's then more time a user has to spend finding what they need.

We appreciate the effort that you put into this PR, and I hope you'll consider contributing again in the future if you find something else you think could be improved. We have some guidelines if you want a more clear idea of what we're looking for: https://contributing.godotengine.org/en/latest/documentation/guidelines/index.html

@skyace65 skyace65 closed this Jul 25, 2026
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 content:new page Issues and PRs related to creation of new documentation pages for new or undocumented features topic:rendering

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants