Document the contents of CreateHalftonePalette

[peteroupc]

Type of issue

Missing information

Feedback

The list of 256 colors of the palette returned by CreateHalftonePalette should be documented. This is especially because some pages on Microsoft Learn may refer to this "halftone palette", such as:

• https://learn.microsoft.com/en-us/cpp/windows/creating-an-icon-or-other-image-image-editor-for-icons?view=msvc-170
• https://learn.microsoft.com/en-us/previous-versions/ms997621(v=msdn.10).

I post this issue here because the sdk-api repository doesn't allow for posting issues, and because it relates to Windows application development.

---

Given that GDI in Windows 8 and later allows for only 32-bit-per-pixel display modes, there is a good chance that CreateHalftonePalette is simulated in such versions, and that other aspects of 8-bit-per-pixel and lower pixel depth modes are simulated, such as the rest of the Windows palette manager or the use of a specific dithering algorithm (and, if so, this dithering algorithm should be documented as well as all other aspects necessary for applications to do a like simulation).