MeVisLab Scripting Reference
MLABBaseDicomTool Class Referenceabstract

#include <mlabBaseDicomTool.h>

Inherits QObject.

Inherited by MLABFindSCU, and MLABPlainDicomTool.

Public Types

enum  Encoding { QueryEncoding , Latin1 , Utf8 }
 
enum  QueryModel { }
 

Public Slots

virtual void cancel ()=0
 
QStringList getErrorMessages () const
 
bool run ()
 
void setCalledAET (const QString &aet)
 
void setCallingAET (const QString &aet)
 
bool start ()
 
bool wait (unsigned long time=ULONG_MAX)
 

Signals

void finished (bool success)
 

Detailed Description

Base class for all Dicom tools of this script extension.

It implements basic setup and handling of the thread (if used).

Member Enumeration Documentation

◆ Encoding

Character encoding mode to use when querying a PACS.

Enumerator
QueryEncoding 

Do not state a SpecificCharacterSet, but request it per dataset.

Values are transmitted and received Latin1-encoded, but this may generate extra result entries (with key name suffix "_display"), where the specified encoding is applied and differs from the Latin1 encoding.

Latin1 

Values are transmitted and received Latin1-encoded. SpecificCharacterSet is set accordingly.

Utf8 

Values are transmitted and received UTF8-encoded. SpecificCharacterSet is set accordingly.

◆ QueryModel

Query information model.

Enumerator
PatientRoot 

Query from patient root.

StudyRoot 

Query from study root.

PatientStudyOnly 

Retired from standard.

Member Function Documentation

◆ cancel

virtual void MLABBaseDicomTool::cancel ( )
pure virtualslot

Cancel asynchronous execution. Not all derived classes may implement this.

Implemented in MLABFindSCU, and MLABPlainDicomTool.

◆ finished

void MLABBaseDicomTool::finished ( bool success)
signal

emitted when the execution of the tool finishes (also when run synchronously).

◆ getErrorMessages

QStringList MLABBaseDicomTool::getErrorMessages ( ) const
slot

Get error messages of the last execution of this tool.

◆ run

bool MLABBaseDicomTool::run ( )
slot

Run tool (waits until finished), return if execution was successful.

◆ setCalledAET

void MLABBaseDicomTool::setCalledAET ( const QString & aet)
slot

Set AET title of called instance.

◆ setCallingAET

void MLABBaseDicomTool::setCallingAET ( const QString & aet)
slot

Set AET title of calling instance.

◆ start

bool MLABBaseDicomTool::start ( )
slot

Run tool asynchronously. Connect to finished() signal to get notified when execution finishes.

◆ wait

bool MLABBaseDicomTool::wait ( unsigned long time = ULONG_MAX)
slot

Wait for asynchronous execution to finish.

This may also block receiving of results, so it might be better to call run() in the first place.