Class HTMLViewportMPR

Extends the HTMLViewport3D class with specific routines to faciliate easier display and navigation of MPR views

Hierarchy

  • HTMLViewport3D
    • HTMLViewportMPR

Index

Constructors

Properties

Methods

Constructors

constructor

  • new HTMLViewportMPR(htmlElementName: string, width: number, height: number, repaintable?: boolean, usePNG?: boolean, renderEngineLocation?: RenderLocation): HTMLViewportMPR

  • Parameters

    • htmlElementName: string
    • width: number
    • height: number
    • Default value repaintable: boolean = false
    • Default value usePNG: boolean = false
    • Default value renderEngineLocation: RenderLocation = Fovia.RenderLocation.Server

    Returns HTMLViewportMPR

Properties

botLeftCorner

botLeftCorner: Vector = new Fovia.Util.Vector(0, 0, 0)

botRightCorner

botRightCorner: Vector = new Fovia.Util.Vector(0, 0, 0)

Protected displayPatientOrientationMarkersInViewport

displayPatientOrientationMarkersInViewport: boolean = false

Protected drawListenerList

drawListenerList: any[] = new Array()

Protected height

height: number

Protected htmlElement

htmlElement: any

Protected htmlElementName

htmlElementName: string

Protected htmlViewportAdaptors

htmlViewportAdaptors: HTMLViewportAdaptors = null

Protected htmlViewportGroup

htmlViewportGroup: HTMLViewportGroup = null

Protected modifiedOrientation

modifiedOrientation: string

Protected observer

observer: ObserverInterface = null

offsetX

offsetX: number = 0

offsetY

offsetY: number = 0

Protected onDrawCallback

onDrawCallback: any = null

Protected renderEngine

renderEngine: any

Protected renderEngineClient

renderEngineClient: RenderEngineContext3D = null

Protected renderEngineLocation

renderEngineLocation: RenderLocation = Fovia.RenderLocation.Server

Protected renderEngineServer

renderEngineServer: RenderEngineContext3D = null

Protected renderImageRescale

renderImageRescale: boolean = false

Protected renderedOnServer

renderedOnServer: boolean = false

Protected repaintData

repaintData: any

Protected repaintHeight

repaintHeight: any

Protected repaintImageBuffer

repaintImageBuffer: any = null

Protected repaintImageType

repaintImageType: any

Protected repaintUsePNG

repaintUsePNG: any

Protected repaintWidth

repaintWidth: any

Protected repaintableViewport

repaintableViewport: boolean = false

scrollData

scrollData: ScrollAdaptorData = null

scrollDataAxial

scrollDataAxial: ScrollAdaptorDataAxial = null

scrollDataCoronal

scrollDataCoronal: ScrollAdaptorDataCoronal = null

scrollDataSagittal

scrollDataSagittal: ScrollAdaptorDataSagittal = null

Protected seriesDataContext

seriesDataContext: SeriesDataContext

Protected showDICOMOverlay

showDICOMOverlay: boolean = false

Protected showLocalizerLines

showLocalizerLines: boolean = false

Protected showRuler

showRuler: boolean = false

topLeftCorner

topLeftCorner: Vector = new Fovia.Util.Vector(0, 0, 0)

topRightCorner

topRightCorner: Vector = new Fovia.Util.Vector(0, 0, 0)

Protected url

url: string

Protected vdc

vdc: VolumeDataContext

Protected viewType

viewType: ViewType = null

Protected width

width: number

wlData

wlData: WindowLevelData = null

Static g_ForceRecalculationOfWindowOffsetForAngular

g_ForceRecalculationOfWindowOffsetForAngular: any = undefined

Methods

GetPixelsPerMillimeter

  • GetPixelsPerMillimeter(spacingX: any, zoom: any): number

GetZoomForPixelsPerMillimeter

  • GetZoomForPixelsPerMillimeter(spacingX: any, pixelsPerMilli: any): number

addDrawListener

  • addDrawListener(drawListener: any): void
  • description

    Add the given event listener into event listener list

    Parameters

    • drawListener: any

      Specifies the event listener

    Returns void

