PointMaterial
PointMaterial represents a material for point geometry rendering.
Properties
Section titled “Properties”center
Section titled “center”Type: { x: number, y: number }
Description: Specifies the shift amount from the center. The range is between 0 and 1. The unit is a relative position to the point circle.
Default: Required
Example:
{ point: { center: { x: 0.5, y: 0.5 } }}clampToGround
Section titled “clampToGround”Type: boolean
Description: Specifies whether to clamp to the ground.
Default: Required
Example:
{ point: { clampToGround: true }}Type: Color
Description: Specifies the point color as a Color instance.
Default: Required
Example:
import { Color } from "@navaramap/three";
{ point: { color: new Color().setHex(0xff0000) }}declutter
Section titled “declutter”Type: boolean | undefined
Description: Participate in screen-space decluttering: when labels/sprites overlap on screen, lower-priority ones are hidden. Enabled by default; set to false to draw every label unconditionally.
Default: true
Example:
{ point: { declutter: false }}declutterPriority
Section titled “declutterPriority”Type: number | undefined
Description: Placement priority for decluttering; higher wins. Only meaningful when declutter is enabled. Can be overridden per feature via FeatureEvaluator.evaluate().
Default: 0.0
Example:
{ point: { declutter: true, declutterPriority: 1 }}depthTest
Section titled “depthTest”Type: boolean | undefined
Description: A variable that determines whether front-facing models occlude back-facing models.
Default: true
Example:
{ point: { depthTest: true }}effectIds
Section titled “effectIds”Type: string[] | undefined
Description: Specifies the IDs of selective effects to apply (e.g., “bloom”, “outline”). Used in conjunction with SelectiveBloomEffectDesc or SelectiveOutlineEffectDesc.
Default: undefined
Example:
{ point: { effectIds: ["bloom", "outline"] }}emissiveColor
Section titled “emissiveColor”Type: Color | undefined
Description: Specifies the emissive color as a Color instance.
Default: undefined
Example:
import { Color } from "@navaramap/three";
{ point: { emissiveColor: new Color().setHex(0xff0000) }}emissiveIntensity
Section titled “emissiveIntensity”Type: number | undefined
Description: Specifies the emissive intensity. The default value is 0.3 when the Bloom effect is enabled.
Default: undefined
Example:
{ point: { emissiveIntensity: 0.5 }}height
Section titled “height”Type: number
Description: Specifies the height. The unit is meters.
Default: Required
Example:
{ point: { height: 100 // 100 meters }}offsetDepth
Section titled “offsetDepth”Type: boolean | undefined
Description: Avoids overlap with the earth’s surface. Use this to prevent the point from clipping into the earth’s surface.
Default: undefined
Example:
{ point: { offsetDepth: true }}opacity
Section titled “opacity”Type: number | undefined
Description: Specifies the opacity of the point. Valid range is 0.0 (fully transparent) to 1.0 (fully opaque).
Default: 1.0
Example:
{ point: { transparent: true, opacity: 0.5 // 50% opacity }}sizeInMeters
Section titled “sizeInMeters”Type: boolean | undefined
Description: Whether the size is specified in meters. If false, the size is in pixels.
Default: true
Example:
{ point: { sizeInMeters: true }}Type: boolean | undefined
Description: Specifies whether to show the point.
Default: undefined
Example:
{ point: { show: true }}Type: number
Description: Specifies the size of the point. The unit is meters.
Default: Required
Example:
{ point: { size: 10 // 10 meters }}transparent
Section titled “transparent”Type: boolean | undefined
Description: Specifies whether to consider the point’s transparency. Note that setting this to true may cause the point to not display correctly when effects are enabled.
Default: undefined
Example:
{ point: { transparent: false }}