ServerContext

<< Click to Display Table of Contents >>

Navigation:  »No topics above this level«

ServerContext

Return to chapter overview

C++ C++ Java Java .NET .NET

Summary

 

The IServerContext (C++) and hdrcServerContext (Java/.NET) establishes the connection to a server application using the IP address and port number of the rendering system, all communication between the client and server is through this object. The IP address can be anything that is reachable on the network, or localhost if running the client and server on the same system. The default port is 6778, although any available port can used. It is through this context that volumetric data can be loaded into the server, and how the data is manipulated. The subset of the methods are described below.

 

oCancelJob
oConnect (C++) / hdrcServerContext constructor (Java/.NET)
oCreateOctree
oCreateVertexCallList
oCreatePolygonUtil
oCreateRenderEngine
oCreateTextureMap
oCreateVertexCallList
oCreateVolumeSegmentation
oDecRef (C++)
oDisconnect
oFinishJobCreateOctree
oFinishJobCustomLoadDataset
oFinishJobLoadDicomDirectory
oFinishJobLoadDICOMFromFileList
oFinishJobLoadRawFiles
oFinishJobLoadSeriesFromDICOMList
oFinishJobScanDICOMDirectory
oGetJobInfo
oGetServerVersion
oIncRef
oLoadCustomDataset
oLoadDicomDirectory
oLoadDICOMFromFileList
oLoadPresets
oLoadRawData
oLoadRawFiles
oLoadSeriesFromDICOMList
oSavePreset
oScanDICOMDirectory (Java/.NET)
oStartJobCreateOctree
oStartJobLoadCustomDataset
oStartJobLoadDicomDirectory
oStartJobLoadDICOMFromFileList
oStartJobLoadRawData
oStartJobLoadRawFiles
oStartJobLoadSeriesFromDICOMList
oStartJobScanDICOMDirectory
oUpdateVertexCallLists

 

Methods

 

IServerContext::CancelJob()

C++

virtual signed int IServerContext::CancelJob ( h_int64  jobID) [pure virtual]

Cancels the specified job. Currently, only IVolumeSegmentationContext::FindPath() supports this operation.

Parameters:
jobIDThe job to cancel.

 

com.fovia.hdrc.hdrcServerContext.cancelJob()

Java/.NET

int com.fovia.hdrc.hdrcServerContext.cancelJob ( long  jobID) throws IOException

Placeholder for cancelJob()

 

IServerContext::Connect()

C++ instantiates the IServerContext class through the ILibrary interface by specifying the rendering systems IP address and port ID. Additional details are provided in Connecting to the Server.

 

C++

virtual signed int IServerContext::Connect ( const char *  host,
const h_uint16  port,
ILogger pLogger,
h_int32 *  serverResponse 
) [pure virtual]

Creates a connection to a server with no timeout.

Parameters:
hostThe network address of the host computer.
portThe port in which the host is listening. This number will be communicated when the server first starts up and is 6778 by default.
pLoggerA pointer to a class that iplements ILogger for logging purposes
serverResponse0 if the server has too many connections, -3 if the license file is invalid and -1 if everything is fine
virtual signed int IServerContext::ConnectEx ( const char *  host,
const h_uint16  port,
ILogger pLogger,
h_int32 *  serverResponse,
const h_uint32  timeout 
) [pure virtual]

Creates a connection to a server with a timeout.

Parameters:
hostThe network address of the host computer.
portThe port in which the host is listening. This number will be communicated when the server first starts up and is 6778 by default.
pLoggerA pointer to a class that iplements ILogger for logging purposes
serverResponse0 if the server has too many connections, -3 if the license file is invalid and -1 if everything is fine
timeoutHow long to wait before giving up on connecting in milliseconds.

 

com.fovia.hdrc.hdrcServerContext() constructor

Java instantiates hdrcServerContext is initialized by specifying the rendering systems IP address and port ID. Additional details on initialize of the hdrcServerContext is provided in Connecting to the Server

 

Java/.NET

com.fovia.hdrc.hdrcServerContext.hdrcServerContext ( String  host,
int  port 
) throws UnknownHostException, IOException, ServerBusyIOException

Creates a connection to a server. The appropriate exception is thrown if there is an issue doing so.

Parameters
hostThe network address of the host computer.
portThe port in which the host is listening. This number will be communicated when the server first starts up and is 6778 by default.
Exceptions
UnknownHostException
ServerBusyIOException
IOException

Doxygen link to hdrcServerContext (String host, int port, int timeout)  missing

IServerContext::CreateOctree()

C++

virtual signed int IServerContext::CreateOctree ( IOctreeContext **  pOctreeContext,
IVolumeDataContext pData 
)
pure virtual

Creates an IOctreeContext object from an IVolumeDataContext. Once this call completes, the octree will be initialized and ready to be passed to a render engine.

