• Hans Verkuil's avatar
    [media] DocBook v4l: update bytesperline handling · 2ddb77bb
    Hans Verkuil authored
    The documentation says that the bytesperline field in v4l2_pix_format refers
    to the largest plane in the case of planar formats (i.e. multiple planes
    stores in a single buffer).
    
    For almost all planar formats the first plane is also the largest (or equal)
    plane, except for two formats: V4L2_PIX_FMT_NV24/NV42. For this YUV 4:4:4
    format the second chroma plane is twice the size of the first luma plane.
    
    Looking at the very few drivers that support this format the bytesperline
    value that they report is actually that of the first plane and not that
    of the largest plane.
    
    Rather than fixing the drivers it makes more sense to update the documentation
    since it is very difficult to use the largest plane for this. You would have
    to check what the format is in order to know to which plane bytesperline
    belongs, which makes calculations much more difficult.
    
    This patch updates the documentation accordingly.
    Signed-off-by: default avatarHans Verkuil <hans.verkuil@cisco.com>
    Acked-by: default avatarLaurent Pinchart <laurent.pinchart@ideasonboard.com>
    Acked-by: default avatarSakari Ailus <sakari.ailus@linux.intel.com>
    Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
    2ddb77bb
vidioc-g-fbuf.xml 17.5 KB