Protected applyDrawImage

  • applyDrawImage(context: any, image: any, width: any, height: any, imageData?: any): void

  • Parameters

    • context: any
    • image: any
    • width: any
    • height: any
    • Default value imageData: any = null

    Returns void

changeHTMLCanvasID

  • changeHTMLCanvasID(newHTMLElement: any): void
  • description

    Change the viewport html element's canvasid from the given Html element

    Parameters

    • newHTMLElement: any

      Specifies the reference to HtmlElement

    Returns void

computeSliceNumber

  • computeSliceNumber(rp: any): void

  • Parameters

    • rp: any

    Returns void

Protected createRenderEngine

  • createRenderEngine(volumeDataInfo: VolumeDataContext, renderEngineType?: RenderType, renderEngineLocation?: RenderLocation): Promise<Object>
  • description

    Create render engine instance for this viewport

    Parameters

    • volumeDataInfo: VolumeDataContext

      VolumeDataContext instance used to rendering purpose

    • Default value renderEngineType: RenderType = Fovia.RenderType.parallel

      render engine type

    • Default value renderEngineLocation: RenderLocation = Fovia.RenderLocation.Server

    Returns Promise<Object>

    This is an asynchronous method that returns a Promise as follows:

    Promise .then(void) .catch (err: ReturnCode )

Protected createRenderEngine4D

  • createRenderEngine4D(volDataArray: Array<VolumeDataContext>, renderEngineType?: RenderType): Promise<Object>
  • description

    Create render engine instance for this viewport

    Parameters

    • volDataArray: Array<VolumeDataContext>
    • Default value renderEngineType: RenderType = Fovia.RenderType.parallel

      render engine type

    Returns Promise<Object>

    This is an asynchronous method that returns a Promise as follows:

    Promise .then(void) .catch (err: ReturnCode )

disableRightClickMenu

  • disableRightClickMenu(disableMenu?: boolean): void
  • description

    toggle the right-click popup menu

    Parameters

    • Default value disableMenu: boolean = true

      Specifies the boolean flag to toggle

    Returns void

displayAnnotations

  • displayAnnotations(showAnnotation: boolean): void
  • description

    base class signature that allows subclass to toggle its annotations on/off

    Parameters

    • showAnnotation: boolean

      true if annotations are to be displayed, false otherwise

    Returns void

displayDICOMOverlay

  • displayDICOMOverlay(showDICOMOverlay?: boolean): void
  • description

    Display or hide the overlay based on the given flag

    Parameters

    • Default value showDICOMOverlay: boolean = true

      Specifies the toggle boolean flag

    Returns void

displayFPS

  • displayFPS(showFPS: boolean): void
  • description

    Display the FPS text in the viewport

    Parameters

    • showFPS: boolean

      Set to true to display frames per seoond in the viewport, false to hide it

    Returns void

displayLocalizerLines

  • displayLocalizerLines(showLocalizerLines?: boolean): void
  • description

    Display or hide the localizer lines based on the given flag

    Parameters

    • Default value showLocalizerLines: boolean = true

      Specifies the toggle boolean flag

    Returns void

displayPatientOrientationMarkers

  • displayPatientOrientationMarkers(showMarkers?: boolean): void
  • description

    Display the image position markers (A/P/S/I/L/R) in the viewport

    Parameters

    • Default value showMarkers: boolean = true

      to true to display image markers in the viewport, false to hide it

    Returns void

displayRuler

  • displayRuler(showRuler?: boolean): void
  • description

    Display or hide the ruler based on the given flag

    Parameters

    • Default value showRuler: boolean = true

      Specifies the toggle boolean flag

    Returns void

Protected doubleBufferInit

  • doubleBufferInit(): void

Protected doubleBufferPaint

  • doubleBufferPaint(bytes: any, width: any, height: any, imageType: any, usePNG: any, data: any): void
  • description

    Render the dicom image on the viewport form the given arguments

    Parameters

    • bytes: any

      Specifies the image data

    • width: any

      Specifies the image width

    • height: any

      Specifies the image height

    • imageType: any

      Specifies the image type

    • usePNG: any

      boolean flag that specifies whether the image to be render as png or not

    • data: any

      Specifies Dicom image data

    Returns void

