vlc.VideoFormatCb

class vlc.VideoFormatCb

Bases: ctypes.c_void_p

Callback prototype to configure picture buffers format. This callback gets the format of the video as output by the video decoder and the chain of video filters (if any). It can opt to change any parameter as it needs. In that case, LibVLC will attempt to convert the video format (rescaling and chroma conversion) but these operations can be CPU intensive.

Note

For each pixels plane, the scanline pitch must be bigger than or equal to the number of bytes per pixel multiplied by the pixel width. Similarly, the number of scanlines must be bigger than of equal to the pixel height. Furthermore, we recommend that pitches and lines be multiple of 32 to not break assumptions that might be held by optimized code in the video decoders, video filters and/or video converters.

Parameters:

  • opaque – pointer to the private pointer passed to. libvlc_video_set_callbacks() [IN/OUT].

  • chroma – pointer to the 4 bytes video format identifier [IN/OUT].

  • width – pointer to the pixel width [IN/OUT].

  • height – pointer to the pixel height [IN/OUT].

  • pitches – table of scanline pitches in bytes for each pixel plane. (the table is allocated by LibVLC) [OUT].

  • lines – table of scanlines count for each plane [OUT].

Returns:

the number of picture buffers allocated, 0 indicates failure.

Initialize self. See help(type(self)) for accurate signature.