Gpu相关笔记

/**
 	 * \brief Creates an array of surfaces
 	 *
 	 * Creates an array of surfaces. The optional list of attributes shall
 	 * be constructed based on what the underlying hardware could expose
 	 * through vaQuerySurfaceAttributes().
 	 *
 	 * @param[in] dpy               the VA display
 	 * @param[in] format            the desired surface format. See \c VA_RT_FORMAT_*
 	 * @param[in] width             the surface width
 	 * @param[in] height            the surface height
 * @param[out] surfaces         the array of newly created surfaces
 	 * @param[in] num_surfaces      the number of surfaces to create
 	 * @param[in] attrib_list       the list of (optional) attributes, or \c NULL
 	 * @param[in] num_attribs       the number of attributes supplied in
 	 *     \c attrib_list, or zero
 	 */
VAStatus
vaCreateSurfaces(
		VADisplay           dpy,
		unsigned int        format,
		unsigned int        width,
		unsigned int        height,
		VASurfaceID        *surfaces,
		unsigned int        num_surfaces,
		VASurfaceAttrib    *attrib_list,
		unsigned int        num_attribs
);   

/**
 	 * Create a VAImage structure
 	 * The width and height fields returned in the VAImage structure may get 
 	 * enlarged for some YUV formats. Upon return from this function, 
 	 * image->buf has been created and proper storage allocated by the library. 
 	 * The client can access the image through the Map/Unmap calls.
 	 */
VAStatus vaCreateImage (
	VADisplay dpy,
	VAImageFormat *format,
	int width,
	int height,
	VAImage *image	/* out */
);

typedef struct _VAImage
{
	VAImageID		image_id; /* uniquely identify this image */
	VAImageFormat		format;
   	VABufferID		buf;	/* image data buffer */
	/*
 	 * Image data will be stored in a buffer of type VAImageBufferType to facilitate
 	 * data store on the server side for optimal performance. The buffer will be 
 	 * created by the CreateImage function, and proper storage allocated based on the image
 	 * size and format. This buffer is managed by the library implementation, and 
 	 * accessed by the client through the buffer Map/Unmap functions.
  	 */
	uint16_t	width; 
	uint16_t	height;
	uint32_t	data_size;
	uint32_t	num_planes;	/* can not be greater than 3 */
	/* 
 	 * An array indicating the scanline pitch in bytes for each plane.
 	 * Each plane may have a different pitch. Maximum 3 planes for planar formats
 	 */
	uint32_t	pitches[3];
	/* 
	 * An array indicating the byte offset from the beginning of the image data 
	 * to the start of each plane.
 	 */
	uint32_t	offsets[3];

	/* The following fields are only needed for paletted formats */
	int32_t num_palette_entries;   /* set to zero for non-palette images */
	/* 
 	 * Each component is one byte and entry_bytes indicates the number of components in 
 	 * each entry (eg. 3 for YUV palette entries). set to zero for non-palette images   
 	 */
	int32_t entry_bytes; 
	/*
 	 * An array of ascii characters describing the order of the components within the bytes.
 	 * Only entry_bytes characters of the string are used.
 	 */
	int8_t component_order[4];

	/** \brief Reserved bytes for future use, must be zero */
	uint32_t                va_reserved[VA_PADDING_LOW];
} VAImage;

/** Buffer functions */

/**
 * Creates a buffer for "num_elements" elements of "size" bytes and 
 * initalize with "data".
 * if "data" is null, then the contents of the buffer data store
 * are undefined.
 * Basically there are two ways to get buffer data to the server side. One is 
 * to call vaCreateBuffer() with a non-null "data", which results the data being
 * copied to the data store on the server side.  A different method that 
 * eliminates this copy is to pass null as "data" when calling vaCreateBuffer(),
 * and then use vaMapBuffer() to map the data store from the server side to the
 * client address space for access.
 * The user must call vaDestroyBuffer() to destroy a buffer.
 *  Note: image buffers are created by the library, not the client. Please see 
 *        vaCreateImage on how image buffers are managed.
 */
VAStatus vaCreateBuffer (
	VADisplay dpy,
	VAContextID context,
	VABufferType type,	/* in */
	unsigned int size,	/* in */
	unsigned int num_elements, /* in */
	void *data,		/* in */
	VABufferID *buf_id	/* out */
);