Protected drawClientData

  • drawClientData(context: any, image: any, width: number, height: number, data: any): void
  • description

    render the given dicom image data on view port

    Parameters

    • context: any

      context used to render

    • image: any

      dicom image to be rendered

    • width: number

      width of the image

    • height: number

      height of the image

    • data: any

      dicom tag data

    Returns void

Protected drawDICOMOverlay

  • drawDICOMOverlay(context: any, width: any, height: any, sdc: any, rp: RenderParams3D, imageTags: any): void

  • Parameters

    • context: any
    • width: any
    • height: any
    • sdc: any
    • rp: RenderParams3D
    • imageTags: any

    Returns void

Protected drawRuler

  • drawRuler(context: any, data: any): void
  • description

    draw the ruler on the canvas from the given data

    Parameters

    • context: any

      context fetched from canvas

    • data: any

      data to be rendered on ruler

    Returns void

getCachedRenderParams

  • getCachedRenderParams(): RenderParams3D

Protected getFPS

  • getFPS(): number
  • description

    get FPS value for current frame but do not update lastimageprocessed

    Returns number

getHTMLElement

  • getHTMLElement(): any
  • description

    Gets the Html element

    Returns any

    HTML element associated with this viewport

getHTMLViewportGroup

  • getHTMLViewportGroup(): HTMLViewportGroup

getHeight

  • getHeight(): number

getHtmlElementName

  • getHtmlElementName(): string
  • description

    Get the html element name of the viewport

    Returns string

    Returns Html element name in success case

getHtmlViewportAdaptors

  • getHtmlViewportAdaptors(): HTMLViewportAdaptors
  • description

    Get the HtmlViewportAdaptors associated with this ViewPort

    Returns HTMLViewportAdaptors

    Returns the HtmlViewportAdaptors

getRenderEngine

  • getRenderEngine(): RenderEngineContext3D

getRenderImageRescale

  • getRenderImageRescale(): boolean
  • description

    Gets state of option to automaticly scale render image to fit viewport.

    Returns boolean

    Returns true if viewport scaling is on, false otherwise.

getRenderLocation

  • getRenderLocation(): RenderLocation

getRepaintImageBuffer

  • getRepaintImageBuffer(): any

getSeriesDataContext

  • getSeriesDataContext(): SeriesDataContext

getWidth

  • getWidth(): number

hasMatchingSeriesDataContext

  • hasMatchingSeriesDataContext(seriesInstaceUID: string): boolean

  • Returns true if the series data context is valid and matching with the given series instance uid

    Parameters

    • seriesInstaceUID: string

    Returns boolean

hasSeriesDataContext

  • hasSeriesDataContext(): boolean

init

  • init(renderEngine: RenderEngineContext3D, renderEngineType: RenderType, orientation: ViewType, thickness: any, onDrawCallback?: any, imageMetaDataReceived?: any, callbackFunc?: any): any
  • init(volumeDataInfo: VolumeDataContext, renderEngineType: RenderType, orientation: ViewType, thickness: any, onDrawCallback?: any, imageMetaDataReceived?: any, callbackFunc?: any): any
  • init(volDataArray: Array<VolumeDataContext>, renderEngineType?: RenderType, onDrawCallback?: any, imageMetaDataReceived?: any, callbackFunc?: any): any

  • Parameters

    • renderEngine: RenderEngineContext3D
    • renderEngineType: RenderType
    • orientation: ViewType
    • thickness: any
    • Optional onDrawCallback: any
    • Optional imageMetaDataReceived: any
    • Optional callbackFunc: any

    Returns any

  • Parameters

    • volumeDataInfo: VolumeDataContext
    • renderEngineType: RenderType
    • orientation: ViewType
    • thickness: any
    • Optional onDrawCallback: any
    • Optional imageMetaDataReceived: any
    • Optional callbackFunc: any

    Returns any

  • Parameters

    • volDataArray: Array<VolumeDataContext>
    • Optional renderEngineType: RenderType
    • Optional onDrawCallback: any
    • Optional imageMetaDataReceived: any
    • Optional callbackFunc: any

    Returns any

