Last updated

API / geotoolkit3d / shapes / GridIntersection3D / GridIntersection3D

Class: GridIntersection3D

shapes.GridIntersection3D.GridIntersection3D

Base class of Carnac3D objects.

This class extends THREE.Object3D to expose some useful functions and add some new features.
It is similar to a CarnacJS Group (has children and holds a transformation that applies to its children).

To change the location/size/orientation of an Object3D, refer to THREEJS documentation

Hierarchy

Table of contents

Constructors
Methods

Contents

Constructors

new GridIntersection3D(options)

new GridIntersection3D(options)

Parameters

Name Type
optionsOptions

Overrides

Object3D.constructor

Methods

add

add(object): GridIntersection3D

Adds object as child of this object.

Parameters

Name Type Description
objectObject3D<Object3DEventMap> | Object3D<Object3DEventMap>[]object

Returns

GridIntersection3D

this

Inherited from

Object3D.add


afterRender

afterRender(scene, camera, plot, renderer): GridIntersection3D

This function is called after rendering and can update this object's content.

It should not trigger any invalidateObject though.
Note that it is not necessary nor recommended to explicitly call afterRender on this object's children as beforeRender will be called on all nodes present in the scene.

This will be executed after the transformations simplification.

See

Plot for more details on the render steps

Parameters

Name Type Description
sceneSceneThe scene
cameraCameraThe camera used for this render phase.
plotPlotThe 3D plot
rendererWebGLRendererThe renderer

Returns

GridIntersection3D

Inherited from

Object3D.afterRender


beforeRender

beforeRender(scene, camera, plot, renderer): GridIntersection3D

This function is called prior to rendering and can update this object's content.

It should not trigger any invalidateObject though.
Note that it is not necessary nor recommended to explicitly call beforeRender on this object's children as beforeRender will be called on all nodes present in the scene.

This will be executed after the transformations simplification.

See

Plot for more details on the render steps

Parameters

Name Type Description
sceneSceneThe scene
cameraCameraThe camera used for this render phase.
plotPlotThe 3D plot
rendererWebGLRendererThe renderer

Returns

GridIntersection3D

Inherited from

Object3D.beforeRender


dispose

dispose(): void

Dispose object

Returns

void

Inherited from

Object3D.dispose


getClassName

getClassName(): string

Returns

string

Inherited from

Object3D.getClassName


getGrid

getGrid(): ReservoirGrid

Returns grid

Returns

ReservoirGrid

grid reservoir grid


getHighlightedCells

getHighlightedCells(): number[]

Returns

number[]


getOptions

getOptions(): Required<Options>

Get options

Returns

Required<Options>

options object

Inherited from

Object3D.getOptions


getPanels

getPanels(): Iterator<AbstractPanel>

Return iterator with panels intersected with Grid

Returns

Iterator<AbstractPanel>

iterator with panels


getVisible

getVisible(): boolean

Get visible

Returns

boolean

true, if object is visible

Inherited from

Object3D.getVisible


invalidateObject

invalidateObject<T>(event?): GridIntersection3D

Notifies this object and its parent that this object has been invalidated.
If this object is in a Plot, it will be marked as dirty and will trigger a rendering cycle.

Type parameters

Name
T

Parameters

Name Type Description
Optional eventEvent<T>The event to fire

Returns

GridIntersection3D

Inherited from

Object3D.invalidateObject


isDisposed

isDisposed(): boolean

Returns whether this object has been disposed

Returns

boolean

Inherited from

Object3D.isDisposed


isSelectable

isSelectable(): boolean

Return if this object can be picked/selected (see RendererPicking).

Returns

boolean

Inherited from

Object3D.isSelectable


notify

notify(type, source, args?): GridIntersection3D

Notify listeners

Parameters

Name Type Description
typestringevent types
sourceanyof the event
Optional argsanyarguments of the event

Returns

GridIntersection3D

this

Inherited from

Object3D.notify


off

off(type?, callback?): GridIntersection3D

Detach listener on event. Calling .off() with no arguments removes all attached listeners. Calling .off(type) with no callback removes all attached listeners for specific type.

Parameters

Name Type Description
Optional typestringtype of the event
Optional callbackEventListenerfunction to be called

Returns

GridIntersection3D

this

Inherited from

Object3D.off

off<E>(type, callback): GridIntersection3D

Type parameters

NameType
Eextends string

Parameters

Name Type
typeE
callback(eventType: E, sender: GridIntersection3D, args: EventMap[E]) => void

Returns

GridIntersection3D

Inherited from

Object3D.off


on

on(type, callback, options?): GridIntersection3D

Attach listener on event that will be called whenever the specified event is delivered to the target

If the callback function is already in the list of event listeners for this target, the function is not added a second time.

If a particular anonymous function is in the list of event listeners registered for a certain target, and then later in the code, an identical anonymous function is given in an "on" call, the second function will also be added to the list of event listeners for that target.

Parameters

