Sync SDL3 wiki -> header

include/SDL3/SDL_pixels.h

@@ -176,37 +176,35 @@ typedef enum SDL_PackedLayout
  *
  * SDL's pixel formats have the following naming convention:
  *
- * - Names with a list of components and a single bit count, such as
+ * - Names with a list of components and a single bit count, such as RGB24 and
- *   RGB24 and ABGR32, define a platform-independent encoding into
+ *   ABGR32, define a platform-independent encoding into bytes in the order
- *   bytes in the order specified. For example, in RGB24 data, each
+ *   specified. For example, in RGB24 data, each pixel is encoded in 3 bytes
- *   pixel is encoded in 3 bytes (red, green, blue) in that order,
+ *   (red, green, blue) in that order, and in ABGR32 data, each pixel is
- *   and in ABGR32 data, each pixel is encoded in 4 bytes
+ *   encoded in 4 bytes alpha, blue, green, red) in that order. Use these
- *   alpha, blue, green, red) in that order. Use these names if the
+ *   names if the property of a format that is important to you is the order
- *   property of a format that is important to you is the order of
+ *   of the bytes in memory or on disk.
- *   the bytes in memory or on disk.
+ * - Names with a bit count per component, such as ARGB8888 and XRGB1555, are
- * - Names with a bit count per component, such as ARGB8888 and
+ *   "packed" into an appropriately-sized integer in the platform's native
- *   XRGB1555, are "packed" into an appropriately-sized integer in
+ *   endianness. For example, ARGB8888 is a sequence of 32-bit integers; in
- *   the platform's native endianness. For example, ARGB8888 is
+ *   each integer, the most significant bits are alpha, and the least
- *   a sequence of 32-bit integers; in each integer, the most
+ *   significant bits are blue. On a little-endian CPU such as x86, the least
- *   significant bits are alpha, and the least significant bits are
+ *   significant bits of each integer are arranged first in memory, but on a
- *   blue. On a little-endian CPU such as x86, the least significant
+ *   big-endian CPU such as s390x, the most significant bits are arranged
- *   bits of each integer are arranged first in memory, but on a
+ *   first. Use these names if the property of a format that is important to
- *   big-endian CPU such as s390x, the most significant bits are
+ *   you is the meaning of each bit position within a native-endianness
- *   arranged first. Use these names if the property of a format that
+ *   integer.
- *   is important to you is the meaning of each bit position within a
+ * - In indexed formats such as INDEX4LSB, each pixel is represented by
- *   native-endianness integer.
+ *   encoding an index into the palette into the indicated number of bits,
- * - In indexed formats such as INDEX4LSB, each pixel is represented
+ *   with multiple pixels packed into each byte if appropriate. In LSB
- *   by encoding an index into the palette into the indicated number
+ *   formats, the first (leftmost) pixel is stored in the least-significant
- *   of bits, with multiple pixels packed into each byte if appropriate.
+ *   bits of the byte; in MSB formats, it's stored in the most-significant
- *   In LSB formats, the first (leftmost) pixel is stored in the
+ *   bits. INDEX8 does not need LSB/MSB variants, because each pixel exactly
- *   least-significant bits of the byte; in MSB formats, it's stored
+ *   fills one byte.
- *   in the most-significant bits. INDEX8 does not need LSB/MSB
- *   variants, because each pixel exactly fills one byte.
  *
  * The 32-bit byte-array encodings such as RGBA32 are aliases for the
- * appropriate 8888 encoding for the current platform. For example,
+ * appropriate 8888 encoding for the current platform. For example, RGBA32 is
- * RGBA32 is an alias for ABGR8888 on little-endian CPUs like x86,
+ * an alias for ABGR8888 on little-endian CPUs like x86, or an alias for
- * or an alias for RGBA8888 on big-endian CPUs.
+ * RGBA8888 on big-endian CPUs.
  *
  * \since This enum is available since SDL 3.0.0.
  */