video: improve docs and design of multiview interlaced

Put fields of interlaced frames after eachother.
Improve the docs of the video interlaced enums.
This commit is contained in:
Wim Taymans 2012-04-25 15:27:04 +02:00
parent 07d34f576a
commit ae42b25c07
2 changed files with 9 additions and 8 deletions

View file

@ -31,8 +31,8 @@ Media Types
the frame and fields. the frame and fields.
"fields" : 2 fields are stored in one buffer, use the frame ID "fields" : 2 fields are stored in one buffer, use the frame ID
to get access to the required field. For multiview (the to get access to the required field. For multiview (the
'views' property > 1) the second field of view N is at N + 'views' property > 1) the fields of view N can be found at
'views'. frame ID (N * 2) and (N * 2) + 1.
Each view has only half the amount of lines as noted in the Each view has only half the amount of lines as noted in the
height property, pads specifying the "fields" property height property, pads specifying the "fields" property
must be prepared for this. This mode requires multiple must be prepared for this. This mode requires multiple

View file

@ -312,14 +312,15 @@ typedef struct _GstVideoFrame GstVideoFrame;
/** /**
* GstVideoInterlaceMode: * GstVideoInterlaceMode:
* @GST_VIDEO_INTERLACE_MODE_PROGRESSIVE: all frames are progressive * @GST_VIDEO_INTERLACE_MODE_PROGRESSIVE: all frames are progressive
* @GST_VIDEO_INTERLACE_MODE_INTERLEAVED: video is interlaced and all fields * @GST_VIDEO_INTERLACE_MODE_INTERLEAVED: 2 fields are interleaved in one video
* are interlaced in one frame. * frame. Extra buffer flags describe the field order.
* @GST_VIDEO_INTERLACE_MODE_MIXED: video contains both interlaced and * @GST_VIDEO_INTERLACE_MODE_MIXED: frames contains both interlaced and
* progressive frames, the buffer flags describe the frame and fields. * progressive video, the buffer flags describe the frame and fields.
* @GST_VIDEO_INTERLACE_MODE_FIELDS: 2 fields are stored in one buffer, use the * @GST_VIDEO_INTERLACE_MODE_FIELDS: 2 fields are stored in one buffer, use the
* frame ID to get access to the required field. For multiview (the * frame ID to get access to the required field. For multiview (the
* 'views' property > 1) the second field of view N is at N + 'views'. * 'views' property > 1) the fields of view N can be found at frame ID
* Each view has only half the amount of lines as noted in the * (N * 2) and (N * 2) + 1.
* Each field has only half the amount of lines as noted in the
* height property. This mode requires multiple GstVideoMeta metadata * height property. This mode requires multiple GstVideoMeta metadata
* to describe the fields. * to describe the fields.
* *