Class J2Ci.jDVInterface
All Packages Class Hierarchy This Package Previous Next Index
Class J2Ci.jDVInterface
Object
|
+----J2Ci.jDVInterface
- public class jDVInterface
- extends Object
A jDVInterface represents the relating C++-Class DVInterface
in Java.
- Author:
- Andreas Schröter
-
J2Ci.jDVInterface(String)
- Constructor, creates a relating C++-Object.
-
deleteInstance(String, String, String)
- Removes an image
-
deleteSeries(String, String)
- Removes a series.
-
deleteStudy(String)
- Removes a study
-
disablePState()
-
Stores the current presentation state in a temporary place
and creates a new presentation state that corresponds with an
image displayed "without" presentation state.
-
enablePState()
-
Restores the stored presentation state (see disablePresentationState)
and deletes the temporary presentation state.
-
finalize()
- Destructor, removes *this* relating C++-Object out of memory
-
getAccessionNumber()
- Returns the accession number of a study which is selected by "selectStudy".
-
getAmbientLightValue(jDoubleByRef)
-
Returns ambient light value for the Barten transformation.
-
getCurrentPState()
- Gets the current PresentationState-Object
-
getDatabaseFolder()
-
Returns the database folder to be used for sending/receiving/browsing.
-
getEthnicGroup()
-
Returns the PatientEthnicGroup of a study which is selected by
the method selectStudy
-
getFilename(String, String, String)
-
Searches in the database for a DICOM instance with the given
study, series and instance UIDs and returns its pathname if found.
-
getGUIConfigEntry(String)
-
Returns the value of configuration file entry key=value
in the section GENERAL/GUI of the config file.
-
getGUIConfigEntryBool(String, boolean)
-
Returns the value of configuration file entry key=value
in the section GENERAL/GUI of the config file.
-
getImageNumber()
-
Returns the image number of an instance which is selected by the methods
selectStudy, selectSeries and selectInstance
-
getInstanceStatus()
- Gets the state of the selected image.
-
getInstanceUID()
- Gets the UID of the selected image.
-
getModality()
- Gets the modality of the selected image.
-
getMonitorCharacteristicsFile()
-
Returns the filename (path) of the monitor characteristics file
used to implement the Barten transform, as configured in section
GENERAL/MONITOR/CHARACTERICSTICS in the config file.
-
getNameOfPhysiciansReadingStudy()
- Returns the name of a physician reading a selected study by "selectStudy".
-
getNetworkAETitle()
-
Returns the AETitle with which this application should identify itself.
-
getNetworkBitPreserving()
-
Returns the BITPRESERVINGMODE entry for the network receiver
from the section GENERAL/NETWORK in the config file.
-
getNetworkDisableNewVRs()
-
Returns the DISABLENEWVRS entry for the network receiver
from the section GENERAL/NETWORK in the config file.
-
getNetworkImplicitVROnly()
- Returns the IMPLICITONLY entry for the network receiver
from the section GENERAL/NETWORK in the config file.
-
getNetworkMaxPDU()
-
Returns the MAXPDU entry for the network receiver
from the section GENERAL/NETWORK in the config file.
-
getNetworkPort()
-
Returns the PORT entry for the network receiver
from the section GENERAL/NETWORK in the config file.
-
getNumberOfInstances()
- Gets the number of images.
-
getNumberOfPStates()
-
Returns number of presentation states referencing the currently selected image.
-
getNumberOfSeries()
- Gets the number of series.
-
getNumberOfStudies()
- Gets the amount of studies.
-
getNumberOfTargets()
- Gets the number of possible targets.
-
getOtherPatientID()
-
Returns the OtherPatientID of a study which is selected by
the method selectStudy
-
getOtherPatientNames()
-
Returns the Other Patient Names of a study which is selected by
the method selectStudy
-
getPStateDescription(int)
-
Returns description of specified presentation state referencing the currently
selected image.
-
getPStateLabel(int)
-
Returns label of specified presentation state referencing the
currently selected image.
-
getPatientBirthDate()
-
Returns the PatientBirthDate of a study which is selected by
the method selectStudy
-
getPatientBirthTime()
-
Returns the PatientBirthTime of a study which is selected by
the method selectStudy
-
getPatientID()
-
Returns the PatientID of a study which is selected by
the method selectStudy
-
getPatientName()
-
Returns the Patient's Name of a study which is selected by
the method selectStudy
-
getPatientSex()
-
Returns the PatientSex of a study which is selected by
the method selectStudy
-
getPresentationDescription()
-
Returns the Presentation Description of the currently selected instance.
-
getPresentationLabel()
-
Returns the Presentation Label of the currently selected instance.
-
getReceiverName()
-
Returns the filename (path) of the DICOM Store SCP application used
for receiving images, as configured in section
GENERAL/NETWORK/RECEIVER in the config file.
-
getReferringPhysiciansName()
- Returns the referring physicians name of a study which is selected by "selectStudy".
-
getSenderName()
-
Returns the filename (path) of the DICOM Store SCU application used
for sending images, as configured in section
GENERAL/NETWORK/SENDER in the config file.
-
getSeriesDate()
- Returns the series date of a series which is selected by "selectSeries".
-
getSeriesDescription()
- Returns the series description of a series which is selected by "selectSeries".
-
getSeriesNumber()
- Returns the series number of a series which is selected by "selectSeries"
-
getSeriesOperatorsName()
- Returns the series operators name of a series which is selected
by "selectSeries".
-
getSeriesPerformingPhysiciansName()
- Returns the series performing physicians name of a series which is selected
by "selectSeries".
-
getSeriesProtocolName()
- Returns the series protocol name of a series which is selected
by "selectSeries".
-
getSeriesStatus()
- Gets the state of the selected series.
-
getSeriesTime()
- Returns the series time of a series which is selected by "selectSeries".
-
getSeriesUID()
- Gets the UID of the selected series.
-
getStudyDate()
- Returns the study date of a study which is selected by "selectStudy".
-
getStudyDescription()
- Gets the desciption of the selected study.
-
getStudyStatus()
- Gets the state of the selected study.
-
getStudyTime()
- Returns the study time of a study which is selected by "selectStudy".
-
getStudyUID()
- Gets the UID of the selected study
-
getTargetAETitle(String)
-
Returns the HOSTNAME entry for the communication partner with the given
target ID from the configuration file.
-
getTargetDescription(int)
- Gets the description of a target at an index.
-
getTargetDescription(String)
- Gets a target description of a target with a known ID.
-
getTargetDisableNewVRs(String)
-
Returns the DISABLENEWVRS entry for the communication partner with the given
target ID from the configuration file.
-
getTargetHostname(String)
-
Returns the HOSTNAME entry for the communication partner with the given
target ID from the configuration file.
-
getTargetID(int)
- Gets a target with at an index.
-
getTargetImplicitOnly(String)
-
Returns the IMPLICITONLY entry for the communication partner with the given
target ID from the configuration file.
-
getTargetMaxPDU(String)
-
Returns the MAXPDU entry for the communication partner with the given
target ID from the configuration file.
-
getTargetPort(String)
-
Returns the PORT entry for the communication partner with the given
target ID from the configuration file.
-
instanceReviewed(String, String, String)
- If the image is reviewed, the state of the database can be changed from "isNew" to
"isNotNew".
-
isBartenTransformPossible()
-
Checks whether Barten correction is possible, i.e.
-
isPresentationState()
- Checks if the image is a PresentationState.
-
isPresentationStateSeries()
- Checks if this Series contains a PresentationState.
-
loadImage(String)
- Loads an image/instance
-
loadImage(String, String, String)
- Loads an image from a series/study
-
loadPState(String, String)
- Loads a PresentationState for an image
-
loadPState(String, String, String)
- Loads a PresentationState for a study/series
-
lockDatabase(boolean)
- Create exclusiv access to the database
-
newInstancesReceived()
-
Tests whether new DICOM objects have been received and
added to the database since the last call to this method.
-
releaseDatabase()
- Releases the database.
-
resetPresentationState()
-
Resets the presentation state object to the status
it had immediately after the last successful operation of "loadImage" or "loadPState".
-
saveCurrentImage(String, boolean)
-
Saves the DICOM image that is currently attached to the presentation state
in a file with the given path and filename.
-
saveDICOMImage(String, byte[], long, long, double)
-
Saves a monochrome bitmap as a DICOM Secondary Capture image.
-
saveDICOMImage(String, byte[], long, long, double, boolean, String)
- saves a monochrome bitmap as a DICOM Secondary Capture image.
-
savePState()
- Saves a PresentationState
-
savePState(String, boolean)
- Saves a PresentationState as...
-
selectInstance(int)
- Selects an image.
-
selectPState(int, boolean)
-
Selects and loads specified presentation state referencing the currently selected
image.
-
selectSeries(int)
- Selects a series.
-
selectStudy(int)
- Select a study.
-
sendIOD(String, String, String, String)
- Sends an IOD to another application or modality
-
sendSeries(String, String, String)
-
Sends a complete series over network to a different DICOM peer.
-
sendStudy(String, String)
-
Sends a complete study over network to a different DICOM peer.
-
setAmbientLightValue(double)
-
Sets ambient light value for the Barten transformation.
-
startReceiver()
-
Starts the network receiver process (Storage Service Class SCP).
-
terminateReceiver()
-
Terminates the network receiver process (Storage Service Class SCP).
jDVInterface
public jDVInterface(String configfile)
- Constructor, creates a relating C++-Object.
- Parameters:
- configfile - s String defining the name of the config file.
deleteInstance
public native int deleteInstance(String studyUID,
String seriesUID,
String instanceUID)
- Removes an image
- Parameters:
- studyUID - UID of Study
- seriesUID - UID of Series
- instanceUID - UID of Image
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
deleteSeries
public native int deleteSeries(String studyUID,
String seriesUID)
- Removes a series.
- Parameters:
- studyUID - UID of study
- seriesUID - UID of series
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
deleteStudy
public native int deleteStudy(String studyUID)
- Removes a study
- Parameters:
- studyUID - UID of Study
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
disablePState
public native int disablePState()
- Stores the current presentation state in a temporary place
and creates a new presentation state that corresponds with an
image displayed "without" presentation state.
If called twice, an error code is returned.
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
enablePState
public native int enablePState()
- Restores the stored presentation state (see disablePresentationState)
and deletes the temporary presentation state.
If no stored presentation state exists, returns an error.
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
finalize
protected void finalize()
- Destructor, removes *this* relating C++-Object out of memory
- Overrides:
- finalize in class Object
getAccessionNumber
public native java.lang.String getAccessionNumber()
- Returns the accession number of a study which is selected by "selectStudy".
- Returns:
- accession number
getAmbientLightValue
public native int getAmbientLightValue(jDoubleByRef value)
- Returns ambient light value for the Barten transformation.
- Parameters:
- value - returned ambient light value. The object of class
jDoubleByRef must be created before passing to this method!
- Returns:
- EC_Normal upon success, an error code otherwise(from jE_Condition).
getCurrentPState
public J2Ci.jDVPresentationState getCurrentPState()
- Gets the current PresentationState-Object
- Returns:
- jDVPresentationState-Object
getDatabaseFolder
public native java.lang.String getDatabaseFolder()
- Returns the database folder to be used for sending/receiving/browsing.
Value is taken from the section GENERAL/DATABASE/DIRECTORY
in the config file. If absent, a default value is returned.
- Returns:
- database folder path. Never returns NULL.
getEthnicGroup
public native java.lang.String getEthnicGroup()
- Returns the PatientEthnicGroup of a study which is selected by
the method selectStudy
getFilename
public native java.lang.String getFilename(String studyUID,
String seriesUID,
String instanceUID)
- Searches in the database for a DICOM instance with the given
study, series and instance UIDs and returns its pathname if found.
If the given instance is not found in the database, NULL is returned.
This method may only be called when the database is locked.
- Parameters:
- studyUID - the DICOM study instance UID
- seriesUID - the DICOM series instance UID
- instanceUID - the DICOM SOP instance UID
- Returns:
- filename (path) if found, NULL otherwise
getGUIConfigEntry
public native java.lang.String getGUIConfigEntry(String key)
- Returns the value of configuration file entry key=value
in the section GENERAL/GUI of the config file.
If the entry is absent, NULL is returned.
- Parameters:
- key - the entry key
- Returns:
- entry value or NULL.
getGUIConfigEntryBool
public native boolean getGUIConfigEntryBool(String key,
boolean dfl)
- Returns the value of configuration file entry key=value
in the section GENERAL/GUI of the config file.
If the entry is absent or cannot be parsed, the default dfl
is returned.
- Parameters:
- key - the entry key
- dfl - the default to be used if the value is absent or incorrect
- Returns:
- entry value or default.
getImageNumber
public native java.lang.String getImageNumber()
- Returns the image number of an instance which is selected by the methods
selectStudy, selectSeries and selectInstance
getInstanceStatus
public native int getInstanceStatus()
- Gets the state of the selected image.
- Returns:
- Value fom jDVIFhierarchyStatus
getInstanceUID
public native java.lang.String getInstanceUID()
- Gets the UID of the selected image.
- Returns:
- UID
getModality
public native java.lang.String getModality()
- Gets the modality of the selected image.
- Returns:
- The modality.
getMonitorCharacteristicsFile
public native java.lang.String getMonitorCharacteristicsFile()
- Returns the filename (path) of the monitor characteristics file
used to implement the Barten transform, as configured in section
GENERAL/MONITOR/CHARACTERICSTICS in the config file.
- Returns:
- monitor characteristics path name or null
getNameOfPhysiciansReadingStudy
public native java.lang.String getNameOfPhysiciansReadingStudy()
- Returns the name of a physician reading a selected study by "selectStudy".
- Returns:
- name of physician
getNetworkAETitle
public native java.lang.String getNetworkAETitle()
- Returns the AETitle with which this application should identify itself.
The AETitle is taken from the section GENERAL/NETWORK in the
config file. If absent, a default value is returned.
- Returns:
- AETitle for this application. Never returns NULL.
getNetworkBitPreserving
public native boolean getNetworkBitPreserving()
- Returns the BITPRESERVINGMODE entry for the network receiver
from the section GENERAL/NETWORK in the config file.
- Returns:
- entry if present in the config file, OFFalse otherwise.
getNetworkDisableNewVRs
public native boolean getNetworkDisableNewVRs()
- Returns the DISABLENEWVRS entry for the network receiver
from the section GENERAL/NETWORK in the config file.
- Returns:
- entry if present in the config file, OFFalse otherwise.
getNetworkImplicitVROnly
public native boolean getNetworkImplicitVROnly()
- Returns the IMPLICITONLY entry for the network receiver
from the section GENERAL/NETWORK in the config file.
- Returns:
- entry if present in the config file, OFFalse otherwise.
getNetworkMaxPDU
public native int getNetworkMaxPDU()
- Returns the MAXPDU entry for the network receiver
from the section GENERAL/NETWORK in the config file.
- Returns:
- entry if present and parsable in the config file, 0 otherwise.
getNetworkPort
public native int getNetworkPort()
- Returns the PORT entry for the network receiver
from the section GENERAL/NETWORK in the config file.
- Returns:
- entry if present and parsable in the config file, 0 otherwise.
getNumberOfInstances
public native int getNumberOfInstances()
- Gets the number of images.
- Returns:
- Number of images.
getNumberOfPStates
public native int getNumberOfPStates()
- Returns number of presentation states referencing the currently selected image.
If no instance is currently selected or the selected instance is a presentation
state, returns an error.
- Returns:
- number of presentation states, 0 if none available or an error occurred
getNumberOfSeries
public native int getNumberOfSeries()
- Gets the number of series.
- Returns:
- Number of series.
getNumberOfStudies
public native int getNumberOfStudies()
- Gets the amount of studies.
- Returns:
- amount of studies.
getNumberOfTargets
public native int getNumberOfTargets()
- Gets the number of possible targets.
- Returns:
- Number of targets.
getOtherPatientID
public native java.lang.String getOtherPatientID()
- Returns the OtherPatientID of a study which is selected by
the method selectStudy
getOtherPatientNames
public native java.lang.String getOtherPatientNames()
- Returns the Other Patient Names of a study which is selected by
the method selectStudy
getPStateDescription
public native java.lang.String getPStateDescription(int idx)
- Returns description of specified presentation state referencing the currently
selected image.
- Parameters:
- idx - index to be selected, must be < getNumberOfPStates()
- Returns:
- presentation state description or NULL if idx is invalid.
getPStateLabel
public native java.lang.String getPStateLabel(int idx)
- Returns label of specified presentation state referencing the
currently selected image.
- Parameters:
- idx - index to be selected, must be < getNumberOfPStates()
- Returns:
- presentation state label or NULL idx is invalid
getPatientBirthDate
public native java.lang.String getPatientBirthDate()
- Returns the PatientBirthDate of a study which is selected by
the method selectStudy
getPatientBirthTime
public native java.lang.String getPatientBirthTime()
- Returns the PatientBirthTime of a study which is selected by
the method selectStudy
getPatientID
public native java.lang.String getPatientID()
- Returns the PatientID of a study which is selected by
the method selectStudy
getPatientName
public native java.lang.String getPatientName()
- Returns the Patient's Name of a study which is selected by
the method selectStudy
getPatientSex
public native java.lang.String getPatientSex()
- Returns the PatientSex of a study which is selected by
the method selectStudy
getPresentationDescription
public native java.lang.String getPresentationDescription()
- Returns the Presentation Description of the currently selected instance.
May be called only if a valid instance selection exists - see selectInstance().
This method acquires a database lock which must be explicitly freed by the user.
- Returns:
- Presentation Description or NULL if absent or not selected.
getPresentationLabel
public native java.lang.String getPresentationLabel()
- Returns the Presentation Label of the currently selected instance.
May be called only if a valid instance selection exists - see
selectInstance().
This method acquires a database lock which must be explicitly
freed by the user.
- Returns:
- Presentation Label or NULL if absent or not selected.
getReceiverName
public native java.lang.String getReceiverName()
- Returns the filename (path) of the DICOM Store SCP application used
for receiving images, as configured in section
GENERAL/NETWORK/RECEIVER in the config file.
- Returns:
- receive application path name or NULL if absent.
getReferringPhysiciansName
public native java.lang.String getReferringPhysiciansName()
- Returns the referring physicians name of a study which is selected by "selectStudy".
- Returns:
- physicians name
getSenderName
public native java.lang.String getSenderName()
- Returns the filename (path) of the DICOM Store SCU application used
for sending images, as configured in section
GENERAL/NETWORK/SENDER in the config file.
- Returns:
- send application path name or NULL if absent.
getSeriesDate
public native java.lang.String getSeriesDate()
- Returns the series date of a series which is selected by "selectSeries".
- Returns:
- series date
getSeriesDescription
public native java.lang.String getSeriesDescription()
- Returns the series description of a series which is selected by "selectSeries".
- Returns:
- series description
getSeriesNumber
public native java.lang.String getSeriesNumber()
- Returns the series number of a series which is selected by "selectSeries"
- Returns:
- series number
getSeriesOperatorsName
public native java.lang.String getSeriesOperatorsName()
- Returns the series operators name of a series which is selected
by "selectSeries".
- Returns:
- operator name
getSeriesPerformingPhysiciansName
public native java.lang.String getSeriesPerformingPhysiciansName()
- Returns the series performing physicians name of a series which is selected
by "selectSeries".
- Returns:
- physician name
getSeriesProtocolName
public native java.lang.String getSeriesProtocolName()
- Returns the series protocol name of a series which is selected
by "selectSeries".
- Returns:
- protocol name
getSeriesStatus
public native int getSeriesStatus()
- Gets the state of the selected series.
- Returns:
- Value from jDVIFhierarchyStatus
getSeriesTime
public native java.lang.String getSeriesTime()
- Returns the series time of a series which is selected by "selectSeries".
- Returns:
- series time
getSeriesUID
public native java.lang.String getSeriesUID()
- Gets the UID of the selected series.
- Returns:
- UID
getStudyDate
public native java.lang.String getStudyDate()
- Returns the study date of a study which is selected by "selectStudy".
- Returns:
- study date
getStudyDescription
public native java.lang.String getStudyDescription()
- Gets the desciption of the selected study.
- Returns:
- Description
getStudyStatus
public native int getStudyStatus()
- Gets the state of the selected study.
- Returns:
- Value (from jDVIFhierarchyStatus).
getStudyTime
public native java.lang.String getStudyTime()
- Returns the study time of a study which is selected by "selectStudy".
- Returns:
- study time
getStudyUID
public native java.lang.String getStudyUID()
- Gets the UID of the selected study
- Returns:
- UID
getTargetAETitle
public native java.lang.String getTargetAETitle(String targetID)
- Returns the HOSTNAME entry for the communication partner with the given
target ID from the configuration file.
- Parameters:
- targetID - communication target ID, must be one of the target
identifiers returned by getTargetID().
- Returns:
- entry if present in the config file, NULL otherwise.
getTargetDescription
public native java.lang.String getTargetDescription(int idx)
- Gets the description of a target at an index.
- Parameters:
- idx - Index of target.
- Returns:
- Target description
getTargetDescription
public native java.lang.String getTargetDescription(String targetID)
- Gets a target description of a target with a known ID.
- Parameters:
- descr - ID of target
- Returns:
- Target description
getTargetDisableNewVRs
public native boolean getTargetDisableNewVRs(String targetID)
- Returns the DISABLENEWVRS entry for the communication partner with the given
target ID from the configuration file.
- Parameters:
- targetID - communication target ID, must be one of the target
identifiers returned by getTargetID().
- Returns:
- entry if present in the config file, OFFalse otherwise.
getTargetHostname
public native java.lang.String getTargetHostname(String targetID)
- Returns the HOSTNAME entry for the communication partner with the given
target ID from the configuration file.
- Parameters:
- targetID - communication target ID, must be one of the target
identifiers returned by getTargetID().
- Returns:
- entry if present in the config file, NULL otherwise.
getTargetID
public native java.lang.String getTargetID(int idx)
- Gets a target with at an index.
- Parameters:
- idx - Index of target
- Returns:
- ID of the target.
getTargetImplicitOnly
public native boolean getTargetImplicitOnly(String targetID)
- Returns the IMPLICITONLY entry for the communication partner with the given
target ID from the configuration file.
- Parameters:
- targetID - communication target ID, must be one of the target
identifiers returned by getTargetID().
- Returns:
- entry if present in the config file, OFFalse otherwise.
getTargetMaxPDU
public native int getTargetMaxPDU(String targetID)
- Returns the MAXPDU entry for the communication partner with the given
target ID from the configuration file.
- Parameters:
- targetID - communication target ID, must be one of the target
identifiers returned by getTargetID().
- Returns:
- entry if present and parsable in the config file, 0.
getTargetPort
public native int getTargetPort(String targetID)
- Returns the PORT entry for the communication partner with the given
target ID from the configuration file.
- Parameters:
- targetID - communication target ID, must be one of the target
identifiers returned by getTargetID().
- Returns:
- entry if present and parsable in the config file, 0.
instanceReviewed
public native int instanceReviewed(String studyUID,
String seriesUID,
String instanceUID)
- If the image is reviewed, the state of the database can be changed from "isNew" to
"isNotNew".
- Parameters:
- studyUID - UID of Study
- seriesUID - UID of Series
- instanceUID - UID of Image
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
isBartenTransformPossible
public native boolean isBartenTransformPossible()
- Checks whether Barten correction is possible, i.e.
a valid monitor characteristics description exists
and current system is a low-cost system (without built-in
calibration).
isPresentationState
public native boolean isPresentationState()
- Checks if the image is a PresentationState.
- Returns:
- true, if yes.
isPresentationStateSeries
public native boolean isPresentationStateSeries()
- Checks if this Series contains a PresentationState.
- Returns:
- true, if yes.
loadImage
public native int loadImage(String filename)
- Loads an image/instance
- Parameters:
- filename - filename of the instance
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
loadImage
public native int loadImage(String studyUID,
String seriesUID,
String instanceUID)
- Loads an image from a series/study
- Parameters:
- studyUID - UID of Study
- seriesUID - UID of Series
- instanceUID - UID of Image
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
loadPState
public native int loadPState(String pstName,
String imgName)
- Loads a PresentationState for an image
- Parameters:
- pstName - Name of PresentationStates
- imgName - Name of Image
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
loadPState
public native int loadPState(String studyUID,
String seriesUID,
String instanceUID)
- Loads a PresentationState for a study/series
- Parameters:
- studyUID - UID of Study
- seriesUID - UID of Series
- instanceUID - UID of Image
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
lockDatabase
public native int lockDatabase(boolean exclusive)
- Create exclusiv access to the database
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
newInstancesReceived
public native boolean newInstancesReceived()
- Tests whether new DICOM objects have been received and
added to the database since the last call to this method.
- Parameters:
- true - if new instances have been received.
releaseDatabase
public native int releaseDatabase()
- Releases the database.
Removes any shared or exclusive lock on the database. This method should be
called when a database transaction is finished (i.e. reading studies, ...).
As long as a lock exists on the db, no other application can add new images
to the db.
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
resetPresentationState
public native int resetPresentationState()
- Resets the presentation state object to the status
it had immediately after the last successful operation of "loadImage" or "loadPState".
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
saveCurrentImage
public native int saveCurrentImage(String filename,
boolean explicitVR)
- Saves the DICOM image that is currently attached to the presentation state
in a file with the given path and filename.
This method does not acquire a database lock and does not register
the saved presentation state in the database.
- Parameters:
- filename - path and filename under which the image is to be saved
- explicitVR - selects the transfer syntax to be written. True (the default) selects
Explicit VR Little Endian, False selects Implicit VR Little Endian.
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
saveDICOMImage
public native int saveDICOMImage(String filename,
byte pixelData,
long width,
long height,
double aspectRatio)
- Saves a monochrome bitmap as a DICOM Secondary Capture image.
The bitmap must use one byte per pixel, left to right, top to bottom
order of the pixels. 0 is interpreted as black, 255 as white.
- Parameters:
- filename - the file name or path under which the image is saved.
- pixelData - a pointer to the image data. Must contain at least
width*height bytes of data.
- width - the width of the image, must be <= 0xFFFF
- height - the height of the image, must be <= 0xFFFF
- aspectRatio - the pixel aspect ratio as width/height. If omitted, a pixel
aspect ratio of 1/1 is assumed (default is 1.0).
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
saveDICOMImage
public native int saveDICOMImage(String filename,
byte pixelData,
long width,
long height,
double aspectRatio,
boolean explicitVR,
String instanceUID)
- saves a monochrome bitmap as a DICOM Secondary Capture image.
The bitmap must use one byte per pixel, left to right, top to bottom
order of the pixels. 0 is interpreted as black, 255 as white.
- Parameters:
- filename - the file name or path under which the image is saved.
- pixelData - a pointer to the image data. Must contain at least
width*height bytes of data.
- width - the width of the image, must be <= 0xFFFF
- height - the height of the image, must be <= 0xFFFF
- aspectRatio - the pixel aspect ratio as width/height. If omitted, a pixel
aspect ratio of 1/1 is assumed.
- explicitVR - selects the transfer syntax to be written.
True selects Explicit VR Little Endian, False selects Implicit VR Little Endian.
- instanceUID - optional parameter containing the SOP Instance UID to be written.
This parameter should be omitted unless the SOP Instance UID needs to be controlled
externally.
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
savePState
public native int savePState()
- Saves a PresentationState
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
savePState
public native int savePState(String filename,
boolean explicitVR)
- Saves a PresentationState as...
- Parameters:
- filename - Filename of PresentationState
- explicitVR - selects the transfer syntax explicit/implicit VR little endian.
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
selectInstance
public native int selectInstance(int idx)
- Selects an image.
- Parameters:
- idx - Index of image.
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
selectPState
public native int selectPState(int idx,
boolean changeStatus)
- Selects and loads specified presentation state referencing the currently selected
image.
- Parameters:
- idx - index to be selected, must be < getNumberOfPStates()
- changeStatus - if true the presentation state is marked 'reviewed' (not new)
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
selectSeries
public native int selectSeries(int idx)
- Selects a series.
- Parameters:
- idx - Index of series
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
selectStudy
public native int selectStudy(int idx)
- Select a study.
- Parameters:
- idx - Index of study
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
sendIOD
public native int sendIOD(String targetID,
String studyUID,
String seriesUID,
String instanceUID)
- Sends an IOD to another application or modality
- Parameters:
- targetID - ID of target
- studyUID - UID of Study
- seriesUID - UID of Series
- instanceUID - UID of Image
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
sendSeries
public native int sendSeries(String targetID,
String studyUID,
String seriesUID)
- Sends a complete series over network to a different DICOM peer.
A separate application or process is launched to handle the send operation.
This call returns when the send operation has successfully been launched.
No information about the status or success of the transfer itself is being made
available.
- Parameters:
- targetID - symbolic identifier of the send target, must be one of the
strings returned by getTargetID().
- studyUID - Study Instance UID of the series to be sent. Must be a series
contained in the database.
- seriesUID - Series Instance UID of the series to be sent. Must be a series
contained in the database.
- Returns:
- EC_Normal when the send process has successfully been launched,
an error condition otherwise (from jE_Condition).
sendStudy
public native int sendStudy(String targetID,
String studyUID)
- Sends a complete study over network to a different DICOM peer.
A separate application or process is launched to handle the send operation.
This call returns when the send operation has successfully been launched.
No information about the status or success of the transfer itself is being made
available.
- Parameters:
- targetID - symbolic identifier of the send target, must be one of the
strings returned by getTargetID().
- studyUID - Study Instance UID of the study to be sent. Must be a study
contained in the database.
- Returns:
- EC_Normal when the send process has successfully been launched,
an error condition otherwise (from jE_Condition).
setAmbientLightValue
public native int setAmbientLightValue(double value)
- Sets ambient light value for the Barten transformation.
- Parameters:
- value - ambient light value to be set
- Returns:
- EC_Normal upon success, an error code otherwise(from jE_Condition).
startReceiver
public native int startReceiver()
- Starts the network receiver process (Storage Service Class SCP).
The receiver process will wait for incoming DICOM associations, receive images
and presentation states. Data will be stored in file and registered in the
database index file. Attention: Successful return of this method is no guarantee
that the network receiver has successfully started, because certain errors
(i.e. incorrect settings in the config file) will only be noted in the network
receiver process when running. On Unix platform, successful return of this method
means that the fork() used to start the receiver was successful.
On Win32 platforms, it means that the CreateProcess() call was successful.
- Returns:
- EC_Normal if the receiver process could be started, an error code
otherwise (from jE_Condition).
terminateReceiver
public native int terminateReceiver()
- Terminates the network receiver process (Storage Service Class SCP).
This method attempts to terminate the network receiver process by
requesting a DICOM association with it and delivering a special "shutdown" command.
If for some reason the network receiver cannot be found (i.e. because it has
terminated abnormally), a TCP/IP timeout (several seconds) may occur before this
method returns.
- Returns:
- EC_Normal upon success, an error code otherwise (from jE_Condition).
All Packages Class Hierarchy This Package Previous Next Index