typedef enum
{
	VAPictureParameterBufferType	= 0,
	VAIQMatrixBufferType		= 1,
	VABitPlaneBufferType		= 2,
	VASliceGroupMapBufferType		= 3,
	VASliceParameterBufferType		= 4,
	VASliceDataBufferType		= 5,
	VAMacroblockParameterBufferType	= 6,
	VAResidualDataBufferType		= 7,
	VADeblockingParameterBufferType	= 8,
	VAImageBufferType			= 9,
	VAProtectedSliceDataBufferType	= 10,
	VAQMatrixBufferType                 = 11,
	VAHuffmanTableBufferType            = 12,
	VAProbabilityBufferType             = 13,

	/* Following are encode buffer types */
	VAEncCodedBufferType		= 21,
	VAEncSequenceParameterBufferType	= 22,
	VAEncPictureParameterBufferType	= 23,
	VAEncSliceParameterBufferType	= 24,
	VAEncPackedHeaderParameterBufferType = 25,
	VAEncPackedHeaderDataBufferType     = 26,
	VAEncMiscParameterBufferType	= 27,
	VAEncMacroblockParameterBufferType	= 28,
	VAEncMacroblockMapBufferType        = 29,

	/**
	 * \brief Encoding QP buffer
	 *
	 * This buffer contains QP per MB for encoding. Currently
	 * VAEncQPBufferH264 is defined for H.264 encoding, see
	 * #VAEncQPBufferH264 for details
	 */
	VAEncQPBufferType                   = 30,
	/* Following are video processing buffer types */
	/**
	 * \brief Video processing pipeline parameter buffer.
	 *
	 * This buffer describes the video processing pipeline. See
	 * #VAProcPipelineParameterBuffer for details.
	 */
	VAProcPipelineParameterBufferType   = 41,
	/**
	 * \brief Video filter parameter buffer.
	 *
	 * This buffer describes the video filter parameters. All buffers
	 * inherit from #VAProcFilterParameterBufferBase, thus including
	 * a unique filter buffer type.
	 *
	 * The default buffer used by most filters is #VAProcFilterParameterBuffer.
	 * Filters requiring advanced parameters include, but are not limited to,
	 * deinterlacing (#VAProcFilterParameterBufferDeinterlacing),
	 * color balance (#VAProcFilterParameterBufferColorBalance), etc.
	 */
	VAProcFilterParameterBufferType     = 42,
VABufferTypeMax
} VABufferType;

/**
 * Create a configuration for the video decode/encode/processing pipeline
 * it passes in the attribute list that specifies the attributes it cares 
 * about, with the rest taking default values.  
 */
VAStatus vaCreateConfig (
	VADisplay dpy,
	VAProfile profile, 
	VAEntrypoint entrypoint, 
	VAConfigAttrib *attrib_list,
	int num_attribs,
	VAConfigID *config_id /* out */
);

/**
 *  Currently defined entrypoints 
 */
typedef enum
{
	VAEntrypointVLD		= 1,
	VAEntrypointIZZ		= 2,
	VAEntrypointIDCT		= 3,
	VAEntrypointMoComp		= 4,
	VAEntrypointDeblocking	= 5,
	VAEntrypointEncSlice	= 6,	/* slice level encode */
	VAEntrypointEncPicture 	= 7,	/* pictuer encode, JPEG, etc */
   		/*
	 * For an implementation that supports a low power/high performance variant
	 * for slice level encode, it can choose to expose the
	 * VAEntrypointEncSliceLP entrypoint. Certain encoding tools may not be
	 * available with this entrypoint (e.g. interlace, MBAFF) and the
 	 * application can query the encoding configuration attributes to find
	 * out more details if this entrypoint is supported.
	 */
	VAEntrypointEncSliceLP 	= 8,
	VAEntrypointVideoProc       = 10,   /**< Video pre/post-processing. */
} VAEntrypoint;


/** Currently defined profiles */
typedef enum
{
	/** \brief Profile ID used for video processing. */
	VAProfileNone                       = -1,
	VAProfileMPEG2Simple		= 0,
	VAProfileMPEG2Main			= 1,
	VAProfileMPEG4Simple		= 2,
	VAProfileMPEG4AdvancedSimple	= 3,
	VAProfileMPEG4Main			= 4,
	VAProfileH264Baseline va_deprecated_enum = 5,
	VAProfileH264Main			= 6,
	VAProfileH264High			= 7,
	VAProfileVC1Simple			= 8,
	VAProfileVC1Main			= 9,
	VAProfileVC1Advanced		= 10,
	VAProfileH263Baseline		= 11,
	VAProfileJPEGBaseline               = 12,
	VAProfileH264ConstrainedBaseline    = 13,
	VAProfileVP8Version0_3              = 14,
	VAProfileH264MultiviewHigh          = 15,
	VAProfileH264StereoHigh             = 16,
	VAProfileHEVCMain                   = 17,
	VAProfileHEVCMain10                 = 18,
	VAProfileVP9Profile0                = 19,
	VAProfileVP9Profile1                = 20,
	VAProfileVP9Profile2                = 21,
	VAProfileVP9Profile3                = 22
} VAProfile;

/**
 * vaCreateContext - Create a context
 *  dpy: display
 *  config_id: configuration for the context
 *  picture_width: coded picture width
 *  picture_height: coded picture height
 *  flag: any combination of the following:
 *    VA_PROGRESSIVE (only progressive frame pictures in the sequence when set)
 *  render_targets: a hint for render targets (surfaces) tied to the context
 *  num_render_targets: number of render targets in the above array
 	 *  context: created context id upon return
 	 */
VAStatus vaCreateContext (
	VADisplay dpy,
	VAConfigID config_id,
	int picture_width,
	int picture_height,
	int flag,
	VASurfaceID *render_targets,
	int num_render_targets,
	VAContextID *context		/* out */
);