Options
All
  • Public
  • Public/Protected
  • All
Menu
summary

The SciChart3DSurface is the root 3D Chart control in SciChart's High Performance Real-time JavaScript 3D Chart Library

description

To create a 3D chart using SciChart, declare a SciChart3DSurface using SciChart3DSurface.create, add X,Y,Z axis via the SciChart3DSurface.xAxis SciChart3DSurface.yAxis and SciChart3DSurface.zAxis properties.

Next, add a series or chart type by adding a BaseRenderableSeries3D to the SciChart3DSurface.renderableSeries collection.

Position the camera in the 3D scene by adjusting the SciChart3DSurface.camera property.

To redraw a SciChart3DSurface at any time, call SciChart3DSurface.invalidateElement, however all properties are reactive and the chart will automatically redraw if data or properties change.

remarks

SciChartSurfaces scale to fit the parent DIV where they are hosted. Use CSS to position the DIV.

Hierarchy

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Properties

adornerLayer

adornerLayer: AdornerLayer

Protected animationList

animationList: IGenericAnimation[] = []

Readonly annotations

summary

Gets the collection of IAnnotation - annotations, markers or shapes drawn over the top of a SciChartSurface

description

A SciChartSurface can have zero to many Annotations.

The Annotations are drawn using our WebGL / WebAssembly rendering engine, but some use SVG for maximum configurability. See derived types of IAnnotation such as BoxAnnotation, LineAnnotation etc...

Use this collection to add and remove Annotations to the chart.

remarks

Adding an Annotation to the chart causes it to automatically redraw. Note that annotations do not pariticpate in autoranging, meaning a chart will zoom to fit data and chart series but not annotations

Readonly axisCubeEntity

axisCubeEntity: AxisCubeEntity

The AxisCubeEntity is a 3D Scene Entity (inherits BaseSceneEntity3D) which renders the 3D X,Y,Z axis cube, axis walls and labels in a SciChart3DSurface

Protected backgroundProperty

backgroundProperty: string

Readonly chartModifiers

An ObservableArray of IChartModifierBase derived types. Chart Modifiers provide behavior such as zooming, panning, tooltips, legends and more in SciChart's High Performance Realtime JavaScript Charts. You can use our built in modifiers (see derived types of ChartModifierBase, or create your own for custom interaction behavior.

Protected cleanupLockToken

cleanupLockToken: () => boolean

Type declaration

    • (): boolean
    • Returns boolean

Protected createSuspended

createSuspended: boolean

Protected deletables

deletables: IDeletable[] = []

Protected destinations

destinations: TSciChartDestination[]

Protected disableAspect

disableAspect: boolean

domBackgroundSvgContainer

domBackgroundSvgContainer: SVGSVGElement

The {@link SVGSVGElement} placed on the background and could be used instead of domSvgContainer

domCanvas2D

domCanvas2D: HTMLCanvasElement

domCanvasWebGL

domCanvasWebGL: HTMLCanvasElement

The {@link HTMLCanvasElement} which is the WebGL canvas that SciChart draws to

domChartRoot

domChartRoot: HTMLDivElement

domDivContainer

domDivContainer: HTMLDivElement

domSeriesBackground

domSeriesBackground: HTMLDivElement

The inner {@link HTMLDivElement} div element placed on the background

domSvgAdornerLayer

domSvgAdornerLayer: SVGSVGElement

The {@link SVGSVGElement} which is the SVG adorner layer canvas, is used for annotation adorners

domSvgContainer

domSvgContainer: SVGSVGElement

The {@link SVGSVGElement} which is the SVG canvas which SciChart adds elements (tooltips, annotations) to

genericAnimationsRun

genericAnimationsRun: EventHandler<any> = new EventHandler<any>()

An event handler which notifies its subscribers when animations stage in render process has finished.

hasInvalidState

hasInvalidState: boolean = false

Protected heightAspect

heightAspect: number

Protected idProperty

idProperty: string = generateGuid()

Protected isDeletedProperty

isDeletedProperty: boolean = false

Protected isInitializedProperty

isInitializedProperty: boolean = false

isWebGLContextActive

isWebGLContextActive: boolean = true

layoutMeasured

layoutMeasured: EventHandler<any> = new EventHandler<any>()

