晨星心语——学到更多,长进更多

Java 3D API 官方教程:用户自定义线型[翻译]

关键词： Java    3D    API    教程    线型                                          

用户自定义线型 <1.2版中新增>

除了标准的实线,虚线,点画线以及点、虚线间隔线四种选择，Java 3D API 1.2版还可以让应用程序开发人员能定义线型。线型可以由一个指定的模式掩码和一个可选的比例因子来设定。模式掩码是一个16位的值，16位中的每一位指定了此模式中一个象素点是要绘制还是忽略。位值为1则把相应的相素点设置成要绘制的（也就是把开关打开），则位值为0时则不绘制相应的象素点（开关关闭）。当所有的16位值都用完之后，模式重新反复。模式掩码通常用八进制的值。掩码中的第0位则与模式中的第一个象素对应。比如，某掩码值为 0x00ff (0b0000000011111111)，则定义了8个象素绘制，另外8个不被绘制。记住，最小位上的位值是在第一次绘制时用到的值，因此，位模式的读取顺序是从右到左。模式掩码0x0101 定义了从1个象素打开而7个象素关闭的重复模式。

对于线带基本图形的每一个线段,以上的这种模式会重复很多遍在一个新的线带开始处,模式的重复也重新开始.对于线序列基本图形,这个模式在每一条线开始处也重新开始.这个模式可以用比例因子扩大至240象素那么大.这个模式与比例因子相乘的规则是将模式的每一个位重复比例因子的次数.比如,一个比例因子3与模式掩码0x001f相乘,则产生一个(3*5)15个象素重复的打开,而其后的(3*11)33个象素关闭的模式.比例因子取值的合理范围是其范围外的值就会被截断的.<0}

>LineAttributes构造函数<0}

LineAttributes()<0}

构造一个一象素宽,实心填充无反锯齿效果的组件对象.<0}

>LineAttributes(float pointSize, int linePattern, boolean state)<0}

构造一个指定象素宽度,指定模式和指定是否反锯齿化效果的线组件对象.

LineAttributes 方法<0}

void setLineWidth(float lineWidth)<0}

设置线形象素的宽度<0}

void setLinePattern(int linePattern)<0}

线模式是如下常量之一:

 PATTERN_SOLID (默认的),<0}

PATTERN_DASH, PATTERN_DOT, PATTERN_DASH_DOT, 或者PATTERN_USER_DEFINED.<0}

这些参数设置了象素如何填充线.对于线形的更多详细的形式如下:<0}

void setLineAntialiasingEnable(boolean state)<0}

设置是否设置反锯齿效果.<0}

void setPatternMask(int mask) <1.2版中新增><0}

将线的模式掩码设置成为指定值.<0}

void setPatternScaleFactor(int scaleFactor) < 1.2版中新增><0}

将线的模式比例因子设置成为指定值.<0}

线属性线模式<0}

PATTERN_SOLID 实线(无模式).这是默认的<0}

PATTERN_DASH 虚线,理想的是,8个象素绘制,8个象素不绘制间隔进行.<0}

PATTERN_DOT 点画线,理想的是,1个象素绘制,7个象素不绘制间隔进行.<0}

PATTERN_DASH_DOT 虚点画线,理想的方式是16个象素时,7个象素绘制,4个象素<0}

不绘制,1个象素绘制以及接下来的4个象素关闭.<0}

PATTERN_USER_DEFINED指明是用户自定义线模式.请查看上面的”用户自定义线型模式”

【作者: wuxingblog】【访问统计:】【2005年11月15日 星期二 00:12】【 加入博采】【打印】