virtual signed int IServerContext::CreateOctreeEx ( IOctreeContext **  pOctreeContext,
IVolumeDataContext pData,
ENUM_SMOOTH_PARAM  smoothType 
)
pure virtual

Creates an IOctreeContext object from an IVolumeDataContext. Once this call completes, the octree will be initialized and ready to be passed to a render engine.

virtual signed int IServerContext::CreateOctreeEx2 ( IOctreeContext **  pOctreeContext,
IVolumeDataContext pData,
h_boolean  bSaveMemory,
ENUM_SMOOTH_PARAM  smoothType 
) [pure virtual]

Creates an IOctreeContext object from an IVolumeDataContext. Once this call completes, the octree will be initialized and ready to be passed to a render engine. bSaveMemory is deprecated and not necessary. It can be safely ignored.

virtual signed int IServerContext::CreateOctreeEx2Dep ( IOctreeContext **  pOctreeContext,
h_int64  dataID,
h_boolean  bSaveMemory,
ENUM_SMOOTH_PARAM  smoothType 
) [pure virtual]

Creates an IOctreeContext object from an IVolumeDataContext. Once this call completes, the octree will be initialized and ready to be passed to a render engine. This overload of this function is deprecated.

 

com.fovia.hdrc.hdrcServerContext.createOctree()

Java/.NET

hdrcOctreeContext com.fovia.hdrc.hdrcServerContext.createOctree ( long  VolumeDataId) throws IOException

Creates an hdrcOctreeContext object. VolumeDataId must be a valid id procured from an initialized hdrcVolumeDataContext. Once this call completes, the octree will be initialized and ready to be passed to a render engine.

Parameters
VolumeDataIdint
Returns
hdrcOctreeContext - Returns null if the call fails.
Exceptions
IOException

References com.fovia.hdrcsrv.hdrcDefines.SMOOTH3D_TRILINEAR.

Referenced by com.fovia.hdrc.hdrcServerContext.createOctree().

hdrcOctreeContext com.fovia.hdrc.hdrcServerContext.createOctree ( long  VolumeDataId,
int  smoothType 
) throws IOException

Same as the basic createOctree call, except you can specify the type of smoothing to be applied to the volume. See SMOOTH3D_* in hdrcDefines for possible values.

Parameters
VolumeDataIdint
smoothTypeint
Returns
hdrcOctreeContext
Exceptions
IOException

References com.fovia.hdrc.hdrcServerContext.createOctree().

hdrcOctreeContext com.fovia.hdrc.hdrcServerContext.createOctree ( long  VolumeDataId,
boolean  bSaveMemory,
int  smoothType 
) throws IOException

A legacy octree creation overload. This one allows you to specify if we should run in memory saving mode or not, but the octree is now always in memory saving mode.

Parameters
VolumeDataIdint
bSaveMemoryboolean
smoothTypeint
Returns
hdrcOctreeContext
Exceptions
IOException

 

IServerContext::CreatePolygonUtil()

C++

virtual signed int IServerContext::CreatePolygonUtil ( IPolygonUtilContext **  pPolygonUtil)
pure virtual

Placeholder for CreatePolygonUtil()

 

com.fovia.hdrc.hdrcServerContext.createPolygonUtil()

Java/.NET

hdrcPolygonUtilContext com.fovia.hdrc.hdrcServerContext.createPolygonUtil ( ) throws IOException

Creates an hdrcIVolumeSegmentation object. Don't forget to call setVolumeData() on the object once it's been created.

Returns
hdrcIVolumeSegmentation - Returns null if the call fails.
Exceptions
IOException

 

IServerContext::CreateRenderEngine()

C++

virtual signed int IServerContext::CreateRenderEngine ( IRenderEngineContext **  pRenderEngine,
ENUM_RENDER_ENGINE_CLASSID  Type 
)
pure virtual

Creates a new IRenderEngineContext of the speficied type.

 

com.fovia.hdrc.hdrcServerContext.createRenderEngine()

Java/.NET

hdrcRenderEngineContext com.fovia.hdrc.hdrcServerContext.createRenderEngine ( int  Type) throws IOException

Creates a new hdrcRenderEngineContext of the speficied type. See RENDER_ENGINE_ID_* in hdrcDefines for a list of valid types.

Parameters
Typeint
Returns
hdrcRenderEngineContext - Returns null if the call fails.
Exceptions
IOException

 

IServerContext::CreateTextureMap()

C++

virtual signed int IServerContext::CreateTextureMap ( ITextureMapContext **  pTextureMapContext)
pure virtual

Creates an ITextureMapContext pointer and returns it into the variable at the address pTextureMapContext.

Parameters
pTextureMapContextThe address to return the ITextureMapContext pointer.

 

com.fovia.hdrc.hdrcServerContext.createTextureMap()

Java/.NET

#MERGE Merge/hdvr_java_xx.html

 

NO DOXYGEN LINK

IServerContext::CreateVertexCallList()

C++

