vlc.VideoFormatCb
=================

.. py:class:: vlc.VideoFormatCb

   Bases: :py:obj:`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.

   :param opaque: pointer to the private pointer passed to.
       :func:`libvlc_video_set_callbacks` [IN/OUT].
   :param chroma: pointer to the 4 bytes video format identifier [IN/OUT].
   :param width: pointer to the pixel width [IN/OUT].
   :param height: pointer to the pixel height [IN/OUT].
   :param pitches: table of scanline pitches in bytes for each pixel plane.
       (the table is allocated by LibVLC) [OUT].
   :param lines: table of scanlines count for each plane [OUT].

   :return: the number of picture buffers allocated, 0 indicates failure.

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