Name Type Description
typestringtype of event or property
callbackEventListenerto be called
Optional optionsOptionsoptions of subscription

Returns

GridIntersection3D

this

Inherited from

Object3D.on

on<E>(type, callback, options?): GridIntersection3D

Type parameters

NameType
Eextends string

Parameters

Name Type
typeE
callback(eventType: E, sender: GridIntersection3D, args: EventMap[E]) => void
Optional optionsOptions

Returns

GridIntersection3D

Inherited from

Object3D.on


onStatsUpdated

onStatsUpdated(metrics): GridIntersection3D

This function is called when the plot has updated performance metric.
It will be called every set number of frames.
The number of frame is customizable in the plot options advancedrendering.performancemetrics.updateframeperiod and is 100 by default.

Parameters

Name Type Description
metricsPerformanceMetricsThe performance metrics.

Returns

GridIntersection3D

Inherited from

Object3D.onStatsUpdated


onVisibilityChanged

Protected onVisibilityChanged(): void

This method is called if visibility is changed. Send event Events.VisibilityChanged

Returns

void

Inherited from

Object3D.onVisibilityChanged


rebuild

rebuild(): GridIntersection3D

Rebuild model

Returns

GridIntersection3D

this


remove

remove(object): GridIntersection3D

Removes object as child of this object.

Parameters

Name Type Description
objectObject3D<Object3DEventMap> | Object3D<Object3DEventMap>[]object

Returns

GridIntersection3D

this

Inherited from

Object3D.remove


setGrid

setGrid(grid): GridIntersection3D

Set grid to intersect with panels

Parameters

Name Type Description
gridReservoirGridreservoir grid to intersect with panels

Returns

GridIntersection3D

this


setHighlightedCells

setHighlightedCells(indexes): GridIntersection3D

Parameters

Name Type
indexesnumber | number[]

Returns

GridIntersection3D


setOptions

setOptions(options?): GridIntersection3D

Set options

Parameters

Name Type Description
Optional optionsOptionsoptions object

Returns

GridIntersection3D

this

Inherited from

Object3D.setOptions


setPanels

setPanels(panels): GridIntersection3D

Set of panels to intersect with grid

Parameters

Name Type Description
panelsAbstractPanel | Iterator<AbstractPanel> | AbstractPanel[]set of panels to intersect with grid

Returns

GridIntersection3D

this


setPosition

setPosition(position): GridIntersection3D

Set Object's local position.

Parameters

Name Type Description
positionObjectlocal position
Optional position.xnumber
Optional position.ynumber
Optional position.znumber

Returns

GridIntersection3D

this

Inherited from

Object3D.setPosition


setRotation

setRotation(x, y, z, order?): GridIntersection3D

Set Object's local rotation (Euler angles), in radians.

Parameters

Name Type Description
xnumberx angle
ynumbery angle
znumberz angle
Optional orderEulerOrdereuler order

Returns

GridIntersection3D

this

Inherited from

Object3D.setRotation


setSelectable

setSelectable(selectable): void

Set if this object can be picked/selected (see RendererPicking).

Parameters

Name Type Description
selectablebooleanif can be selected

Returns

void

Inherited from

Object3D.setSelectable


setVisible

setVisible(visible, silent?): GridIntersection3D

Set visible

Parameters

Name Type Description
visiblebooleantrue, if object is visible
Optional silentbooleantrue, if object shouldn't be invalidated

Returns

GridIntersection3D

this

Inherited from

Object3D.setVisible


updateObject

updateObject(scene, camera): GridIntersection3D

This function is called prior to rendering and can update this object's content.

It should not trigger any invalidateObject though.
Note that it is not necessary nor recommended to explicitly call updateObject on this object's children as updateObject will be called on all nodes present in the scene.

This will be executed before the transformations simplification.

See

Plot for more details on the render steps

Parameters

Name Type Description
sceneSceneThe scene
cameraCameraThe camera

Returns

GridIntersection3D

Inherited from

Object3D.updateObject


updateTimeStamp

Protected updateTimeStamp(): GridIntersection3D

Update time stamp to indicate that Node or Children has been changed.

Returns

GridIntersection3D

this


useOwnHighlight

useOwnHighlight(): boolean

Returns true if this object make its own highlight effect (like geotoolkit3d.scene.reservoir.hexahedral.ReservoirGrid) This is to prevent unnecessary executions of the costly highlight passes.

Returns

boolean

Inherited from

Object3D.useOwnHighlight


getClassName

Static getClassName(): string

Returns

string

Inherited from

Object3D.getClassName


register

Static register(): void

Register object for special processing through a callback function

Example

geotoolkit3d.util.ObjectProcessor.getDefaultInstance().registerObject(this.getClassName(), callback);

Deprecated

since 5.0, to allow custom object highlighting, please instead make your Object implement the interface geotoolkit3d/scene/ICustomHighlight.

Returns

void

Inherited from

Object3D.register