virtual signed int IServerContext::CreateVertexCallList ( IVertexCallListContext **  pVertexCallListContext)
pure virtual

Creates an IVertexCallListContext pointer and returns it into the variable at the address pVertexCallListContext.

Parameters
pVertexCallListContextThe address to return the IVertexCallListContext pointer.

 

com.fovia.hdrc.hdrcServerContext.createVertexCallList()

Java/.NET

hdrcVertexCallListContext com.fovia.hdrc.hdrcServerContext.createVertexCallList ( ) throws IOException

Placeholder for createVertexCAllList()

 

IServerContext::CreateVolumeSegmentation()

C++

virtual signed int IServerContext::CreateVolumeSegmentation ( IVolumeSegmentationContext **  pvolumeSegmentationContext)
pure virtual

Creates an IVolumeSegmentation object. Don't forget to call IVolumeSegmentation::SetVolumeData() once it's been created.

 

com.fovia.hdrc.hdrcServerContext.CreateVolumeSegmentation()

Java/.NET

hdrcIVolumeSegmentation com.fovia.hdrc.hdrcServerContext.createVolumeSegmentation ( ) throws IOException

Creates an hdrcIVolumeSegmentation object. Don't forget to call setVolumeData() on the object once it's been created.

Returns
hdrcIVolumeSegmentation - Returns null if the call fails.
Exceptions
IOException

 

IServerContext::DecRef()

C++

virtual signed int IServerContext::DecRef ( )
pure virtual

Decreases the reference count on this object by 1. If the reference count reaches 0, the object is deallocated.

Implements IRoot.

 

IServerContext::Disconnect()

C++

virtual signed int IRenderEngineContext::SetVolumeData ( IVolumeDataContext pData,
IOctreeContext pOctree 
)
pure virtual

Sets the volume data for this engine. Either parameter may be null. This is important because MPR engines do not require an Octree

Parameters
pDataThe volume data.
pOctreeAn initialized octree for the previously specified volume data.

 

com.fovia.hdrc.hdrcServerContext..disconnect()

Java/.NET

int com.fovia.hdrc.hdrcRenderEngineContext.setVolumeData ( hdrcVolumeDataContext  Volume,
hdrcOctreeContext  Octree 
) throws IOException

Sets the volume data for this engine. Either parameter may be null. This is important because MPR engines do not require an Octree

Parameters
VolumeThe volume data.
OctreeAn initialized octree for the previously specified volume data.
Returns
int - 0 if successful.
Exceptions
IOException

 

IServerContext::FinishJobCreateOctree()

C++

virtual signed int IServerContext::FinishJobCreateOctree ( IOctreeContext **  pOctreeContext,
h_int64  job 
) [pure virtual]

Waits for an asynchronous octree creation operation to finish.

Parameters:
jobThe job ID.
pOctreeContextThe address of the IOctreeContext* to receive the location of the new object.

 

com.fovia.hdrc.hdrcServerContext.FinishJobCreateOctree()

Java/.NET

hdrcOctreeContext com.fovia.hdrc.hdrcServerContext.finishJobCreateOctree ( long  job) throws IOException

Blocks until the octree creation job is finnished.

Parameters
job
Returns
Exceptions
IOException

 

IServerContext::FinishJobCustomLoadDataset()

C++

virtual signed int IServerContext::FinishJobCustomLoadDataset ( IVolumeDataContext **  pData,
const h_int64  job 
) [pure virtual]

Waits for an asynchronous load operation to finish.

Parameters:
jobThe job ID.
pDataThe address of the IVolumeDataContext* to receive the location of the new object.

 

com.fovia.hdrc.hdrcServerContext.finishJobCustomLoadDataset()

Java/.NET

hdrcVolumeDataContext com.fovia.hdrc.hdrcServerContext.finishJobCustomLoadDataset ( long  job) throws IOException

Waits for an asynchronous load operation to finish.

Parameters
jobThe job ID.
Returns
hdrcVolumeDataContext - Returns null if the call fails.
Exceptions
IOException

 

IServerContext::FinishJobLoadDicomDirectory()

C++

virtual signed int IServerContext::FinishJobLoadDicomDirectory ( IVolumeDataContext **  pData,
const h_int64  job 
) [pure virtual]

Waits for an asynchronous load operation to finish.

Parameters:
jobThe job ID.
pDataThe address of the IVolumeDataContext* to receive the location of the new object.

 

com.fovia.hdrc.hdrcServerContext.FinishJobLoadDicomDirectory()

Java/.NET

hdrcVolumeDataContext com.fovia.hdrc.hdrcServerContext.finishJobLoadDicomDirectory ( long  job) throws IOException

Waits for an asynchronous DICOM load operation to finish.

Parameters
jobint
Returns
hdrcVolumeDataContext - Returns null if the call fails.
Exceptions
IOException

 

IServerContext::FinishJobLoadDICOMFromFileList()

C++

