Ovis_Decoration_2D_Square_Create()
摘要
创建 2D 正方形。
语法
Ovis_Decoration_2D_Square_Create (center, x_scale, y_scale, color, filled, layer_ptr, destroy_proc, user_state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
center |
OvisT_2D_Position |
正方形的中心 |
x_scale |
double |
正方形的 X 缩放,通常在 0.0 到 1.0 之间 |
y_scale |
double |
正方形的 Y 缩放,通常在 0.0 到 1.0 之间 |
color |
PrgT_Color |
颜色 |
filled |
OvisT_Boolean |
指示是否填充 |
layer_ptr |
OvisT_Layer * |
Ovis 图层 |
destroy_proc |
OvisT_Decoration_State_Destroy_Proc |
销毁与该对象关联的数据并释放其内存 |
user_state_ptr |
void * |
可选的用户提供的装饰状态 |
返回类型
OvisT_2D_Square *
该 2D 正方形
头文件
ovis_decoration.h
详情
该函数创建 Ovis 2D 正方形,并指定正方形的各属性。正方形的初始透明度为 0,图案为实心(若圆形被填充则所有位均启用),且不闪烁。
x_scale 和 y_scale 因子以窗口的宽度和高度为基准定义。取值 1.0 表示正方形的宽度或高度将等于窗口的宽度或高度。注意,只有当 3D 渲染窗口本身是真正的正方形时,x_scale 与 y_scale 相等的"正方形"看起来才像正方形。
示例
OvisT_2D_Position pos;
OvisT_2D_Square * square;
PrgT_Color color = prg_color_from_string ("red");
pos.x = pos.y = 0; /* middle of the screen */
square = Ovis_Decoration_2D_Square_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()函数修改正方形的 x 和 y 尺寸。 - 使用
Ovis_2D_Polygon_Rotation_Set()函数修改绕垂直于显示器的 Z 轴的旋转。