initOverrideMouseAdaptor

  • initOverrideMouseAdaptor(overrideMouseAdaptor: MouseAdaptorInterface, mouseButton?: MouseButton, modifier?: KeyboardModifier, character: any): void
  • description

    Set the override MouseAdaptor into HtmlViewPortAdaptors

    Parameters

    • overrideMouseAdaptor: MouseAdaptorInterface
    • Default value mouseButton: MouseButton = MouseButton.none

      Specifies the Mouse button to invoke this adapter

    • Default value modifier: KeyboardModifier = KeyboardModifier.none

      Specifies the Key modifier to invoke this Adapter

    • character: any

    Returns void

Protected invokeObserver

  • invokeObserver(data: any): void

isRenderEngineClientAvailable

  • isRenderEngineClientAvailable(): boolean

isRenderEngineLocationClient

  • isRenderEngineLocationClient(): boolean

isRenderEngineLocationServer

  • isRenderEngineLocationServer(): boolean

isRenderEngineServerAvailable

  • isRenderEngineServerAvailable(): boolean

isRepaintable

  • isRepaintable(): boolean
  • description

    Get the Flag whether the viewport is repaint able or not

    Returns boolean

    Returns the repaint able flag

Protected paint

  • paint(bytes: any, width: any, height: any, imageType: any, usePNG: any, data: any): void
  • description

    paints the dicom image and overlay

    Parameters

    • bytes: any

      raw image

    • width: any

      width of the viewport

    • height: any

      height of the viewport

    • imageType: any

      image type

    • usePNG: any

      Specifies the boolean flag whether image rendered as png or not

    • data: any

      dicom image

    Returns void

Protected processImageFromServer

  • processImageFromServer(data: any): void
  • description

    processImageFromServer is called when image is ready to be rendered for a render engine. If data.image is null, there was an error, in which case we reset the mouse/touch state.
    At this point, there is no knowledge of the canvasID (either in our code, or external), so the mapping between the renderEngineID (data.name) is used to find the correct object, and then its render() method will be called. render the supplied bytes to the HTML element using paint(), and then update the internal state varaibles. If the mouse adaptor has a postRender step, such as during flythrough, invoke its postRender() method after the rendering is complete so the next frames can be requested.
    The renderImageData() method is extended in the subclass HTMLViewport3D to create a duplicate copy of the rendered image from the server, so it is possible to update the viewport without forcing a native renderImageData() if the render parameters have not changed.
    TODO: extend this to support postRender for the touch flythrough

    Parameters

    • data: any

      data to be processed

    Returns void

projectPoint

  • projectPoint(vectorList: Array<Vector>, callbackFunc?: any): any

  • Projects the specific array of vectors into the scene and returns a correpsonding array of points.

    Parameters

    • vectorList: Array<Vector>
    • Optional callbackFunc: any

    Returns any

    This is an asynchronous method that returns a Promise as follows:

    Promise .then(pointList : Array< Point >) .catch (err: ReturnCode )

    callbackFunc(err: ReturnCode , pointList Point : Array< Point> )

reAlignViewport

  • reAlignViewport(current3DCursor: Vector, optionalRender?: RenderRequest, callbackFunc?: any): Promise<Object>
  • description

    realign the viewport based on the given 3d cursor location

    Parameters

    • current3DCursor: Vector

      3d cursor location

      This will realign the viewport with the associated 3DCursor location

    • Default value optionalRender: RenderRequest = Fovia.RenderRequest.render
    • Optional callbackFunc: any

    Returns Promise<Object>

releaseSessionResources

  • releaseSessionResources(callbackFunc?: any): Promise<__type>

removeAllDrawListener

  • removeAllDrawListener(): void

removeDrawListener

  • removeDrawListener(drawListener: any): void
  • description

    Remove the given event listener from the event listener list

    Parameters

    • drawListener: any

      Specifies the event listener

    Returns void

removeMouseAdaptors

  • removeMouseAdaptors(): void

render

  • render(): any
  • description

    Triggers an asynchronous intermedate render operation, and generate a JPEG image using the interactive quality setting.

    Returns any

    This is a synchronous method and returns ReturnCode.ok on success.