virtual signed int IServerContext::FinishJobLoadDICOMFromFileList ( ILiteDICOMFileContext ***  files,
h_int64  job,
const h_int32  numPaths,
IAllocator piAlloc 
) [pure virtual]

Waits for an asynchronous load operation to finish.

Parameters:
jobThe job ID.
filesThe address of an ILiteDICOMFileContext** that will receive the array of ILiteDICOMFileContext* objects.
numPathsThe number of files expected in the return parameter files.
piAllocThe allocator to use when creating the returned array.

 

com.fovia.hdrc.hdrcServerContext.FinishJobLoadDICOMFromFileList()

Java/.NET

hdrcILiteDICOMFile [] com.fovia.hdrc.hdrcServerContext.finishJobLoadDICOMFromFileList ( long  job,
String  paths[] 
) throws IOException

Blocks until the DICOM files have finished loading. If a file failed to load, its position in the array will be null.

Parameters
jobThe job ID.
pathsThe paths to the files. This should be the same array passed into the start function.
Returns
hdrcILiteDICOMFile[] - The file objects allocated on the server.
Exceptions
IOException

 

IServerContext::FinishJobLoadRawFiles()

C++

virtual signed int IServerContext::FinishJobLoadRawFiles ( IVolumeDataContext **  pData,
const h_int64  job 
) [pure virtual]

Waits for an asynchronous load operation to finish.

Parameters:
jobThe job ID.
pDataThe address of the IVolumeDataContext* to receive the location of the new object.

 

com.fovia.hdrc.hdrcServerContext.finishLoadRawFiles()

Java/.NET

hdrcVolumeDataContext com.fovia.hdrc.hdrcServerContext.finishLoadRawFiles ( long  job) throws IOException

Waits for an asynchronous load operation to finish.

Parameters
jobThe job ID.
Returns
hdrcVolumeDataContext - Returns null if the call fails.
Exceptions
IOException

 

IServerContext::FinishJobLoadSeriesFromDICOMList()

C++

virtual signed int IServerContext::FinishJobLoadSeriesFromDICOMList ( IVolumeDataContext **  pData,
h_int64  job 
) [pure virtual]

Waits for an asynchronous load operation to finish.

Parameters:
jobThe job ID.
pDataThe address of the IVolumeDataContext* to receive the location of the new object.

 

com.fovia.hdrc.hdrcServerContext.FinishJobLoadSeriesFromDICOMList()

Java/.NET

hdrcVolumeDataContext com.fovia.hdrc.hdrcServerContext.finishJobLoadSeriesFromDICOMList ( long  job) throws IOException

Blocks until the series is finished loading into memory.

Parameters
jobThe Job ID
Returns
hdrcVolumeDataContext - The object representing the loaded series. This will be null upon failure.
Exceptions
IOException

 

IServerContext::FinishJobScanDICOMDirectory()

C++

virtual signed int IServerContext::FinishJobScanDICOMDirectory ( ILiteDICOMFileContext ***  files,
char ***  paths,
h_uint32 *  numfiles,
h_int64  job,
IAllocator pAlloc 
) [pure virtual]

Waits for an asynchronous scan operation to finish.

Parameters:
jobThe job ID.
filesThe address of an ILiteDICOMFileContext** that will receive the array of ILiteDICOMFileContext* objects.
pathsThe address of an array of strings to get the path of each file returned in the parameter files.
numfilesThe address of an integer to get the number of files describes in the parameter files.
pAllocThe allocator to use when creating the returned array.

 

com.fovia.hdrc.hdrcServerContext.FinishJobScanDICOMDirectory()

Java/.NET

hdrcILiteDICOMFile [] com.fovia.hdrc.hdrcServerContext.finishJobScanDICOMDirectory ( long  job) throws IOException

Blocks until the DICOM directory scan completes.

Parameters
jobThe job ID.
Returns
hdrcILiteDICOMFile[] - An array of all the DICOM files found on the server. This can potentially be 0 in length (none found).
Exceptions
IOException

 

IServerContext::GetJobInfo()

C++

virtual signed int IServerContext::GetJobInfo ( h_int64  jobID,
JOBINFO jobInfo 
) [pure virtual]

Returns information about the status of a current asynchronous operation. If progress is 100, the job has completed. Errors can also be returned in the jobInfo structure.

 

com.fovia.hdrc.hdrcServerContext.getJobInfo()

Java/.NET

hdrcJobInfo com.fovia.hdrc.hdrcServerContext.getJobInfo ( long  jobID) throws IOException

Returns information about the status of a current asynchronous operation. If progress is 100, the job has completed.

Parameters
jobIDint - The ID value of the job to request info on. This is generated by an asynchronous startJob*() function.
Returns
hdrcJobInfo - A reference to a hdrcJobInfo structure. Returns null if the call fails.
Exceptions
IOException

 

IServerContext::GetServerVersion()

C++

virtual signed int IServerContext::GetServerVersion ( h_uint32 *  version) [pure virtual]

