@@ -510,11 +510,20 @@ typedef struct _VABlendState {
510510 * \brief Specifies whether to apply power or performance
511511 * optimizations to a pipeline.
512512 *
513- * When processing several surfaces, it may be necessary to prioritize
514- * more certain pipelines than others. This flag is only a hint to the
515- * video processor so that it can omit certain filters to save power
516- * for example. Typically, this flag could be used with video surfaces
517- * decoded from a secondary bitstream.
513+ * This flag is a hint to the video processor to achieve faster processing speed
514+ * (better performance)in the pipeine. Hardware vendor might have several approaches
515+ * for one functionality, this flag is to indicate the one with best performance.
516+ * Performance depends on the hardware capablity, plesae refer to the specific hardware
517+ * specification from hardware vendors. Here, lists a few examples as the reference.
518+ * 1) When processing several surfaces, it may be necessary to prioritize more certain
519+ * pipelines with this flag than others. 2) This flag is only a hint to the video processor
520+ * so that it can omit certain filters for better performance for example. 3) Typically, this
521+ * flag could be used with video surfaces decoded from a secondary bitstream.
522+ *
523+ * Regarding the usage of this flag, there are some filter properties in vaapi such as
524+ * VA_FILTER_SCALING_XXX, when VA_PROC_PIPELINE_FAST is combined with these properties,
525+ * the backend implementation should honor VA_PROC_PIPELINE_FAST which means this flag
526+ * could change the filter properties implicitly for better performance.
518527 */
519528#define VA_PROC_PIPELINE_FAST 0x00000002
520529/**@}*/
0 commit comments