renderFinal

  • renderFinal(): any
  • description

    Triggers an asynchronous final render operation and generates either a JPEG image using the final quality setting, or a lossless compressed PNG file. This operation is much more costly than a render() and should not be done inside a mouseDrag loop, only done when the user finishes the operation, such as a mouseUp. The initial display should use a renderFinal to ensure the highest quality result is displayed.

    Returns any

    This is a synchronous method and returns ReturnCode.ok on success.

renderNoCachedImages

  • renderNoCachedImages(data: any): void
  • description

    "Image is not yet cached." label displayed in the viewer when the image is not cached or image is not available

    Parameters

    • data: any

    Returns void

repaint

  • repaint(): void
  • description

    Initiates a client-side repaint() of the viewport. This will not trigger a server operaiton, but instead will redraw the last server image onto the canvas, allowing the client to draw its objects onto the viewport (such as moving of annotations).

    Returns void

resetFPSTime

  • resetFPSTime(): void

Protected resizeCanvas

  • resizeCanvas(width: number, height: number, adjustZoom?: boolean, useMax?: boolean): void

  • Resizes this viewport element

    Parameters

    • width: number

      Updated width of this viewport

    • height: number

      Updated height of this viewport

    • Default value adjustZoom: boolean = true
    • Default value useMax: boolean = false

    Returns void

    This is a synchronous method and returns ReturnCode.ok on success.

resizeWindow

  • resizeWindow(width: number, height: number, adjustZoom?: boolean, useMax?: boolean): void
  • description

    Resizes this component and triggers a render() / renderFinal() sequence

    Parameters

    • width: number

      Updated width of this viewport

    • height: number

      Updated height of this viewport

    • Default value adjustZoom: boolean = false

      udpdate the zoom level

    • Default value useMax: boolean = false

      flag that mention maximum zoom level or not

    Returns void

    This is a synchronous method and returns ReturnCode.ok on success.

setAndRenderXMLPreset

  • setAndRenderXMLPreset(xmlPresetName: String, callbackFunc?: any): any
  • setAndRenderXMLPreset(xmlPresetName: Array<String>, callbackFunc?: any): any
  • description

    Applies the specified XML preset to this viewport

    Parameters

    • xmlPresetName: String

      path and filename of the XML file to load. This will be relative to the FoviaWebSDK.EXE directory, or can be an absolute path

    • Optional callbackFunc: any

    Returns any

    This is an asynchronous method that returns a Promise as follows:

    Promise .then(void) .catch (err: ReturnCode )

    callbackFunc(err: ReturnCode , void)

    While this does not provide a return value, the application will be notified once the preset has been applied and rendered

  • Parameters

    • xmlPresetName: Array<String>
    • Optional callbackFunc: any

    Returns any

setCustomMouseAdaptor

  • setCustomMouseAdaptor(mouseAdaptorInterface: any, mouseButton: MouseButton, modifier?: KeyboardModifier): void
  • description

    set custom Mouse Adapter into HtmlViewPortAdaptors

    Parameters

    • mouseAdaptorInterface: any

      Specifies the reference to MouseAdaptorInterface

    • mouseButton: MouseButton

      Specifies the Mouse button to invoke this adapter

    • Default value modifier: KeyboardModifier = KeyboardModifier.none

      Specifies the Key modifier to invoke this Adapter

    Returns void

setCustomTouchAdaptor

  • setCustomTouchAdaptor(touchAdaptorInterface: TouchAdaptorInterface, touchEvent: TouchEvents): void
  • description

    Set the custom adapter into HtmlViewPortAdaptors

    Parameters

    • touchAdaptorInterface: TouchAdaptorInterface

      Specifies the reference to TouchAdaptorInterface

    • touchEvent: TouchEvents

      Specifies the touch event to invoke this adapter

    Returns void

setDefaultAdaptors

  • setDefaultAdaptors(renderType: RenderType, forceInit?: boolean): void
  • description

    Set default adapter from the given render type

    Parameters

    • renderType: RenderType

      Specifies the render type

    • Default value forceInit: boolean = false

    Returns void

setHTMLViewportAdaptor

  • setHTMLViewportAdaptor(htmlViewportAdaptors?: any): void