The version parameter will get the version of the server that we are currently connected to.

Returns:
If successful, S_OK. If version is NULL, E_INVALIDARG. If we're not connected to a server, E_UNEXPECTED.

 

com.fovia.hdrc.hdrcServerContext.GetServerVersion()

Java/.NET

long com.fovia.hdrc.hdrcServerContext.getServerVersion ( )

Returns the version of the server SDK the currently connected server is running. Note that this implies an active connection to a server is in place. If you are not connected to a server, this will return 0.

References com.fovia.hdrc.hdrcServerContext.getServerVersion().

Referenced by com.fovia.hdrc.hdrcServerContext.getServerVersion().

 

IServerContext::IncRef()

C++

virtual signed int IServerContext::IncRef ( )
pure virtual

Increases the reference count on this object by 1. You do not need to call this after an object is first created. It is 1 by default.

Implements IRoot.

 

IServerContext::LoadCustomDataset()

C++

virtual signed int IServerContext::LoadCustomDataset ( IVolumeDataContext **  pData,
ENUM_LOAD_DATASET_OPTIONS  type,
const char *  path 
)
pure virtual

Performs a synchronous load of data of the specified type. Use LoadRawData() for loading .raw files and LoadDicomDirectory() for loading DICOM directories. Type 1001 is to load via the Fovia .ini file shared memory function.

Parameters
typeType of data to load. This is generally the integer ID value set with IHdrcServer::SetDatasetLoadFunc().
pathPath of the data. This can be literally any string you like if you've written your own load function. For type 1001 it's the path to the .ini file on the server.
pDataReceives the address of an IVolumeDataContext representing the data on the server

 

com.fovia.hdrc.hdrcServerContext.loadCustomDataset()

Java/.NET

hdrcVolumeDataContext com.fovia.hdrc.hdrcServerContext.loadCustomDataset ( int  type,
String  path 
) throws IOException

Performs a synchronous load of data of the specified type. Use loadRawData(String) for loading .raw files and loadDicomDirectory(String) for loading DICOM directories. Type 1001 is to load via the Fovia .ini file based shared memory function.

Parameters
typeType of data to load. This is generally the integer ID value set with IHdrcServer::SetDatasetLoadFunc().
pathPath of the data. This string is formatted based upon what type of data we're loading.
Returns
hdrcVolumeDataContext - Returns null if the call fails.
Exceptions
IOException

 

IServerContext::LoadDicomDirectory

C++

virtual signed int IServerContext::LoadDicomDirectory ( IVolumeDataContext **  pData,
const char *  path 
)
pure virtual

Performs a synchronous load of a DICOM directory. The folder is expected to contain exactly one DICOM series. The folder should not contain any non-DICOM files such as text based index files, etc. If your folder structure is more complicated than that, use ScanDICOMDirectory() and LoadSeriesFromDICOMList().

 

com.fovia.hdrc.hdrcServerContext.loadDicomDirectory()

Java/.NET

hdrcVolumeDataContext com.fovia.hdrc.hdrcServerContext.loadDicomDirectory ( String  path) throws IOException

Performs a synchronous load of a DICOM directory. The folder is expected to contain exactly one DICOM series. The folder should not contain any non-DICOM files such as text based index files, etc. If your folder structure is more complicated than that, use scanDICOMDirectory() and loadSeriesFromDICOMList().

Parameters
pathString
Returns
hdrcVolumeDataContext - Returns null if the call fails.
Exceptions
IOException

 

IServerContext::LoadDICOMFromFileList()

C++

virtual signed int IServerContext::LoadDICOMFromFileList ( ILiteDICOMFileContext ***  files,
char **  paths,
h_uint32  numPaths,
IAllocator pAlloc 
) [pure virtual]

Loads up DICOM file objects from a list of paths to the file objects.

Parameters:
pathsPaths to the files on the server
numPathsThe number of paths described in the parameter numPaths.
filesAddress of an ILiteDICOMFileContext** that will receive an array of ILiteDICOMFileContext* objects representing the valid DICOM files found.
pAllocThe allocator to use when allocating the ILiteDICOMFileContext* array.
Exceptions:
IOException

 

com.fovia.hdrc.hdrcServerContext.LoadDICOMFromFileList()

Java/.NET

hdrcILiteDICOMFile [] com.fovia.hdrc.hdrcServerContext.loadDICOMFromFileList ( String  paths[]) throws IOException

Loads up DICOM file objects from a list of paths to the file objects.

Parameters
pathsThe paths to the file objects.
Returns
hdrcILiteDICOMFile[] - Array of DICOM file objects. If a file object failed to load, it will be null.
Exceptions
IOException

 

IServerContext::LoadPresets()

C++

virtual signed int IServerContext::LoadPreset ( const char *  path,
RENDER_PARAMS rp 
)
pure virtual

Loads an XML preset file stored on the server into the specified RENDER_PARAMS structu.