An event handler which notifies its subscribers when a layout stage in render process has finished.

Protected loaderJson

loaderJson: any

Readonly modifierAnnotations

modifierAnnotations: ObservableArray<IAnnotation>
summary

Gets the collection of IAnnotation - modifier annotations, markers or shapes drawn over the top of a SciChartSurface

description

A SciChartSurface can have zero to many Annotations.

The Annotations are drawn using our WebGL / WebAssembly rendering engine, but some use SVG for maximum configurability. See derived types of IAnnotation such as BoxAnnotation, LineAnnotation etc...

Use this collection to add and remove Modifier Annotations to the chart.

remarks

Adding an Modifier Annotation to the chart causes it to automatically redraw. Note that annotations do not pariticpate in autoranging, meaning a chart will zoom to fit data and chart series but not annotations

mouseManager

mouseManager: MouseManager

The MouseManager subscribes to mouse events on the domChartRoot and routes them to components within SciChart

onCreatedName

onCreatedName: string

For serialization Only. The name of the onCreated function applied by the builder api

Readonly painted

painted: EventHandler<any> = new EventHandler<any>()

An event handler which notifies its subscribers when a chart was visually painted a display canvas.

remarks

Not applicable to sub-charts

preRender

preRender: EventHandler<void> = new EventHandler<void>()

An event handler which notifies its subscribers when a render operation starts. Use this to update elements of the chart for the current render. Any updates made here will not trigger a subsequent render.

Protected previousThemeProviderProperty

previousThemeProviderProperty: IThemeProvider = SciChartSurfaceBase.DEFAULT_THEME

Readonly propertyChanged

A propertyChanged EventHandler. See EventHandler for how to subscribe to and be notified when a property changes on the SciChartSurfaceBase

redrawRequested

redrawRequested: EventHandler<boolean> = new EventHandler<boolean>()

An event handler which notifies its subscribers when a chart was requested to redraw initially.

Readonly renderError

renderError: EventHandler<any> = new EventHandler<any>()

Readonly renderableSeries

summary

Gets the collection of IRenderableSeries3D - the chart types or seres on this SciChart3DSurface

description

A SciChart3DSurface can have zero to many RenderableSeries.

The RenderableSeries are drawn as chart types, e.g. 3D Scatter series, Surface Mesh series. Each RenderableSeries must have a DataSeries.

Use this collection to add and remove series to the chart.

remarks

Adding a series to the chart causes it to automatically redraw. To zoom to fit the data after adding a series, either set AxisCore.autoRange or call {@link SciChart3DSurface.zoomExtents}

rendered

rendered: EventHandler<boolean> = new EventHandler<boolean>()

An event handler which notifies its subscribers when a render operation has finished. Use this to time render performance, or to update elements of the chart or your UI on redraw.

renderedToDestination

renderedToDestination: EventHandler<any> = new EventHandler<any>()

An event handler which notifies its subscribers when a chart was rendered to a display canvas.

remarks

Not applicable to sub-charts

renderedToWebGl

renderedToWebGl: EventHandler<any> = new EventHandler<any>()

An event handler which notifies its subscribers when a chart was rendered to WebgL Canvas.

remarks

Not applicable to sub-charts

Readonly resized

resized: EventHandler<Size> = new EventHandler<Size>()

rootEntity

rootEntity: RootSceneEntity
summary

The RootSceneEntity is a special BaseSceneEntity3D type which is the root of the entire scene in in SciChart's High Performance JavaScript 3D Charts

remarks

Add and remove entities to the scene using the property SciChart3DSurface.rootEntity and calling SceneEntity.children.add.

When a BaseRenderableSeries3D is added to SciChart3DSurface.renderableSeries, it's entity is automatically added to the scene.

showErrors

showErrors: boolean = true

Whether to show errors that occur during the render process. Defaults true.

Readonly suspender

suspender: UpdateSuspender = new UpdateSuspender()

Protected themeProviderProperty

themeProviderProperty: IThemeProvider = SciChartSurfaceBase.DEFAULT_THEME

Protected touchActionProperty

touchActionProperty: string

Protected visibilityObserver

visibilityObserver: VisibilityObserver

watermarkPosition

