Last updated

API / geotoolkit3d / gigagrid / ReservoirGrid / ReservoirGrid

Class: ReservoirGrid

gigagrid.ReservoirGrid.ReservoirGrid

The main class in GigaGrid, controlling grid creation, render process, and resolution switching.

Hierarchy

Table of contents

Constructors
Methods

Contents

Constructors

new ReservoirGrid(options)

new ReservoirGrid(options)

Parameters

Name Type
optionsOptions

Overrides

AbstractReservoirGrid.constructor

Methods

add

add(object): ReservoirGrid

Adds object as child of this object.

Parameters

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

Returns

ReservoirGrid

this

Inherited from

AbstractReservoirGrid.add


afterRender

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

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

ReservoirGrid

Inherited from

AbstractReservoirGrid.afterRender


beforeRender

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

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

ReservoirGrid

Inherited from

AbstractReservoirGrid.beforeRender


dispose

dispose(): void

Dispose all event listeners, Object3D, cache

Returns

void

Overrides

AbstractReservoirGrid.dispose


getClassName

getClassName(): string

Returns

string

Inherited from

AbstractReservoirGrid.getClassName


getCurrentCellCount

getCurrentCellCount(): number

Get the current number of cells

Returns

number

cellcount


getGridResult

getGridResult(): GigaGridResult

Get grid overall information

Returns

GigaGridResult

Grid


getIJKFilter

getIJKFilter(): IJKFilter

Get IJK range filter

Returns

IJKFilter

filter


getLoadingProgress

getLoadingProgress(): number

Get loading progress percentage.

Returns

number

percentage


getOptions

getOptions(): Required<Options> & Omit<Options, "colorprovider" | "skeleton" | "cachelimit" | "highlightmode"> & { cachelimit: number ; colorprovider?: ColorProvider ; highlightmode: HighlightMode ; skeleton: { color: string ; linewidth: number } }

Get the ReservoirGrid options, returned as an object

Returns

Required<Options> & Omit<Options, "colorprovider" | "skeleton" | "cachelimit" | "highlightmode"> & { cachelimit: number ; colorprovider?: ColorProvider ; highlightmode: HighlightMode ; skeleton: { color: string ; linewidth: number } }

Overrides

AbstractReservoirGrid.getOptions


getPropertyFilter

getPropertyFilter(): PropertyFilter

Get property filter

Returns

PropertyFilter

filter


getPropertyKey

getPropertyKey(): PropertyKey

Get property key

Returns

PropertyKey

key


getSelectedIJKIndex

getSelectedIJKIndex(): IJKIndex

Get IJK info of selected cell
Needs to have highlighting enabled in Plot

Returns

IJKIndex

ijkindex


getTotalCellCount

getTotalCellCount(): number

Get total number of cells available in the gigagrid

Returns

number

total cells in the the grid


getVisible

getVisible(): boolean

Get visible

Returns

boolean

true, if object is visible

Inherited from

AbstractReservoirGrid.getVisible


invalidateObject

invalidateObject<T>(event?): ReservoirGrid

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

ReservoirGrid

Inherited from

AbstractReservoirGrid.invalidateObject


isDisposed

isDisposed(): boolean

Returns whether this object has been disposed

Returns

boolean

Inherited from

AbstractReservoirGrid.isDisposed


isSelectable

isSelectable(): boolean

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

Returns

boolean

Inherited from

AbstractReservoirGrid.isSelectable


notify

notify(type, source, args?): ReservoirGrid

Notify listeners

Parameters

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

Returns

ReservoirGrid

this

Inherited from

AbstractReservoirGrid.notify


off

off(type?, callback?): ReservoirGrid

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

ReservoirGrid

this

Inherited from

AbstractReservoirGrid.off

off<E>(type, callback): ReservoirGrid

Type parameters

NameType
Eextends string

Parameters

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

Returns

ReservoirGrid

Inherited from

AbstractReservoirGrid.off


on

on(type, callback, options?): ReservoirGrid

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

ReservoirGrid

this

Inherited from

AbstractReservoirGrid.on

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

Type parameters

NameType
Eextends string

Parameters

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

Returns

ReservoirGrid

Inherited from

AbstractReservoirGrid.on


onStatsUpdated

onStatsUpdated(metrics): ReservoirGrid

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

ReservoirGrid

Inherited from

AbstractReservoirGrid.onStatsUpdated


onVisibilityChanged

Protected onVisibilityChanged(): void

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

Returns

void

Inherited from

AbstractReservoirGrid.onVisibilityChanged


redraw

redraw(): void

Trigger the redraw of GigaGrid.
This method will be automatically called if options have changed

Returns

void


remove

remove(object): ReservoirGrid

Removes object as child of this object.

Parameters

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

Returns

ReservoirGrid

this

Inherited from

AbstractReservoirGrid.remove


removeHighlightShape

removeHighlightShape(): void

Remove the helper shape representing the selected cell from being displayed.

Returns

void

Overrides

AbstractReservoirGrid.removeHighlightShape


setOptions

setOptions(options?): ReservoirGrid

Set options, the given json will be merged with the object's state so that only the given options will be changes.

Parameters

Name Type Description
Optional optionsOptionsBaseThe options

Returns

ReservoirGrid

this

Overrides

AbstractReservoirGrid.setOptions


setPosition

setPosition(position): ReservoirGrid

Set Object's local position.

Parameters

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

Returns

ReservoirGrid

this

Inherited from

AbstractReservoirGrid.setPosition


setPropertyKey

setPropertyKey(propertyKey): void

Set colormap based on property key for gigagrid

Parameters

Name Type Description
propertyKeyPropertyKeykey

Returns

void


setRotation

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

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

Parameters

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

Returns

ReservoirGrid

this

Inherited from

AbstractReservoirGrid.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

AbstractReservoirGrid.setSelectable


setVisible

setVisible(visible, silent?): ReservoirGrid

Set visible

Parameters

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

Returns

ReservoirGrid

this

Inherited from

AbstractReservoirGrid.setVisible


updateObject

updateObject(scene, camera): ReservoirGrid

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

ReservoirGrid

Inherited from

AbstractReservoirGrid.updateObject


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

AbstractReservoirGrid.useOwnHighlight


getClassName

Static getClassName(): string

Returns

string

Inherited from

AbstractReservoirGrid.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

AbstractReservoirGrid.register