CatmullRomCurve3

The cientos package provides a <CatmullRomCurve3 /> component that allows you to make smooth(ish) 3D lines.

<CatmullRomCurve3 /> wraps Three.js's CatmullRomCurve3 functionality, but applies it to Cientos' <Line2 /> under the hood, meaning you can use all the props from <Line2 />.

Usage

<script setup lang="ts">
import { TresCanvas } from '@tresjs/core'
import { CatmullRomCurve3, OrbitControls } from '@tresjs/cientos'
</script>

<template>
  <TresCanvas clear-color="#4f4f4f">
    <CatmullRomCurve3
      :points="[[-1.5, 0, 0], [-0.5, 1, 0], [0.5, 0, 0], [1.5, 1, 0]]"
      :segments="40"
      :line-width="10"
      color="#fbb03b"
    />
    <TresGridHelper />
    <OrbitControls />
  </TresCanvas>
</template>

Props

Prop	Type	Description	Default
points	Array<Vector3 | [number, number, number]>	Curve's control points
segments	number	Number of segments in the resulting curve (higher = smoother)	20
closed	boolean	The curve will loop back onto itself when this is true.	false
curveType	'centripetal' | 'chordal' | 'catmullrom'	Curve type	'centripetal'
tension	number	Catmullrom's tension, when curveType is 'catmullrom'	0.5
vertexColors	TresColor[]	Vertex colors, if using	null
color	TresColor	Color for the line – multiplies vertex colors	'white'
lineWidth	number	Width of the line – in world units with size attenuation, pixels otherwise	1
worldUnits	boolean	Whether the line width is in world units or pixels	false
alphaToCoverage	boolean	Enables alpha to coverage. Can only be used with MSAA-enabled contexts (meaning when the renderer was created with antialias parameter set to true).	false
dashed	boolean	Whether the line is dashed	false
dashSize	number	Dash size	1
gapSize	number	Gap size in dashed line	1
dashScale	number	Scale of the dashes/gaps	1
dashOffset	number	Dash offset	0