绘制圆形 - DrawCircle

函数简介

在图片中绘制圆形。支持实线圆和填充圆，可以指定颜色和透明度。

接口名称

DrawCircle

DLL调用

long DrawCircle(long ola, long ptr, int x, int y, int radius, int thickness, string color)

参数定义:

  • ola (长整型数): OLAPlug对象的指针，由DLL版本 CreateCOLAPlugInterFace 接口生成
  • ptr (长整型数): OLAImage对象的地址
  • x (整型数): 圆心X坐标
  • y (整型数): 圆心Y坐标
  • radius (整型数): 圆的半径，单位为像素
  • thickness (整型数): 线条的粗细
    • 正值: 表示圆形轮廓的线条粗细
    • 负值: 表示绘制填充圆
  • color (字符串): 填充的颜色，支持ARGB格式，如"#FFFFFFFF"
    • 前两位: Alpha通道，00-FF，表示透明度
    • 中间两位: Red通道，00-FF
    • 后四位: Green和Blue通道，各00-FF

示例:

// 加载原图
long imagePtr = ola.LoadImage("test.bmp");

// 绘制一个红色实心圆
long filledCircle = ola.DrawCircle(imagePtr, 100, 100, 50, -1, "#FFFF0000");

// 绘制一个蓝色空心圆，线条粗细为2像素
long outlineCircle = ola.DrawCircle(imagePtr, 200, 200, 30, 2, "#FF0000FF");

// 绘制一个半透明的绿色实心圆
long transparentCircle = ola.DrawCircle(imagePtr, 300, 300, 40, -1, "#8000FF00");

// 显示结果
ola.ShowImage(filledCircle);

// 释放内存
ola.FreeImagePtr(imagePtr);
ola.FreeImagePtr(filledCircle);
ola.FreeImagePtr(outlineCircle);
ola.FreeImagePtr(transparentCircle);

COM调用

long DrawCircle(long ptr, int x, int y, int radius, int thickness, string color)

参数定义:

  • ptr (长整型数): OLAImage对象的地址
  • x (整型数): 圆心X坐标
  • y (整型数): 圆心Y坐标
  • radius (整型数): 圆的半径，单位为像素
  • thickness (整型数): 线条的粗细
    • 正值: 表示圆形轮廓的线条粗细
    • 负值: 表示绘制填充圆
  • color (字符串): 填充的颜色，支持ARGB格式，如"#FFFFFFFF"
    • 前两位: Alpha通道，00-FF，表示透明度
    • 中间两位: Red通道，00-FF
    • 后四位: Green和Blue通道，各00-FF

返回值

长整型数: 返回新的OLAImage对象的地址

注意：

  • 图片使用完后需要调用 FreeImagePtr 接口释放内存
  • 原图不会被修改，而是返回一个新的图片对象
  • 坐标系原点(0,0)在图片左上角
  • 确保圆形的范围不超出图片边界，否则可能会被裁剪
Last Updated: