[VDPAU] [PATCH 1/1] Add new frame and field mode chroma types. Add VdpDecoderQueryProfileCapability API
Manoj Bonda
mbonda at nvidia.com
Wed Oct 17 12:16:26 UTC 2018
From: manoj <mbonda at nvidia.com>
Chroma types :
VDP_CHROMA_TYPE_420
VDP_CHROMA_TYPE_422
VDP_CHROMA_TYPE_444
already exist, surfaces of these types could be transparently used with
any VdpVideoDecoder. The implementation is free to internally convert
the surface between frame/field(NV12/NV24) as required by
VdpVideoDecoder operation. The interop API would allow registration of
these surfaces for either field or frame based interop.
This change adds new enums for frame and field chroma types:
VDP_CHROMA_TYPE_420_FIELD
VDP_CHROMA_TYPE_422_FIELD
VDP_CHROMA_TYPE_444_FIELD
VDP_CHROMA_TYPE_420_FRAME
VDP_CHROMA_TYPE_422_FRAME
VDP_CHROMA_TYPE_444_FRAME
So that frame/field based video surfaces can be created and exposed via
VDPAU OpenGL interop.
The new chroma types could only be used by a VdpVideoDecoder that
supports output to field/frame surfaces respectively. Internal surface
convertion is not allowed. The interop API would allow registration
of these surfaces to field/frame based interop only. This will avoid
implicit conversions and allocation of shadow surface.
Existing VdpDecoderQueryCapabilities() returns maxlevel, maxwidth,
height and macro blocks for a given decoder profile. Since it is not
possible to extend this API to return more capabilities, adding new API
VdpDecoderQueryProfileCapability(). In this change, new API will be able
to return supported picture structure along with other existing
capabilities.
VdpDecoderQueryProfileCapability() can be extended in future to query
newer capabilities exposed. VdpDecoderCapabilities defines the
capabilities that can be queried.
This function returns queried capability of the requested profile on the
underlying h/w. By design, only one capability can be queried at a time.
---
include/vdpau/vdpau.h | 93 +++++++++++++++++++++++++++++++++++++++++--
1 file changed, 90 insertions(+), 3 deletions(-)
diff --git a/include/vdpau/vdpau.h b/include/vdpau/vdpau.h
index 0bc5b60..3e5a980 100644
--- a/include/vdpau/vdpau.h
+++ b/include/vdpau/vdpau.h
@@ -838,13 +838,66 @@ typedef int VdpBool;
*/
typedef uint32_t VdpChromaType;
-/** \hideinitializer \brief 4:2:0 chroma format. */
+/** \hideinitializer \brief 4:2:0 chroma format. Undefined field/frame based
+ * Video surfaces allocated with this chroma type have undefined
+ * field/frame structure. The implementation is free to internally morph
+ * the surface between frame/field(NV12/NV24) as required by
+ * VdpVideoDecoder operation. Interop with OpenGL allows registration
+ * of these surfaces for either field- or frame-based interop. But, an implicit
+ * field/frame structure conversion may be performed.
+ */
#define VDP_CHROMA_TYPE_420 ((VdpChromaType)0)
-/** \hideinitializer \brief 4:2:2 chroma format. */
+/** \hideinitializer \brief 4:2:2 chroma format. Undefined field/frame based
+ * Video surfaces allocated with this chroma type have undefined
+ * field/frame structure. The implementation is free to internally morph
+ * the surface between frame/field(NV12/NV24) as required by
+ * VdpVideoDecoder operation. Interop with OpenGL allows registration
+ * of these surfaces for either field- or frame-based interop. But, an implicit
+ * field/frame structure conversion may be performed.
+ */
#define VDP_CHROMA_TYPE_422 ((VdpChromaType)1)
-/** \hideinitializer \brief 4:4:4 chroma format. */
+/** \hideinitializer \brief 4:4:4 chroma format. Undefined field/frame based
+ * Video surfaces allocated with this chroma type have undefined
+ * field/frame structure. The implementation is free to internally morph
+ * the surface between frame/field(NV12/NV24) as required by
+ * VdpVideoDecoder operation. Interop with OpenGL allows registration
+ * of these surfaces for either field- or frame-based interop. But, an implicit
+ * field/frame structure conversion may be performed.
+ */
#define VDP_CHROMA_TYPE_444 ((VdpChromaType)2)
+/** \hideinitializer \brief 4:2:0 chroma format. Field based.
+ * Video surfaces allocated with this chroma type can only be
+ * interoped with OpenGL if the matching field/frame structure is
+ * specified in the OpenGL API */
+#define VDP_CHROMA_TYPE_420_FIELD ((VdpChromaType)3)
+/** \hideinitializer \brief 4:2:2 chroma format. Field based.
+ * Video surfaces allocated with this chroma type can only be
+ * interoped with OpenGL if the matching field/frame structure is
+ * specified in the OpenGL API */
+#define VDP_CHROMA_TYPE_422_FIELD ((VdpChromaType)4)
+/** \hideinitializer \brief 4:4:4 chroma format. Field based.
+ * Video surfaces allocated with this chroma type can only be
+ * interoped with OpenGL if the matching field/frame structure is
+ * specified in the OpenGL API */
+#define VDP_CHROMA_TYPE_444_FIELD ((VdpChromaType)5)
+
+/** \hideinitializer \brief 4:2:0 chroma format. Frame based.
+ * Video surfaces allocated with this chroma type can only be
+ * interoped with OpenGL if the matching field/frame structure is
+ * specified in the OpenGL API */
+#define VDP_CHROMA_TYPE_420_FRAME ((VdpChromaType)6)
+/** \hideinitializer \brief 4:2:2 chroma format. Frame based.
+ * Video surfaces allocated with this chroma type can only be
+ * interoped with OpenGL if the matching field/frame structure is
+ * specified in the OpenGL API */
+#define VDP_CHROMA_TYPE_422_FRAME ((VdpChromaType)7)
+/** \hideinitializer \brief 4:4:4 chroma format. Frame based.
+ * Video surfaces allocated with this chroma type can only be
+ * interoped with OpenGL if the matching field/frame structure is
+ * specified in the OpenGL API */
+#define VDP_CHROMA_TYPE_444_FRAME ((VdpChromaType)8)
+
/**
* \brief The set of all known YCbCr surface formats.
*/
@@ -2620,6 +2673,38 @@ typedef uint32_t VdpDecoderProfile;
/** \hideinitializer */
#define VDP_DECODER_LEVEL_HEVC_6_2 186
+typedef enum {
+ VDP_VIDEO_SURFACE_FIELD = (1 << 0),
+ VDP_VIDEO_SURFACE_FRAME = (1 << 1)
+} VdpVideoSurfaceSupportedType;
+
+typedef enum {
+ VDP_DECODER_PROFILE_MAX_LEVEL = 0,
+ VDP_DECODER_PROFILE_MAX_MACROBLOCKS = 1,
+ VDP_DECODER_PROFILE_MAX_WIDTH = 2,
+ VDP_DECODER_PROFILE_MAX_HEIGHT = 3,
+ VDP_DECODER_PROFILE_SUPPORTED_SURFACE_FORMAT = 4
+} VdpDecoderCapabilities;
+
+/**
+ * \brief Query the supported value of the requested capability, for
+ * the specified profile on the specified device.
+ * \param[in] device The device to query.
+ * \param[in] profile The decoder profile for which information is requested.
+ * \param[in] capability The decoder profile capability for which the value
+ * is requested.
+ * \param[out] capability_value The value of the requested capability.
+ * \return VdpStatus The completion status of the operation.
+ */
+
+typedef VdpStatus VdpDecoderQueryProfileCapability(
+ VdpDevice device,
+ VdpDecoderProfile profile,
+ /* output parameters follow */
+ VdpDecoderCapabilities capability,
+ void * capability_value
+);
+
/**
* \brief Query the implementation's VdpDecoder capabilities.
* \param[in] device The device to query.
@@ -4587,6 +4672,8 @@ typedef uint32_t VdpFuncId;
#define VDP_FUNC_ID_PRESENTATION_QUEUE_QUERY_SURFACE_STATUS ((VdpFuncId)65)
/** \hideinitializer */
#define VDP_FUNC_ID_PREEMPTION_CALLBACK_REGISTER ((VdpFuncId)66)
+/** \hideinitializer */
+#define VDP_FUNC_ID_DECODER_QUERY_CAPABILITY ((VdpFuncId)67)
#define VDP_FUNC_ID_BASE_WINSYS 0x1000
--
2.19.1
More information about the VDPAU
mailing list