Class for MONOCHROME1 images. More...

Inheritance diagram for DiMono1Image:

Public Member Functions
	DiMono1Image (const DiDocument *docu, const EI_Status status)
	constructor More...

virtual	~DiMono1Image ()
	destructor

virtual EP_Interpretation	getInternalColorModel () const
	get color model of internal pixel representation. More...

virtual const void *	getOutputData (const unsigned long frame, const int bits, const int planar=0)
	get pixel data with specified format. More...

virtual int	getOutputData (void *buffer, const unsigned long size, const unsigned long frame, const int bits, const int planar=0)
	get pixel data with specified format. More...

DiImage *	createImage (const unsigned long fstart, const unsigned long fcount) const
	create copy of current image object More...

DiImage *	createScale (const signed long left_pos, const signed long top_pos, const unsigned long clip_width, const unsigned long clip_height, const unsigned long scale_width, const unsigned long scale_height, const int interpolate, const int aspect, const Uint16 pvalue) const
	create scaled copy of specified (clipping) area of the current image object. More...

DiImage *	createFlip (const int horz, const int vert) const
	create a flipped copy of the current image More...

DiImage *	createRotate (const int degree) const
	create a rotated copy of the current image. More...

DiImage *	createMono (const double dummy1, const double dummy2, const double dummy3) const
	create monochrome copy of the current image. More...

Public Member Functions inherited from DiMonoImage
	DiMonoImage (const DiDocument *docu, const EI_Status status)
	constructor More...

	DiMonoImage (const DiDocument *docu, const EI_Status status, const double slope, const double intercept)
	constructor, rescale More...

	DiMonoImage (const DiDocument docu, const EI_Status status, const DcmUnsignedShort &data, const DcmUnsignedShort &descriptor, const DcmLongString explanation)
	constructor, modality LUT More...

virtual	~DiMonoImage ()
	destructor

virtual int	processNextFrames (const unsigned long fcount)
	process next couple of frames More...

int	getMinMaxValues (double &min, double &max, const int mode) const
	get minimum and maximum pixel values. More...

DiDisplayFunction *	getDisplayFunction () const
	get display function More...

int	setDisplayFunction (DiDisplayFunction *display)
	set display function More...

int	setNoDisplayFunction ()
	set no display function. More...

int	setNoVoiTransformation ()
	unset all VOI transformations (windows and LUTs). More...

int	deleteDisplayLUT (const int bits)
	delete specified display LUT(s) More...

int	isValueUnused (const unsigned long value)
	check whether given output value is unused More...

int	convertPValueToDDL (const Uint16 pvalue, Uint16 &ddl, const int bits)
	convert P-value to DDL. More...

int	setMinMaxWindow (const int idx=1)
	set automatically calculated minimum/maximum window. More...

int	setRoiWindow (const unsigned long left_pos, const unsigned long top_pos, const unsigned long width, const unsigned long height, const unsigned long frame)
	set automatically calculated VOI window for the specified Region of Interest (ROI). More...

int	setHistogramWindow (const double thresh)
	set automatically calculated histogram window. More...

int	setWindow (const unsigned long pos=0)
	set specified window (given by index to window width/center sequence stored in image file). More...

int	setWindow (const double center, const double width, const char *explanation=NULL)
	set specified window (given by window width and center). More...

int	getWindow (double &center, double &width)
	get current window center and width values More...

unsigned long	getWindowCount () const
	get number of VOI windows (stored in image file) More...

EF_VoiLutFunction	getVoiLutFunction () const
	get VOI LUT function. More...

int	setVoiLutFunction (const EF_VoiLutFunction function)
	set VOI LUT function More...

int	setVoiLut (const DcmUnsignedShort &data, const DcmUnsignedShort &descriptor, const DcmLongString *explanation, const EL_BitsPerTableEntry descripMode=ELM_UseValue)
	set VOI LUT (given by dcmdata elements). More...

int	setVoiLut (const unsigned long pos, const EL_BitsPerTableEntry descripMode=ELM_UseValue)
	set VOI LUT (given by index to VOI LUT sequence stored in image file). More...

unsigned long	getVoiLutCount () const
	get number of VOI LUTs (stored in image file) More...

const char *	getVoiTransformationExplanation () const
	get description of active VOI transformation More...

