Interface OBJ_Line3

3D Line options object that extends OBJ_Generic3All and OBJ_FigurePrimitive

A 3D line is a cylinder with optional arrows on the end. Unlike a 2D line, the arrow profiles can only be simple triangles.

sides number — number of sides (10)
p1 TypeParsablePoint — ([0, 0, 0])
p2 TypeParsablePoint — (default: p1 + [1, 0, 0])
width number — width of line
arrow OBJ_Line3Arrow — define to use arrows at one or both ends of the line
rotation number — rotation of line around its axis - this is only noticable for small numbers of sides (0)
normals flat | curve — flat normals will make light shading across a line face constant. curve will gradiate the shading. Use curve to make a surface look more round with fewer number of sides. (curve)

See

To test examples, append them to the boilerplate

Example

// Simple line
figure.add({
  make: 'line3',
  p1: [0, 0, 0],
  p2: [0, 1, 0],
  color: [1, 0, 0, 1],
});

Example

// Thick line with arrows on both ends
figure.add({
  make: 'line3',
  p1: [0, 0, 0],
  p2: [0, 1, 0],
  arrow: { ends: 'all', width: 0.1, length: 0.1 },
  sides: 30,
  width: 0.05,
  color: [1, 0, 0, 1],
});

Example

// Wire mesh line with arrow
figure.add({
  make: 'line3',
  p1: [0, 0, 0],
  p2: [0, 1, 0],
  arrow: { ends: 'end' },
  color: [1, 0, 0, 1],
  lines: true,
});

Example

// Ball of arrows
figure.add(
  {
    make: 'line3',
    p1: [0, 0, 0],
    p2: [0, 0.4, 0],
    color: [1, 0, 0, 1],
    width: 0.01,
    arrow: { end: 'end', width: 0.02 },
    copy: [
      { along: 'rotation', num: 20, step: Math.PI * 2 / 20 },
      { along: 'rotation', axis: [0, 1, 0], num: 20, step: Math.PI * 2 / 20 },
    ],
  },
);
@interface

Interface OBJ_Line3

See

Example

Example

Example

Example

Settings