Ovis_Segmented_Line_Segment_Length_Set()
摘要
指定单个线段相对于整条分段线的尺寸(以百分比表示)。
语法
Ovis_Segmented_Line_Segment_Length_Set (seg_line_ptr, index, percentage)
| 参数 | 类型 | 说明 |
|---|---|---|
seg_line_ptr |
OvisT_Segmented_Line * |
指定分段线 |
index |
unsigned char |
指定线段的索引 |
percentage |
unsigned char |
指定偏移的百分比 |
返回类型
OvisT_Compcode
若装饰对象是有效的二维或三维分段线,返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。
头文件
ovis_decoration.h
详情
该函数指定单个线段相对于整条分段线的尺寸(以百分比表示)。整条线为 100%;目标线段表示其占分段线的百分比。
某个线段的起始位置对应于其之前所有线段偏移百分比之和。
显示时只包含偏移之和达到 100 为止的线段或线段部分。若各线段偏移之和超过 100,部分线段或线段部分将不显示。若之和小于 100,最后一个线段会在显示中自动拉伸。
注意: 该函数原名为 Ovis_Segmented_Line_Segment_Offset_Set()。旧名称仍作为新名称的别名可用。
示例
OvisT_2D_Segmented_Line * line;
/* … .line created at some point with 3 segments */
/* Two short segments at the ends, and a big one in the middle */
Ovis_Segmented_Line_Segment_Length_Set (line, 0, 10);
Ovis_Segmented_Line_Segment_Length_Set (line, 1, 80);
Ovis_Segmented_Line_Segment_Length_Set (line, 2, 10);
错误
- 装饰对象不是分段线(segmented Line)。
- 装饰对象为 NIL。
- 不能使用 'OVISC_SEGMENTED_LINE_ALL_SEGMENTS' 索引值。
- 从 0 开始的线段索引(
<index>)对于<num>个线段来说过大。
参考
- 使用函数
Ovis_Segmented_Line_Segment_Length_Get()获取线段的百分比尺寸。