const char *	getVoiWindowExplanation (const unsigned long pos, OFString &explanation) const
	get description of specified VOI window (stored in the image file) More...

const char *	getVoiLutExplanation (const unsigned long pos, OFString &explanation) const
	get description of specified VOI LUT (stored in the image file) More...

const char *	getModalityLutExplanation () const
	get description of performed modality LUT transformation More...

int	setHardcopyParameters (const unsigned int min, const unsigned int max, const unsigned int reflect, const unsigned int illumin)
	set hardcopy parameters. More...

ES_PresentationLut	getPresentationLutShape () const
	get shape for presentation transformation. More...

int	setPresentationLutShape (const ES_PresentationLut shape)
	set shape for presentation transformation. More...

int	setPresentationLut (const DcmUnsignedShort &data, const DcmUnsignedShort &descriptor, const DcmLongString *explanation=NULL, const EL_BitsPerTableEntry descripMode=ELM_UseValue)
	set LUT for presentation transformation. More...

int	setInversePresentationLut (const DcmUnsignedShort &data, const DcmUnsignedShort &descriptor, const EL_BitsPerTableEntry descripMode=ELM_UseValue)
	set inverse LUT for presentation transformation. More...

const char *	getPresentationLutExplanation () const
	get description of active presentation LUT More...

int	addOverlay (const unsigned int group, const signed int left_pos, const signed int top_pos, const unsigned int columns, const unsigned int rows, const DcmOverlayData &data, const DcmLongString &label, const DcmLongString &description, const EM_Overlay mode)
	add specified plane to group of additional overlay planes. More...

int	removeAllOverlays ()
	remove all additional overlay planes More...

DiOverlay *	getOverlayPtr (const unsigned int idx)
	get pointer to specified overlay managing object More...

DiMonoImage *	getMonoImagePtr ()
	get pointer to current monochrome image (this) More...

int	flip (const int horz, const int vert)
	flip current image (horizontally and/or vertically) More...

int	rotate (const int degree)
	rotate current image (by steps of 90 degrees) More...

virtual int	getBits (const int bits=0) const
	get number of bits per sample. More...

virtual unsigned long	getOutputDataSize (const int bits=0) const
	get number of bytes required for the rendered output of a single frame More...

virtual const void *	getOutputData (const unsigned long frame, const int bits, const int planar=0)=0
	get pixel data with specified format. More...

virtual int	getOutputData (void *buffer, const unsigned long size, const unsigned long frame, const int bits, const int planar=0)=0
	get pixel data with specified format. More...

const void *	getOutputPlane (const int dummy) const
	get pixel data of specified plane. More...

void	deleteOutputData ()
	delete internally handled output memory buffer Save memory if data is no longer needed.

const void *	getOverlayData (const unsigned long frame, const unsigned int plane, unsigned int &left_pos, unsigned int &top_pos, unsigned int &width, unsigned int &height, EM_Overlay &mode, const unsigned int idx, const int bits=8, const Uint16 fore=0xff, const Uint16 back=0x0)
	create bitmap for specified overlay plane. More...

const void *	getFullOverlayData (const unsigned long frame, const unsigned int plane, unsigned int &width, unsigned int &height, const unsigned int idx, const int bits=8, const Uint16 fore=0xff, const Uint16 back=0x0)
	create bitmap for specified overlay plane. More...

void	deleteOverlayData ()
	delete buffer for overlay plane data. More...

unsigned long	create6xxx3000OverlayData (Uint8 *&buffer, const unsigned int plane, unsigned int &width, unsigned int &height, unsigned long &frames, const unsigned int idx=0)
	create bitmap for specified overlay plane and store it in (6xxx,3000) format. More...

const DiPixel *	getInterData () const
	get pointer to intermediate pixel data representation More...

const DiMonoPixel *	getMonoInterData () const
	get pointer to intermediate pixel data representation More...

unsigned long	createDIB (void *&data, const unsigned long size, const unsigned long frame, const int bits, const int upsideDown, const int padding=1)
	create true color (24/32 bit) or palette (8 bit) bitmap for MS Windows. More...

unsigned long	createAWTBitmap (void *&data, const unsigned long frame, const int bits)
	create true color (32 bit) or palette (8 bit) bitmap for Java (AWT default format). More...

DiImage *	createOutputImage (const unsigned long frame, const int bits)
	create new single frame DiImage with applied grayscale transformations. More...

