dotnet / dotnet/dotnet-api-docs

PixelFormats.Prgba64 docs has invalid statement (channel bits : 32, instead of 16)

Open
#7,538 1 comment 0 reactions 0 assignees View on GitHub
area-WPF Pri3 untriaged
Dominant language
C#
Stars
949
Forks
1.7k
Avg merge
3d 27m
Merged PRs (30d)
49

Description

Documentation on PixelFormats.Prgba64 member has following invalid statement ("Each channel (...) is allocated 32 bits per pixel"):
`Gets the pixel format. is a sRGB format with 64 bits per pixel (BPP). Each channel (blue, green, red, and alpha) is allocated 32 bits per pixel (BPP). Each color channel is pre-multiplied by the alpha value. This format has a gamma of 1.0.`

Obviously it should state the following ("Each channel (...) is allocated 16 bits per pixel" instead):
`Gets the pixel format. is a sRGB format with 64 bits per pixel (BPP). Each channel (blue, green, red, and alpha) is allocated 16 bits per pixel (BPP). Each color channel is pre-multiplied by the alpha value. This format has a gamma of 1.0.`

32 bits per channel is misleading, someone might think it's 128 bits pixel format, or some magic composition of values is happening like in RGBE WIC pixel format.

Also it bothers me missing 'with', shouldn't it state : "Each channel (...) is allocated with N bits per pixel"?
All members in PixelFormats class have missing 'with', but it's not big concern (it transfers the idea correctly).

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.