Parameters
pathPath to the XML file.
rpThe address of a RENDER_PARAMS that will get the data stored at path.

 

com.fovia.hdrc.hdrcServerContext.loadPreset()

Java/.NET

int com.fovia.hdrc.hdrcServerContext.loadPreset ( String  path,
RENDER_PARAMS  rp 
) throws IOException

Loads an XML preset file stored on the server into the specified RENDER_PARAMS structure.

Parameters
pathPath to the XML file.
rpRENDER_PARAMS
Returns
int - 0 if successful.
Exceptions
IOException

 

IServerContext::LoadRawData()

C++

virtual signed int IServerContext::LoadRawData ( IVolumeDataContext **  pData,
const char *  path 
)
pure virtual

Performs a synchronous load of a RAW file.

 

com.fovia.hdrc.hdrcServerContext.loadRawData()

Java/.NET

#MERGE Merge/hdvr_java_xx.html

 

IServerContext::LoadRawFiles()

C++

virtual signed int IServerContext::LoadRawFiles ( IVolumeDataContext **  pData,
RAW_DATASET_DESCRIPTION rdd 
)
pure virtual

Performs a synchronous load of a RAW dataset that may have multiple files.

Parameters
rddRaw dataset description to load
pDataReceives the address of an IVolumeDataContext representing the data on the server

 

com.fovia.hdrc.hdrcServerContext.LoadRawFiles()

Java/.NET

hdrcVolumeDataContext com.fovia.hdrc.hdrcServerContext.loadRawFiles ( RAW_DATASET_DESCRIPTION  rdd) throws IOException

Loads up multi-file RAW dataset defined by RAW_DATASET_DESCRIPTION.

Parameters
rddDefinition of the dataset to load.
Returns
id - Array of DICOM file objects. If a file object failed to load, it will be null.
Exceptions
IOException

 

IServerContext::LoadSeriesFromDICOMList()

C++

virtual signed int IServerContext::LoadSeriesFromDICOMList ( IVolumeDataContext **  pData,
const h_int32  numFiles,
ILiteDICOMFileContext **  files,
const char *  seriesUID 
) [pure virtual]

Loads a series from a list of DICOM files loaded into memory. Only files with the seriesUID will be loaded for inclusion in the data set. NOTE: This releases the ILiteDICOMFiles from memory on the server. You may no longer use any of the objects passed in after calling this function.

Parameters:
filesFiles to scan.
numFilesThe number of files described in the parameter files.
seriesUIDUID of the series to load. You can qeury this by getting the DCM_SeriesInstanceUID from a file in the series.
pDataAddress of an IVolumeDataContext* to receive the newly loaded volume data.

 

com.fovia.hdrc.hdrcServerContext.LoadSeriesFromDICOMList()

Java/.NET

hdrcVolumeDataContext com.fovia.hdrc.hdrcServerContext.loadSeriesFromDICOMList ( hdrcILiteDICOMFile  files[],
String  seriesUID 
) throws IOException

Loads a series from a list of DICOM files loaded into memory. Only files with the seriesUID will be loaded for inclusion in the data set. NOTE: This releases the hdrcILiteDICOMFiles from memory on the server. You may no longer use any of the objects passed in after calling this function.

Parameters
filesFiles to scan.
seriesUIDUID of the series to load. You can qeury this by getting the DCM_SeriesInstanceUID from a file in the series.
Returns
hdrcVolumeDataContext - Will be null if loading fails.
Exceptions
IOException

 

IServerContext::SavePreset()

C++

virtual signed int IServerContext::SavePreset ( const char *  path,
RENDER_PARAMS rp 
)
pure virtual

Saves the current RENDER_PARAMS into an XML file on the server.

Parameters
pathPath to the location the file should be stored.
rpThe preset to save.

 

com.fovia.hdrc.hdrcServerContext.SavePreset()

Java/.NET

int com.fovia.hdrc.hdrcServerContext.savePreset ( String  path,
RENDER_PARAMS  rp 
) throws IOException

Saves the current RENDER_PARAMS into an XML file on the server.

Parameters
pathPath to the location the file should be stored.
rpRENDER_PARAMS
Returns
int - 0 if successful.
Exceptions
IOException

 

com.fovia.hdrc.ScanDICOMDirectory()

Java/.NET

hdrcILiteDICOMFile [] com.fovia.hdrc.hdrcServerContext.scanDICOMDirectory ( String  path) throws IOException

Scans a directory for DICOM files. This is a recursive scan, so subfolders will be searched as well.

Parameters
pathPath to the directory on the server
Returns
hdrcILiteDICOMFile[] - DICOM file objects representing all of the valid DICOM files found.
Exceptions
IOException

 

IServerContext::StartJobCreateOctree()

C++

virtual signed int IServerContext::StartJobCreateOctreeDep ( h_int64 *  jobID,
h_int64  dataID,
h_boolean  bSaveMemory,
ENUM_SMOOTH_PARAM  smoothType 
) [pure virtual]