int	writeImageToDataset (DcmItem &dataset, const int mode, const int planar)
	write current image and related attributes to DICOM dataset. More...

int	writePPM (STD_NAMESPACE ostream &stream, const unsigned long frame, const int bits)
	write pixel data to PPM file. More...

int	writePPM (FILE *stream, const unsigned long frame, const int bits)
	write pixel data to PPM file. More...

int	writeRawPPM (FILE *stream, const unsigned long frame, const int bits)
	write pixel data to raw PPM file More...

int	writeBMP (FILE *stream, const unsigned long frame, const int bits)
	write pixel data to BMP file More...

Public Member Functions inherited from DiImage
	DiImage (const DiDocument *docu, const EI_Status status, const int spp)
	constructor More...

virtual	~DiImage ()
	destructor

virtual int	processNextFrames (const unsigned long fcount)
	process next couple of frames More...

EI_Status	getStatus () const
	get status of the image object More...

Uint32	getNumberOfFrames () const
	get number of frames More...

Uint32	getFirstFrame () const
	get index of first frame More...

Uint32	getTotalNumberOfFrames () const
	get total number of frames More...

Uint32	getRepresentativeFrame () const
	get representative frame More...

double	getFrameTime () const
	get frame time More...

Uint16	getRows () const
	get number of rows More...

Uint16	getColumns () const
	get number of columns More...

double	getPixelWidth () const
	get pixel's width More...

double	getPixelHeight () const
	get pixel's height More...

double	getRowColumnRatio () const
	get pixel's rows/column ratio More...

double	getColumnRowRatio () const
	get pixel's column/rows ratio More...

int	setRowColumnRatio (const double ratio)
	set pixel's rows/column ratio More...

int	setColumnRowRatio (const double ratio)
	set pixel's column/rows ratio More...

EP_Polarity	getPolarity () const
	get polarity. More...

int	setPolarity (const EP_Polarity polarity)
	set polarity. More...

virtual int	getBits (const int bits=0) const
	get number of bits per sample. More...

virtual EP_Interpretation	getInternalColorModel () const =0
	get color model of internal pixel representation. More...

virtual const DiPixel *	getInterData () const =0
	get access to intermediate pixel data representation (abstract) More...

virtual unsigned long	getOutputDataSize (const int bits=0) const =0
	get number of bytes required for the rendered output of a single frame More...

virtual const void *	getOutputData (const unsigned long frame, const int bits, const int planar)=0
	get pixel data with specified format (abstract). More...

virtual int	getOutputData (void *buffer, const unsigned long size, const unsigned long frame, const int bits, const int planar)=0
	get pixel data with specified format (abstract). More...

virtual const void *	getOutputPlane (const int plane) const =0
	get pixel data of specified plane (abstract). More...

virtual void	deleteOutputData ()=0
	delete internally handled output memory buffer (abstract)

virtual DiOverlay *	getOverlayPtr (const unsigned int)
	get pointer to the object managing the overlay planes More...

virtual DiMonoImage *	getMonoImagePtr ()
	get pointer to monochrome image object More...

virtual DiImage *	createImage (const unsigned long fstart, const unsigned long fcount) const =0
	create copy of current image object (abstract) More...

virtual DiImage *	createScale (const signed long left_pos, const signed long top_pos, const unsigned long clip_width, const unsigned long clip_height, const unsigned long scale_width, const unsigned long scale_height, const int interpolate, const int aspect, const Uint16 pvalue) const =0
	create scaled copy of specified (clipping) area of the current image object (abstract). More...

virtual int	flip (const int horz, const int vert)=0
	flip current image horizontally and/or vertically (abstract) More...

virtual DiImage *	createFlip (const int horz, const int vert) const =0
	create a flipped copy of the current image (abstract). More...

virtual int	rotate (const int degree)
	rotate current image (by steps of 90 degrees) More...

virtual DiImage *	createRotate (const int degree) const =0
	create a rotated copy of the current image (abstract). More...

virtual DiImage *	createMono (const double red, const double green, const double blue) const =0
	create monochrome copy of the current image (abstract). More...

virtual unsigned long	createDIB (void *&data, const unsigned long size, const unsigned long frame, const int bits, const int upsideDown, const int padding=1)=0
	create true color (24/32 bit) or palette (8 bit) bitmap for MS Windows (abstract). More...

