ZBar源码分析：zbar_symbol(3)

2021SC@SDUSC

symbol.c中关键函数

zbar_symbol_ref函数实现符号引用计数操作。存储对符号的新引用时，增加引用计数。不再使用引用符号时计数减少。一旦计数减少且包含的图像已被回收或销毁，符号不能被引用。要注意的是包含该符号的图像包含对该符号的引用，因此只有在图像被销毁或重新使用后保留符号时，才需要使用该函数。

void zbar_symbol_ref (const zbar_symbol_t *sym,
                      int refs)
{
    zbar_symbol_t *ncsym = (zbar_symbol_t*)sym;
    _zbar_symbol_refcnt(ncsym, refs);
}

zbar_symbol_get_type函数检索已解码符号的类型，返回符号的类型。

zbar_symbol_type_t zbar_symbol_get_type (const zbar_symbol_t *sym)
{
    return(sym->type);
}

zbar_symbol_get_configs函数检索符号布尔配置设置。返回位掩码，位掩码指示解码期间为检测到的符号设置了哪些配置。

unsigned int zbar_symbol_get_configs (const zbar_symbol_t *sym)
{
    return(sym->configs);
}

zbar_symbol_get_modifiers函数检索符号修改器标志设置。返回位掩码，位掩码指示解码期间检测到的特征。

unsigned int zbar_symbol_get_modifiers (const zbar_symbol_t *sym)
{
    return(sym->modifiers);
}

zbar_symbol_get_data函数检索从符号解码出的数据。返回数据字符串。

const char *zbar_symbol_get_data (const zbar_symbol_t *sym)
{
    return(sym->data);
}

zbar_symbol_get_data_length函数检索二进制数据的长度。返回解码数据的长度。

unsigned int zbar_symbol_get_data_length (const zbar_symbol_t *sym)
{
    return(sym->datalen);
}

zbar_symbol_get_count函数检索当前缓存计数。当为image_scanner启用缓存时，这将为视频流提供帧间可靠性和冗余信息。

int zbar_symbol_get_count (const zbar_symbol_t *sym)
{
    return(sym->cache_count);
}

zbar_symbol_get_quality检索符号置信度度量。返回未标度的相对数量，较大的值优于较小的值，其中“大”和“小”取决于应用程序。随着度量标准的完善，预计该数量的确切定义会发生变化。目前仅定义了两个值之间的有序关系，在未来将保持稳定。

int zbar_symbol_get_quality (const zbar_symbol_t *sym)
{
    return(sym->quality);
}

zbar_symbol_get_loc_size检索位置多边形中的点数。位置多边形定义图像区域用来提取符号。函数返回位置多边形中的点数。要注意目前这不是多边形，而是解码符号的扫描位置。

unsigned zbar_symbol_get_loc_size (const zbar_symbol_t *sym)
{
    return(sym->npts);
}