Post

PointProperties

Posted Updated
By CREATE3000 1 min read

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 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

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'/>

See Also

Shape

components, Shape
PointProperties Shape
This post is licensed under CC BY 4.0 by the author.