virtual unsigned long	createAWTBitmap (void *&data, const unsigned long frame, const int bits)=0
	create true color (32 bit) bitmap for Java AWT (abstract). More...

int	writeFrameToDataset (DcmItem &dataset, const unsigned long frame=0, const int bits=0, const int planar=0)
	render pixel data of given frame and write image related attributes to DICOM dataset. More...

virtual int	writeImageToDataset (DcmItem &dataset, const int mode=0, const int planar=2)=0
	write current image and related attributes to DICOM dataset. More...

virtual int	writePPM (STD_NAMESPACE ostream &stream, const unsigned long frame, const int bits)=0
	write pixel data to PPM file (abstract). More...

virtual int	writePPM (FILE *stream, const unsigned long frame, const int bits)=0
	write pixel data to PPM file (abstract). More...

virtual int	writeRawPPM (FILE *stream, const unsigned long frame, const int bits)=0
	write pixel data to raw PPM file (abstract) More...

virtual int	writeBMP (FILE *stream, const unsigned long frame, const int bits)
	write pixel data to BMP file More...

Protected Member Functions
	DiMono1Image (const DiMonoImage *image, const unsigned long fstart, const unsigned long fcount)
	constructor, copy More...

	DiMono1Image (const DiMonoImage *image, const signed long left_pos, const signed long top_pos, const Uint16 src_cols, const Uint16 src_rows, const Uint16 dest_cols, const Uint16 dest_rows, const int interpolate=0, const int aspect=0, const Uint16 pvalue=0)
	constructor, scale/clip More...

	DiMono1Image (const DiMonoImage *image, const int horz, const int vert)
	constructor, flip More...

	DiMono1Image (const DiMonoImage *image, const int degree)
	constructor, rotate More...

Protected Member Functions inherited from DiMonoImage
	DiMonoImage (const DiDocument *image, const EI_Status status, const char dummy)
	constructor More...

	DiMonoImage (const DiMonoImage *image, const unsigned long fstart, const unsigned long fcount)
	constructor, copy More...

	DiMonoImage (const DiColorImage *image, const double red, const double green, const double blue)
	constructor, convert color images to monochrome More...

	DiMonoImage (const DiMonoImage *image, const signed long left_pos, const signed long top_pos, const Uint16 src_cols, const Uint16 src_rows, const Uint16 dest_cols, const Uint16 dest_rows, const int interpolate, const int aspect, const Uint16 pvalue)
	constructor, scale/clip More...

	DiMonoImage (const DiMonoImage *image, const int horz, const int vert)
	constructor, flip More...

	DiMonoImage (const DiMonoImage *image, const int degree)
	constructor, rotate More...

	DiMonoImage (const DiMonoImage image, DiMonoOutputPixel pixel, const unsigned long frame, const int stored, const int alloc)
	constructor, createMonoOutput More...

void	Init (DiMonoModality *modality, const OFBool reuse=OFFalse)
	initialize internal data structures and member variables More...

void	InitUint8 (DiMonoModality *modality)
	initialize internal data structures (for Uint8) More...

void	InitSint8 (DiMonoModality *modality)
	initialize internal data structures (for Sint8) More...

void	InitUint16 (DiMonoModality *modality)
	initialize internal data structures (for Uint16) More...

void	InitSint16 (DiMonoModality *modality)
	initialize internal data structures (for Sint16) More...

void	InitUint32 (DiMonoModality *modality)
	initialize internal data structures (for Uint32) More...

void	InitSint32 (DiMonoModality *modality)
	initialize internal data structures (for Sint32) More...

int	checkInterData (const int mode=1)
	check intermediate pixel representation for consistency More...

virtual void	updateImagePixelModuleAttributes (DcmItem &dataset)
	update Image Pixel Module attributes in the given dataset. More...

const void *	getData (void *buffer, const unsigned long size, const unsigned long frame, int bits, const int planar, const int negative)
	get pixel data with specified format. More...

void	getDataUint8 (void buffer, DiDisplayFunction disp, const int samples, const unsigned long frame, const int bits, const Uint32 low, const Uint32 high)
	get pixel data with specified format for Uint8 input (helper function). More...

