绘制图片指针 - DrawGuiImagePtr

函数简介

基于已有的内存图片指针创建绘制对象，将图片绘制到指定位置。

接口名称

DrawGuiImagePtr

DLL调用

int64_t DrawGuiImagePtr(int64_t instance, int64_t imagePtr, int32_t x, int32_t y);

参数说明

参数名	类型	说明
instance	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
imagePtr	长整数型	图片指针（通常为图像处理相关接口返回的图像句柄）。
x	整数型	绘制区域左上角 X 坐标。
y	整数型	绘制区域左上角 Y 坐标。

示例

int64_t ola = CreateCOLAPlugInterFace();
// 例如通过图像处理接口加载图片
int64_t img = LoadImage(ola, "C:/imgs/logo.png");
int64_t obj = DrawGuiImagePtr(ola, img, 10, 10);
// ...
DestroyCOLAPlugInterFace(ola);

返回值

对象句柄，失败返回0。

注意事项

• imagePtr 需要是有效的图像句柄，在绘制对象使用期间不要提前释放。
• 适合已经在内存中的图像复用场景，相比直接从路径绘制可以减少重复加载开销。