# 视频 API
Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/video-apis.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/video-apis.html)
使用视频 API 配置视频缓存和视频转换器。
## GstImageBufferPool API
- 配置它以将 [GstVideoMeta](https://gstreamer.freedesktop.org/documentation/video/gstvideometa.html#GstVideoMeta) 添加至缓存。
- 配置视频特定要求：
- 步幅对齐或像素填充
- 内存管理类型 (GBM/ION)。
Figure : GstImageBufferPool 工作流
以下列表提供了 GstImageBufferPool API 的说明：
- **原型**
创建一个缓存池，用于将视频帧缓存分配给内存。
GstBufferPool *
gst_image_buffer_pool_new (const gchar * type)Copy to clipboard
- **参数**
| [in] | `type` | 该池用于分配缓存的内存。 |
| :--- | :--- | :--- |
- **返回结果**
- 用于分配视频帧的新 [GstBufferPool](https://gstreamer.freedesktop.org/documentation/gstreamer/gstbufferpool.html?gi-language=c)。
- [通过 gst_object_unref](https://gstreamer.freedesktop.org/documentation/gstreamer/gstobject.html#gst_object_unref) 释放。
- **参数**
下表列出了可以传递给 gst\_image\_buffer\_pool\_new() 用于配置缓存存储器的参数： | 参数 | 说明 | 用法 |
| --- | --- | --- |
| GST\_IMAGE\_BUFFER\_POOL\_TYPE\_ION | 通过 ION 内存管理器分配缓存。 | #define GST_IMAGE_BUFFER_POOL_TYPE_ION "GstBufferPoolTypeIonMemory"Copy to clipboard |
| GST\_IMAGE\_BUFFER\_POOL\_TYPE\_GBM | 通过通用缓存管理 (GBM) 分配缓存。 | #define GST_IMAGE_BUFFER_POOL_TYPE_GBM "GstBufferPoolTypeGbmMemory"Copy to clipboard |
| GST\_IMAGE\_BUFFER\_POOL\_OPTION\_UBWC\_MODE | 指示分配的缓存必须处于 Qualcomm^®^ UBWC 模式。 | #define GST_IMAGE_BUFFER_POOL_OPTION_UBWC_MODE "GstBufferPoolOptionUBWCMode"Copy to clipboard |
| GST\_IMAGE\_BUFFER\_POOL\_OPTION\_KEEP\_MAPPED | 指示映射的缓存内存是否会始终保持映射状态，直至内存被销毁。 | #define GST_IMAGE_BUFFER_POOL_OPTION_KEEP_MAPPED "GstBufferPoolOptionKeepMapped"Copy to clipboard |
## GstGlesVideoConverter API
Figure : 硬件加速的图像处理、转换和颜色转换
以下列表提供了有关每个GstGlesVideoConverter API的信息：
- **gst\_gles\_video\_converter\_new**
创建 GstGlesVideoConverter。
**原型**
GstGlesVideoConverter *
gst_gles_video_converter_new (void)Copy to clipboard
**返回结果**
一个新的 GstGlesVideoConverter，采用gst\_gles\_video\_converter\_free()可自由使用。
- gst\_gles\_video\_converter\_free：释放转换器持有的所有资源并释放与之关联的内存。
**原型**
void
gst_gles_video_converter_free (GstGlesVideoConverter * convert)Copy to clipboard
**参数**
| [in] | `convert` | 一个 GstGlesVideoConverter |
| :--- | :--- | :--- |
**返回结果**
无
- **gst\_gles\_video\_converter\_submit\_request**
提交一些将一起执行的视频作品。
**原型**
gpointer
gst_gles_video_converter_submit_request (GstGlesVideoConverter *convert, GstGlesComposition * compositions, guint n_compositions)Copy to clipboard
**参数**
| [in] | `convert` | 一个 GstGlesVideoConverter |
| :--- | :--- | :--- |
| [in] | `compositions` | 一个合成帧数组 |
| [in] | `n_compositions` | 组合数量 |
**返回结果**
如果操作成功，则唯一的指针请求 ID。
- **gst\_gles\_video\_converter\_wait\_request**
等待已提交到 GPU 的请求合成完成。
**原型**
gboolean
gst_gles_video_converter_wait_request (GstGlesVideoConverter *convert, gpointer request_id)Copy to clipboard
**参数**
| [in] | `convert` | 一个 GstGlesVideoConverter |
| :--- | :--- | :--- |
| [in] | `request_id` | 指定请求 ID |
**返回结果**
如果操作成功，则为 TRUE。
- **gst\_gles\_video\_converter\_flush**
等待已提交到 GPU 的合成完成并刷新数据。
**原型**
void
gst_gles_video_converter_flush (GstGlesVideoConverter *convert)Copy to clipboard
**参数**
| [in] | `convert` | 一个 GstGlesVideoConverter |
| :--- | :--- | :--- |
**返回结果**
无
**Parent Topic:** [GSt API](https://docs.qualcomm.com/doc/80-70020-50SC/topic/gst-apis.html)
Last Published: Jul 23, 2025
[Previous Topic
GSt API](https://docs.qualcomm.com/bundle/publicresource/80-70020-50SC/topics/gst-apis.md) [Next Topic
机器学习 API](https://docs.qualcomm.com/bundle/publicresource/80-70020-50SC/topics/machine-learning-apis.md)