开源相机管理库Aravis例程学习（七）——chunk-parser

简介

本文针对官方例程中的：05-chunk-parser做简单的讲解。并介绍其中调用的arv_camera_create_chunk_parser，arv_camera_set_chunks，arv_chunk_parser_get_integer_value函数。

aravis版本：0.8.31
操作系统：ubuntu-20.04
gcc版本：9.4.0

例程代码

这段代码使用Aravis的API，操作相机捕获图像并获取流数据中附加的块信息（例程中启用的块数据为图像的长和宽），主要操作步骤如下：

• 连接相机
• 设置启用的块数据
• 图像采集
• 打印相关数据
• 释放资源

/* SPDX-License-Identifier:Unlicense */
/* Aravis header */
#include <arv.h>
/* Standard headers */
#include <stdio.h>

int main (int argc, char **argv)
{
	ArvCamera *camera;
	ArvChunkParser *parser;
	GError *error =NULL;
	//连接相机
	camera = arv_camera_new (NULL, &error);

	if (ARV_IS_CAMERA (camera)) 
    {
		ArvBuffer *buffer = NULL;

		printf ("Found camera '%s'\n", arv_camera_get_model_name (camera, NULL));

        //创建chunk parser对象
		parser = arv_camera_create_chunk_parser (camera);

		//设置启用的块数据
		arv_camera_set_chunks (camera, "Width,Height", &error);

		//获取单帧图像
		if (error == NULL)
			buffer = arv_camera_acquisition	(camera, 1000000, &error);

		if (buffer != NULL) {
			printf ("ChunkWidth = %d\n", (int) arv_chunk_parser_get_integer_value (parser,
											       buffer, "ChunkWidth", NULL));
			printf ("ChunkHeight = %d\n", (int) arv_chunk_parser_get_integer_value (parser,
												buffer, "ChunkHeight", NULL));
		} else {
			printf ("Failed to acquire a single buffer\n");
		}
		//释放资源
		g_clear_object (&buffer);
		g_clear_object (&parser);
		g_clear_object (&camera);
	}

	if (error != NULL) {
		/* En error happened, display the correspdonding message */
		printf ("Error: %s\n", error->message);
		g_clear_error (&error);
		return EXIT_FAILURE;
	}

	return EXIT_SUCCESS;
}

运行结果：

函数说明

arv_camera_create_chunk_parser

简介：创建一个与camera关联的ArvChunkParser对象，用于从ArvBuffer中提取块数据

ArvChunkParser* arv_camera_create_chunk_parser(ArvCamera* camera)

Available since: 0.4.0

arv_camera_set_chunks

简介：启用或禁用相机数据流中的块数据模式。

void arv_camera_set_chunks (
  ArvCamera* camera,
  const char* chunk_list,    //以逗号分隔的字符串列表，指定要启用的块数据类型
  GError** error
)

• 启用块数据：如果 chunk_list 是非空字符串，函数将解析这个字符串并启用列表中指定的所有块数据类型。这意味着这些数据将包含在相机输出的每帧图像数据中。

• 禁用块数据：如果 chunk_list 是 NULL 或空字符串，这表示要禁用块数据模式。相机将停止发送所有块数据，只提供纯粹的图像数据。

未列出的所有块数据都被禁用

Available since: 0.8.0

arv_chunk_parser_get_integer_value

简介：从相机的数据缓冲区中提取与给定名称匹配的块数据中的整数值

gint64 arv_chunk_parser_get_integer_value (
  ArvChunkParser* parser,
  ArvBuffer* buffer,
  const char* chunk,    //一个字符串，指定要检索的块数据的名称
  GError** error
)