setHTMLViewportGroup

  • setHTMLViewportGroup(htmlViewportGroup: any): void
  • description

    Set the htmlViewportGroup instance

    Parameters

    • htmlViewportGroup: any

      Specifies the htmlViewportGroup instance

    Returns void

setMouseAdaptor

  • setMouseAdaptor(mouseAdaptorID: any, mouseButton: MouseButton, modifier?: KeyboardModifier, orientation?: ViewType): void
  • description

    Set Mouse Adapter into HtmlViewPortAdaptors

    Parameters

    • mouseAdaptorID: any

      Specifies the mouse adapter id

    • mouseButton: MouseButton

      Specifies the reference to mouse button to invoke this adapter

    • Default value modifier: KeyboardModifier = KeyboardModifier.none

      Specifies the Key modifier to invoke this adapter

    • Default value orientation: ViewType = Fovia.ViewType.oblique

      Specifies the view type

    Returns void

setOverrideKeyCharacter

  • setOverrideKeyCharacter(character: any): void
  • description

    Set the override Key Character into HtmlViewPortAdaptors

    Parameters

    • character: any

      Specifies the keyboard characters

    Returns void

setOverrideMouseAdaptor

  • setOverrideMouseAdaptor(overrideMouseAdaptor: MouseAdaptorInterface): void
  • description

    Set the override MouseAdaptor into HtmlViewPortAdaptors

    Parameters

    • overrideMouseAdaptor: MouseAdaptorInterface

      Specifies the MouseAdaptorInterface reference

    Returns void

setOverrideTouchAdaptor

  • setOverrideTouchAdaptor(overrideTouchAdaptor: TouchAdaptorInterface): void
  • description

    Set the override ed TouchAdaptorInterface into HtmlViewPortAdaptors

    Parameters

    • overrideTouchAdaptor: TouchAdaptorInterface

      Specifies the reference to TouchAdaptorInterface

    Returns void

setRenderImageRescale

  • setRenderImageRescale(doRescale: boolean): void
  • description

    Sets option to automaticly scale render image to fit viewport.

    Parameters

    • doRescale: boolean

      If true, do image rescaling. If false, render image at acutal size.

    Returns void

setRenderLocation

  • setRenderLocation(renderLocation: RenderLocation): Promise<boolean>

setRepaintImageBuffer

  • setRepaintImageBuffer(newRepaintImageBuffer: any): any

setTouchAdaptor

  • setTouchAdaptor(touchAdaptorInterface: TouchAdaptors, touchEvent: TouchEvents, orientation?: ViewType): void
  • description

    Set touch Adaptor into HtmlViewPortAdaptors

    Parameters

    • touchAdaptorInterface: TouchAdaptors

      Specifies the reference to TouchAdaptorInterface

    • touchEvent: TouchEvents

      Specifies the touch event to invoke this adapter

    • Default value orientation: ViewType = Fovia.ViewType.oblique

      Specifies the view type

    Returns void

shootRay

  • shootRay(pointList: Array<Point>, callbackFunc?: any): any

  • Shoots ray into the screen from an array of points, and returns a correpsonding array of RayStopInfo objects.

    Parameters

    • pointList: Array<Point>

      Array of Vectors to project into the scene. At most 20 points can be passed at one time.

    • Optional callbackFunc: any

    Returns any

    This is an asynchronous method that returns a Promise as follows:

    Promise .then(rayStopInfoList : Array< RayStopInfo>) .catch (err: ReturnCode )

    callbackFunc(err: ReturnCode , rayStopInfoList : Array< RayStopInfo> )

Protected updateFPS

  • updateFPS(): void

volume2ProjectionPlaneParallel

  • volume2ProjectionPlaneParallel(inputVector: Vector, zoom: number, spacingX: number, transform: Matrix, imgSize: Size): Vector

  • Converts a 3D point in patient coordinates to a point on the screen. The returned value will have projection plane coordinates for x and y. In z offset from the projection plane is communicated. The extra parameters should be taken directly from the current RenderParams3D, except for spacingX, which is the X spacing from the VolumeDataContext.

    Parameters

    • inputVector: Vector
    • zoom: number
    • spacingX: number
    • transform: Matrix
    • imgSize: Size

    Returns Vector