watermarkPosition: EWatermarkPosition = SciChartDefaults.watermarkPosition

The position of the watermark for trials and community licenses

Readonly webAssemblyContext3D

webAssemblyContext3D: TSciChart3D

The SciChart 3D WebAssembly Context containing native methods and access to our WebGL2 Engine and WebAssembly numerical methods

Protected widthAspect

widthAspect: number

Static AntiAliasWebGlBackbuffer

AntiAliasWebGlBackbuffer: boolean = false

Global property defining whether the WebGL render target is anti-aliased or not. This will affect all SciChartSurfaces (2D & 3D) in the application.

remarks

Defaults to FALSE for crisp gridlines and lines. Individual line series and text labels are chart parts are automatically anti-aliased

Static DEFAULT_THEME

DEFAULT_THEME: IThemeProvider = new SciChartJSDarkv2Theme()

Gets or sets the application-wide default theme. See IThemeProvider for details

Static autoDisposeWasmContext

autoDisposeWasmContext: boolean = false

Defines if the shared wasmContext (WebAssembly Context) should be deleted after all of the surfaces that use it are deleted.

Static domMasterCanvas

domMasterCanvas: HTMLCanvasElement

The master WebGL canvas

remarks

WARNING: Do not set this property, this is set internally by SciChart when initializing mutliple charts

Static invalidateOnTabVisible

invalidateOnTabVisible: boolean = true

Defines if charts should rerender when the tab becomes active.

remarks

Enabled by default. Purpose of this behavior is to deal with the issue of canvas data being cleared on an inactive tab .

Static wasmContextDisposeTimeout

wasmContextDisposeTimeout: number = 0

Defines a delay of the shared wasmContext auto-dispose if autoDisposeWasmContext is enabled.

Accessors

background

  • get background(): string
  • set background(background: string): void
  • Gets or sets the SciChartSurface Background as an HTML color code

    remarks

    Allowable values are colors e.g. 'Red', '#FF00FF', 'rgba(255,0,0,1)'. Also, main surface background supports gradients 'linear-gradient(45deg, rgb(255,0,0,1), rgb(0,0,255,1))', or background images e.g. 'url('https://somewebsite.com/someimage.png')'. Sub-charts, however, support only basic formats.

    Returns string

  • Gets or sets the SciChartSurface Background as an HTML color code

    remarks

    Allowable values are colors e.g. 'Red', '#FF00FF', 'rgba(255,0,0,1)'. Also, main surface background supports gradients 'linear-gradient(45deg, rgb(255,0,0,1), rgb(0,0,255,1))', or background images e.g. 'url('https://somewebsite.com/someimage.png')'. Sub-charts, however, support only basic formats.

    Parameters

    • background: string

      The HTML color code

    Returns void

camera

  • The ICameraController is a 3D Camera which allows choosing perspective, orthogonal projections, camera position, target, orientation such as Pitch, Yaw and Roll etc...

    remarks

    See CameraController for a concrete implementation of ICameraController

    Returns ICameraController

  • The ICameraController is a 3D Camera which allows choosing perspective, orthogonal projections, camera position, target, orientation such as Pitch, Yaw and Roll etc...

    remarks

    See CameraController for a concrete implementation of ICameraController

    Parameters

    Returns void

chartModifierGroups

  • get chartModifierGroups(): string[]
  • Gets Chart Modifier Groups, is used for sharing events between chart modifiers

    Returns string[]

chartViewRect

  • get chartViewRect(): Rect

clipRect

  • get clipRect(): Rect

enableGizmo

  • get enableGizmo(): boolean
  • set enableGizmo(isEnabled: boolean): void
  • Gets or sets whether the Xyz gizmo is enabled - a small 3D Xyz axis on the bottom left of the 3D Chart

    Returns boolean

  • Gets or sets whether the Xyz gizmo is enabled - a small 3D Xyz axis on the bottom left of the 3D Chart

    Parameters

    • isEnabled: boolean

    Returns void

freezeWhenOutOfView

  • get freezeWhenOutOfView(): boolean
  • set freezeWhenOutOfView(freezeWhenOutOfView: boolean): void
  • When true, charts that are out of the viewport will be frozen (pausing rendering). Data updates can resume Once the chart is in view again, rendering will resume. This can be useful for performance optimization.

    Returns boolean

  • When true, charts that are out of the viewport will be frozen (pausing rendering). Data updates can resume Once the chart is in view again, rendering will resume. This can be useful for performance optimization.

    Parameters

    • freezeWhenOutOfView: boolean

    Returns void

