Interface PrimitiveManagerLineInterface

The PrimitiveManagerLineInterface is used to display 3D lines on top of the DMU.

The PrimitiveManagerLineInterface is accessed through the getLineManager function (the PrimitiveManagerInterface is accessed through getPrimitiveManager).

A 3D line is defined as a segment, thus with two 3D points. Rendered 3D lines are manipulated through their ids (and not a dedicated object), indeed each line is assigned a strictly positive integer id that will represent it. 0 is an invalid line id.

The color of the 3D line is handled by the PrimitiveManagerMaterialInterface, accessed through getMaterialManager. Materials are accessed by their ids, and modified by their ids. 3D primitives are rendered colored with their primitive material id, and not directly from a color.
WARNING : do not confuse the PrimitiveManagerMaterialInterface and the MaterialManagerInterface, these two interfaces are separated, do not use MaterialManagerInterface ids to draw lines !!!

Creating a 3D line may be done with the following :

/** 
 * Sample to explain how to create 3d lines on top of the rendering (PrimitiveManagerLineInterface).
 */
import { InfiniteEngineInterface, PrimitiveManagerMaterialInterface, PrimitiveManagerLineInterface, Vector4, Vector3 } from 'generated/documentation/appinfiniteapi';

// created previously
let lInfiniteEngine : InfiniteEngineInterface;
// created previously, the segment point position 1
let lLinePosition1 : Vector3;
// created previously, the segment point position 2
let lLinePosition2 : Vector3;

// the material for the line color
let lLineColorMaterial : number = -1;
// the primitive material manager
const lPrimitiveMaterialManager : PrimitiveManagerMaterialInterface = lInfiniteEngine.getPrimitiveManager().getMaterialManager();
// the line manager
const lLineManager : PrimitiveManagerLineInterface = lInfiniteEngine.getPrimitiveManager().getLineManager();
// line color is white opaque (1 as last parameter)
const lLineColor : Vector4 = new Vector4(1, 1, 1, 1);

// create material
lLineColorMaterial = lPrimitiveMaterialManager.createMaterial(lLineColor);

// and create the line
const lLineId : number = lLineManager.createLine(
    // segment extents
    lLinePosition1,
    lLinePosition2,
    lLineColorMaterial,
    // line width
    5
);

console.log('Line id is ' + lLineId);

You may create also boxes, points, etc with [PrimitiveManagerBoxInterface](PrimitiveManagerBoxInterface.html), [PrimitiveManagerPointInterface](PrimitiveManagerPointInterface.html), etc.

See

• PrimitiveManagerMaterialInterface
• PrimitiveManagerInterface
• InfiniteEngineInterface