Class: StreamingImageVolume
Streaming Image Volume Class that extends ImageVolume base class. It implements load method to load the imageIds and insert them into the volume.
Extends
default
Constructors
new StreamingImageVolume()
new StreamingImageVolume(
imageVolumeProperties,streamingProperties):StreamingImageVolume
Parameters
• imageVolumeProperties: ImageVolumeProps
• streamingProperties: IStreamingVolumeProperties
Returns
Overrides
BaseStreamingImageVolume.constructor
Defined in
packages/core/src/cache/classes/StreamingImageVolume.ts:14
Properties
additionalDetails?
optionaladditionalDetails:Record<string,unknown>
Property to store additional information
Inherited from
BaseStreamingImageVolume.additionalDetails
Defined in
packages/core/src/cache/classes/ImageVolume.ts:77
autoRenderOnLoad
protectedautoRenderOnLoad:boolean=true
Inherited from
BaseStreamingImageVolume.autoRenderOnLoad
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:36
cachedFrames
protectedcachedFrames:any[] =[]
Inherited from
BaseStreamingImageVolume.cachedFrames
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:37
cornerstoneImageMetaData
protectedcornerstoneImageMetaData:any=null
Inherited from
BaseStreamingImageVolume.cornerstoneImageMetaData
Defined in
packages/core/src/cache/classes/ImageVolume.ts:33
dataType?
optionaldataType:PixelDataTypedArrayString
Inherited from
BaseStreamingImageVolume.dataType
Defined in
packages/core/src/cache/classes/ImageVolume.ts:84
dimensions
dimensions:
Point3
Dimensions of the volume
Inherited from
BaseStreamingImageVolume.dimensions
Defined in
packages/core/src/cache/classes/ImageVolume.ts:41
direction
direction:
Mat3
volume direction in world space
Inherited from
BaseStreamingImageVolume.direction
Defined in
packages/core/src/cache/classes/ImageVolume.ts:43
hasPixelSpacing
hasPixelSpacing:
boolean
whether the metadata for the pixel spacing is not undefined
Inherited from
BaseStreamingImageVolume.hasPixelSpacing
Defined in
packages/core/src/cache/classes/ImageVolume.ts:75
imageData?
optionalimageData:vtkImageData
volume image data
Inherited from
BaseStreamingImageVolume.imageData
Defined in
packages/core/src/cache/classes/ImageVolume.ts:65
imagesLoader
imagesLoader:
IImagesLoader
Inherited from
BaseStreamingImageVolume.imagesLoader
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:47
isPreScaled
isPreScaled:
boolean=false
Inherited from
BaseStreamingImageVolume.isPreScaled
Defined in
packages/core/src/cache/classes/ImageVolume.ts:38
loadStatus
loadStatus:
object
load status object for the volume
callbacks
callbacks: (...
args) =>void[]
cancelled
cancelled:
boolean
loaded
loaded:
boolean
loading
loading:
boolean
Inherited from
BaseStreamingImageVolume.loadStatus
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:41
metadata
metadata:
Metadata
volume metadata
Inherited from
BaseStreamingImageVolume.metadata
Defined in
packages/core/src/cache/classes/ImageVolume.ts:45
numFrames
numFrames:
number
Inherited from
BaseStreamingImageVolume.numFrames
Defined in
packages/core/src/cache/classes/ImageVolume.ts:88
numTimePoints?
optionalnumTimePoints:number
Inherited from
BaseStreamingImageVolume.numTimePoints
Defined in
packages/core/src/cache/classes/ImageVolume.ts:87
numVoxels
numVoxels:
number
volume number of voxels
Inherited from
BaseStreamingImageVolume.numVoxels
Defined in
packages/core/src/cache/classes/ImageVolume.ts:63
origin
origin:
Point3
volume origin, Note this is an opinionated origin for the volume
Inherited from
BaseStreamingImageVolume.origin
Defined in
packages/core/src/cache/classes/ImageVolume.ts:47
referencedImageIds?
optionalreferencedImageIds:string[]
optional reference image ids if the volume is derived from a set of images in the image cache
Inherited from
BaseStreamingImageVolume.referencedImageIds
Defined in
packages/core/src/cache/classes/ImageVolume.ts:73
referencedVolumeId?
optionalreferencedVolumeId:string
optional reference volume id if the volume is derived from another volume
Inherited from
BaseStreamingImageVolume.referencedVolumeId
Defined in
packages/core/src/cache/classes/ImageVolume.ts:71
reRenderFraction
protectedreRenderFraction:number=2
Inherited from
BaseStreamingImageVolume.reRenderFraction
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:39
reRenderTarget
protectedreRenderTarget:number=0
Inherited from
BaseStreamingImageVolume.reRenderTarget
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:38
scaling?
optionalscaling:object
volume scaling parameters if it contains scaled data
PT?
optionalPT:object
PT.SUVbsaFactor?
optionalSUVbsaFactor:number
PT.suvbwToSuvbsa?
optionalsuvbwToSuvbsa:number
PT.suvbwToSuvlbm?
optionalsuvbwToSuvlbm:number
PT.SUVlbmFactor?
optionalSUVlbmFactor:number
Inherited from
BaseStreamingImageVolume.scaling
Defined in
packages/core/src/cache/classes/ImageVolume.ts:50
spacing
spacing:
Point3
volume spacing in 3d world space
Inherited from
BaseStreamingImageVolume.spacing
Defined in
packages/core/src/cache/classes/ImageVolume.ts:61
totalNumFrames
protectedtotalNumFrames:number
volume scalar data 3D or 4D
Inherited from
BaseStreamingImageVolume.totalNumFrames
Defined in
packages/core/src/cache/classes/ImageVolume.ts:32
volumeId
readonlyvolumeId:string
Read-only unique identifier for the volume
Inherited from
BaseStreamingImageVolume.volumeId
Defined in
packages/core/src/cache/classes/ImageVolume.ts:36
voxelManager?
optionalvoxelManager:IVoxelManager<number> |IVoxelManager<RGB>
The new volume model which solely relies on the separate image data and do not cache the volume data at all
Inherited from
BaseStreamingImageVolume.voxelManager
Defined in
packages/core/src/cache/classes/ImageVolume.ts:83
vtkOpenGLTexture
vtkOpenGLTexture:
vtkStreamingOpenGLTexture
open gl texture for the volume
Inherited from
BaseStreamingImageVolume.vtkOpenGLTexture
Defined in
packages/core/src/cache/classes/ImageVolume.ts:67
Accessors
imageIds
getimageIds():string[]
return the image ids for the volume if it is made of separated images
setimageIds(newImageIds):void
updates the image ids
Parameters
• newImageIds: string[]
Returns
string[]
Inherited from
BaseStreamingImageVolume.imageIds
Defined in
packages/core/src/cache/classes/ImageVolume.ts:185
sizeInBytes
getsizeInBytes():number
Returns
number
Inherited from
BaseStreamingImageVolume.sizeInBytes
Defined in
packages/core/src/cache/classes/ImageVolume.ts:180
Methods
callLoadImage()
callLoadImage(
imageId,imageIdIndex,options):any
Parameters
• imageId: any
• imageIdIndex: any
• options: any
Returns
any
Inherited from
BaseStreamingImageVolume.callLoadImage
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:412
callLoadStatusCallback()
protectedcallLoadStatusCallback(evt):void
Parameters
• evt: any
Returns
void
Inherited from
BaseStreamingImageVolume.callLoadStatusCallback
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:110
cancelLoading()
cancelLoading():
void
It cancels loading the images of the volume. It sets the loading status to false and filters any imageLoad request in the requestPoolManager that has the same volumeId
Returns
void
Inherited from
BaseStreamingImageVolume.cancelLoading
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:77
checkDimensionGroupCompletion()
protectedcheckDimensionGroupCompletion(imageIdIndex):void
Parameters
• imageIdIndex: number
Returns
void
Inherited from
BaseStreamingImageVolume.checkDimensionGroupCompletion
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:592
clearLoadCallbacks()
clearLoadCallbacks():
void
Clear the load callbacks
Returns
void
Inherited from
BaseStreamingImageVolume.clearLoadCallbacks
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:106
destroy()
destroy():
void
destroy the volume and make it unusable
Returns
void
Inherited from
BaseStreamingImageVolume.destroy
Defined in
packages/core/src/cache/classes/ImageVolume.ts:243
errorCallback()
errorCallback(
imageId,permanent,error):void
Parameters
• imageId: any
• permanent: any
• error: any
Returns
void
Inherited from
BaseStreamingImageVolume.errorCallback
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:228
getCornerstoneImages()
getCornerstoneImages():
IImage[]
Returns an array of all the volume's images as Cornerstone images. It iterates over all the imageIds and converts them to Cornerstone images.
Returns
IImage[]
An array of Cornerstone images.
Inherited from
BaseStreamingImageVolume.getCornerstoneImages
Defined in
packages/core/src/cache/classes/ImageVolume.ts:309
getImageIdByIndex()
getImageIdByIndex(
imageIdIndex):string
Parameters
• imageIdIndex: number
Returns
string
Inherited from
BaseStreamingImageVolume.getImageIdByIndex
Defined in
packages/core/src/cache/classes/ImageVolume.ts:223
getImageIdIndex()
getImageIdIndex(
imageId):number
return the index of a given imageId
Parameters
• imageId: string
imageId
Returns
number
imageId index
Inherited from
BaseStreamingImageVolume.getImageIdIndex
Defined in
packages/core/src/cache/classes/ImageVolume.ts:219
getImageIdsRequests()
protectedgetImageIdsRequests(imageIds,priorityDefault):object[]
Parameters
• imageIds: string[]
• priorityDefault: number
Returns
object[]
Inherited from
BaseStreamingImageVolume.getImageIdsRequests
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:449
getImageIdsToLoad()
getImageIdsToLoad():
string[]
Returns
string[]
Overrides
BaseStreamingImageVolume.getImageIdsToLoad
Defined in
packages/core/src/cache/classes/StreamingImageVolume.ts:51
getImageLoadRequests()
getImageLoadRequests(
priority):ImageLoadRequests[]
It returns the imageLoad requests for the streaming image volume instance. It involves getting all the imageIds of the volume and creating a success callback which would update the texture (when the image has loaded) and the failure callback. Note that this method does not executes the requests but only returns the requests. It can be used for sorting requests outside of the volume loader itself e.g. loading a single slice of CT, followed by a single slice of PET (interleaved), before moving to the next slice.
Parameters
• priority: number
Returns
Array of requests including imageId of the request, its imageIdIndex, options (targetBuffer and scaling parameters), and additionalDetails (volumeId)
Overrides
BaseStreamingImageVolume.getImageLoadRequests
Defined in
packages/core/src/cache/classes/StreamingImageVolume.ts:45
getImageURIIndex()
getImageURIIndex(
imageURI):number
return the index of a given imageURI
Parameters
• imageURI: string
Returns
number
imageURI index
Inherited from
BaseStreamingImageVolume.getImageURIIndex
Defined in
packages/core/src/cache/classes/ImageVolume.ts:232
getLoaderImageOptions()
getLoaderImageOptions(
imageId):object
Parameters
• imageId: string
Returns
object
additionalDetails
additionalDetails:
object
additionalDetails.imageId
imageId:
string
additionalDetails.imageIdIndex
imageIdIndex:
number
additionalDetails.volumeId
volumeId:
string
allowFloatRendering
allowFloatRendering:
boolean
preScale
preScale:
object
preScale.enabled
enabled:
boolean
preScale.scalingParameters
scalingParameters:
ScalingParameters
requestType
requestType:
RequestType=requestTypeDefault
targetBuffer
targetBuffer:
object
targetBuffer.columns
columns:
any
targetBuffer.rows
rows:
any
targetBuffer.type
transferPixelData
transferPixelData:
boolean=true
transferSyntaxUID
transferSyntaxUID:
any
Inherited from
BaseStreamingImageVolume.getLoaderImageOptions
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:319
getScalarData()
getScalarData():
PixelDataTypedArray
Return the scalar data (buffer)
Returns
volume scalar data
Defined in
packages/core/src/cache/classes/StreamingImageVolume.ts:29
getScalarDataLength()
getScalarDataLength():
number
Returns
number
Inherited from
BaseStreamingImageVolume.getScalarDataLength
Defined in
packages/core/src/cache/classes/ImageVolume.ts:277
imageIdIndexToFrameIndex()
protectedimageIdIndexToFrameIndex(imageIdIndex):number
Converts imageIdIndex into frameIndex which will be the same for 3D volumes but different for 4D volumes. The indices are 0 based.
Parameters
• imageIdIndex: number
Returns
number
Inherited from
BaseStreamingImageVolume.imageIdIndexToFrameIndex
Defined in
packages/core/src/cache/classes/ImageVolume.ts:299
invalidate()
invalidate():
void
Returns
void
Inherited from
BaseStreamingImageVolume.invalidate
Defined in
packages/core/src/cache/classes/ImageVolume.ts:253
invalidateVolume()
protectedinvalidateVolume(immediate):void
Parameters
• immediate: boolean
Returns
void
Inherited from
BaseStreamingImageVolume.invalidateVolume
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:57
isDynamicVolume()
isDynamicVolume():
boolean
return true if it is a 4D volume or false if it is 3D volume
Returns
boolean
Inherited from
BaseStreamingImageVolume.isDynamicVolume
Defined in
packages/core/src/cache/classes/ImageVolume.ts:210
load()
load(
callback):void
It triggers a prefetch for images in the volume.
Parameters
• callback
A callback function to be called when the volume is fully loaded
Returns
void
Inherited from
BaseStreamingImageVolume.load
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:272
loadImages()
loadImages():
Promise<boolean>
Retrieves images using the older getImageLoadRequests method to setup all the requests. Ensures compatibility with the custom image loaders.
Returns
Promise<boolean>
Inherited from
BaseStreamingImageVolume.loadImages
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:514
modified()
modified():
void
Updates the internals of the volume to reflect the changes in the underlying scalar data. This should be called when the scalar data is modified externally
Returns
void
Inherited from
BaseStreamingImageVolume.modified
Defined in
packages/core/src/cache/classes/ImageVolume.ts:266
removeFromCache()
removeFromCache():
void
Returns
void
Inherited from
BaseStreamingImageVolume.removeFromCache
Defined in
packages/core/src/cache/classes/ImageVolume.ts:273
successCallback()
successCallback(
imageId,image):void
Parameters
• imageId: string
• image: any
Returns
void
Inherited from
BaseStreamingImageVolume.successCallback
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:201
updateTextureAndTriggerEvents()
protectedupdateTextureAndTriggerEvents(imageIdIndex,imageId,imageQualityStatus):void
Parameters
• imageIdIndex: any
• imageId: any
• imageQualityStatus: ImageQualityStatus = ImageQualityStatus.FULL_RESOLUTION
Returns
void
Inherited from
BaseStreamingImageVolume.updateTextureAndTriggerEvents
Defined in
packages/core/src/cache/classes/BaseStreamingImageVolume.ts:140