id

  • get id(): string
  • set id(value: string): void
  • Gets or sets the SciChartSurface Id

    Returns string

  • Gets or sets the SciChartSurface Id

    Parameters

    • value: string

    Returns void

isAxisCubeRendered

  • get isAxisCubeRendered(): boolean
  • Called internally Gets isAxisCubeRenderedProperty flag

    Returns boolean

isCopyCanvasSurface

  • get isCopyCanvasSurface(): HTMLCanvasElement

isDeleted

  • get isDeleted(): boolean
  • Used internally - gets isDeleted flag

    Returns boolean

isHitTestEnabled

  • get isHitTestEnabled(): boolean
  • set isHitTestEnabled(isEnabled: boolean): void
  • Required to enable Hit-Test if any of the following functions are needed in SciChart3DSurface:

    Enabling hit-test adds minor a performance overhead for drawing and should be disabled if not required.

    Returns boolean

  • Required to enable Hit-Test if any of the following functions are needed in SciChart3DSurface:

    Enabling hit-test adds minor a performance overhead for drawing and should be disabled if not required.

    Parameters

    • isEnabled: boolean

    Returns void

isInitialized

  • get isInitialized(): boolean

isInvalidated

  • get isInvalidated(): boolean

isPolar

  • get isPolar(): boolean

isRunningAnimation

  • get isRunningAnimation(): boolean
  • Returns true if an animation is running

    Returns boolean

isSuspended

  • get isSuspended(): boolean
  • Gets a value indicating whether updates for the target are currently suspended

    inheritdoc

    Returns boolean

isXYPlaneVisible

  • get isXYPlaneVisible(): boolean
  • set isXYPlaneVisible(value: boolean): void
  • deprecated.

    Use xyAxisPlane.isVisible

    Returns boolean

  • deprecated.

    Use xyAxisPlane.isVisible

    Parameters

    • value: boolean

    Returns void

isZXPlaneVisible

  • get isZXPlaneVisible(): boolean
  • set isZXPlaneVisible(value: boolean): void
  • deprecated.

    Use zxAxisPlane.isVisible

    Returns boolean

  • deprecated.

    Use zxAxisPlane.isVisible

    Parameters

    • value: boolean

    Returns void

isZYPlaneVisible

  • get isZYPlaneVisible(): boolean
  • set isZYPlaneVisible(value: boolean): void
  • deprecated.

    Use zyAxisPlane.isVisible

    Returns boolean

  • deprecated.

    Use zyAxisPlane.isVisible

    Parameters

    • value: boolean

    Returns void

otherSurfaces

preRenderAll

  • An event handler which notifies its subscribers when a render operation starts. Use this to update elements of the chart for the current render. Any updates made here will not trigger a subsequent render.

    remarks

    this is an alias for preRender.

    Returns EventHandler<void>

previousThemeProvider

seriesViewRect

  • get seriesViewRect(): Rect

surfaceType

themeProvider

viewRect

  • get viewRect(): Rect

viewportManager

  • Gets or sets the Viewport Manager - a class that allows managing of viewport axis ranges

    Returns ViewportManager3DBase

  • Gets or sets the Viewport Manager - a class that allows managing of viewport axis ranges

    Parameters

    Returns void

worldDimensions

  • get worldDimensions(): Vector3
  • set worldDimensions(worldDimensions: Vector3): void
  • The WorldDimensions defines the size of the world in 3D space. Series and objects can exist outside of this world however the Axis cube will conform to this size.

    remarks

    See our Documentation online to see how the World Dimensions property configures the size of the chart.

    Returns Vector3

  • The WorldDimensions defines the size of the world in 3D space. Series and objects can exist outside of this world however the Axis cube will conform to this size.

    remarks

    See our Documentation online to see how the World Dimensions property configures the size of the chart.

    Parameters

    Returns void

