@animech-public/playcanvas/build/playcanvas.dbg/src/scene/geometry/capsule-geometry.js

PlayCanvas WebGL game engine

import { ConeBaseGeometry } from './cone-base-geometry.js';
import { calculateTangents } from './geometry-utils.js';

/**
 * A procedural capsule-shaped geometry.
 *
 * The size, shape and tesselation properties of the capsule can be controlled via constructor
 * parameters. By default, the function will create a capsule standing vertically centered on the
 * XZ-plane with a radius of 0.3, a height of 1.0, 1 height segment and 20 cap segments.
 *
 * Note that the capsule is created with UVs in the range of 0 to 1.
 *
 * @category Graphics
 */
class CapsuleGeometry extends ConeBaseGeometry {
  /**
   * Create a new CapsuleGeometry instance.
   *
   * @param {object} [opts] - An object that specifies optional inputs for the function as follows:
   * @param {number} [opts.radius] - The radius of the tube forming the body of the capsule (defaults
   * to 0.3).
   * @param {number} [opts.height] - The length of the body of the capsule from tip to tip (defaults
   * to 1.0).
   * @param {number} [opts.heightSegments] - The number of divisions along the tubular length of the
   * capsule (defaults to 1).
   * @param {number} [opts.sides] - The number of divisions around the tubular body of the capsule
   * (defaults to 20).
   * @param {boolean} [opts.calculateTangents] - Generate tangent information (defaults to false).
   */
  constructor(opts = {}) {
    var _opts$radius, _opts$height, _opts$heightSegments, _opts$sides;
    // Check the supplied options and provide defaults for unspecified ones
    const radius = (_opts$radius = opts.radius) != null ? _opts$radius : 0.3;
    const height = (_opts$height = opts.height) != null ? _opts$height : 1;
    const heightSegments = (_opts$heightSegments = opts.heightSegments) != null ? _opts$heightSegments : 1;
    const sides = (_opts$sides = opts.sides) != null ? _opts$sides : 20;

    // Create vertex data for a cone that has a base and peak radius that is the same (i.e. a cylinder)
    super(radius, radius, height - 2 * radius, heightSegments, sides, true);
    if (opts.calculateTangents) {
      this.tangents = calculateTangents(this.positions, this.normals, this.uvs, this.indices);
    }
  }
}

export { CapsuleGeometry };