# 视频 API Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/video-apis.html](https://docs.qualcomm.com/doc/80-70022-50SC/topic/video-apis.html) 使用视频 API 配置视频缓存和视频转换器。 ## GstImageBufferPool API - 配置它以将 [GstVideoMeta](https://gstreamer.freedesktop.org/documentation/video/gstvideometa.html#GstVideoMeta) 添加至缓存。 - 配置视频特定要求： - 步幅对齐或像素填充 - 内存管理类型 (GBM/ION)。 Figure : GstImageBufferPool 工作流 Layer_1 Sheet.2 Sheet.3 Sheet.5 GstImageBufferPool GstImageBufferPool Sheet.8 Sheet.9 GstBufferPool GstBufferPool Sheet.12 Sheet.13 GstBuffer GstBuffer Sheet.16 Sheet.17 GstImageBufferPoolPrivate GstImageBufferPoolPrivate Sheet.20 Sheet.21 GstBufferPoolPrivate GstBufferPoolPrivate Sheet.24 Sheet.25 GstMemory GstMemory Sheet.28 Sheet.29 Sheet.30 Sheet.31 Sheet.32 Sheet.33 Sheet.34 Sheet.35 Sheet.36 Sheet.37 Sheet.38 Sheet.39 Sheet.40 Sheet.47 parent: GstBufferPool priv: GstImageBufferPoolPrivate * · parent: GstBufferPool· priv: GstImageBufferPoolPrivate * Sheet.48 object: GstObject flushing: gint priv: GstBufferPoolPrivate *... · object: GstObject· flushing: gint· priv: GstBufferPoolPrivate *· started: gboolean· _gst_reserved: gpointer[GST_PADDING] Sheet.49 mini_object: GstMiniObject pool: GstBufferPool * pts: GstCloc... · mini_object: GstMiniObject· pool: GstBufferPool *· pts: GstClockTime· dts: GstClockTime· duration: GstClockTime· offset: guint64· offset_end: guint64 Sheet.50 memtype: Gquark allocator: GstAllocator params: GstAllocation... · memtype: Gquark· allocator: GstAllocator· params: GstAllocationParams· info: GstMLInfo· addmeta: gboolean· continuous: gboolean· devid: gint· gbmhandle: gpointer· gbmdevice: struct gbm_device· datamap: GHash Table· lock: GMutex Sheet.51 queue: GstAtomicQueue poll: GstPoll * rec_lock: GRecMutex max... · queue: GstAtomicQueue· poll: GstPoll *· rec_lock: GRecMutex· maxsize: gsize· started: gboolean· active: gboolean· outstanding: gint· configured: gboolean· min_buffers: guint· max_buffers: guint· cur_buffers: guint· allocator: GstAllocator *· params: GstAllocationParams Sheet.52 mini_object: GstMiniObject allocator: GstAllocator * parent: ... · mini_object: GstMiniObject· allocator: GstAllocator *· parent: GstMemory *· maxsize: gsize· align: gsize· offset: gsize· size: gsize 以下列表提供了 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 : 硬件加速的图像处理、转换和颜色转换 Layer_1 Sheet.1 gst_gles_converter_new gst_gles_converter_new Sheet.3 Sheet.4 Sheet.5 dlopen libIB2C.so dlopen libIB2C.so Sheet.6 GstGlesConverter * GstGlesConverter * Sheet.7 gst_gles_converter_set_input_ops gst_gles_converter_set_input_ops Sheet.8 gst_gles_converter_set_input_ops gst_gles_converter_set_input_ops Sheet.9 gboolean gboolean Sheet.10 插件 插件 Sheet.11 GLES 引擎 GLES 引擎 Sheet.12 IB2C IB2C Sheet.13 Sheet.14 Sheet.19 Sheet.20 Opt Opt Sheet.22 Sheet.23 Sheet.24 gst_gles_converter_submit_request gst_gles_converter_submit_request Sheet.26 Sheet.27 Sheet.29 Sheet.30 Sheet.31 Sheet.32 Sheet.33 ::ib2c::IEngine ::ib2c::IEngine Sheet.35 Sheet.36 Sheet.37 surface_id surface_id Sheet.39 Sheet.40 Sheet.41 request_id request_id Sheet.43 Sheet.44 Sheet.45 请求 ID 请求 ID Sheet.47 Sheet.48 Sheet.49 ::ib2c::IEngine::CreateSurface ::ib2c::IEngine::CreateSurface Sheet.51 Sheet.52 Sheet.53 ::ib2c::IEngine::Compose ::ib2c::IEngine::Compose Sheet.55 Sheet.56 Sheet.57 ::ib2c::IEngine::Finish ::ib2c::IEngine::Finish Sheet.59 Sheet.60 Sheet.62 Sheet.63 Sheet.65 Sheet.66 Sheet.67 Sheet.68 Sheet.69 Sheet.70 Sheet.71 Sheet.72 Sheet.73 获取与框架关联的表面 获取与框架关联的表面 Sheet.75 Sheet.76 Sheet.77 Sheet.78 Sheet.79 Sheet.80 Sheet.81 Sheet.82 Sheet.83 GstStructure 中的现金输入操作 GstStructure 中的现金输入操作 Sheet.85 Sheet.86 Sheet.87 Sheet.88 Sheet.89 Sheet.90 Sheet.91 Sheet.92 Sheet.93 GstStructure 中的现金输出操作 GstStructure 中的现金输出操作 Sheet.95 Sheet.96 Sheet.97 Sheet.98 Sheet.99 Sheet.100 Sheet.101 Sheet.102 Sheet.103 delete ::ib2c::IEngine delete ::ib2c::IEngine Sheet.105 Sheet.106 Sheet.107 Sheet.108 Sheet.109 Sheet.110 Sheet.111 Sheet.112 Sheet.113 dlclose libIB2C.so dlclose libIB2C.so Sheet.115 Sheet.116 Sheet.117 Sheet.118 Sheet.119 Sheet.120 Sheet.121 Sheet.122 Sheet.123 dlsym libIB2C.so NewEngine 符号 dlsym libIB2C.so NewEngine 符号 Sheet.125 Sheet.126 Sheet.127 Sheet.128 Sheet.129 Sheet.130 Sheet.131 Sheet.132 Sheet.133 初始化区间变量 初始化区间变量 Sheet.134 NewEngine NewEngine Sheet.136 Sheet.137 Sheet.138 Sheet.139 Sheet.140 Sheet.141 Sheet.142 Sheet.143 Sheet.144 [每个传入缓存或缓存组] [每个传入缓存或缓存组] Sheet.145 ::ib2c::IEngine::DestroySurface ::ib2c::IEngine::DestroySurface Sheet.147 Sheet.148 Sheet.150 Sheet.151 Sheet.153 Sheet.154 Sheet.155 gboolean gboolean Sheet.157 Sheet.158 Sheet.159 Sheet.161 Sheet.162 Sheet.163 gst_gles_converter_wait_request gst_gles_converter_wait_request Sheet.164 gboolean gboolean Sheet.166 Sheet.167 Sheet.169 Sheet.170 Sheet.172 Sheet.173 Sheet.175 Sheet.176 Sheet.177 gst_gles_converter_free gst_gles_converter_free Sheet.179 Sheet.180 Sheet.182 Sheet.183 loop loop Sheet.184 [对于每个帧] [对于每个帧] Sheet.186 Sheet.187 alt alt Sheet.188 [其他] [其他] Sheet.190 Sheet.191 loop loop Sheet.192 Sheet.193 Sheet.194 Sheet.195 Sheet.196 Sheet.197 Sheet.198 Sheet.199 Sheet.200 Sheet.201 Sheet.202 Sheet.203 Sheet.204 Sheet.205 Sheet.206 Sheet.207 Sheet.208 Sheet.209 Sheet.210 Sheet.211 [对于每个追逐表面] [对于每个追逐表面] Sheet.212 Sheet.213 [为框架创建表面] [为框架创建表面] Sheet.215 Sheet.216 以下列表提供了有关每个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-70022-50SC/topic/gst-apis.html) Last Published: Nov 05, 2025 [Previous Topic GSt API](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/gst-apis.md) [Next Topic 机器学习 API](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/machine-learning-apis.md)