xAxis

  • Gets or sets the XAxis in the 3D Chart.

    remarks

    Axis types which derive from AxisBase3D or concrete type NumericAxis3D are valid

    Returns AxisBase3D

  • Gets or sets the XAxis in the 3D Chart.

    remarks

    Axis types which derive from AxisBase3D or concrete type NumericAxis3D are valid

    Parameters

    Returns void

xyAxisPlane

  • Settings for the XY Axis Plane

    Returns IAxisPlane

yAxis

  • Gets or sets the YAxis in the 3D Chart.

    remarks

    Axis types which derive from AxisBase3D or concrete type NumericAxis3D are valid

    Returns AxisBase3D

  • Gets or sets the YAxis in the 3D Chart.

    remarks

    Axis types which derive from AxisBase3D or concrete type NumericAxis3D are valid

    Parameters

    Returns void

zAxis

  • Gets or sets the ZAxis in the 3D Chart.

    remarks

    Axis types which derive from AxisBase3D or concrete type NumericAxis3D are valid

    Returns AxisBase3D

  • Gets or sets the ZAxis in the 3D Chart.

    remarks

    Axis types which derive from AxisBase3D or concrete type NumericAxis3D are valid

    Parameters

    Returns void

zxAxisPlane

  • Settings for the ZX Axis Plane

    Returns IAxisPlane

zyAxisPlane

  • Settings for the ZY Axis Plane

    Returns IAxisPlane

Methods

addAnimation

  • Add a GenericAnimation to the surface. Multiple animations will be run in parallel, so if you want to run one after another, use the onCompleted callback to add another animation after the first completes

    Parameters

    Returns void

addDeletable

Protected applyOptions

Protected applySciChartBackground

  • applySciChartBackground(background: string): void
  • inheritdoc

    Parameters

    • background: string

    Returns void

applyTheme

Protected attachChartModifier

Protected changeMasterCanvasViewportSize

  • changeMasterCanvasViewportSize(wasmContext: TSciChart | TSciChart3D, pixelWidth: number, pixelHeight: number): void

changeViewportSize

  • changeViewportSize(pixelWidth: number, pixelHeight: number): void

Protected changeWebGLCanvasViewportSize

  • changeWebGLCanvasViewportSize(wasmContext: TSciChart | TSciChart3D, pixelWidth: number, pixelHeight: number): void

Protected clearRootElement

  • clearRootElement(clearHtml: boolean): void

delete

  • delete(clearHtml?: boolean): void
  • Deletes native (WebAssembly) memory used by this type, after which it cannot be used.

    Parameters

    • Default value clearHtml: boolean = true

    Returns void

Protected detachChartModifier

doDrawingLoop

  • doDrawingLoop(): void
  • Called internally - the main drawing loop

    Returns void

getAnimations

  • Gets the generic animations currently on the surface. Do not manipulate this array directly. To add, use addAnimation. To remove, find an animation and call .cancel() on it.

    Returns ReadonlyArray<IGenericAnimation>

getDefaultXAxis

getDefaultYAxis