Start an octree creation job. Use the job ID returned by this function and GetJobInfo() to query the status of the operation. See CreateOctree() for parameter definitions. This overload of this function is deprecated.

 

com.fovia.hdrc.hdrcServerContext.StartJobCreateOctree()

Java/.NET

long com.fovia.hdrc.hdrcServerContext.startJobCreateOctree ( long  VolumeDataId,
boolean  bSaveMemory,
int  smoothType 
) throws IOException

Start an octree creation job. Use the job ID returned by this function and getJobInfo(int) to query the status of the operation. See createOctree() for parameter definitions.

Parameters
VolumeDataId
bSaveMemory
smoothType
Returns
int - Less than 0 indicates failure.
Exceptions
IOException

 

IServerContext::StartJobLoadCustomDataset()

C++

virtual signed int IServerContext::StartJobLoadCustomDataset ( h_int64 *  jobID,
ENUM_LOAD_DATASET_OPTIONS  loadtype,
const char *  path 
) [pure virtual]

Begins an asynchronous load of a dataset. LoadCustomDataset() for more information about loading custom datasets. Use the job ID returned by this function and GetJobInfo() to query the status of the load operation.

 

com.fovia.hdrc.hdrcServerContext.startJobLoadCustomDataset()

Java/.NET

long com.fovia.hdrc.hdrcServerContext.startJobLoadCustomDataset ( int  loadtype,
String  path 
) throws IOException

Begins an asynchronous load of a dataset. See loadCustomDataset(int,String) for more information about loading custom datasets. Use the job ID returned by this function and getJobInfo(int) to query the status of the load operation.

Parameters
loadtypeType of data to load. This is generally the integer ID value set with IHdrcServer::SetDatasetLoadFunc(). 1001 is the ini-based shared memory load.
pathPath to the data. Format depends upon loadtype.
Returns
int - The job id of the load operation.
Exceptions
IOException

 

IServerContext::StartJobLoadDicomDirectory()

C++

virtual signed int IServerContext::StartJobLoadDicomDirectory ( h_int64 *  jobID,
const char *  path 
) [pure virtual]

Starts an asynchronous load of a DICOM directory. The folder is expected to contain exactly one DICOM series. If your folder structure is more complicated than that, use ScanDICOMDirectory() and LoadSeriesFromDICOMList(). See StartJobLoadCustomDataset() for more information on this process.

Parameters:
jobIDGets the job id for this operation. Use it for reference when getting the job info or calling the finish function.
pathPath to the DICOM directory to load.

 

com.fovia.hdrc.hdrcServerContext.StartJobLoadDicomDirectory()

Java/.NET

long com.fovia.hdrc.hdrcServerContext.startJobLoadDicomDirectory ( String  path) throws IOException

Starts an asynchronous load of a DICOM directory. See startJobLoadCustomDataset(int,String) for more information on this process.

Parameters
pathPath to the DICOM directory to load.
Returns
int - Returns the job ID of the load operation.
Exceptions
IOException

 

IServerContext::StartJobLoadDICOMFromFileList()

C++

virtual signed int IServerContext::StartJobLoadDICOMFromFileList ( h_int64 *  jobID,
const h_int32  numPaths,
const char **  paths 
) [pure virtual]

Begins Loading a list of DICOM files from a specified list of paths. Use the job ID returned by this function and GetJobInfo() to query the status of the load operation.

Parameters:
jobIDGets the job id for this operation. Use it for reference when getting the job info or calling the finish function.
numPathsThe number of paths specified in the parameter paths.
pathsLocation on the server of each of the files to load.

 

com.fovia.hdrc.hdrcServerContext.StartJobLoadDICOMFromFileList()

Java/.NET

long com.fovia.hdrc.hdrcServerContext.startJobLoadDICOMFromFileList ( String  paths[]) throws IOException

Begins Loading a list of DICOM files from a specified list of paths. Use the job ID returned by this function and getJobInfo(int) to query the status of the load operation.

Parameters
pathsLocation on the server of each of the files to load.
Returns
int - Less than 0 indicates failure
Exceptions
IOException

 

IServerContext::StartJobLoadRawData()

C++

virtual signed int IServerContext::StartJobLoadRawData ( h_int64 *  jobID,
const char *  path 
) [pure virtual]

Starts an asynchronous load of a RAW file. See StartJobLoadCustomDataset() for more information on this process.

Parameters:
jobIDGets the job id for this operation. Use it for reference when getting the job info or calling the finish function.
pathPath to the RAW file to load.

 

com.fovia.hdrc.hdrcServerContext.StartJobLoadRawData()

Java/.NET

long com.fovia.hdrc.hdrcServerContext.startJobLoadRawData ( String  path) throws IOException

Starts an asynchronous load of a RAW file. See startJobLoadCustomDataset(int,String) for more information on this process.

Parameters
pathPath to the RAW file to load.
Returns
int - Returns the job ID of the load operation.
Exceptions
IOException

