获取OLA图像 - GetOlaImage
函数简介
从OLA数据库中获取指定目录和文件名的图像数据,返回图像对象的指针。
函数原型
long GetOlaImage(long ola, const long db, string dir, string fileName);
参数定义
ola
(长整型数): OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。db
(长整型数): 数据库连接句柄,由 OpenDatabase 接口生成。dirPath
(字符串): 图片目录路径。fileName
(字符串): 图片文件名。
返回值
- 返回值:图像对象的指针。如果操作失败,返回
0
。
示例
SDK
C#
using System;
using OLA.ServiceCenter.PlugFactory;
namespace OLADemo
{
internal class Program
{
static OLAPlugServer OLAServer;
static void Main(string[] args)
{
OLAServer = new OLAPlugServer();
var regResult = OLAServer.Reg(
OLAServer.UserCode,
OLAServer.SoftCode,
OLAServer.FeatureList
);
OLAServer.CreateCOLAPlugInterFace();
long db = OLAServer.OpenDatabase("OLAPlugDemo.db", "olaplug");
Console.WriteLine($"OpenDatabase 返回:{db}");
// 获取OLA图像
string imageDir = "C:/images";
string fileName = "image.png";
long imagePtr = OLAServer.GetOlaImage(db, imageDir, fileName);
if (imagePtr != 0)
{
Console.WriteLine("OLA图像获取成功。");
// 使用图像对象进行后续操作
}
else
{
Console.WriteLine("OLA图像获取失败。");
}
}
}
}
Python
from OLAPlugServer import OLAPlugServer
# 实例化
OLAServer = OLAPlugServer()
# 注册
OLAServer.Reg(OLAServer.UserCode, OLAServer.SoftCode, OLAServer.FeatureList)
# 创建OLAPlug对象
OLAServer.CreateCOLAPlugInterFace()
# 打开数据库
db = OLAServer.OpenDatabase('OLAPlug.db', 'OLAPlug')
print(f"openDatabaseResult={db}")
# 获取OLA图像
imageDir = "C:/images"
fileName = "image.png"
imagePtr = OLAServer.GetOlaImage(db, imageDir, fileName)
if imagePtr != 0:
print("OLA图像获取成功。")
# 使用图像对象进行后续操作
else:
print("OLA图像获取失败。")
原生方式
Python
import os
import sys
from ctypes import *
# 1. 加载dll
# 此处路径为插件所在路径,请根据实际情况修改。
# 32位python使用x86版本,64位python使用x64版本
if sys.maxsize > 2**32:
olaplug_dll = WinDLL(os.path.abspath(os.path.join(os.getcwd(), 'OLAPlug_x64.dll')))
else:
olaplug_dll = WinDLL(os.path.abspath(os.path.join(os.getcwd(), 'OLAPlug_x86.dll')))
# 2. 注册到后台
UserCode = "c38e200f116d4fa8bd0deb45ccb523ea"
SoftCode = "701bc92ba84642c68845e7a06c10fd99"
FeatureList = "OLA|OLAPlus"
olaplug_dll.Reg.argtypes = [c_char_p, c_char_p, c_char_p]
olaplug_dll.Reg.restype = c_int32
result = olaplug_dll.Reg(UserCode.encode('utf-8'), SoftCode.encode('utf-8'), FeatureList.encode('utf-8'))
print(f'注册结果返回: {result}')
# 3. 创建ola对象
olaplug_dll.CreateCOLAPlugInterFace.restype = c_void_p
ola_obj = olaplug_dll.CreateCOLAPlugInterFace()
# 4. 打开数据库
olaplug_dll.OpenDatabase.argtypes = [c_void_p, c_char_p, c_char_p]
olaplug_dll.OpenDatabase.restype = c_void_p
db = olaplug_dll.OpenDatabase(ola_obj, "OLAPlugDemo.db".encode('utf-8'), "olaplug".encode('utf-8'))
print(f"openDatabaseResult={db}")
# 5. 获取OLA图像
imageDir = "C:/images"
fileName = "image.png"
olaplug_dll.GetOlaImage.argtypes = [c_void_p, c_void_p, c_char_p, c_char_p]
olaplug_dll.GetOlaImage.restype = c_void_p
imagePtr = olaplug_dll.GetOlaImage(ola_obj, db, imageDir.encode('utf-8'), fileName.encode('utf-8'))
if imagePtr != 0:
print("OLA图像获取成功。")
# 使用图像对象进行后续操作
else:
print("OLA图像获取失败。")
注意事项
- 该函数用于从OLA数据库中获取指定目录和文件名的图像数据,适用于从数据库中检索图像的场景。
- 如果图像不存在或操作失败,函数将返回
0
。可以通过 GetDatabaseError 函数获取详细的错误信息。 - 确保目录路径和文件名正确,且图像数据存在于数据库中,否则可能导致获取失败。
- 使用完返回的图像对象指针后,应妥善处理资源,避免内存泄漏。