@kitware/vtk.js 34.16.7 → 34.18.0

package/CONTRIBUTING.md

@@ -128,7 +128,7 @@ The vtk.js documentation is part of the code repository and is entirely written
 
 If you create an example, please list it in the [examples landing page](Documentation/content/examples/index.md).
 
-Images and GIF videos added to the [gallery](Documentation/public/gallery) must be compressed as much as possible (e.g. 432px by 300px with 50% JPEG compression). You may want to use [ezgif.com](https://ezgif.com/).
+Images and GIF videos added to the [gallery](Documentation/public/gallery) must be compressed as much as possible (e.g. 500px by 280px with 50% JPEG compression). You may want to use [ezgif.com](https://ezgif.com/).
 
 ## Reporting Issues
 

package/Common/Core/Math/index.js

@@ -1928,6 +1928,18 @@ function getMajorAxisIndex(vector) {
   }
   return axisIndex;
 }
+function getMinorAxisIndex(vector) {
+  let minValue = Infinity;
+  let axisIndex = -1;
+  for (let i = 0; i < vector.length; i++) {
+    const value = Math.abs(vector[i]);
+    if (value < minValue) {
+      axisIndex = i;
+      minValue = value;
+    }
+  }
+  return axisIndex;
+}
 
 // Return the closest orthogonal matrix of 1, -1 and 0
 // It works for both column major and row major matrices
@@ -2110,6 +2122,7 @@ var vtkMath = {
   // JS add-on
   createUninitializedBounds,
   getMajorAxisIndex,
+  getMinorAxisIndex,
   getSparseOrthogonalMatrix,
   floatToHex2,
   floatRGB2HexCode,
@@ -2232,6 +2245,7 @@ var vtkMath$1 = /*#__PURE__*/Object.freeze({
   isNan: isNan,
   createUninitializedBounds: createUninitializedBounds,
   getMajorAxisIndex: getMajorAxisIndex,
+  getMinorAxisIndex: getMinorAxisIndex,
   getSparseOrthogonalMatrix: getSparseOrthogonalMatrix,
   floatToHex2: floatToHex2,
   floatRGB2HexCode: floatRGB2HexCode,
@@ -2239,4 +2253,4 @@ var vtkMath$1 = /*#__PURE__*/Object.freeze({
   'default': vtkMath
 });
 
-export { createArray as $, rowsToMat3 as A, degreesFromRadians as B, ldexp as C, xyz2rgb as D, areEquals as E, clampValue as F, arrayRange as G, getMajorAxisIndex as H, createUninitializedBounds as I, normalize4D as J, identity as K, multiplyMatrix as L, floor as M, isInf as N, rgb2hsv as O, rgb2lab as P, lab2rgb as Q, round as R, normalize2D as S, nearestPowerOfTwo as T, multiply3x3_vect3 as U, getSparseOrthogonalMatrix as V, areBoundsInitialized as W, floatRGB2HexCode as X, isPowerOfTwo as Y, angleBetweenVectors as Z, signedAngleBetweenVectors as _, areMatricesEqual as a, isNaN as a$, Pi as a0, ceil as a1, min as a2, max as a3, arrayMin as a4, arrayMax as a5, ceilLog2 as a6, factorial as a7, binomial as a8, beginCombination as a9, quaternionToMatrix3x3 as aA, roundNumber as aB, matrix3x3ToQuaternion as aC, multiplyQuaternion as aD, orthogonalize3x3 as aE, diagonalize3x3 as aF, singularValueDecomposition3x3 as aG, luFactorLinearSystem as aH, luSolveLinearSystem as aI, estimateMatrixCondition as aJ, solveHomogeneousLeastSquares as aK, solveLeastSquares as aL, hex2float as aM, lab2xyz as aN, xyz2lab as aO, rgb2xyz as aP, computeBoundsFromPoints as aQ, clampAndNormalizeValue as aR, getScalarTypeFittingRange as aS, getAdjustedScalarRange as aT, extentIsWithinOtherExtent as aU, boundsIsWithinOtherBounds as aV, pointIsWithinBounds as aW, solve3PointCircle as aX, inf as aY, negInf as aZ, isFinite as a_, nextCombination as aa, randomSeed as ab, getSeed as ac, gaussian as ad, multiplyScalar2D as ae, multiplyAccumulate2D as af, outer as ag, projectVector as ah, dot2D as ai, projectVector2D as aj, gaussianAmplitude as ak, gaussianWeight as al, outer2D as am, norm2D as an, rowsToMat4 as ao, columnsToMat4 as ap, columnsToMat3 as aq, LUFactor3x3 as ar, LUSolve3x3 as as, linearSolve3x3 as at, multiply3x3_mat3 as au, transpose3x3 as av, invert3x3 as aw, identity3x3 as ax, isIdentity as ay, isIdentity3x3 as az, vtkMath as b, floatToHex2 as b0, float2CssRGBA as b1, roundVector as c, dot as d, clampVector as e, distance2BetweenPoints as f, solveLinearSystem as g, hsv2rgb as h, isNan as i, cross as j, add as k, normalize as l, multiplyAccumulate as m, norm as n, determinant2x2 as o, invertMatrix as p, jacobiN as q, radiansFromDegrees as r, subtract as s, perpendiculars as t, uninitializeBounds as u, vtkMath$1 as v, jacobi as w, multiplyScalar as x, random as y, determinant3x3 as z };
+export { createArray as $, rowsToMat3 as A, degreesFromRadians as B, ldexp as C, xyz2rgb as D, areEquals as E, clampValue as F, arrayRange as G, getMajorAxisIndex as H, createUninitializedBounds as I, normalize4D as J, identity as K, multiplyMatrix as L, floor as M, isInf as N, rgb2hsv as O, rgb2lab as P, lab2rgb as Q, round as R, normalize2D as S, nearestPowerOfTwo as T, multiply3x3_vect3 as U, getSparseOrthogonalMatrix as V, areBoundsInitialized as W, floatRGB2HexCode as X, isPowerOfTwo as Y, angleBetweenVectors as Z, signedAngleBetweenVectors as _, areMatricesEqual as a, isNaN as a$, Pi as a0, ceil as a1, min as a2, max as a3, arrayMin as a4, arrayMax as a5, ceilLog2 as a6, factorial as a7, binomial as a8, beginCombination as a9, quaternionToMatrix3x3 as aA, roundNumber as aB, matrix3x3ToQuaternion as aC, multiplyQuaternion as aD, orthogonalize3x3 as aE, diagonalize3x3 as aF, singularValueDecomposition3x3 as aG, luFactorLinearSystem as aH, luSolveLinearSystem as aI, estimateMatrixCondition as aJ, solveHomogeneousLeastSquares as aK, solveLeastSquares as aL, hex2float as aM, lab2xyz as aN, xyz2lab as aO, rgb2xyz as aP, computeBoundsFromPoints as aQ, clampAndNormalizeValue as aR, getScalarTypeFittingRange as aS, getAdjustedScalarRange as aT, extentIsWithinOtherExtent as aU, boundsIsWithinOtherBounds as aV, pointIsWithinBounds as aW, solve3PointCircle as aX, inf as aY, negInf as aZ, isFinite as a_, nextCombination as aa, randomSeed as ab, getSeed as ac, gaussian as ad, multiplyScalar2D as ae, multiplyAccumulate2D as af, outer as ag, projectVector as ah, dot2D as ai, projectVector2D as aj, gaussianAmplitude as ak, gaussianWeight as al, outer2D as am, norm2D as an, rowsToMat4 as ao, columnsToMat4 as ap, columnsToMat3 as aq, LUFactor3x3 as ar, LUSolve3x3 as as, linearSolve3x3 as at, multiply3x3_mat3 as au, transpose3x3 as av, invert3x3 as aw, identity3x3 as ax, isIdentity as ay, isIdentity3x3 as az, vtkMath as b, getMinorAxisIndex as b0, floatToHex2 as b1, float2CssRGBA as b2, roundVector as c, dot as d, clampVector as e, distance2BetweenPoints as f, solveLinearSystem as g, hsv2rgb as h, isNan as i, cross as j, add as k, normalize as l, multiplyAccumulate as m, norm as n, determinant2x2 as o, invertMatrix as p, jacobiN as q, radiansFromDegrees as r, subtract as s, perpendiculars as t, uninitializeBounds as u, vtkMath$1 as v, jacobi as w, multiplyScalar as x, random as y, determinant3x3 as z };

package/Common/Core/Math.d.ts

@@ -1074,6 +1074,13 @@ export function createUninitializedBounds(): Bounds;
  */
 export function getMajorAxisIndex(vector: number[]): number;
 
+/**
+ * Return the index of the component with the smallest absolute value.
+ * Returns -1 for empty arrays.
+ * @param {Number[]} vector
+ */
+export function getMinorAxisIndex(vector: number[]): number;
+
 /**
  * Return the closest orthogonal matrix of 1, -1 and 0
  * It works for both column major and row major matrices
@@ -1244,6 +1251,7 @@ export declare const vtkMath: {
   isInf: typeof isInf;
   createUninitializedBounds: typeof createUninitializedBounds;
   getMajorAxisIndex: typeof getMajorAxisIndex;
+  getMinorAxisIndex: typeof getMinorAxisIndex;
   getSparseOrthogonalMatrix: typeof getSparseOrthogonalMatrix;
   floatToHex2: typeof floatToHex2;
   floatRGB2HexCode: typeof floatRGB2HexCode;

package/Common/Core/Math.js

@@ -1,4 +1,4 @@
 import 'seedrandom';
 import '../../macros2.js';
 import './Math/Constants.js';
-export { ar as LUFactor3x3, as as LUSolve3x3, a0 as Pi, k as add, Z as angleBetweenVectors, W as areBoundsInitialized, E as areEquals, a as areMatricesEqual, a5 as arrayMax, a4 as arrayMin, G as arrayRange, a9 as beginCombination, a8 as binomial, aV as boundsIsWithinOtherBounds, a1 as ceil, a6 as ceilLog2, aR as clampAndNormalizeValue, F as clampValue, e as clampVector, aq as columnsToMat3, ap as columnsToMat4, aQ as computeBoundsFromPoints, $ as createArray, I as createUninitializedBounds, j as cross, b as default, B as degreesFromRadians, o as determinant2x2, z as determinant3x3, aF as diagonalize3x3, f as distance2BetweenPoints, d as dot, ai as dot2D, aJ as estimateMatrixCondition, aU as extentIsWithinOtherExtent, a7 as factorial, b1 as float2CssRGBA, X as floatRGB2HexCode, b0 as floatToHex2, M as floor, ad as gaussian, ak as gaussianAmplitude, al as gaussianWeight, aT as getAdjustedScalarRange, H as getMajorAxisIndex, aS as getScalarTypeFittingRange, ac as getSeed, V as getSparseOrthogonalMatrix, aM as hex2float, h as hsv2rgb, K as identity, ax as identity3x3, aY as inf, aw as invert3x3, p as invertMatrix, a_ as isFinite, ay as isIdentity, az as isIdentity3x3, N as isInf, a$ as isNaN, i as isNan, Y as isPowerOfTwo, w as jacobi, q as jacobiN, Q as lab2rgb, aN as lab2xyz, C as ldexp, at as linearSolve3x3, aH as luFactorLinearSystem, aI as luSolveLinearSystem, aC as matrix3x3ToQuaternion, a3 as max, a2 as min, au as multiply3x3_mat3, U as multiply3x3_vect3, m as multiplyAccumulate, af as multiplyAccumulate2D, L as multiplyMatrix, aD as multiplyQuaternion, x as multiplyScalar, ae as multiplyScalar2D, T as nearestPowerOfTwo, aZ as negInf, aa as nextCombination, n as norm, an as norm2D, l as normalize, S as normalize2D, J as normalize4D, aE as orthogonalize3x3, ag as outer, am as outer2D, t as perpendiculars, aW as pointIsWithinBounds, ah as projectVector, aj as projectVector2D, aA as quaternionToMatrix3x3, r as radiansFromDegrees, y as random, ab as randomSeed, O as rgb2hsv, P as rgb2lab, aP as rgb2xyz, R as round, aB as roundNumber, c as roundVector, A as rowsToMat3, ao as rowsToMat4, _ as signedAngleBetweenVectors, aG as singularValueDecomposition3x3, aX as solve3PointCircle, aK as solveHomogeneousLeastSquares, aL as solveLeastSquares, g as solveLinearSystem, s as subtract, av as transpose3x3, u as uninitializeBounds, aO as xyz2lab, D as xyz2rgb } from './Math/index.js';
+export { ar as LUFactor3x3, as as LUSolve3x3, a0 as Pi, k as add, Z as angleBetweenVectors, W as areBoundsInitialized, E as areEquals, a as areMatricesEqual, a5 as arrayMax, a4 as arrayMin, G as arrayRange, a9 as beginCombination, a8 as binomial, aV as boundsIsWithinOtherBounds, a1 as ceil, a6 as ceilLog2, aR as clampAndNormalizeValue, F as clampValue, e as clampVector, aq as columnsToMat3, ap as columnsToMat4, aQ as computeBoundsFromPoints, $ as createArray, I as createUninitializedBounds, j as cross, b as default, B as degreesFromRadians, o as determinant2x2, z as determinant3x3, aF as diagonalize3x3, f as distance2BetweenPoints, d as dot, ai as dot2D, aJ as estimateMatrixCondition, aU as extentIsWithinOtherExtent, a7 as factorial, b2 as float2CssRGBA, X as floatRGB2HexCode, b1 as floatToHex2, M as floor, ad as gaussian, ak as gaussianAmplitude, al as gaussianWeight, aT as getAdjustedScalarRange, H as getMajorAxisIndex, b0 as getMinorAxisIndex, aS as getScalarTypeFittingRange, ac as getSeed, V as getSparseOrthogonalMatrix, aM as hex2float, h as hsv2rgb, K as identity, ax as identity3x3, aY as inf, aw as invert3x3, p as invertMatrix, a_ as isFinite, ay as isIdentity, az as isIdentity3x3, N as isInf, a$ as isNaN, i as isNan, Y as isPowerOfTwo, w as jacobi, q as jacobiN, Q as lab2rgb, aN as lab2xyz, C as ldexp, at as linearSolve3x3, aH as luFactorLinearSystem, aI as luSolveLinearSystem, aC as matrix3x3ToQuaternion, a3 as max, a2 as min, au as multiply3x3_mat3, U as multiply3x3_vect3, m as multiplyAccumulate, af as multiplyAccumulate2D, L as multiplyMatrix, aD as multiplyQuaternion, x as multiplyScalar, ae as multiplyScalar2D, T as nearestPowerOfTwo, aZ as negInf, aa as nextCombination, n as norm, an as norm2D, l as normalize, S as normalize2D, J as normalize4D, aE as orthogonalize3x3, ag as outer, am as outer2D, t as perpendiculars, aW as pointIsWithinBounds, ah as projectVector, aj as projectVector2D, aA as quaternionToMatrix3x3, r as radiansFromDegrees, y as random, ab as randomSeed, O as rgb2hsv, P as rgb2lab, aP as rgb2xyz, R as round, aB as roundNumber, c as roundVector, A as rowsToMat3, ao as rowsToMat4, _ as signedAngleBetweenVectors, aG as singularValueDecomposition3x3, aX as solve3PointCircle, aK as solveHomogeneousLeastSquares, aL as solveLeastSquares, g as solveLinearSystem, s as subtract, av as transpose3x3, u as uninitializeBounds, aO as xyz2lab, D as xyz2rgb } from './Math/index.js';

package/Filters/General/WindowedSincPolyDataFilter.js

@@ -2,7 +2,6 @@ import { m as macro } from '../../macros2.js';
 import vtkBoundingBox from '../../Common/DataModel/BoundingBox.js';
 import vtkDataArray from '../../Common/Core/DataArray.js';
 import { b as vtkMath } from '../../Common/Core/Math/index.js';
-import { AttributeTypes } from '../../Common/DataModel/DataSetAttributes/Constants.js';
 import vtkPoints from '../../Common/Core/Points.js';
 import vtkPolyData from '../../Common/DataModel/PolyData.js';
 import vtkTriangle from '../../Common/DataModel/Triangle.js';
@@ -484,8 +483,7 @@ function vtkWindowedSincPolyDataFilter(publicAPI, model) {
         numberOfComponents: 1,
         values: newScalars
       });
-      const idx = output.getPointData().addArray(newScalarsArray);
-      output.getPointData().setActiveAttribute(idx, AttributeTypes.SCALARS);
+      output.getPointData().setScalars(newScalarsArray);
     }
     if (model.generateErrorVectors) {
       const newVectors = new Float32Array(3 * numPts);
@@ -513,7 +511,7 @@ function vtkWindowedSincPolyDataFilter(publicAPI, model) {
     if (!input) {
       return;
     }
-    const output = outData[0]?.initialize() || vtkPolyData.newInstance();
+    const output = outData[0] || vtkPolyData.newInstance();
     const outputPoints = publicAPI.vtkWindowedSincPolyDataFilterExecute(input.getPoints(), input, output);
     output.setPointData(input.getPointData());
     output.setCellData(input.getCellData());

package/Filters/Modeling/RibbonFilter.d.ts

@@ -0,0 +1,196 @@
+import { vtkAlgorithm, vtkObject } from './../../interfaces';
+import { Vector3 } from './../../types';
+
+export type IGenerateTCoords =
+  | 'TCOORDS_OFF'
+  | 'TCOORDS_FROM_SCALARS'
+  | 'TCOORDS_FROM_LENGTH'
+  | 'TCOORDS_FROM_NORMALIZED_LENGTH';
+
+/**
+ *
+ */
+export interface IRibbonFilterInitialValues {
+  useDefaultNormal?: boolean;
+  width?: number;
+  varyWidth?: boolean;
+  angle?: number;
+  generateTCoords?: IGenerateTCoords;
+  widthFactor?: number;
+  textureLength?: number;
+  defaultNormal?: Vector3;
+}
+
+type vtkRibbonFilterBase = vtkObject & vtkAlgorithm;
+
+export interface vtkRibbonFilter extends vtkRibbonFilterBase {
+  /**
+   * Get the angle (in degrees) of rotation about the line tangent used to
+   * orient the ribbon.
+   */
+  getAngle(): number;
+
+  /**
+   * Get the default normal used to orient the ribbon when no normals are
+   * provided in the input.
+   */
+  getDefaultNormal(): Vector3;
+
+  /**
+   * Get the default normal used to orient the ribbon when no normals are
+   * provided in the input.
+   */
+  getDefaultNormalByReference(): Vector3;
+
+  /**
+   * Get the method used to generate texture coordinates.
+   */
+  getGenerateTCoords(): IGenerateTCoords;
+
+  /**
+   * Get the method used to generate texture coordinates as a string.
+   */
+  getGenerateTCoordsAsString(): string;
+
+  /**
+   * Get the texture length, used when generating texture coordinates from
+   * length.
+   */
+  getTextureLength(): number;
+
+  /**
+   * Get whether to use the default normal to orient the ribbon when no
+   * normals are provided in the input.
+   */
+  getUseDefaultNormal(): boolean;
+
+  /**
+   * Get whether to vary the width of the ribbon using scalar data.
+   */
+  getVaryWidth(): boolean;
+
+  /**
+   * Get the width of the ribbon.
+   */
+  getWidth(): number;
+
+  /**
+   * Get the width factor, used to scale the width when varying the width.
+   */
+  getWidthFactor(): number;
+
+  /**
+   *
+   * @param inData
+   * @param outData
+   */
+  requestData(inData: any, outData: any): void;
+
+  /**
+   * Set the angle (in degrees) of rotation about the line tangent used to orient the ribbon.
+   * Default is 0.0.
+   * @param angle The angle in degrees.
+   * @returns true if the angle is set successfully.
+   */
+  setAngle(angle: number): boolean;
+
+  /**
+   * Set the default normal used to orient the ribbon when no normals are provided in the input.
+   * The default normal is a vector defined by three components (x,y,z). The
+   * default is (0,0,1).
+   * @param defaultNormal The default normal as an array of three numbers or a Vector3.
+   * @returns true if the default normal is set successfully.
+   */
+  setDefaultNormal(defaultNormal: Vector3): boolean;
+
+  /**
+   * Set the default normal used to orient the ribbon when no normals are provided in the input.
+   * The default normal is a vector defined by three components (x,y,z). The
+   * default is (0,0,1).
+   * @returns true if the default normal is set successfully.
+   */
+  setDefaultNormalFrom(defaultNormal: Vector3): boolean;
+
+  /**
+   * Set the method used to generate texture coordinates. By default, texture
+   * coordinates are not generated.
+   * @param generateTCoords The method to generate texture coordinates.
+   * @returns true if the method is set successfully.
+   */
+  setGenerateTCoords(generateTCoords: IGenerateTCoords): boolean;
+
+  /**
+   * Set the texture length, used when generating texture coordinates from length.
+   * The default is 1.0.
+   * @param textureLength The texture length.
+   * @returns true if the texture length is set successfully.
+   */
+  setTextureLength(textureLength: number): boolean;
+
+  /**
+   * Set whether to use the default normal to orient the ribbon when no normals are provided in the input.
+   * The default is false.
+   * @param useDefaultNormal Whether to use the default normal.
+   * @returns true if the flag is set successfully.
+   */
+  setUseDefaultNormal(useDefaultNormal: boolean): boolean;
+
+  /**
+   * Set whether to vary the width of the ribbon using scalar data. By default,
+   * the width of the ribbon is uniform.
+   * @param varyWidth Whether to vary the width of the ribbon.
+   * @returns true if the flag is set successfully.
+   */
+  setVaryWidth(varyWidth: boolean): boolean;
+
+  /**
+   * Set the width of the ribbon. The width is the total width of the ribbon;
+   * the ribbon extends width/2 on either side of the line. The default is 0.5.
+   * @param width The width of the ribbon.
+   * @returns true if the width is set successfully.
+   */
+  setWidth(width: number): boolean;
+
+  /**
+   * Set the width factor, used to scale the width when varying the width.
+   * The default is 1.0.
+   * @param widthFactor The width factor.
+   * @returns true if the width factor is set successfully.
+   */
+  setWidthFactor(widthFactor: number): boolean;
+}
+
+/**
+ * Method used to decorate a given object (publicAPI+model) with vtkRibbonFilter characteristics.
+ *
+ * @param publicAPI object on which methods will be bounds (public)
+ * @param model object on which data structure will be bounds (protected)
+ * @param {IRibbonFilterInitialValues} [initialValues] (default: {})
+ */
+export function extend(
+  publicAPI: object,
+  model: object,
+  initialValues?: IRibbonFilterInitialValues
+): void;
+
+/**
+ * Method used to create a new instance of vtkRibbonFilter
+ * @param {IRibbonFilterInitialValues} [initialValues] for pre-setting some of its content
+ */
+export function newInstance(
+  initialValues?: IRibbonFilterInitialValues
+): vtkRibbonFilter;
+
+/**
+ * vtkRibbonFilter is a filter to create oriented ribbons from lines defined in
+ * polygonal dataset. The orientation of the ribbon is along the line segments
+ * and perpendicular to "projected" line normals. Projected line normals are the
+ * original line normals projected to be perpendicular to the local line
+ * segment. An offset angle can be specified to rotate the ribbon with respect
+ * to the normal.
+ */
+export declare const vtkRibbonFilter: {
+  newInstance: typeof newInstance;
+  extend: typeof extend;
+};
+export default vtkRibbonFilter;