Wavelet channel class. More...

#include <Subband.h>

Public Member Functions
	CSubband ()
	~CSubband ()
bool	AllocMemory ()
void	FreeMemory ()
void	ExtractTile (CEncoder &encoder, bool tile=false, UINT32 tileX=0, UINT32 tileY=0) THROW_
void	PlaceTile (CDecoder &decoder, int quantParam, bool tile=false, UINT32 tileX=0, UINT32 tileY=0) THROW_
void	Quantize (int quantParam)
void	Dequantize (int quantParam)
void	SetData (UINT32 pos, DataT v)
DataT *	GetBuffer ()
DataT	GetData (UINT32 pos) const
int	GetLevel () const
int	GetHeight () const
int	GetWidth () const
Orientation	GetOrientation () const
Private Member Functions
void	Initialize (UINT32 width, UINT32 height, int level, Orientation orient)
void	WriteBuffer (DataT val)
void	SetBuffer (DataT *b)
DataT	ReadBuffer ()
UINT32	GetBuffPos () const
void	InitBuffPos ()
Private Attributes
UINT32	m_width
	width in pixels
UINT32	m_height
	height in pixels
UINT32	m_size
	size of data buffer m_data
int	m_level
	recursion level
Orientation	m_orientation
	0=LL, 1=HL, 2=LH, 3=HH L=lowpass filtered, H=highpass filterd
UINT32	m_dataPos
	current position in m_data
DataT *	m_data
	buffer
Friends
class	CWaveletTransform

Detailed Description

Wavelet channel class.

PGF wavelet channel subband class.

Author:: C. Stamm, R. Spuler

Definition at line 42 of file Subband.h.

Constructor & Destructor Documentation

CSubband::CSubband ( )

Standard constructor.

Definition at line 35 of file Subband.cpp.

: m_width(0)
, m_height(0)
, m_size(0)
, m_level(0)
, m_orientation(LL)
, m_data(0)
, m_dataPos(0)
#ifdef __PGFROISUPPORT__
, m_nTiles(0)
#endif
{
}

CSubband::~CSubband ( )

Destructor.

Definition at line 51 of file Subband.cpp.

                    {
        FreeMemory();
}

Member Function Documentation

bool CSubband::AllocMemory ( )

Allocate a memory buffer to store all wavelet coefficients of this subband.

Returns:: True if the allocation did work without any problems

Definition at line 77 of file Subband.cpp.

                           {
        UINT32 oldSize = m_size;

#ifdef __PGFROISUPPORT__
        m_size = BufferWidth()*m_ROI.Height();
#endif
        ASSERT(m_size > 0);

        if (m_data) {
                if (oldSize >= m_size) {
                        return true;
                } else {
                        delete[] m_data;
                        m_data = new(std::nothrow) DataT[m_size];
                        return (m_data != 0);
                }
        } else {
                m_data = new(std::nothrow) DataT[m_size];
                return (m_data != 0);
        }
}

void CSubband::Dequantize ( int quantParam )

Perform subband dequantization with given quantization parameter. A scalar quantization (with dead-zone) is used. A large quantization value results in strong quantization and therefore in big quality loss.

Parameters:

quantParam A quantization parameter (larger or equal to 0)

Definition at line 154 of file Subband.cpp.

                                        {
        if (m_orientation == LL) {
                quantParam -= m_level + 1;
        } else if (m_orientation == HH) {
                quantParam -= m_level - 1;
        } else {
                quantParam -= m_level;
        }
        if (quantParam > 0) {
                for (UINT32 i=0; i < m_size; i++) {
                        m_data[i] <<= quantParam;
                }
        }
}

void CSubband::ExtractTile	(	CEncoder &	encoder,
		bool	tile = `false`,
		UINT32	tileX = `0`,
		UINT32	tileY = `0`
	)

Extracts a rectangular subregion of this subband. Write wavelet coefficients into buffer. It might throw an IOException.

Parameters:

encoder	An encoder instance
tile	True if just a rectangular region is extracted, false if the entire subband is extracted.
tileX	Tile index in x-direction
tileY	Tile index in y-direction