void	getDataSint8 (void buffer, DiDisplayFunction disp, const int samples, const unsigned long frame, const int bits, const Uint32 low, const Uint32 high)
	get pixel data with specified format for Sint8 input (helper function). More...

void	getDataUint16 (void buffer, DiDisplayFunction disp, const int samples, const unsigned long frame, const int bits, const Uint32 low, const Uint32 high)
	get pixel data with specified format for Uint16 input (helper function). More...

void	getDataSint16 (void buffer, DiDisplayFunction disp, const int samples, const unsigned long frame, const int bits, const Uint32 low, const Uint32 high)
	get pixel data with specified format for Sint16 input (helper function). More...

void	getDataUint32 (void buffer, DiDisplayFunction disp, const int samples, const unsigned long frame, const int bits, const Uint32 low, const Uint32 high)
	get pixel data with specified format for Uint32 input (helper function). More...

void	getDataSint32 (void buffer, DiDisplayFunction disp, const int samples, const unsigned long frame, const int bits, const Uint32 low, const Uint32 high)
	get pixel data with specified format for Sint32 input (helper function). More...

int	createLinODPresentationLut (const unsigned long count, const int bits)
	create a presentation look-up table converting the pixel data which is linear to Optical Density to DDLs of the softcopy device (used to display print images on screen). More...

Protected Member Functions inherited from DiImage
	DiImage (const DiDocument *docu, const EI_Status status)
	constructor More...

	DiImage (const DiImage *image, const unsigned long fstart, const unsigned long fcount)
	constructor, copy More...

	DiImage (const DiImage *image, const Uint16 width, const Uint16 height, const int aspect=0)
	constructor, scale/clip More...

	DiImage (const DiImage *image, const int degree=0)
	constructor, rotate More...

	DiImage (const DiImage *image, const unsigned long frame, const int stored, const int alloc)
	constructor, createMonoOutput More...

void	deleteInputData ()
	delete internally handled object for the input pixel data conversion

void	checkPixelExtension ()
	check and possibly correct values for pixel spacing, aspect ratio etc.

void	convertPixelData ()
	create input pixel data representation from DICOM dataset structures

virtual void	updateImagePixelModuleAttributes (DcmItem &dataset)
	update Image Pixel Module attributes in the given dataset. More...

int	detachPixelData ()
	detach pixel data. More...

