Skip to main content

@novorender/web_app / RenderStateOutlines

Interface: RenderStateOutlines

Outline related render state.

Remarks

Enabling this feature will render the intersection of geometry surface with the specified plane as lines. This is particularly useful when in orthographic mode on surfaces that are perfectly perpendicular to the image plane. These surfaces would otherwise be invisible and unpickable.

Due to limitations of WebGL2, outline rendering comes as at potentially significant performance and memory cost. Thus, is may be unavailable on weaker devices and should be used sparingly otherwise.

Properties

breakingPointAngleThreshold

readonly breakingPointAngleThreshold: number;

Minimum angle to create breaking points from outlines in degrees

Defined in

@novorender/core3d/state/index.ts:775


enabled

readonly enabled: boolean;

Whether to do outline rendering.

Defined in

@novorender/core3d/state/index.ts:730


hidden

readonly hidden: boolean;

Hide outline on screen, it can still be used for measurement

Defined in

@novorender/core3d/state/index.ts:727


linearThickness

readonly linearThickness: number;

Outline thickness, in meters.

Default

0.01

Defined in

@novorender/core3d/state/index.ts:735


lineColor

readonly lineColor: RGB;

Color of outline lines.

Remarks

Due to tone mapping the color displayed on screen will a bit duller. If you require bright colors, you may "overexpose" them, e.g. [10,0,0] for bright red.

Defined in

@novorender/core3d/state/index.ts:762


maxPixelThickness

readonly maxPixelThickness: number;

Outline maximum thickness, in pixels.

Default

9

Defined in

@novorender/core3d/state/index.ts:745


minPixelThickness

readonly minPixelThickness: number;

Outline minimum thickness, in pixels.

Default

3

Defined in

@novorender/core3d/state/index.ts:740


planes

readonly planes: ReadonlyVec4[];

The outline intersection plane.

Defined in

@novorender/core3d/state/index.ts:772


relativePointSize

readonly relativePointSize: number;

Outline relative size between lines and points.

Default

2

Defined in

@novorender/core3d/state/index.ts:750


vertexColor

readonly vertexColor: RGB;

Color of outline vertices.

Remarks

Due to tone mapping the color displayed on screen will a bit duller. If you require bright colors, you may "overexpose" them, e.g. [10,0,0] for bright red.

Defined in

@novorender/core3d/state/index.ts:769


vertexObjectIdBase

readonly vertexObjectIdBase: number;

Outline vertex base object id value.

Default

0x7000_0000

Defined in

@novorender/core3d/state/index.ts:755