深入理解libvips：如何扩展图像处理操作-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01005/article/details/148415786

深入理解libvips：如何扩展图像处理操作

libvips A fast image processing library with low memory needs. 项目地址: https://gitcode.com/gh_mirrors/li/libvips

前言

libvips是一个高性能的图像处理库，其独特的按需加载和并行处理机制使其在处理大图像时表现出色。本文将深入探讨如何在libvips中扩展自定义图像处理操作，帮助开发者理解其内部工作机制并实现自己的图像处理算法。

核心概念

在libvips中，所有图像处理操作都是VipsOperation的子类，而VipsOperation本身继承自GObject的对象系统。这种设计使得libvips能够提供统一的接口和灵活的类型系统。

操作类结构设计

基本结构

每个操作需要定义两个核心结构体：

typedef struct _Negative {
  VipsOperation parent_instance;  // 必须包含父类实例
  
  // 操作参数
  VipsImage *in;     // 输入图像
  VipsImage *out;    // 输出图像
  int image_max;     // 反转基准值
} Negative;

typedef struct _NegativeClass {
  VipsOperationClass parent_class;
  // 可选的类成员
} NegativeClass;

这里我们以实现图像反色(Negative)操作为例，它接受一个输入图像并输出其反色版本，同时允许指定反色的基准值。

类型注册

使用GObject的宏简化类型注册：

G_DEFINE_TYPE(Negative, negative, VIPS_TYPE_OPERATION);

这个宏会自动生成类型注册所需的样板代码，包括negative_get_type()函数。

初始化过程

实例初始化

static void negative_init(Negative *negative) {
  negative->image_max = 255;  // 设置默认参数值
}

实例初始化主要负责设置操作的默认参数值。

类初始化

类初始化更为复杂，需要配置操作的元信息：

static void negative_class_init(NegativeClass *class) {
    GObjectClass *gobject_class = G_OBJECT_CLASS(class);
    VipsObjectClass *object_class = VIPS_OBJECT_CLASS(class);

    // 配置GObject属性系统
    gobject_class->set_property = vips_object_set_property;
    gobject_class->get_property = vips_object_get_property;

    // 设置操作元信息
    object_class->nickname = "negative";
    object_class->description = "photographic negative";
    object_class->build = negative_build;

    // 定义操作参数
    VIPS_ARG_IMAGE(class, "in", 1, "Input", "Input image",
        VIPS_ARGUMENT_REQUIRED_INPUT, G_STRUCT_OFFSET(Negative, in));
    
    VIPS_ARG_INT(class, "image_max", 4, "Image maximum",
        "Maximum value in image: pivot about this",
        VIPS_ARGUMENT_OPTIONAL_INPUT, G_STRUCT_OFFSET(Negative, image_max),
        0, 255, 255);
}

类初始化需要：

配置属性系统
设置操作昵称和描述
指定build函数
定义所有输入输出参数

构建过程

build()函数是操作的核心，负责参数验证和输出图像准备：

static int negative_build(VipsObject *object) {
    Negative *negative = (Negative *) object;
    
    // 1. 调用父类构建
    if (VIPS_OBJECT_CLASS(negative_parent_class)->build(object))
        return -1;
    
    // 2. 参数验证
    if (vips_check_uncoded("negative", negative->in) ||
        vips_check_format("negative", negative->in, VIPS_FORMAT_UCHAR))
        return -1;
    
    // 3. 创建输出图像
    g_object_set(object, "out", vips_image_new(), NULL);
    
    // 4. 建立处理管道
    if (vips_image_pipelinev(negative->out,
            VIPS_DEMAND_STYLE_THINSTRIP, negative->in, NULL))
        return -1;
    
    // 5. 设置生成函数
    if (vips_image_generate(negative->out,
            vips_start_one, negative_generate, vips_stop_one,
            negative->in, negative))
        return -1;
    
    return 0;
}

构建过程分为五个关键步骤，确保了操作的正确性和高效性。

图像生成函数

generate()函数是实际进行像素处理的地方：

static int negative_generate(VipsRegion *out_region,
    void *vseq, void *a, void *b, gboolean *stop) {
    
    VipsRect *r = &out_region->valid;  // 需要处理的区域
    VipsRegion *ir = (VipsRegion *) vseq;  // 输入区域
    Negative *negative = (Negative *) b;  // 操作实例
    
    // 准备输入区域
    if (vips_region_prepare(ir, r))
        return -1;
    
    // 处理每一行像素
    for (int y = 0; y < r->height; y++) {
        unsigned char *p = VIPS_REGION_ADDR(ir, r->left, r->top + y);
        unsigned char *q = VIPS_REGION_ADDR(out_region, r->left, r->top + y);
        
        for (int x = 0; x < r->width * negative->in->Bands; x++)
            q[x] = negative->image_max - p[x];  // 反色计算
    }
    
    return 0;
}

生成函数采用逐行处理的方式，确保内存高效使用。VIPS_REGION_ADDR宏用于获取特定位置的像素指针。