Additional Inherited Members
Static Public Member Functions inherited from DiMonoImage
static void *	createPackedBitmap (const void *buffer, const unsigned long size, const unsigned long count, const int alloc, const int stored)
	create packed bitmap (e.g. More...

Protected Attributes inherited from DiMonoImage
double	WindowCenter
	center of current VOI-window

double	WindowWidth
	width of current VOI-window

unsigned long	WindowCount
	number of stored VOI-windows

unsigned long	VoiLutCount
	number of stored VOU-LUTs

int	ValidWindow
	true, if current VOI-window is valid

OFString	VoiExplanation
	free text explanation of current VOI transformation

EF_VoiLutFunction	VoiLutFunction
	VOI LUT function (linear or sigmoid)

ES_PresentationLut	PresLutShape
	presentation LUT shape (identity, inverse or lin od)

unsigned int	MinDensity
	minimum density of a print-out (in hundreds of Optical Density)

unsigned int	MaxDensity
	maximum density of a print-out (ditto)

unsigned int	Reflection
	reflected ambient light (in candela per square meter)

unsigned int	Illumination
	illumination (ditto)

DiOverlay *	Overlays [2]
	points to associated overlay-objects ([0] = built-in, [1] = additional)

DiLookupTable *	VoiLutData
	points to associated VOI-LUT-object

DiLookupTable *	PresLutData
	points to associated presentation-LUT-object

DiMonoPixel *	InterData
	points to intermediate pixel data representation (object)

DiDisplayFunction *	DisplayFunction
	points to grayscale standard display function (only referenced!)

Protected Attributes inherited from DiImage
EI_Status	ImageStatus
	copy of status variable declared in class 'DicomImage'

const DiDocument *	Document
	points to special object, which encapsulates the dcmdata module

Uint32	FirstFrame
	first frame to be processed

Uint32	NumberOfFrames
	number of frames in case of multi-frame images (otherwise '1')

Uint32	TotalNumberOfFrames
	total number of frames stored in the dataset

Uint32	RepresentativeFrame
	number of representative frame, type 3 attribute (default '0')

double	FrameTime
	nominal time between individual frames (0 if absent)

Uint16	Rows
	number of rows (in pixel)

Uint16	Columns
	number of columns (in pixel)

double	PixelWidth
	width of each pixel according to 'PixelSpacing/AspectRatio'

double	PixelHeight
	height of each pixel according to 'PixelSpacing/AspectRatio'

Uint16	BitsAllocated
	number of bits allocated for each pixel

Uint16	BitsStored
	number of bits stored for each pixel (see 'BitsPerSample')

Uint16	HighBit
	position of highest stored bit

int	BitsPerSample
	actual number of bits per sample (depth)

int	SamplesPerPixel
	number of samples per pixel (1, 3 or 4)

EP_Polarity	Polarity
	polarity (normal or reverse)

int	hasSignedRepresentation
	is 'true' if pixel data is signed

int	hasPixelSpacing
	is 'true' if attribute 'PixelSpacing' is present

int	hasImagerPixelSpacing
	is 'true' if attribute 'ImagerPixelSpacing' is present

int	hasNominalScannedPixelSpacing
	is 'true' if attribute 'hasNominalScannedPixelSpacing' is present

int	hasPixelAspectRatio
	is 'true' if attribute 'PixelAspectRatio' is present

int	isOriginal
	is 'false' if derived from original image data (e.g. scaled)

DiInputPixel *	InputData
	points to intermediate pixel representation (template object)

DcmFileCache	FileCache
	file cache object used for partial read

Uint32	CurrentFragment
	current pixel item fragment (for encapsulated pixel data)

Detailed Description

Class for MONOCHROME1 images.

Constructor & Destructor Documentation

◆ DiMono1Image() [1/5]

DiMono1Image::DiMono1Image	(	const DiDocument *	docu,
		const EI_Status	status
	)

constructor

Parameters

docu	pointer to dataset (encapsulated)
status	current image status

◆ DiMono1Image() [2/5]

DiMono1Image::DiMono1Image	(	const DiMonoImage *	image,
		const unsigned long	fstart,
		const unsigned long	fcount
	)

protected

constructor, copy

Parameters

image	pointer to reference image
fstart	first frame to be processed
fcount	number of frames

◆ DiMono1Image() [3/5]

DiMono1Image::DiMono1Image	(	const DiMonoImage *	image,
		const signed long	left_pos,
		const signed long	top_pos,
		const Uint16	src_cols,
		const Uint16	src_rows,
		const Uint16	dest_cols,
		const Uint16	dest_rows,
		const int	interpolate = `0`,
		const int	aspect = `0`,
		const Uint16	pvalue = `0`
	)

protected

constructor, scale/clip

Parameters

image	pointer to reference image
left_pos	x coordinate of top left corner of area to be scaled (referring to image origin, negative values create a border around the image)
top_pos	y coordinate of top left corner of area to be scaled
src_cols	width of area to be scaled
src_rows	height of area to be scaled
dest_cols	width of scaled image (in pixels)
dest_rows	height of scaled image (in pixels)
interpolate	specifies whether scaling algorithm should use interpolation (if necessary). default: no interpolation (0), preferred interpolation algorithm (if applicable): 1 = pbmplus algorithm, 2 = c't algorithm, 3 = bilinear magnification, 4 = bicubic magnification
aspect	specifies whether pixel aspect ratio should be taken into consideration (if true, width OR height should be 0, i.e. this component will be calculated automatically)
pvalue	P-value used for the border outside the image (0..65535)

◆ DiMono1Image() [4/5]

DiMono1Image::DiMono1Image	(	const DiMonoImage *	image,
		const int	horz,
		const int	vert
	)

protected

constructor, flip

Parameters

image	pointer to reference image
horz	flip horizontally if true
vert	flip vertically if true

◆ DiMono1Image() [5/5]

DiMono1Image::DiMono1Image	(	const DiMonoImage *	image,
		const int	degree
	)

protected

constructor, rotate

Parameters

image	pointer to reference image
degree	angle by which the image shall be rotated

Member Function Documentation

◆ createFlip()

DiImage * DiMono1Image::createFlip	(	const int	horz,
		const int	vert
	)		const

virtual

create a flipped copy of the current image

Parameters

horz	flip horizontally if true
vert	flip vertically if true

Returns: pointer to new DiImage object (NULL if an error occurred)

Implements DiImage.

◆ createImage()

DiImage * DiMono1Image::createImage	(	const unsigned long	fstart,
		const unsigned long	fcount
	)		const

virtual

create copy of current image object

Parameters

fstart	first frame to be processed
fcount	number of frames

Returns: pointer to new DicomImage object (NULL if an error occurred)

Implements DiImage.

◆ createMono()

DiImage * DiMono1Image::createMono	(	const double	dummy1,
		const double	dummy2,
		const double	dummy3
	)		const

virtual

create monochrome copy of the current image.

Since the image is already monochrome the effect is the same as with createImage().

Parameters

dummy1	not used
dummy2	not used
dummy3	not used

Returns: pointer to new DiImage object (NULL if an error occurred)

Implements DiImage.

◆ createRotate()

DiImage * DiMono1Image::createRotate ( const int degree ) const

virtual

create a rotated copy of the current image.

Parameters

degree angle by which the image shall be rotated

Returns: pointer to new DiImage object (NULL if an error occurred)

Implements DiImage.

◆ createScale()

DiImage * DiMono1Image::createScale	(	const signed long	left_pos,
		const signed long	top_pos,
		const unsigned long	clip_width,
		const unsigned long	clip_height,
		const unsigned long	scale_width,
		const unsigned long	scale_height,
		const int	interpolate,
		const int	aspect,
		const Uint16	pvalue
	)		const

virtual

create scaled copy of specified (clipping) area of the current image object.

Parameters

left_pos	x coordinate of top left corner of area to be scaled (referring to image origin, negative values create a border around the image)
top_pos	y coordinate of top left corner of area to be scaled
clip_width	width of area to be scaled
clip_height	height of area to be scaled
scale_width	width of scaled image (in pixels)
scale_height	height of scaled image (in pixels)
interpolate	specifies whether scaling algorithm should use interpolation (if necessary). default: no interpolation (0), preferred interpolation algorithm (if applicable): 1 = pbmplus algorithm, 2 = c't algorithm, 3 = bilinear magnification, 4 = bicubic magnification
aspect	specifies whether pixel aspect ratio should be taken into consideration (if true, width OR height should be 0, i.e. this component will be calculated automatically)
pvalue	P-value used for the border outside the image (0..65535)

Returns: pointer to new DiImage object (NULL if an error occurred)

Implements DiImage.

◆ getInternalColorModel()

virtual EP_Interpretation DiMono1Image::getInternalColorModel ( ) const

inlinevirtual

get color model of internal pixel representation.

Returns: always returns EPI_Monochrome1

Implements DiImage.

References EPI_Monochrome1.

◆ getOutputData() [1/2]

virtual const void * DiMono1Image::getOutputData	(	const unsigned long	frame,
		const int	bits,
		const int	planar = `0`
	)

virtual

get pixel data with specified format.

(memory is handled internally)

Parameters

frame	number of frame to be rendered
bits	number of bits for the output pixel data (depth)
planar	flags, whether the output data (for multi-planar images) should be planar or not

Returns: untyped pointer to the pixel data if successful, NULL otherwise

Implements DiMonoImage.

◆ getOutputData() [2/2]

virtual int DiMono1Image::getOutputData	(	void *	buffer,
		const unsigned long	size,
		const unsigned long	frame,
		const int	bits,
		const int	planar = `0`
	)

virtual

get pixel data with specified format.

(memory is handled externally)

Parameters

buffer	untyped pointer to the externally allocated memory buffer
size	size of the memory buffer in bytes (will be checked)
frame	number of frame to be rendered
bits	number of bits for the output pixel data (depth)
planar	flags, whether the output data (for multi-planar images) should be planar or not

Returns: status, true if successful, false otherwise

Implements DiMonoImage.

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

dcmimgle/include/dcmtk/dcmimgle/dimo1img.h

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ DiMono1Image() [1/5]

◆ DiMono1Image() [2/5]

◆ DiMono1Image() [3/5]

◆ DiMono1Image() [4/5]

◆ DiMono1Image() [5/5]

Member Function Documentation

◆ createFlip()

◆ createImage()

◆ createMono()

◆ createRotate()

◆ createScale()

◆ getInternalColorModel()

◆ getOutputData() [1/2]

◆ getOutputData() [2/2]