Definition at line 177 of file Subband.cpp.

                                                                                                {
#ifdef __PGFROISUPPORT__
        if (tile) {
                // compute tile position and size
                UINT32 xPos, yPos, w, h;
                TilePosition(tileX, tileY, xPos, yPos, w, h);

                // write values into buffer using partitiong scheme
                encoder.Partition(this, w, h, xPos + yPos*m_width, m_width);
        } else 
#endif
        {
                // write values into buffer using partitiong scheme
                encoder.Partition(this, m_width, m_height, 0, m_width);
        }
}

void CSubband::FreeMemory ( )

Delete the memory buffer of this subband.

Definition at line 101 of file Subband.cpp.

                          {
        if (m_data) {
                delete[] m_data; m_data = 0;
        }
}

DataT* CSubband::GetBuffer ( ) [inline]

Get a pointer to an array of all wavelet coefficients of this subband.

Returns:: Pointer to array of wavelet coefficients

Definition at line 106 of file Subband.h.

{ return m_data; }

UINT32 CSubband::GetBuffPos ( ) const [inline, private]

Definition at line 150 of file Subband.h.

{ return m_dataPos; }

DataT CSubband::GetData ( UINT32 pos ) const [inline]

Return wavelet coefficient at given position.

Parameters:

pos	A subband position (>= 0)

Returns:: Wavelet coefficient

Definition at line 112 of file Subband.h.

{ ASSERT(pos < m_size); return m_data[pos]; }

int CSubband::GetHeight ( ) const [inline]

Return height of this subband.

Returns:: Height of this subband (in pixels)

Definition at line 122 of file Subband.h.

{ return m_height; }

int CSubband::GetLevel ( ) const [inline]

Return level of this subband.

Returns:: Level of this subband

Definition at line 117 of file Subband.h.

{ return m_level; }

Orientation CSubband::GetOrientation ( ) const [inline]

Return orientation of this subband. LL LH HL HH

Returns:: Orientation of this subband (LL, HL, LH, HH)

Definition at line 134 of file Subband.h.

{ return m_orientation; }

int CSubband::GetWidth ( ) const [inline]

Return width of this subband.

Returns:: Width of this subband (in pixels)

Definition at line 127 of file Subband.h.

{ return m_width; }

void CSubband::InitBuffPos ( ) [inline, private]

Definition at line 160 of file Subband.h.

{ m_dataPos = 0; }

void CSubband::Initialize	(	UINT32	width,
		UINT32	height,
		int	level,
		Orientation	orient
	)		`[private]`

Definition at line 57 of file Subband.cpp.

                                                                                    {
        m_width = width;
        m_height = height;
        m_size = m_width*m_height;
        m_level = level;
        m_orientation = orient;
        m_data = 0;
        m_dataPos = 0;
#ifdef __PGFROISUPPORT__
        m_ROI.left = 0;
        m_ROI.top = 0;
        m_ROI.right = m_width;
        m_ROI.bottom = m_height;
        m_nTiles = 0;
#endif
}

void CSubband::PlaceTile	(	CDecoder &	decoder,
		int	quantParam,
		bool	tile = `false`,
		UINT32	tileX = `0`,
		UINT32	tileY = `0`
	)

Decoding and dequantization of this subband. It might throw an IOException.

Parameters:

decoder	A decoder instance
quantParam	Dequantization value
tile	True if just a rectangular region is placed, false if the entire subband is placed.
tileX	Tile index in x-direction
tileY	Tile index in y-direction

