Ovis_Segmented_Line_Segment_Arrows_Get()
摘要
返回分段线的某个线段在其起点和/或终点是否有箭头。
语法
Ovis_Segmented_Line_Segment_Arrows_Get (seg_line_ptr, index, head_arrow_ptr, tail_arrow_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
seg_line_ptr |
OvisT_Segmented_Line * |
分段线 |
index |
unsigned char |
线段的索引号 |
head_arrow_ptr |
OvisT_Boolean * |
若线段起点有箭头则为 True |
tail_arrow_ptr |
OvisT_Boolean * |
若线段终点有箭头则为 True |
返回类型
OvisT_Compcode
若装饰对象是有效的二维或三维分段线,返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。
头文件
ovis_decoration.h
详情
头部箭头(head arrow)朝向整条线的“from”位置,尾部箭头(tail arrow)朝向整条线的“to”位置。
示例
OvisT_2D_Segmented_Line * line;
OvisT_Boolean head, tail;
/* … .line created at some point */
Ovis_Segmented_Line_Segment_Arrows_Get (line, 0, &head, &tail);
错误
- 装饰对象不是分段线(segmented Line)。
- 装饰对象为 NIL。
- 从 0 开始的线段索引(
<index>)对于<num>个线段来说过大。 - 不能使用 'OVISC_SEGMENTED_LINE_ALL_SEGMENTS' 索引值。
- 'head_arrow' 值的返回地址为 NIL。
- 'tail_arrow' 值的返回地址为 NIL。
参考
- 使用函数
Ovis_Segmented_Line_Segment_Arrows_Set()指定线段的箭头。