PolylineMaterial
PolylineMaterial represents a material for polyline geometry rendering.
Properties
Section titled “Properties”castShadow
Section titled “castShadow”Type: boolean | undefined
Description: Specifies whether the polyline casts shadows.
Default: undefined
Example:
{ polyline: { castShadow: true }}clampToGround
Section titled “clampToGround”Type: boolean
Description: Specifies whether to clamp the polyline to the ground.
Default: Required
Example:
{ polyline: { clampToGround: true }}Type: Color
Description: Specifies the polyline color as a Color instance.
Default: Required
Example:
import { Color } from "@navaramap/three";
{ polyline: { color: new Color().setHex(0x0066cc) }}depthWrite
Section titled “depthWrite”Type: boolean | undefined
Description: Enables writing to the depth buffer. Set to false for transparent materials to prevent depth sorting issues.
Default: true
Example:
{ polyline: { depthWrite: false }}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:
{ polyline: { 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";
{ polyline: { 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:
{ polyline: { emissiveIntensity: 0.5 }}height
Section titled “height”Type: number | undefined
Description: Specifies the height of the polyline. The unit is meters.
Default: undefined
Example:
{ polyline: { height: 1 }}maxWidth
Section titled “maxWidth”Type: number | undefined
Description: Maximum line width in pixels, clamping the rendered width regardless of zoom level. Smaller values are cheaper to render as they reduce fragment shader overdraw.
Default: undefined
Example:
{ polyline: { maxWidth: 10 }}receiveShadow
Section titled “receiveShadow”Type: boolean | undefined
Description: Specifies whether the polyline receives shadows.
Default: undefined
Example:
{ polyline: { receiveShadow: true }}Type: boolean | undefined
Description: Specifies whether to show the polyline.
Default: undefined
Example:
{ polyline: { show: true }}transparent
Section titled “transparent”Type: boolean | undefined
Description: Enables transparency and alpha blending. This allows the polyline to be rendered with opacity.
Default: false
Example:
{ polyline: { transparent: true }}Type: boolean | undefined
Description: Splits the polyline into XYZ vector tiles for rendering, even when the data source is not an MVT layer. This can improve performance for large polylines. Enabling clampToGround implicitly forces tiled to true.
Default: false
Example:
{ polyline: { tiled: true }}Type: number
Description: Specifies the width of the polyline. The unit is pixels.
Default: Required
Example:
{ polyline: { width: 3 }}