Definition at line 202 of file Subband.cpp.

                                                                                                              {
        // allocate memory
        if (!AllocMemory()) ReturnWithError(InsufficientMemory);

        // correct quantParam with normalization factor
        if (m_orientation == LL) {
                quantParam -= m_level + 1;
        } else if (m_orientation == HH) {
                quantParam -= m_level - 1;
        } else {
                quantParam -= m_level;
        }
        if (quantParam < 0) quantParam = 0;

#ifdef __PGFROISUPPORT__
        if (tile) {
                UINT32 xPos, yPos, w, h;

                // compute tile position and size
                TilePosition(tileX, tileY, xPos, yPos, w, h);
                
                ASSERT(xPos >= m_ROI.left && yPos >= m_ROI.top);
                decoder.Partition(this, quantParam, w, h, (xPos - m_ROI.left) + (yPos - m_ROI.top)*BufferWidth(), BufferWidth());
        } else 
#endif
        {
                // read values into buffer using partitiong scheme
                decoder.Partition(this, quantParam, m_width, m_height, 0, m_width);
        }
}

void CSubband::Quantize ( int quantParam )

Perform subband quantization with given quantization parameter. A scalar quantization (with dead-zone) is used. A large quantization value results in strong quantization and therefore in big quality loss.

Parameters:

quantParam A quantization parameter (larger or equal to 0)

Definition at line 112 of file Subband.cpp.

                                      {
        if (m_orientation == LL) {
                quantParam -= (m_level + 1);
                // uniform rounding quantization
                if (quantParam > 0) {
                        quantParam--;
                        for (UINT32 i=0; i < m_size; i++) {
                                if (m_data[i] < 0) {
                                        m_data[i] = -(((-m_data[i] >> quantParam) + 1) >> 1);
                                } else {
                                        m_data[i] = ((m_data[i] >> quantParam) + 1) >> 1;
                                }
                        }
                }
        } else {
                if (m_orientation == HH) {
                        quantParam -= (m_level - 1);
                } else {
                        quantParam -= m_level;
                }
                // uniform deadzone quantization
                if (quantParam > 0) {
                        int threshold = ((1 << quantParam) * 7)/5;      // good value
                        quantParam--;
                        for (UINT32 i=0; i < m_size; i++) {
                                if (m_data[i] < -threshold) {
                                        m_data[i] = -(((-m_data[i] >> quantParam) + 1) >> 1);
                                } else if (m_data[i] > threshold) {
                                        m_data[i] = ((m_data[i] >> quantParam) + 1) >> 1;
                                } else {
                                        m_data[i] = 0;
                                }
                        }
                }
        }
}

DataT CSubband::ReadBuffer ( ) [inline, private]

Definition at line 148 of file Subband.h.

{ ASSERT(m_dataPos < m_size); return m_data[m_dataPos++]; }

void CSubband::SetBuffer ( DataT * b ) [inline, private]

Definition at line 147 of file Subband.h.

{ ASSERT(b); m_data = b; }

void CSubband::SetData	(	UINT32	pos,
		DataT	v
	)		`[inline]`

Store wavelet coefficient in subband at given position.

Parameters:

pos	A subband position (>= 0)
v	A wavelet coefficient

Definition at line 101 of file Subband.h.

{ ASSERT(pos < m_size); m_data[pos] = v; }

void CSubband::WriteBuffer ( DataT val ) [inline, private]

Definition at line 146 of file Subband.h.

{ ASSERT(m_dataPos < m_size); m_data[m_dataPos++] = val; }

Friends And Related Function Documentation

friend class CWaveletTransform [friend]

Definition at line 43 of file Subband.h.

Member Data Documentation

DataT* CSubband::m_data [private]

buffer

Definition at line 170 of file Subband.h.

UINT32 CSubband::m_dataPos [private]

current position in m_data

Definition at line 169 of file Subband.h.

UINT32 CSubband::m_height [private]

height in pixels

Definition at line 165 of file Subband.h.

int CSubband::m_level [private]

recursion level

Definition at line 167 of file Subband.h.

Orientation CSubband::m_orientation [private]

0=LL, 1=HL, 2=LH, 3=HH L=lowpass filtered, H=highpass filterd

Definition at line 168 of file Subband.h.

UINT32 CSubband::m_size [private]

size of data buffer m_data

Definition at line 166 of file Subband.h.

UINT32 CSubband::m_width [private]

width in pixels

Definition at line 164 of file Subband.h.

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

Public Member Functions

Private Member Functions

Private Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation