Ovis_2D_Polygon_Scale_Set()
摘要
设置 2D 多边形的缩放比例。
语法
Ovis_2D_Polygon_Scale_Set (poly_ptr, x_scale, y_scale)
| 参数 | 类型 | 说明 |
|---|---|---|
poly_ptr |
OvisT_Polygon * |
多边形 |
x_scale |
double |
指定 X 方向缩放(>= 0) |
y_scale |
double |
指定 Y 方向缩放(>= 0) |
返回类型
OvisT_Compcode
若提供的对象是有效的 2D 多边形(圆形或方形),返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。
头文件
ovis_decoration.h
详情
该函数设置 2D 多边形的 x 方向与 y 方向缩放比例。2D 多边形可以是方形或圆形。
x_scale 与 y_scale 系数以窗口的宽度和高度为基准定义。取值 1.0 表示圆形或方形的宽度或高度将等于窗口的宽度或高度。注意,只有当 3D 渲染窗口本身是真正的正方形时,x_scale 与 y_scale 系数相等的"方形"才会在屏幕上呈现为正方形。圆形同理。
注意,图案不受缩放影响。缩放应用之后,图案始终在垂直方向上以 32 位范围应用。
示例
OvisT_2D_Circle * circle;
/* … circle created previously */
Ovis_2D_Polygon_Scale_Set (circle, 2.0, 5.5);
错误
- 装饰对象不是 2D 圆形或方形。
- 装饰对象为 NIL。
- X 方向缩放值无效(
<value>)。缩放值必须为正数。 - Y 方向缩放值无效(
<value>)。缩放值必须为正数。
参考
- 使用函数
Ovis_2D_Polygon_Scale_Get()可获取圆形或方形的半径。