Ovis_Decoration_2D_Circle_Create()
摘要
创建 2D 圆。
语法
Ovis_Decoration_2D_Circle_Create (center, x_scale, y_scale, color, filled, layer_ptr, destroy_proc, user_state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
center |
OvisT_2D_Position |
圆的中心 |
x_scale |
double |
圆的 X 缩放 |
y_scale |
double |
圆的 Y 缩放 |
color |
PrgT_Color |
圆的颜色 |
filled |
OvisT_Boolean |
指示是否填充 |
layer_ptr |
OvisT_Layer * |
Ovis 图层 |
destroy_proc |
OvisT_Decoration_State_Destroy_Proc |
销毁与该对象关联的数据并释放其内存 |
user_state_ptr |
void * |
可选的、由用户提供的 decoration 状态 |
返回类型
OvisT_2D_Circle *
该 2D 圆。
头文件
ovis_decoration.h
详情
此函数创建一个 Ovis 2D 圆,并指定该圆的属性。该圆的初始透明度为 0,图案为实心(若圆被填充,则所有位均启用),且不闪烁。
x_scale 和 y_scale 因子以窗口的宽度和高度来定义。对于中心位于 0,0 的圆,取值 1.0 意味着圆的“直径”等于窗口的宽度或高度。注意,只有当 3D 渲染窗口实际为正方形时,x_scale 与 y_scale 相等的“圆”看起来才像圆(参见图 11)。
图 11:窗口尺寸对圆形外观的影响

示例
OvisT_2D_Position pos;
OvisT_2D_Circle * circle;
PrgT_Color color = prg_color_from_string ("red");
pos.x = pos.y = 0; /* middle of the screen */
circle = Ovis_Decoration_2D_Circle_Create (pos, 5, 5, color, OvisC_True, OPC_NIL,
OPC_NIL, OPC_NIL);
错误
- 无效的 2D 位置
<x,y>。2D 位置值必须在 –128 到 127 之间。 - 无效的 X 缩放值 (
<value>)。缩放值必须为正。 - 无效的 Y 缩放值 (
<value>)。缩放值必须为正。
参考
- 使用
Ovis_2D_Polygon_Center_Set()函数修改圆的中心 - 使用
Ovis_Decoration_Color_Set()函数修改圆的颜色。 - 使用
Ovis_Decoration_Transparency_Set()函数修改圆的透明度。 - 使用
Ovis_Decoration_Flashing_Set()函数修改闪烁状态。 - 使用
Ovis_Shape_Pattern_Set()函数修改圆渲染区域所使用的图案。 - 使用
Ovis_Polygon_Fill_Set()函数修改填充(圆盘)或未填充(圆环)状态。 - 使用
Ovis_2D_Polygon_Scale_Set()函数修改圆或椭圆的半径。 - 使用
Ovis_2D_Polygon_Rotation_Set()函数修改绕垂直于显示器的 Z 轴的旋转。