Ovis_Decoration_2D_Line Create()
摘要
创建 2D 直线。
语法
Ovis_Decoration_2D_Line_Create (from, to, color, thickness, layer_ptr, destroy_proc, user_state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
from |
OvisT_2D_Position |
直线的起点 |
to |
OvisT_2D_Position |
直线的终点 |
color |
PrgT_Color |
颜色 |
thickness |
unsigned char |
直线的粗细,以像素计 |
layer_ptr |
OvisT_Layer * |
Ovis 图层 |
destroy_proc |
OvisT_Decoration_State_Destroy_Proc |
销毁与该对象关联的数据并释放其内存 |
user_state_ptr |
void * |
可选的、由用户提供的 decoration 状态 |
返回类型
OvisT_2D_Line *
该 2D 直线。
头文件
ovis_decoration.h
详情
此函数创建 Ovis 2D 直线,并指定该直线的属性。
示例
OvisT_2D_Position from, to;
OvisT_2D_Line * line;
PrgT_Color olor = prg_color_from_string ("green");
from.x = to.x = 0;
from.y = 50;
to.y = -50;
line = Ovis_Decoration_2D_Line_Create (from, to, color, 3, OPC_NIL,
OPC_NIL, OPC_NIL);
错误
- 无效的 'from' 2D 位置
<x,y>。2D 位置值必须在 –128 到 127 之间。 - 无效的 'to' 2D 位置
<x,y>。2D 位置值必须在 –128 到 127 之间。
参考
- 使用
Ovis_Decoration_Color_Set()函数修改直线的颜色。 - 使用
Ovis_Decoration_Transparency_Set()函数修改直线的透明度。 - 使用
Ovis_Decoration_Flashing_Set()函数修改闪烁状态。 - 使用
Ovis_Shape_Pattern_Set()函数修改直线所使用的图案。 - 使用
Ovis_2D_Line_Endpoints_Set()函数修改直线的端点。 - 使用
Ovis_Line_Thickness_Set()函数修改直线的粗细。 - 使用
Ovis_Line_Arrows_Set()函数启用/禁用直线两端的箭头。