References com.fovia.hdrcsrv.hdrcDefines.LDO_RAW_DATASET_PATH, and com.fovia.hdrcsrv.hdrcDefines.LDO_SEGY_DATASET_PATH.

 

IServerContext::StartJobLoadRawFiles()

C++

virtual signed int IServerContext::StartJobLoadRawFiles ( h_int64 *  jobID,
RAW_DATASET_DESCRIPTION rdd 
) [pure virtual]

Begins an asynchronous load of a RAW dataset that may have multiple files. Use the job ID returned by this function and GetJobInfo() to query the status of the load operation.

com.fovia.hdrc.hdrcServerContext.startJobLoadRawFiles()

Java/.NET

long com.fovia.hdrc.hdrcServerContext.startJobLoadRawFiles ( RAW_DATASET_DESCRIPTION  rdd) throws IOException

Begins an asynchronous load of a multi-file RAW dataset. See loadRawFiles(RAW_DATASET_DESCRIPTION) for more information about loading raw datasets. Use the job ID returned by this function and getJobInfo(int) to query the status of the load operation.

Parameters
rddDefinition of the dataset to load.
Returns
int - The job id of the load operation.
Exceptions
IOException

 

IServerContext::StartJobLoadSeriesFromDICOMList()

C++

virtual signed int IServerContext::StartJobLoadSeriesFromDICOMList ( h_int64 *  jobID,
const h_int32  numFiles,
ILiteDICOMFileContext **  files,
const char *  seriesUID 
) [pure virtual]

Begins loading a DICOM series into memory for volume rendering. NOTE: This releases the ILiteDICOMFiles from memory on the server. You may no longer use any of the objects passed in after calling this function. Use the job ID returned by this function and GetJobInfo() to query the status of the load operation.

Parameters:
jobIDGets the job id for this operation. Use it for reference when getting the job info or calling the finish function.
numFilesThe number of files in the parameter files.
filesThe files that contain the series. Note that this can contain a sub-sequence of the series.
seriesUIDUID of the series to load. You can qeury this by getting the DCM_SeriesInstanceUID from a file in the series.

 

com.fovia.hdrc.hdrcServerContext.StartJobLoadSeriesFromDICOMList()

Java/.NET

long com.fovia.hdrc.hdrcServerContext.startJobLoadDICOMFromFileList ( String  paths[]) throws IOException

Begins Loading a list of DICOM files from a specified list of paths. Use the job ID returned by this function and getJobInfo(int) to query the status of the load operation.

Parameters
pathsLocation on the server of each of the files to load.
Returns
int - Less than 0 indicates failure
Exceptions
IOException

 

IServerContext::StartJobScanDICOMDirectory()

C++

virtual signed int IServerContext::StartJobScanDICOMDirectory ( h_int64 *  jobID,
const char *  path 
) [pure virtual]

Begins an asynchronous recursive scan of a directory for DICOM files. Use the job ID returned by this function and GetJobInfo() to query the status of the load operation.

Parameters:
jobIDGets the job id for this operation. Use it for reference when getting the job info or calling the finish function.
pathLocation of the DICOM directory on the server.

 

com.fovia.hdrc.hdrcServerContext.StartJobScanDICOMDirectory()

Java/.NET

long com.fovia.hdrc.hdrcServerContext.startJobScanDICOMDirectory ( String  path) throws IOException

Begins an asynchronous recursive scan of a directory for DICOM files. Use the job ID returned by this function and getJobInfo(int) to query the status of the load operation.

Parameters
pathLocation of the DICOM directory on the server.
Returns
int - Less than 0 indicates failure.
Exceptions
IOException

 

IServerContext::UpdateVertexCallLists()

C++

virtual signed int IServerContext::UpdateVertexCallLists ( const h_uint32  numVertexCallLists,
IVertexCallListContext **  arrVertices 
) [pure virtual]

Updates the server state of the specified vertex call lists. Note that you normally should not have to call this function explicitly as the state is automatically updated as you set it in the appropriate SetRenderParams() calls.

Parameters:
numVertexCallListsThe number of call lists to update.
arrVerticesAn array of IVertexCallListContext to update on the server.
virtual signed int IServerContext::UpdateVertexCallListsEx ( const h_boolean  bUpdatingServer,
const h_uint32  toTransfer,
const h_uint32  numVertexCallLists,
IVertexCallListContext **  arrVertices 
) [pure virtual]

Placeholder for UpdateVertexCallListsEx()

com.fovia.hdrc.hdrcServerContext.UpdateVertexCallLists()

Java/.NET

int com.fovia.hdrc.hdrcServerContext.updateVertexCallLists ( hdrcVertexCallListContext  callLists[]) throws IOException

 

Doxygen Links

 

Complete details of member variables and class names are available in the source level documentation available from these links to Doxygen.

 

C++

IServerContext

Java / .NET

hdrcServerContext