MeasurementAPI

• webVis API Reference
• MeasurementAPI

Interface MeasurementAPI

These functions allow the creation of Measurements.

Example

// Get the context
const context : ContextAPI = webvis.getContext();

// Define a point target
const pointTarget : webvis.MeasurementTarget<MeasurementTargetClass.POINT> =
{
    class: webvis.MeasurementTargetClass.POINT,
    value: [ 0, 0, 0 ]
};

// Define a plane target
const planeTarget : webvis.MeasurementTarget<MeasurementTargetClass.PLANE> =
{
    class: webvis.MeasurementTargetClass.PLANE,
    value: [ 1, 0, 0, 1 ]
}

// Create a new single Measurement
const singleMeasurementID : number = context.createMeasurement(
    webvis.MeasurementType.SINGLE,
    [ pointTarget ],
    { enabled: true }
);

// Create a double Measurement between a point and a plane
const doubleMeasurementID : number = context.createMeasurement(
    webvis.MeasurementType.MULTIPLE,
    [ pointTarget, planeTarget ],
    { enabled: true }
);

interface MeasurementAPI {
    changeMeasurement(
        measurementID: number,
        properties: MeasurementProperties,
    ): MeasurementProperties;
    createMeasurement<T extends keyof MeasurementTypeToTargetMap>(
        type: T,
        targets: MeasurementTypeToTargetMap[T],
        properties?: MeasurementProperties,
    ): number;
    getMeasurements(): number[];
    measureBetween(
        target0: MeasurementTarget,
        target1: MeasurementTarget,
    ): Promise<BetweenMeasurementResult>;
    measureTangent(
        topology: { class: TOPOLOGY; value: TopologyHandle },
        point: { class: POINT; value: [number, number, number] },
    ): Promise<TangentMeasurementResult>;
    measureThickness(
        topology: { class: TOPOLOGY; value: TopologyHandle },
        point: { class: POINT; value: [number, number, number] },
    ): Promise<ThicknessMeasurementResult>;
    removeMeasurement(measurementID: number, safe?: boolean): RemoveState;
    requestMeasurementData(
        measurementID: number,
    ): Promise<MeasurementProperties>;
}

Hierarchy (View Summary)

• MeasurementAPI
  • ContextAPI

Index

Methods

changeMeasurement createMeasurement getMeasurements measureBetween measureTangent measureThickness removeMeasurement requestMeasurementData

Methods

changeMeasurement

• changeMeasurement(
      measurementID: number,
      properties: MeasurementProperties,
  ): MeasurementProperties

• Changes one or more properties of a Measurement with the specified id.

  Parameters

  • measurementID: number

    The id of the Measurement you want to change.
  • properties: MeasurementProperties

    The properties of the Measurement you want change.

  Returns MeasurementProperties

  An Object with the changed Properties.

createMeasurement

• createMeasurement<T extends keyof MeasurementTypeToTargetMap>(
      type: T,
      targets: MeasurementTypeToTargetMap[T],
      properties?: MeasurementProperties,
  ): number

• Creates a new Measurement.

  Type Parameters

  • T extends keyof MeasurementTypeToTargetMap

  Parameters

  • type: T

    The type of the Measurement.
  • targets: MeasurementTypeToTargetMap[T]

    The targets of the Measurement.
  • Optionalproperties: MeasurementProperties

    The properties of the Measurement.

  Returns number

  The ID of the created Measurement.

getMeasurements

• getMeasurements(): number[]

• Returns number[]

  The IDs of all available Measurements.

measureBetween

• measureBetween(
      target0: MeasurementTarget,
      target1: MeasurementTarget,
  ): Promise<BetweenMeasurementResult>

• Measures the distance and if possible the angle between two measurement targets.

  Parameters

  • target0: MeasurementTarget

    The first measurement target.
  • target1: MeasurementTarget

    The second measurement target.

  Returns Promise<BetweenMeasurementResult>

  The result of the Measurement between the two specified targets.

measureTangent

• measureTangent(
      topology: { class: TOPOLOGY; value: TopologyHandle },
      point: { class: POINT; value: [number, number, number] },
  ): Promise<TangentMeasurementResult>

• Measures the tangent of an edge at the specified point.

  Parameters

  • topology: { class: TOPOLOGY; value: TopologyHandle }

    The topological target.

    • class: TOPOLOGY

      Describes the MeasurementTargetClass of the target.

    • value: TopologyHandle

      Describes the value of the target depending on the specified class.
  • point: { class: POINT; value: [number, number, number] }

    The point target.

    • class: POINT

      Describes the MeasurementTargetClass of the target.

    • value: [number, number, number]

      Describes the value of the target depending on the specified class.

  Returns Promise<TangentMeasurementResult>

  The result of the tangent measurement.

measureThickness

• measureThickness(
      topology: { class: TOPOLOGY; value: TopologyHandle },
      point: { class: POINT; value: [number, number, number] },
  ): Promise<ThicknessMeasurementResult>

• Measures the thickness of a shape at the specified point.

  Parameters

  • topology: { class: TOPOLOGY; value: TopologyHandle }

    The topological target.

    • class: TOPOLOGY

      Describes the MeasurementTargetClass of the target.

    • value: TopologyHandle

      Describes the value of the target depending on the specified class.
  • point: { class: POINT; value: [number, number, number] }

    The point target.

    • class: POINT

      Describes the MeasurementTargetClass of the target.

    • value: [number, number, number]

      Describes the value of the target depending on the specified class.

  Returns Promise<ThicknessMeasurementResult>

  The result of the thickness measurement.

removeMeasurement

• removeMeasurement(measurementID: number, safe?: boolean): RemoveState

• Removes the Measurement from the scene and all related Snapshots.

  Parameters

  • measurementID: number
  • Optionalsafe: boolean

    Performs a safe remove which interrupt the removal process if the Measurement is part of one or more Snapshots.

  Returns RemoveState

requestMeasurementData

• requestMeasurementData(measurementID: number): Promise<MeasurementProperties>

• Returns the MeasurementProperties for the specified Measurement id.

  Parameters

  • measurementID: number

    The id of the Measurement you want to request the data for.

  Returns Promise<MeasurementProperties>

  The requested Measurement properties.

---

Did you find this page useful? Please give it a rating:

★ ★ ★ ★ ★

Thank you for rating this page!

Any issues or feedback?

What kind of problem would you like to report?

• This page needs code samples
• Code samples do not work
• Information is missing
  Please tell us more about what's wrong:
• Information is incorrect
  Please tell us more about what's wrong:
• Information is unclear or confusing
  Please tell us more about what's wrong:
• The page is rendered incorrectly (styling/CSS)
• Give Feedback

Please tell us more about what's wrong: Name E-Mail Problem (required)