GStreamer perspective元素matrix属性设置及gst-launch使用问题咨询

一、matrix属性输入格式 #

perspective元素的matrix属性接收9个浮点值组成的GValueArray，对应行优先存储的3×3透视变换矩阵，参数定义规则如下：

• 9个值依次对应矩阵第1行3个值、第2行3个值、第3行3个值
• 矩阵第三行最后一个值通常固定为1，第三行前两个值控制透视畸变的程度
• 所有参数支持单精度/双精度浮点类型

二、代码中配置的最佳实现方式 #

C语言实现 #

直接通过g_object_set方法配置即可，完整示例如下：

#include <gst/gst.h>
#include <gobject/gvaluearray.h>

void set_perspective_matrix(GstElement *perspective_element)
{
    // 按行优先定义3x3透视矩阵，可根据实际变换需求修改数值
    gdouble mat[9] = {
        1.0, 0.0, 0.0,
        0.0, 1.0, 0.0,
        0.001, 0.001, 1.0
    };

    // 初始化GValueArray存储矩阵值
    GValueArray *arr = g_value_array_new(9);
    for (int i = 0; i < 9; i++) {
        GValue val = G_VALUE_INIT;
        g_value_init(&val, G_TYPE_DOUBLE);
        g_value_set_double(&val, mat[i]);
        g_value_array_append(arr, &val);
        g_value_unset(&val);
    }

    // 设置属性
    g_object_set(perspective_element, "matrix", arr, NULL);

    // 释放资源
    g_value_array_free(arr);
}

其他语言绑定实现（以Python PyGObject为例） #

高层绑定会自动处理GValueArray的封装，直接传入数值序列即可：

# 直接传入9个元素的元组即可
perspective.set_property("matrix", (1.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.001, 0.001, 1.0))

三、gst-launch工具配置方法 #

可以直接通过gst-launch配置该属性，格式为用尖括号包裹逗号分隔的9个浮点值，不需要额外加空格，示例管道如下：

# bash环境下需要对尖括号转义
gst-launch-1.0 videotestsrc ! perspective matrix=\<1.0,0.0,0.0,0.0,1.0,0.0,0.001,0.001,1.0\> ! autovideosink

部分不需要转义的shell环境下可以直接写matrix=<1.0,0.0,0.0,0.0,1.0,0.0,0.001,0.001,1.0>

内容的提问来源于stack exchange，提问作者edwinkamulegeya