Package uk.co.caprica.vlcj.binding.internal

Interface libvlc_video_format_cb

  • All Superinterfaces:
    com.sun.jna.Callback
    public interface libvlc_video_format_cb
extends com.sun.jna.Callback
    Callback prototype to configure picture buffers format.

    • Nested Class Summary

      • Nested classes/interfaces inherited from interface com.sun.jna.Callback

        com.sun.jna.Callback.UncaughtExceptionHandler

    • Field Summary

      • Fields inherited from interface com.sun.jna.Callback

        FORBIDDEN_NAMES, METHOD_NAME

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      int format​(com.sun.jna.ptr.PointerByReference opaque, com.sun.jna.ptr.PointerByReference chroma, com.sun.jna.ptr.IntByReference width, com.sun.jna.ptr.IntByReference height, com.sun.jna.ptr.PointerByReference pitches, com.sun.jna.ptr.PointerByReference lines)
      Callback prototype to configure picture buffers format.

    • Method Detail

      • format

        int format​(com.sun.jna.ptr.PointerByReference opaque,
           com.sun.jna.ptr.PointerByReference chroma,
           com.sun.jna.ptr.IntByReference width,
           com.sun.jna.ptr.IntByReference height,
           com.sun.jna.ptr.PointerByReference pitches,
           com.sun.jna.ptr.PointerByReference lines)
        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.

        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 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 assumption that might be made by various optimizations in the video decoders, video filters and/or video converters.