Ovis_Segmented_Line_Segment_Transparency_Get()
摘要
获取分段线中某一线段的透明度。
语法
Ovis_Segmented_Line_Segment_Transparency_Get (seg_line_ptr, index, transparency_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
seg_line_ptr |
OvisT_Segmented_Line * |
目标分段线。 |
index |
unsigned char |
目标线段的索引。 |
transparency_ptr |
unsigned char * |
用于存放该线段当前透明度设置的区域。 |
返回类型
OvisT_Compcode
若装饰对象是有效的 2D 或 3D 分段线,返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。
头文件
ovis_decoration.h
详情
该函数返回指定线段的透明度。透明度是 0 到 100 之间的值,0 表示完全不透明,100 表示完全透明(不可见)。
示例
OvisT_2D_Segmented_Line * line;
unsigned char transparency;
/* … .line created at some point */
Ovis_Segmented_Line_Segment_Transparency_Get (line, 0, &transparency);
错误
- 装饰对象不是分段线(segmented Line)。
- 装饰对象为 NIL。
- 从 0 开始的线段索引(
<index>)对于<num>个线段来说过大。 - 不能使用 'OVISC_SEGMENTED_LINE_ALL_SEGMENTS' 索引值。
- 用于返回透明度值的地址为 NIL。
参考
- 使用函数 Ovis_Segmented_Line_Segment_Transparency_Set() 可指定某一线段的透明度。