getLicenseContext

  • getLicenseContext(): { SCRTCredentials: { ApplyLicenseResponse: (response: string) => number; Dump: () => string; GetAllowDebugging: () => boolean; GetDeveloperCount: () => number; GetEncryptedOrderId: () => string; GetLicenseChallenge: () => string; GetLicenseDaysRemaining: () => number; GetLicenseErrors: () => string; GetLicenseType: () => SCRTLicenseType; GetOrderId: () => string; GetProductCode: () => string; HasFeature: (feature: string) => SCRTLicenseType; RequiresValidation: () => boolean; ResetRuntimeLicense: () => void; SetRuntimeLicenseKeyW: (licenseKey: string) => void }; SCRTLicenseType: { LICENSE_TYPE_COMMUNITY: SCRTLicenseType; LICENSE_TYPE_FULL: SCRTLicenseType; LICENSE_TYPE_FULL_EXPIRED: SCRTLicenseType; LICENSE_TYPE_INVALID_DEVELOPER_LICENSE: SCRTLicenseType; LICENSE_TYPE_INVALID_LICENSE: SCRTLicenseType; LICENSE_TYPE_NO_LICENSE: SCRTLicenseType; LICENSE_TYPE_REQUIRES_VALIDATION: SCRTLicenseType; LICENSE_TYPE_SUBSCRIPTION_EXPIRED: SCRTLicenseType; LICENSE_TYPE_TRIAL: SCRTLicenseType; LICENSE_TYPE_TRIAL_EXPIRED: SCRTLicenseType } }
  • Returns { SCRTCredentials: { ApplyLicenseResponse: (response: string) => number; Dump: () => string; GetAllowDebugging: () => boolean; GetDeveloperCount: () => number; GetEncryptedOrderId: () => string; GetLicenseChallenge: () => string; GetLicenseDaysRemaining: () => number; GetLicenseErrors: () => string; GetLicenseType: () => SCRTLicenseType; GetOrderId: () => string; GetProductCode: () => string; HasFeature: (feature: string) => SCRTLicenseType; RequiresValidation: () => boolean; ResetRuntimeLicense: () => void; SetRuntimeLicenseKeyW: (licenseKey: string) => void }; SCRTLicenseType: { LICENSE_TYPE_COMMUNITY: SCRTLicenseType; LICENSE_TYPE_FULL: SCRTLicenseType; LICENSE_TYPE_FULL_EXPIRED: SCRTLicenseType; LICENSE_TYPE_INVALID_DEVELOPER_LICENSE: SCRTLicenseType; LICENSE_TYPE_INVALID_LICENSE: SCRTLicenseType; LICENSE_TYPE_NO_LICENSE: SCRTLicenseType; LICENSE_TYPE_REQUIRES_VALIDATION: SCRTLicenseType; LICENSE_TYPE_SUBSCRIPTION_EXPIRED: SCRTLicenseType; LICENSE_TYPE_TRIAL: SCRTLicenseType; LICENSE_TYPE_TRIAL_EXPIRED: SCRTLicenseType } }

    • SCRTCredentials: { ApplyLicenseResponse: (response: string) => number; Dump: () => string; GetAllowDebugging: () => boolean; GetDeveloperCount: () => number; GetEncryptedOrderId: () => string; GetLicenseChallenge: () => string; GetLicenseDaysRemaining: () => number; GetLicenseErrors: () => string; GetLicenseType: () => SCRTLicenseType; GetOrderId: () => string; GetProductCode: () => string; HasFeature: (feature: string) => SCRTLicenseType; RequiresValidation: () => boolean; ResetRuntimeLicense: () => void; SetRuntimeLicenseKeyW: (licenseKey: string) => void }
      • ApplyLicenseResponse: (response: string) => number
          • (response: string): number
          • Parameters

            • response: string

            Returns number

      • Dump: () => string
          • (): string
          • Returns string

      • GetAllowDebugging: () => boolean
          • (): boolean
          • Returns boolean

      • GetDeveloperCount: () => number
          • (): number
          • Returns number

      • GetEncryptedOrderId: () => string
          • (): string
          • Returns string

      • GetLicenseChallenge: () => string
          • (): string
          • Returns string

      • GetLicenseDaysRemaining: () => number
          • (): number
          • Returns number

      • GetLicenseErrors: () => string
          • (): string
          • Returns string

      • GetLicenseType: () => SCRTLicenseType
          • (): SCRTLicenseType
          • Returns SCRTLicenseType

      • GetOrderId: () => string
          • (): string
          • Returns string

      • GetProductCode: () => string
          • (): string
          • Returns string

      • HasFeature: (feature: string) => SCRTLicenseType
          • (feature: string): SCRTLicenseType
          • Parameters

            • feature: string

            Returns SCRTLicenseType

      • RequiresValidation: () => boolean
          • (): boolean
          • Returns boolean

      • ResetRuntimeLicense: () => void
          • (): void
          • Returns void

      • SetRuntimeLicenseKeyW: (licenseKey: string) => void
          • (licenseKey: string): void
          • Parameters

            • licenseKey: string

            Returns void

    • SCRTLicenseType: { LICENSE_TYPE_COMMUNITY: SCRTLicenseType; LICENSE_TYPE_FULL: SCRTLicenseType; LICENSE_TYPE_FULL_EXPIRED: SCRTLicenseType; LICENSE_TYPE_INVALID_DEVELOPER_LICENSE: SCRTLicenseType; LICENSE_TYPE_INVALID_LICENSE: SCRTLicenseType; LICENSE_TYPE_NO_LICENSE: SCRTLicenseType; LICENSE_TYPE_REQUIRES_VALIDATION: SCRTLicenseType; LICENSE_TYPE_SUBSCRIPTION_EXPIRED: SCRTLicenseType; LICENSE_TYPE_TRIAL: SCRTLicenseType; LICENSE_TYPE_TRIAL_EXPIRED: SCRTLicenseType }
      • LICENSE_TYPE_COMMUNITY: SCRTLicenseType
      • LICENSE_TYPE_FULL: SCRTLicenseType
      • LICENSE_TYPE_FULL_EXPIRED: SCRTLicenseType
      • LICENSE_TYPE_INVALID_DEVELOPER_LICENSE: SCRTLicenseType
      • LICENSE_TYPE_INVALID_LICENSE: SCRTLicenseType
      • LICENSE_TYPE_NO_LICENSE: SCRTLicenseType
      • LICENSE_TYPE_REQUIRES_VALIDATION: SCRTLicenseType
      • LICENSE_TYPE_SUBSCRIPTION_EXPIRED: SCRTLicenseType
      • LICENSE_TYPE_TRIAL: SCRTLicenseType
      • LICENSE_TYPE_TRIAL_EXPIRED: SCRTLicenseType

