Threaded functional group writer, used to write per-frame functional groups in parallel. More...

Inheritance diagram for FGInterface::ThreadedFGWriter:

Public Member Functions
void	init (OFVector< OFPair< Uint32, FunctionalGroups * > > frameGroups, OFVector< DcmItem > perFrameResultItems, OFMutex perFrameResultItemsMutex, const Uint32 startFrame, const Uint32 endFrame, OFConditionConst errorOccurred, OFMutex errorMutex)
	Initialize the thread. More...

	ThreadedFGWriter ()
	Default constructor.

	~ThreadedFGWriter ()
	Destructor, nothing to do.

void	run ()
	Run method, called by OFThread::start() This method will write the functional groups for the frames assigned to this thread to the output vector. More...

Public Member Functions inherited from OFThread
	OFThread ()
	default constructor. More...

virtual	~OFThread ()
	destructor. More...

int	start ()
	adds a new thread of control to the current process. More...

int	join ()
	blocks the calling thread until the thread referenced by the OFThread object terminates. More...

unsigned long	threadID ()
	returns the thread identifier of the thread referenced by the OFThread object, if the thread has already been started. More...

OFBool	equal (unsigned long tID)
	checks if the given thread ID matches the thread ID of the thread referenced by this object. More...

Public Attributes
OFVector< OFPair< Uint32, FunctionalGroups * > > *	m_frameGroups
	Vector of pairs of frame number and functional groups to write for that frame.

OFVector< DcmItem * > *	m_perFrameResultItems
	Output vector, where the per-frame items are written to (one item per frame containing all functional groups for that frame). More...

OFMutex *	m_perFrameResultItemsMutex
	Mutex to protect the output vector.

Uint32	m_startFrame
	Start frame this thread should handle (inclusive, starts with 0)

Uint32	m_endFrame
	End frame this thread should handle (exclusive, i.e. the last frame this thread handles is m_endFrame - 1)

OFMutex *	m_errorMutex
	Mutex to protect error output.

OFConditionConst *	m_errorOccurred
	Pointer to a condition variable that is set if an error occurs during writing. More...

Additional Inherited Members
Static Public Member Functions inherited from OFThread
static void	errorstr (OFString &description, int code)
	converts any of the error codes returned by the methods of this class into a textual description, which is written into the string object. More...

Static Public Attributes inherited from OFThread
static const int	busy
	this constant is returned by the join() method if another thread is already waiting for termination of the thread referenced by the OFThread object. More...

Static Protected Member Functions inherited from OFThread
static void	thread_exit ()
	terminates the calling thread, in a similar way that exit() terminates the calling process. More...

static unsigned long	self ()
	returns the thread ID of the calling thread. More...

Detailed Description

Threaded functional group writer, used to write per-frame functional groups in parallel.

Each thread gets assigned some frames and writes the functional groups for those frames to the output vector.

Member Function Documentation

◆ init()

void FGInterface::ThreadedFGWriter::init	(	OFVector< OFPair< Uint32, FunctionalGroups * > > *	frameGroups,
		OFVector< DcmItem * > *	perFrameResultItems,
		OFMutex *	perFrameResultItemsMutex,
		const Uint32	startFrame,
		const Uint32	endFrame,
		OFConditionConst *	errorOccurred,
		OFMutex *	errorMutex
	)

Initialize the thread.

Parameters

frameGroups	Input vector of pairs of frame number and functional groups to write for that frame
perFrameResultItems	Output vector, where the per-frame items are written to, (frame number as index, one item per frame containing all functional groups for that frame).
perFrameResultItemsMutex	Mutex to protect the output vector
startFrame	Start frame this thread should handle (inclusive, starts with 0)
endFrame	End frame this thread should handle (exclusive, i.e. the last frame this thread handles is m_endFrame - 1)
errorOccurred	Pointer to a condition variable that is set if an error occurs
errorMutex	Mutex to protect error output

◆ run()

void FGInterface::ThreadedFGWriter::run ( )

virtual

Run method, called by OFThread::start() This method will write the functional groups for the frames assigned to this thread to the output vector.

It will stop in case of an error and set the error condition variable to indicate that an error occurred.

Implements OFThread.

Member Data Documentation

◆ m_errorOccurred

OFConditionConst* FGInterface::ThreadedFGWriter::m_errorOccurred

Pointer to a condition variable that is set if an error occurs during writing.

This is used to signal the main thread that an error occurred during writing. The main thread can then check the error condition variable to see if an error occurred and handle it accordingly.

◆ m_perFrameResultItems

OFVector<DcmItem*>* FGInterface::ThreadedFGWriter::m_perFrameResultItems

Output vector, where the per-frame items are written to (one item per frame containing all functional groups for that frame).

The vector is resized to the total number of frames before starting the threads.

The documentation for this struct was generated from the following file:

dcmfg/include/dcmtk/dcmfg/fginterface.h

Public Member Functions

Public Attributes