读取字库图片 - GetDictImage
函数简介
从OLA数据库中获取指定字库和指定文字的图像数据,支持设置文字间隔与方向,返回图像对象的指针。
接口名称
GetDictImage
DLL调用
long GetDictImage(long ola, long db, string dict_name, string word, int gap, int dir);
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| ola | 长整数型 | OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。 |
| db | 长整数型 | 数据库连接句柄,由 OpenDatabase 接口生成。 |
| dict_name | 字符串 | 字库名称 |
| word | 字符串 | 要读取的文字 |
| gap | 整数型 | 文字间隔,单位为像素 |
| dir | 整数型 | 拼接方向,0 水平拼接,1 垂直拼接 |
示例
C++
long instance = CreateCOLAPlugInterFace();
long db = OpenDatabase(instance, "dict.db");
// 从字库"mydict"中读取文字"ABC"的图片,间隔2像素,水平拼接
long imgPtr = GetDictImage(instance, db, "mydict", "ABC", 2, 0);
Python
# 待补充
返回值
长整数型,返回图像对象的指针。操作失败返回 0。
注意事项
- 如果图像不存在或操作失败,可以通过 GetDatabaseError 函数获取详细的错误信息
- 确保字库名称和文字正确,且图像数据存在于数据库中
- 使用完返回的图像对象指针后,应妥善处理资源,避免内存泄漏