getMainCanvas

  • getMainCanvas(): HTMLCanvasElement

getNextState

  • Triggers the rerendering of the surface and after the chart rerendering is completed, returns its serialized state retrieved with SciChartSurface.toJSON.

    Parameters

    • Default value excludeData: boolean = false

      if set true, data values will not be included in the json.

    Returns Promise<{ type: Default3D } & ISciChart3DDefinition>

    JSON-like object ISciChart3DDefinition

Protected getOptions

  • getOptions(): {}
  • Returns {}

Protected getOtherSurfaces

getSceneWorld

  • getSceneWorld(): SCRTSceneWorld
  • Used internally: Gets the {@link SCRTSceneWorld} object at the root of the 3d scene graph

    Returns SCRTSceneWorld

getSeriesViewRectPadding

  • getSeriesViewRectPadding(scaled: boolean): Thickness

getXAxisById

  • getXAxisById(axisId: string): AxisBase3D | undefined

getYAxisById

  • getYAxisById(axisId: string): AxisBase3D | undefined

invalidateElement

  • invalidateElement(options?: { force?: boolean }): void
  • inheritdoc

    Parameters

    • Optional options: { force?: boolean }
      • Optional force?: boolean

    Returns void

nextStateRender

  • nextStateRender(options?: { invalidateOnResume?: boolean; resumeBefore?: boolean; suspendAfter?: boolean }): Promise<void>
  • Creates a promise which resolves when the chart is updated to the next fully rendered state

    remarks

    If the surface is initialized with createSingle the promise resolves after the main render function is executed. Otherwise, if it is initialized with create - the promise resolves after image data is copied to the 2D canvas.

    Parameters

    • Optional options: { invalidateOnResume?: boolean; resumeBefore?: boolean; suspendAfter?: boolean }
      • Optional invalidateOnResume?: boolean
      • Optional resumeBefore?: boolean
      • Optional suspendAfter?: boolean

    Returns Promise<void>

Protected notifyPropertyChanged

  • notifyPropertyChanged(propertyName: string): void

onAnimate

  • onAnimate(timeElapsed: number): void
  • Is being called on each render, to run animations

    Parameters

    • timeElapsed: number

    Returns void

onDpiChanged

onResize

  • onResize(width: number, height: number): void

onSciChartRendered

  • onSciChartRendered(): void
  • Called after the SciChart3DSurface has rendered.

    Returns void

registerFont

  • registerFont(fontName: string, url: string): Promise<boolean>
  • Parameters

    • fontName: string

      Register a font to be used with native text.

    • url: string

    Returns Promise<boolean>

resumeUpdates

  • resumeUpdates(options?: { force?: boolean; invalidateOnResume?: boolean }): void
  • inheritdoc

    Parameters

    • Optional options: { force?: boolean; invalidateOnResume?: boolean }
      • Optional force?: boolean
      • Optional invalidateOnResume?: boolean

    Returns void

setDestinations

