PointProperties
Overview
PointProperties allows precise fine-grained control over the rendering style of PointSet node points inside the same Shape.
The PointProperties node belongs to the Shape component and requires at least support level 5, its default container field is pointProperties. It is available from X3D version 4.0 or higher.
Hierarchy
1
2
3
+ X3DNode
+ X3DAppearanceChildNode
+ PointProperties
Fields
| Type | Access Type | Name | Default Value |
|---|---|---|---|
| SFNode | [in, out] | metadata | NULL |
| SFFloat | [in, out] | pointSizeScaleFactor | 1 |
| SFFloat | [in, out] | pointSizeMinValue | 1 |
| SFFloat | [in, out] | pointSizeMaxValue | 1 |
| SFVec3f | [in, out] | attenuation | 1 0 0 |
SFNode [in, out] metadata NULL [X3DMetadataObject]
Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
Hint
SFFloat [in, out] pointSizeScaleFactor 1 (1,∞)
Nominal rendered point size is a browser-dependent minimum renderable point size, which is then multiplied by an additional pointSizeScaleFactor (which is greater than or equal to 1).
Hint
- Additional sizing modifications are determined by pointSizeMinValue, pointSizeMaxValue, and attenuation array.
SFFloat [in, out] pointSizeMinValue 1 [0,∞)
pointSizeMinValue is minimum allowed scaling factor on nominal browser point scaling.
Warning
- Maintain pointSizeMinValue <= pointSizeMaxValue.
SFFloat [in, out] pointSizeMaxValue 1 (0,∞)
pointSizeMaxValue is maximum allowed scaling factor on nominal browser point scaling.
Warning
- Maintain pointSizeMinValue <= pointSizeMaxValue.
SFVec3f [in, out] attenuation 1 0 0 (0,∞)
Are set to default values if undefined. Together these parameters define attenuation factor 1/(a + b×r + c×r^2) where r is the distance from observer position (current viewpoint) to each point.
Hint
- Nominal point size is multiplied by attenuation factor and then clipped to a minimum value of pointSizeMinValue × minimum renderable point size, then clipped to maximum size of pointSizeMaxValue × minimum renderable point size.
Advice
Hints
- DEF/USE copies of a single node can provide a similar “look + feel” style for related shapes in a scene.
- When an X3DTextureNode is defined in the same Appearance instance as PointProperties node, the points of a PointSet shall be displayed as point sprites using the given texture(s).
Warning
- Requires X3D
profile='Full'or else include<component name='Shape' level='5'/>