The v4l2_plane_pix_format structures define size and layout for each of the planes in a multi-planar format. The v4l2_pix_format_mplane structure contains information common to all planes (such as image width and height) and an array of v4l2_plane_pix_format structures, describing all planes of that format.
Table 2.2. struct v4l2_plane_pix_format
| __u32 | sizeimage | Maximum size in bytes required for image data in this plane. |
| __u32 | bytesperline | Distance in bytes between the leftmost pixels in two adjacent lines. See struct v4l2_pix_format. |
| __u16 | reserved[6] | Reserved for future extensions. Should be zeroed by drivers and applications. |
Table 2.3. struct v4l2_pix_format_mplane
| __u32 | width | Image width in pixels. See struct v4l2_pix_format. |
| __u32 | height | Image height in pixels. See struct v4l2_pix_format. |
| __u32 | pixelformat | The pixel format. Both single- and multi-planar four character codes can be used. |
| enum v4l2_field | field | See struct v4l2_pix_format. |
| enum v4l2_colorspace | colorspace | See struct v4l2_pix_format. |
| struct v4l2_plane_pix_format | plane_fmt[VIDEO_MAX_PLANES] | An array of structures describing format of each plane this
pixel format consists of. The number of valid entries in this array
has to be put in the num_planes
field. |
| __u8 | num_planes | Number of planes (i.e. separate memory buffers) for this format
and the number of valid entries in the
plane_fmt array. |
| __u8 | flags | Flags set by the application or driver, see Table 2.23, “Format Flags”. |
| enum v4l2_ycbcr_encoding | ycbcr_enc | This information supplements the
colorspace and must be set by the driver for
capture streams and by the application for output streams,
see the section called “Colorspaces”. |
| enum v4l2_quantization | quantization | This information supplements the
colorspace and must be set by the driver for
capture streams and by the application for output streams,
see the section called “Colorspaces”. |
| enum v4l2_xfer_func | xfer_func | This information supplements the
colorspace and must be set by the driver for
capture streams and by the application for output streams,
see the section called “Colorspaces”. |
| __u8 | reserved[7] | Reserved for future extensions. Should be zeroed by drivers and applications. |