setIsAxisCubeRendered

  • setIsAxisCubeRendered(): void
  • Called internally Sets isAxisCubeRenderedProperty flag after Axis Cube is rendered

    Returns void

setIsInitialized

  • setIsInitialized(): void

setSeriesViewRect

  • setSeriesViewRect(seriesViewRect: Rect): void

setSvgClipPathDefinitions

  • setSvgClipPathDefinitions(svgElement: SVGSVGElement, seriesViewRect: Rect, surfaceViewRect: Rect): void
  • Adds or updates clipPath definitions on an SVG canvas

    Parameters

    • svgElement: SVGSVGElement
    • seriesViewRect: Rect
    • surfaceViewRect: Rect

    Returns void

suspendUpdates

  • suspendUpdates(): void

toJSON

  • Convert the object to a definition that can be serialized to JSON, or used directly with the builder api

    Parameters

    • Default value excludeData: boolean = false

      if set true, data values will not be included in the json.

    Returns { type: Default3D } & ISciChart3DDefinition

updateBackground

  • updateBackground(): void
  • Returns void

updateClipPlanes

  • updateClipPlanes(): void
  • Updates Clip Planes to do clipping

    Returns void

updateWatermark

  • updateWatermark(left: number, bottom: number): void

worldToScreenCoord

  • Converts a 3D Xyz coordinate in world coordinates space to a screen coordinate (2d) in pixels. This allows you to get the 2D screen coordinate of any object or vertex in the 3D scene.

    remarks

    Note: Conversions to/from world/data space must be performed using the {@link AxisBase3D.getCurrentCoordinateCalculator()} API, which returns CoordinateCalculatorBase. Functions CoordinateCalculatorBase.getDataValue and CoordinateCalculatorBase.getCoordinate convert to/from world coords/data space

    Parameters

    • worldCoordXyz: Vector3

      The 3D Xyz coordinate

    Returns Point

    The 2D screen coordinate in pixels

Static UseCommunityLicense

  • UseCommunityLicense(): void

Static configure

  • Allows setting of web URL for Wasm files, in the case you are loading SciChart outside of npm/webpack environment. Note if loading from CDN the version number of wasm Url must match the version number of SciChart.js you are using.

    example
    // 3D Charts
    SciChart.SciChart3DSurface.configure({
     wasmUrl: "https://cdn.jsdelivr.net/npm/scichart@2.2.2378/_wasm/scichart3d.wasm"
    });

    Parameters

    Returns void

Static create

Static createSingle

Static disposeSharedWasmContext

  • disposeSharedWasmContext(): void

Static loadWasmFromCDN

  • loadWasmFromCDN(): void
  • Tell SciChart to load the Wasm files from CDN, rather than expecting them to be served by the host server.

    Returns void

Static loadWasmLocal

  • loadWasmLocal(): void
  • Tell SciChart to load the Wasm files from the local server, rather than from CDN.

    Returns void

Static resolveOptions

Static setLicenseCallback

  • setLicenseCallback(callback: (queryString: string) => Promise<Response>): void
  • Sets function that will be called by the framework to validate a runtime license from the server, if you need to add additional handling, such as custom authentication. The request sent to the server must include the queryString section passed in, which does not come with a leading ?

    Parameters

    • callback: (queryString: string) => Promise<Response>
        • (queryString: string): Promise<Response>
        • Parameters

          • queryString: string

          Returns Promise<Response>

    Returns void

Static setRuntimeLicenseKey

  • setRuntimeLicenseKey(keyCode: string): void
  • Sets the runtime license key. Use for full licenses or trials only, not developer licenses.

    Parameters

    • keyCode: string

    Returns void

Static setServerLicenseEndpoint

  • setServerLicenseEndpoint(endpoint: string): void
  • Sets the endpoint for validating a runtime license key with the server. Must be a relative path.

    default

    api/license

    Parameters

    • endpoint: string

    Returns void

Static useWasmFromCDN

  • useWasmFromCDN(): void
  • Tell SciChart to load the Wasm files from CDN, rather than expecting them to be served by the host server.

    deprecated

    the method name breaks eslint react-hooks/rules-of-hooks. To avoid this error in React, use loadWasmFromCDN instead.

    Returns void

Generated using TypeDoc