BIAS::ImageBase Class Reference
[Image and Image Base]

This is the base class for images in BIAS. More...

#include <Base/Image/ImageBase.hh>

Inheritance diagram for BIAS::ImageBase:

Collaboration diagram for BIAS::ImageBase:

List of all members.

Get functions

BIASImageBase_EXPORT std::ostream & operator<< (std::ostream &os, const ImageBase &img)

BIASImageBase_EXPORT std::istream & operator>> (std::istream &is, ImageBase &img)

bool DimensionMatch (const BIAS::ImageBase &other) const

bool FormatMatch (const BIAS::ImageBase &d) const

unsigned int GetBitDepth () const

returns the bits per channel Is not necessairily 8*sizeof(StorageType), could be fewer bits, eg.

unsigned int GetByteDepth () const

int GetChannel (const ImageBase &source, const unsigned int channel)

copies one specific channel from source to Image can only be called from an planar image, so call ToPlanar() before so far only implemented for CM_YUYV422, BGR and RGB

unsigned int GetChannelCount () const

returns the number of Color channels, e.g.

enum EColorModel GetColorModel () const

unsigned int GetDepth () const

returns the bytes per channel, which is the sizeof(StorageType) Should match GetSizeDepth(GetStorageType()).

unsigned int GetHeight () const

void * GetImageData ()

const void * GetImageData () const

void ** GetImageDataArray () const

Get an array of pointers to image data.

const MetaData * GetMetaData () const

MetaData * GetMetaData ()

unsigned long int GetPixelCount () const

returns number of pixels in image

unsigned int GetPixelPosition (unsigned int x, unsigned int y, unsigned short int channel=0) const

returns the Position (index from array start) in ImageData Warning: until 2005-01-04 the position inbyte was returned but used as position in <StorageType> (ImageDraw).

unsigned int GetSize () const

returns the image size in bytes = count - NOT the dimension DEPRECATED Please use GetSizeByte instead to avoid storage type confusion on pointers and char/wideChar unicode

unsigned int GetSizeByte () const

returns the nr.

enum EStorageType GetStorageType () const

const BIAS::UUID & GetUID () const

returns the UUID of the image

int GetVersionNumber () const

unsigned int GetWidth () const

unsigned int GetWidthStep () const

returns the number of bytes per line

bool IsInterleaved () const

bool IsPlanar () const

void SetMetaData (const MetaData &m)

static void PrintPixelValue (const ImageBase &im, const unsigned int x, const unsigned int y, const unsigned short channel=0, std::ostream &os=std::cout)

Misc functions

void BIASToTextureCoordinates (const double &biasx, const double &biasy, double &gl_x, double &gl_y) const

transfer BIAS image coordinates [0.

void ClearDataPointer ()

set data pointer to NULL, such that image IsEmpty _without_ deletion of data.

int Display () const

display image simple signature interface for Debugger usage This function can be used to display an (intermediate) image "interactively" with the MS Visual Studio Debugger in "Watch+Debug" expert mode.

int Display (const bool &waitForKey, const unsigned int &delayMsec, const float &scale) const

DEPRECATED to avoid interface conflict between char* and bool.

int Display (const std::string &DestWin) const

simpler interface for the above.

int Display (const std::string &DestWin, const bool &autoresize, const bool &moveToTopLeft, const bool &waitForKey, const unsigned int &delayMsec=DEFAULT_Display_delay, const float &scale=DEFAULT_32to8_scale, const bool &allowAlphaWindow=false) const

OpenCV onscreen popup display, very useful for fast debugging. (JW).

bool IsPositionInImage (const int &x, const int &y) const

check if image contains that pixel position

bool IsPowerOfTwoSize () const

int MoveToClosestPositionInImage (int &x, int &y) const

find closest valid pixel position to x,y

bool NotBiggerPixelAndSameChannelCount (const ImageBase &Image) const

checks if data area has bigger or the same "size" as Image of other type

void * PixelValueBase (unsigned x, unsigned y, unsigned channel=0)

bool PowerOfTwoSize (unsigned int &width2, unsigned int &height2) const

void PrintHeader (std::ostream &os=std::cout) const

void RedirectImageDataPointer (void *data)

This method takes data and set the internal image data pointer to this.

void ReleaseImageDataPointer ()

Releases ImageData_ (to be used together with RedirectImageDataPointer).

bool SamePixelAndChannelCount (const ImageBase &Image) const

checks if data area has same "size" as Image of other type

void SetZero ()

zeroes the image

void TextureToBIASCoordinates (const double &gl_x, const double &gl_y, double &biasx, double &biasy) const

transfer GL texture coordinates [0.

static int GetChannelcount (const enum BIAS::ImageBase::EColorModel &colormodel)

get the number of channels corresponding to the enum ColorModel Determines the number of (packed) data values.

static int GetSizeByte (const enum BIAS::ImageBase::EStorageType &storagetype)

get the size in Byte of the type corresponding to a storagetype uses sizeof(type) internally.

static int GetSizeUnits (const enum BIAS::ImageBase::EColorModel &colormodel)

get the number of (packed) data values of color model E.g: CM_Grey : 1 CM_YUYV422 : 2 packs 3 channel YUV into 2 Bytes CM_RGB : 3 CM_BGRA : 4 CM_Bayer_GBRG : 1 packed Bayer pattern CM_PGR_XB3_F7M3_GBRG : 3 packed three Bayer patterns w.

static int GetStorageSizeByte (const unsigned int &width, const unsigned int &height, const unsigned int nChannels, const enum EStorageType storageType)

computes the storage data size in Byte required for a given video format.

static bool IsPowerOfTwoSize (const unsigned int w, const unsigned int h)

static unsigned int PowerOfTwoSize (const unsigned int &val)

static void StringToColorModel (const std::string &str, ImageBase::EColorModel &cm)

static void StringToStorageType (const std::string &str, ImageBase::EStorageType &st)

Public Types

enum EColorModel {
  CM_invalid = -1, CM_Grey, CM_RGB, CM_BGR,
  CM_YUYV422, CM_UYVY422, CM_YUV420P, CM_YUV444,
  CM_YUV411, CM_HSV, CM_HSI_OBS, CM_DV,
  CM_RGBA, CM_GreyA, CM_Bayer_RGGB, CM_Bayer_GBRG,
  CM_Bayer_GRBG, CM_Bayer_BGGR, CM_HSL, CM_hsL,
  CM_SymTensor2x2, CM_BGRA, CM_RGBE, CM_PGR_XB3_F7M3_GBRG,
  CM_DepthAndVariance, CM_YUYV, CM_LUV, CM_XYZ,
  CM_LAB, CM_Disparity, CM_Depth, CM_I1I2I3,
  CM_DOES_NOT_EXIST
}

These are the most often used color models. More...

enum EStorageType {
  ST_invalid = -1, ST_unsignedchar, ST_char, ST_unsignedshortint,
  ST_shortint, ST_unsignedint, ST_int, ST_float,
  ST_double
}

Public Member Functions

void AddDebugLevel (const std::string &name)

void AddDebugLevel (const long int lv)

virtual ImageBase * Clone () const

virtual covariant copy constructor which produces the same type of object as the template object (Image, Camera, .

void CopyIn_NoInit (void *data)

Take some data and fill it into the Image.

bool DebugLevelIsSet (const std::string &name) const

bool DebugLevelIsSet (const long int lv) const

template<class outputType>

void GetChannel (const BIAS::ImageBase &im, const unsigned int channelId, outputType *channelOut)

int GetDebugLevel () const

void GetDebugStream (std::ostream &os) const

std::ostream & GetDebugStream () const

template<class castType>

castType GetValue (const ImageBase &im, const unsigned int x, const unsigned int y, const unsigned int channel)

ImageBase (unsigned int width, unsigned int height, unsigned int channels=1, enum EStorageType storageType=ST_unsignedchar, const bool interleaved=true)

Constructor, initializing image size and channels.

ImageBase (const ImageBase &im)

ImageBase ()

void Init (unsigned int width, unsigned int height, unsigned int nChannels=1, enum EStorageType storageType=ST_unsignedchar, const bool interleaved=true)

Initialize image size and channels.

bool IsEmpty () const

check if ImageData_ points to allocated image buffer or not

long int Name2DebugLevel (const std::string &name) const

looks up a debuglevel in the internal map, returns 0 if not found

long int NewDebugLevel (const std::string &name)

creates a new debuglevel

void PrintDebugLevel (std::ostream &os=std::cout) const

void ReInit (const unsigned int &width, const unsigned int &height, const unsigned int nChannels=1, const enum EStorageType storageType=ST_unsignedchar, const bool interleaved=true, const EColorModel colormodel=CM_Grey)

(Re-)Initialize Image data if required.

void Release (const bool reset_storage_type=false)

Free the allocated data structures Hands off: Do !!NOT!! change the default of reset_storage_type: ImageBase::Release() is also implicitly called for templated images when releasing the storage type here, it becomes possible to assign a float image to an unsigned char image via ImageBase: Image<float> f; Image<unsigned char> uc; ImageBase *ibf = dynamic_cast<ImageBase *>(f); ImageBase *ibuc = dynamic_cast<ImageBase *>(uc); (*ibf) = (*ibuc);.

void RemoveDebugLevel (const std::string &name)

void RemoveDebugLevel (const long int lv)

template<class inputType>

void SetChannel (const BIAS::ImageBase &im, const unsigned int channelId, const inputType *channelIn)

void SetDebugLevel (const std::string &name)

void SetDebugLevel (const long int lv)

void SetDebugStream (const std::ostream &os)

template<class inputType>

void SetValue (const ImageBase &im, const unsigned int x, const unsigned int y, const unsigned int channel, const inputType val)

void ShowDebugLevel (std::ostream &os=std::cout) const

prints all internally known debuglevels

int StealImage (ImageBase &source)

steals the image data array from source, after releasing the actual image data and sets source image data to NULL

virtual ~ImageBase ()

Region of Interest Functions

Important: the ROI has a size of (lrx-ulx)*(lry-uly) that means the lower right point is not part of the ROI!

int Cut2ROI ()

reduces image to current ROI, !!! image size changes !!!

int GetCopyOfROI (ImageBase &copy) const

returns a copy of ROI (a new image) lower right point excluded, only interleaved images !

int GetCopyOfROI2 (ImageBase &copy) const

like GetCopyOfROI, but with lower right point included only interleaved images !

void GetROI (int &UpperLeftX, int &UpperLeftY, int &LowerRightX, int &LowerRightY) const

deprecated, use GetROICorners()

void GetROI (unsigned int &UpperLeftX, unsigned int &UpperLeftY, unsigned int &LowerRightX, unsigned int &LowerRightY) const

deprecated, use GetROICorners()

const ROI * GetROI () const

ROI * GetROI ()

Returns a pointer to the roi object.

void GetROICorners (int &UpperLeftX, int &UpperLeftY, int &LowerRightX, int &LowerRightY) const

access region of interest rectangle JW

void GetROICorners (unsigned int &UpperLeftX, unsigned int &UpperLeftY, unsigned int &LowerRightX, unsigned int &LowerRightY) const

access region of interest rectangle JW

const unsigned int GetROILowerRightX () const

deprecated, use GetROI()->GetCorners()

const unsigned int GetROILowerRightY () const

deprecated, use GetROI()->GetCorners()

const unsigned int GetROIUpperLeftX () const

deprecated, use GetROI()->GetCorners()

const unsigned int GetROIUpperLeftY () const

deprecated, use GetROI()->GetCorners()

const bool IsInROI (const double &x, const double &y) const

int Paste2ROI (const ImageBase &Image)

paste Image to current ROI

void PrintROI (std::ostream &os=std::cout) const

deprecated, use 'os << *GetROI()'

void SetOutsideROIZero ()

sets all pixel not in ROI to zero

int SetROI (const ROI &roi)

int SetROI (unsigned int UpperLeftX, unsigned int UpperLeftY, unsigned int LowerRightX, unsigned int LowerRightY)

deprecated, use SetROICorners()

int SetROICorners (unsigned int UpperLeftX, unsigned int UpperLeftY, unsigned int LowerRightX, unsigned int LowerRightY)

void UnsetROI ()

deprecated, use GetROI()->UnsetROI()

Padding and Appending

int Flip ()

flips the image vertically (row order is inverted) In place function return 0 in case of success, -1 otherwise

int FlipHorizontal ()

flips the image horizontal (column order is inverted) In place function return 0 in case of success, -1 otherwise

int Mirror ()

interface for the above JW

int Pad (const unsigned int &newwidth, const unsigned int &newheight, const int &padVal=0)

int Pad (BIAS::ImageBase &dest, const unsigned int &newwidth, const unsigned int &newheight, const int &padVal=0) const

int PadToPowerOfTwo (const int &padVal=0)

in place version of the above

int PadToPowerOfTwo (BIAS::ImageBase &dest, const int &padVal=0) const

increase the size of this image to next power of two (e.g.

int PadToPowerOfTwoAndFlip (const int &padVal=0)

first pad, then flip.

int ZeroPad (const unsigned int newwidth, const unsigned int newheight, unsigned char bgcolor=0)

backward compatibility interface for Pad.

Set functions

void InvalidateUID ()

sets the image's uid to invalid

void SetBitDepth (unsigned bitdepth)

needed by ImageIO

void SetColorModel (EColorModel Model)

void SetInterleaved (bool interleaved)

void SetUID (const BIAS::UUID &id)

Operators

ImageBase & operator= (const ImageBase &Source)

assignment operator, allocates memory structure via Init only if necessary

bool operator== (const ImageBase &img) const

comparison operator, based upon the adresses of the actual image data

Static Public Member Functions

static void GetChannel (const ImageBase &im, const unsigned int channelId, half *channelOut)

template<class outputType>

static void GetChannel (const ImageBase &im, const unsigned int channelId, outputType *channelOut)

Copy channel, determines the internal ImageBase type and casts it to the output type.

static long int GetGlobalDebugLevel ()

template<class castType>

static castType GetValue (const ImageBase &im, const unsigned int x, const unsigned int y, const unsigned int channel=0)

Determines the internale ImageBase type and casts it to the output type.

template<class inputType>

static void SetChannel (const ImageBase &im, const unsigned int channelId, const inputType *channelIn)

Copy channel, determines the internal ImageBase type and casts the input type to the type foreseen in im.

static void SetGlobalDebugLevel (long int lev)

template<class inputType>

static void SetValue (const ImageBase &im, const unsigned int x, const unsigned int y, const unsigned int channel, const inputType val)

Determines the internal ImageBase type and casts the input type to the type foreseen in im.

Protected Member Functions

long ConsumeNextFreeDebuglevel_ ()

returns the next available debuglevel

void SetStorageType (const EStorageType st)

changes StorageType data mmeber

int UpdateImageDataArrayFromImageData_ ()

recomputes pointer array returned by GetImageDataArray

Protected Attributes

long int _liDebugLevel

long int _liNextDebugLevel

new concept, debuglevel are managed here in the debug class

MetaData _MetaData

additional data block, handled by derived classes

std::map< std::string, long int > _String2Debuglevel

BIAS::UUID _UID

unique id for every image

unsigned int BitDepth_

relevant bits per pixel per channel

unsigned int ChannelCount_

number of channels per pixel

enum EColorModel ColorModel_

the color model of the pixels

unsigned int Depth_

size of one channel of one pixel in bytes

unsigned int Height_

image height in pixels

void * ImageData_

a pointer to the image data

void ** ImageDataArray_

array of pointers to the first byte in an image row

bool InterleavedDataOrder_

planar or interleaved: planar means we have several image planes, e.g.

ROI Roi_

roi object

enum EStorageType StorageType_

the storage type in a pixel channel

unsigned int Width_

image width in pixels

unsigned int WidthStep_

size of a line in bytes for interleaved, NOT nr . of pixels (but size a line in one plane for planar)

Static Protected Attributes

static std::ostream _zDebugStream

static long int GlobalDebugLevel = 0

static const int Version_ = VERSION_NUMBER

version number of imagebase class

Friends

class ImageConvert

class ImageIO

class WrapBias2Ipl

Detailed Description

This is the base class for images in BIAS.

It is a non template class, so you can write image type independet functions. Use this class if you deal with different storage types or you don't know the storage type, eg. when loading an image from disk.

Examples:: EvaluateAlignment.cpp, ExampleAlignment.cpp, ExampleBilateral.cpp, ExampleBlobDetectorLevelSet.cpp, ExampleCannyEdge.cpp, ExampleConvert.cpp, ExampleCornerDetector.cpp, ExampleDeInterlace2.cpp, ExampleDynamicCastImage.cpp, ExampleEmpty.cpp, ExampleHSVConversion2.cpp, ExampleImageLoad.cpp, ExampleImageWinApi.cpp, ExampleMedian.cpp, ExampleMedian3x3x3.cpp, ExampleProjectionParametersPerspective.cpp, ExampleTracker.cpp, ExampleTrackerBase.cpp, ExampleTrackerBaseInterface.cpp, TestPyramidImage.cpp, and viff2mip.cpp.

Definition at line 102 of file ImageBase.hh.

Member Enumeration Documentation

enum BIAS::ImageBase::EColorModel

These are the most often used color models.

Determines the data storage size per channel per pixel.

Enumerator:

CM_invalid	invalid (not set) image format
CM_Grey	gray values, 1 channel
CM_RGB	color values, 3 channels, order: red,green,blue
CM_BGR	color values, 3 channels, order: blue,green,red
CM_YUYV422	YUYV422, 2 channels, full luminance Y, subsampled half U,V.
CM_UYVY422	UYVY422, 2 channels, full luminance Y, subsampled half U,V inverse order.
CM_YUV420P	YUV420P, 2 channels, full luminance Y, 1 U, 1 V. Y, U and V are grouped together for better compression.
CM_YUV444	CM_YUV444, 3 channels, all channels have full data.
CM_YUV411	YUV411, 2 channles, full luminance, 1 U, 1 V.
CM_HSV	HSV, 3 channels, order: hue, sat , value.
CM_HSI_OBS	obsolete, HSI is unused and identical to HSL
CM_DV	DV, color model used for digital video cameras such as Mini-DV.
CM_RGBA	RGBA, 4 channels, order: red,green,blue,alpha.
CM_GreyA	GreyA, 2 channels, grey plus Alpha.
CM_Bayer_RGGB	Bayer_RGGB, 1 channel RGB image Bayer tile.
CM_Bayer_GBRG	Bayer_GBRG, 1 channel RGB image Bayer tile.
CM_Bayer_GRBG	Bayer_GRBG, 1 channel RGB image Bayer tile.
CM_Bayer_BGGR	Bayer_BGGR, 1 channel RGB image Bayer tile.
CM_HSL	HSL, similar to HSV but space is a double tipped cone.
CM_hsL	hsl, similar to HSL but euclidean (h,s) for CNCC
CM_SymTensor2x2	SymTensor2x2 The image contains a 2x2 symmetric tensor.
CM_BGRA	BGRA color values, 4 channels, order: blue,green,red,alpha.
CM_RGBE	RGBE color values, 4 channels, RADIANCE hdr format, four low dynamic channels meaning: 3x mantissa (red,green,blue) +1x (exponent).
CM_PGR_XB3_F7M3_GBRG	PGR XB3 in format 7 mode 3 delivers an image that consists of 3 channels with 8bbp (overal 24bpp), each channel codes an whole color image in GBRG bayer pattern, ch0 = left image, ch1 = right image, ch3 = center image.
CM_DepthAndVariance	Todo: Unclear, I think one channel float, why isn't grey used for that?
CM_YUYV	Todo: Conflict with YUVU model, what does it do?
CM_LUV	CIELUV color space, 3 channels, http://en.wikipedia.org/wiki/CIELUV_color_space.
CM_XYZ	XYZ, 3 channels, http://en.wikipedia.org/wiki/Xyz_color_space.
CM_LAB	LAB, 3 channels, http://en.wikipedia.org/wiki/Lab_color_space.
CM_Disparity	Disparity images Q: should disp and depth be treated separately, if not what would be a good name to cover both?
CM_Depth	Depth images A: separated for now.
CM_I1I2I3	Othe's principle component generalization for RGB based segmentation.
CM_DOES_NOT_EXIST

Definition at line 127 of file ImageBase.hh.

enum BIAS::ImageBase::EStorageType

Enumerator:

ST_invalid	invalid not set image storage type
ST_unsignedchar	(8bit) unsigned char image storage type
ST_char	(8bit) signed char image storage type
ST_unsignedshortint	(16bit) unsigned integer image storage type
ST_shortint	(16bit) signed integer image storage type
ST_unsignedint	(32bit) unsigned integer image storage type
ST_int	(32bit) signed integer image storage type
ST_float	float image storage type
ST_double	double image storage type

Definition at line 109 of file ImageBase.hh.

Constructor & Destructor Documentation

ImageBase::ImageBase ( )

Definition at line 55 of file ImageBase.cpp.

References _MetaData, _UID, BitDepth_, ChannelCount_, CM_invalid, ColorModel_, Depth_, Height_, ImageData_, ImageDataArray_, InterleavedDataOrder_, ST_invalid, StorageType_, Width_, and WidthStep_.

Referenced by Pad(), and PadToPowerOfTwo().

ImageBase::~ImageBase ( ) [virtual]

Definition at line 41 of file ImageBase.cpp.

References ImageData_, and ImageDataArray_.

ImageBase::ImageBase ( const ImageBase & im )

Definition at line 76 of file ImageBase.cpp.

References ChannelCount_, Height_, ImageData_, ImageDataArray_, ST_invalid, StorageType_, and Width_.

ImageBase::ImageBase	(	unsigned int	width,
		unsigned int	height,
		unsigned int	channels = `1`,
		enum EStorageType	storageType = `ST_unsignedchar`,
		const bool	interleaved = `true`
	)

Constructor, initializing image size and channels.

Author:: Felix Woelk tested

Parameters:

	width	image width of the new image
	height	image height of the new image
	channels	number of color planes

Note:

Example: Defining an RGB image.

        ImageBase im;
        im.init(width, height, 3);

Definition at line 92 of file ImageBase.cpp.

References CM_invalid, ColorModel_, ImageData_, ImageDataArray_, Init(), InterleavedDataOrder_, BIAS::ROI::Resize(), Roi_, and BIAS::ROI::UnsetROI().

Member Function Documentation

void BIAS::Debug::AddDebugLevel ( const std::string & name ) [inline, inherited]

Definition at line 363 of file Debug.hh.

void BIAS::Debug::AddDebugLevel ( const long int lv ) [inline, inherited]

Reimplemented in BIAS::GLProjectionParametersBase.

Examples:: EvaluateAlignment.cpp, ExampleAlignment.cpp, ExampleDebug.cpp, ExampleRANSAC.cpp, ExampleRANSACPlane.cpp, ExampleTriangulateOptimal.cpp, and TestGuiEnhanced.cpp.

Definition at line 356 of file Debug.hh.

Referenced by BIAS::GLProjectionParametersBase::AddDebugLevel(), BIAS::Triangulation::CorrectCorrespondences(), BIAS::FilterBase< InputStorageType, OutputStorageType >::FilterBase(), BIAS::RANSAC< SolutionType >::RANSAC(), and BIAS::SceneOpenSceneGraph::SceneOpenSceneGraph().

void BIAS::ImageBase::BIASToTextureCoordinates	(	const double &	biasx,
		const double &	biasy,
		double &	gl_x,
		double &	gl_y
	)			const `[inline]`

transfer BIAS image coordinates [0.

.w-1] x [0..h-1] to GL texture coordinates [0..1[ x [0..1[

GL coordinates are relative to image size of *this (must be valid) !

Please note that this is only one of many possible bias to gl coord transformations which may be particularly different for pow2, non-pow2, rectangle, padded, scaled, bordered, offset etc. OpenGL textures.

BIASASSERT(Equal(biasx, biasx2)); BIASASSERT(Equal(biasy, biasy2));

Definition at line 1222 of file ImageBase.hh.

Referenced by BIAS::BackwardMapping< InputStorageType, OutputStorageType >::GetDisplacementMap().

void BIAS::ImageBase::ClearDataPointer ( ) [inline]

set data pointer to NULL, such that image IsEmpty _without_ deletion of data.

Author:: evers

Definition at line 851 of file ImageBase.hh.

Referenced by BIAS::VideoSource_DCAM::GrabSingleAndConvertForGrey().

virtual ImageBase* BIAS::ImageBase::Clone ( ) const [inline, virtual]

virtual covariant copy constructor which produces the same type of object as the template object (Image, Camera, .

..). Must be implemented in all derived classes and since some people do work with ImageBase objects, it is also implemented there. The caller is responsible to delete the clone.

Author:: koeser 06/2006

Reimplemented in BIAS::Image< StorageType >, BIAS::Camera< StorageType >, BIAS::CorrespondenceMap< StorageType >, BIAS::Image< InputST >, BIAS::Image< InputStorageType >, BIAS::Image< LABEL_CALC_TYPE >, BIAS::Image< float >, BIAS::Image< CONV_FLOAT >, BIAS::Image< unsigned char >, BIAS::Image< OutputStorageType >, BIAS::Image< CONV_INT >, BIAS::Image< CalculationType >, BIAS::Image< OutputST >, BIAS::Camera< InputStorageType >, BIAS::Camera< float >, and BIAS::Camera< unsigned char >.

Definition at line 193 of file ImageBase.hh.

long BIAS::Debug::ConsumeNextFreeDebuglevel_ ( ) [inline, protected, inherited]

returns the next available debuglevel

Author:: woelk 09/2006

Definition at line 522 of file Debug.hh.

void ImageBase::CopyIn_NoInit ( void * data )

Take some data and fill it into the Image.

Warning:: Image must be initialized already !

Author:: Evers

Examples:: ExampleMixtureOfGaussians.cpp.

Definition at line 745 of file ImageBase.cpp.

References GetChannelCount(), GetDepth(), GetImageData(), and GetPixelCount().

Referenced by BIAS::WrapBias2Ipl::CreateBiasImageCopy(), BIAS::BlobDetectorBFS< StorageType >::Detect(), BIAS::ExampleMixtureOfGaussiansFrame::grabImages_(), BIAS::VideoSource_DCAM::GrabSingle(), BIAS::VideoSource_uEye::GrabSingle(), BIAS::VideoSource_Net::GrabSingle(), BIAS::VideoSource_V4L::GrabSingle(), BIAS::VideoSource_DSHOW::GrabSingle(), BIAS::VideoSource_DCAM::GrabSingleAndConvert(), BIAS::ImageIO::ImportRAWwithHeader(), BIAS::ExampleMixtureOfGaussiansFrame::processImages_(), and BIAS::MixtureOfGaussians< StorageType >::Update_().

int ImageBase::Cut2ROI ( )

reduces image to current ROI, !!! image size changes !!!

Author:: Felix Woelk untested

Todo:: Make it work on colored Images

Definition at line 564 of file ImageBase.cpp.

References ChannelCount_, Depth_, GetChannelCount(), BIAS::ROI::GetCorners(), GetDepth(), GetHeight(), GetImageDataArray(), GetROI(), GetWidth(), Height_, RedirectImageDataPointer(), ReleaseImageDataPointer(), BIAS::ROI::Resize(), UnsetROI(), Width_, and WidthStep_.

Referenced by BIAS::Dilation< InputStorageType, OutputStorageType >::Filter(), and BIAS::Erosion< InputStorageType, OutputStorageType >::Filter().

bool BIAS::Debug::DebugLevelIsSet ( const std::string & name ) const [inline, inherited]

Definition at line 351 of file Debug.hh.

bool BIAS::Debug::DebugLevelIsSet ( const long int lv ) const [inline, inherited]

Examples:: ExampleTriangulateOptimal.cpp.

Definition at line 342 of file Debug.hh.

bool ImageBase::DimensionMatch ( const BIAS::ImageBase & other ) const

Returns:: true if the image dimension w x h of this and other match = are equal, values of descriptions Fit.

Author:: JW

Definition at line 903 of file ImageBase.cpp.

References GetHeight(), and GetWidth().

Referenced by FormatMatch().

int ImageBase::Display ( ) const

display image simple signature interface for Debugger usage This function can be used to display an (intermediate) image "interactively" with the MS Visual Studio Debugger in "Watch+Debug" expert mode.

This signature is required because MSVS debugger does not support default params.

Author:: Jan Woetzel

Definition at line 1381 of file ImageBase.cpp.

Referenced by Display().

int ImageBase::Display	(	const bool &	waitForKey,
		const unsigned int &	delayMsec,
		const float &	scale
	)			const

DEPRECATED to avoid interface conflict between char* and bool.

interface for the above

Author:: Jan Woetzel 2005

Definition at line 1370 of file ImageBase.cpp.

References Display().

int ImageBase::Display ( const std::string & DestWin ) const

simpler interface for the above.

shows image in window named "DestWin" without. Does not wait for key, you may want to use WrapBias2Ipl::WaitKey after calling this.

Definition at line 1358 of file ImageBase.cpp.

References Display().

int ImageBase::Display	(	const std::string &	DestWin,
		const bool &	autoresize,
		const bool &	moveToTopLeft,
		const bool &	waitForKey,
		const unsigned int &	delayMsec = `DEFAULT_Display_delay`,
		const float &	scale = `DEFAULT_32to8_scale`,
		const bool &	allowAlphaWindow = `false`
	)			const

OpenCV onscreen popup display, very useful for fast debugging. (JW).

display image as popup to screnn sing OpenCv IplImage using Highgui functions. Very useful to easily display an image, e.g. for debugging. Can be used inside MSVS debugger watch to inspect intermediate Images wit a popup. Can be used with waiting for user interaction (for delayMsec).

Returns:: positive nr. of pressed key or negative if no key pressed or error occured.

Parameters:

	waitForKey	if true delayMsec is waited for keypres. 0=forever.
	delayMsec	if waitForKey is true wait for key with 0=forever, see cvWaitkey.

Returns:: pressed key (if any)

Author:: Jan Woetzel 2005

Examples:: ExampleImageWinApi.cpp.

Definition at line 1332 of file ImageBase.cpp.

References BIAS::WrapBias2Ipl::Display().

int ImageBase::Flip ( )

flips the image vertically (row order is inverted) In place function return 0 in case of success, -1 otherwise

Author:: Daniel Grest

Date:: Jun 2002 Interleaved tested, planar untested Aug 2002: Jan-Friso Evers: fixed interleaved for float and other

Definition at line 752 of file ImageBase.cpp.

References GetChannelCount(), GetDepth(), GetPixelCount(), GetWidth(), Height_, ImageDataArray_, InterleavedDataOrder_, RedirectImageDataPointer(), and ReleaseImageDataPointer().

Referenced by BIAS::ImgObjGL::CreateGLTexture(), BIAS::GLProjectionParametersBase::GetGreyImage(), BIAS::GLProjectionParametersBase::GetImage(), BIAS::VideoSource_DSHOW::GrabSingle(), BIAS::ThreeDOut::OpenGLOutIndexedFaceSets(), BIAS::OpenSceneGraphHelper::OSGimageToBIASimage(), PadToPowerOfTwoAndFlip(), BIAS::OpenGLCanvasBase::ScreenShot(), BIAS::GLProjectionParametersBase::TranslateDepthToZ(), BIAS::GLProjectionParametersBase::TranslateZToDepth(), and BIAS::GLProjectionParametersBase::TranslateZToMetricZ().

int ImageBase::FlipHorizontal ( )

flips the image horizontal (column order is inverted) In place function return 0 in case of success, -1 otherwise

Author:: woelk 10/2004

Definition at line 796 of file ImageBase.cpp.

References GetChannelCount(), GetDepth(), GetPixelCount(), Height_, ImageDataArray_, InterleavedDataOrder_, RedirectImageDataPointer(), ReleaseImageDataPointer(), Width_, and WidthStep_.

Referenced by BIAS::ImageConvert::BayerToRGB().

bool ImageBase::FormatMatch ( const BIAS::ImageBase & d ) const

Returns:: true if (all) format descriptions between this and dest image match/fit are equal.

Author:: JW

Definition at line 910 of file ImageBase.cpp.

References DimensionMatch(), GetBitDepth(), GetChannelCount(), GetColorModel(), GetDepth(), GetHeight(), GetSizeByte(), GetWidth(), and GetWidthStep().

unsigned int BIAS::ImageBase::GetBitDepth ( ) const [inline]

returns the bits per channel Is not necessairily 8*sizeof(StorageType), could be fewer bits, eg.

12/16.

Author:: woelk 12/2004

Examples:: ExampleImageLoad.cpp.

Definition at line 324 of file ImageBase.hh.

Referenced by BIAS::BVWXMainFrame::AddInfo(), BIAS::MainFrame::AddInfo(), BIAS::ImageConvert::BayerToRGB(), BIAS::DeMosaicing< StorageType >::DeMosaic(), FormatMatch(), BIAS::ImgObjGL::GetGLInternalFormat(), BIAS::ImageIO::ImportDevIL(), operator=(), Pad(), StealImage(), BIAS::ImageConvert::TohsL(), and BIAS::ImageConvert::ToHSL().

unsigned int BIAS::ImageBase::GetByteDepth ( ) const [inline]

Definition at line 314 of file ImageBase.hh.

template<class outputType>

void BIAS::ImageBase::GetChannel	(	const BIAS::ImageBase &	im,
		const unsigned int	channelId,
		outputType *	channelOut
	)			`[inline]`

Definition at line 448 of file ImageBaseInline.hh.

References GetChannelCount(), GetHeight(), GetImageDataArray(), GetStorageType(), GetWidth(), IsInterleaved(), ST_char, ST_double, ST_float, ST_int, ST_shortint, ST_unsignedchar, ST_unsignedint, and ST_unsignedshortint.

void BIAS::ImageBase::GetChannel	(	const ImageBase &	im,
		const unsigned int	channelId,
		half *	channelOut
	)			`[static]`

Definition at line 1925 of file ImageBase.cpp.

References GetChannelCount(), GetHeight(), GetImageDataArray(), GetStorageType(), GetWidth(), IsInterleaved(), ST_char, ST_double, ST_float, ST_int, ST_shortint, ST_unsignedchar, ST_unsignedint, and ST_unsignedshortint.

template<class outputType>

void BIAS::ImageBase::GetChannel	(	const ImageBase &	im,
		const unsigned int	channelId,
		outputType *	channelOut
	)			`[inline, static]`

Copy channel, determines the internal ImageBase type and casts it to the output type.

Attention:: im and channel both have to be initialized and of compatible size! Only for interleaved images.

Definition at line 1530 of file ImageBase.hh.

int ImageBase::GetChannel	(	const ImageBase &	source,
		const unsigned int	channel
	)

copies one specific channel from source to Image can only be called from an planar image, so call ToPlanar() before so far only implemented for CM_YUYV422, BGR and RGB

Author:: Felix Woelk untested (17/04/2002)

Definition at line 352 of file ImageBase.cpp.

References CM_YUYV422, GetChannelCount(), GetColorModel(), GetDepth(), GetHeight(), GetImageData(), GetPixelCount(), GetStorageType(), GetWidth(), Init(), IsEmpty(), and IsPlanar().

Referenced by BIAS::OpenEXRInterface::AddSlice_(), BIAS::Median< InputStorageType, OutputStorageType >::Filter3x3x3Color(), BIAS::Median< InputStorageType, OutputStorageType >::FilterColorImg(), BIAS::DeInterlace< InputStorageType, OutputStorageType >::FilterColorImg(), BIAS::Bilateral< InputStorageType, OutputStorageType >::FilterColorImg(), and BIAS::ImageConvert::RGBToXYZ().

int ImageBase::GetChannelcount ( const enum BIAS::ImageBase::EColorModel & colormodel ) [static]

get the number of channels corresponding to the enum ColorModel Determines the number of (packed) data values.

Is typically consistent with GetSizeByte. E.g. CM_Grey : 1 CM_YUYV422 : packs 3 channel YUV into 2 Bytes CM_RGB : 3 CM_BGRA : 4 CM_Bayer_GBRG : 1 packs 3 channel RGB into 1 Byte Bayer pattern

Author:: Jan Woetzel

Definition at line 1284 of file ImageBase.cpp.

References CM_Bayer_BGGR, CM_Bayer_GBRG, CM_Bayer_GRBG, CM_Bayer_RGGB, CM_BGR, CM_BGRA, CM_Grey, CM_GreyA, CM_hsL, CM_HSL, CM_HSV, CM_PGR_XB3_F7M3_GBRG, CM_RGB, and CM_RGBA.

unsigned int BIAS::ImageBase::GetChannelCount ( ) const [inline]

returns the number of Color channels, e.g.

RGB 3

the value returned is independent of the StorageType

Examples:: ExampleImageLoad.cpp, and ExampleProjectionParametersPerspective.cpp.

Definition at line 362 of file ImageBase.hh.

enum EColorModel BIAS::ImageBase::GetColorModel ( ) const [inline]

Examples:: ExampleMixtureOfGaussians.cpp.

Definition at line 387 of file ImageBase.hh.

int ImageBase::GetCopyOfROI ( ImageBase & copy ) const

returns a copy of ROI (a new image) lower right point excluded, only interleaved images !

Author:: Felix Woelk, grest untested

Definition at line 492 of file ImageBase.cpp.

References GetChannelCount(), GetColorModel(), BIAS::ROI::GetCorners(), GetDepth(), GetImageDataArray(), GetROI(), GetStorageType(), Init(), IsEmpty(), IsPlanar(), Release(), and SetColorModel().

Referenced by BIAS::TriangleMesh::GenerateDenseMesh(), BIAS::Label::Label4Neighbour(), BIAS::Label::Process(), and BIAS::ImageConvertThreaded::SplitImage_().

int ImageBase::GetCopyOfROI2 ( ImageBase & copy ) const

like GetCopyOfROI, but with lower right point included only interleaved images !

Note:: GetCopyOfROI returns an image where the lower right ROI point is not included. This version does it. Correction are not made in the original method, because extensive corrections would become necessary in other methods.

Author:: Ingo Thomsen

Definition at line 459 of file ImageBase.cpp.

References GetChannelCount(), GetColorModel(), BIAS::ROI::GetCorners(), GetDepth(), GetImageDataArray(), GetROI(), GetStorageType(), Init(), IsEmpty(), IsPlanar(), Release(), and SetColorModel().

int BIAS::Debug::GetDebugLevel ( ) const [inline, inherited]

Examples:: DebugMyMain.cpp, ExampleCamPoseCalib.cpp, ExampleCopy.cpp, and ExampleParabola.cpp.

Definition at line 333 of file Debug.hh.

Referenced by BIAS::MSAC< SolutionType >::_GenerateSamplesRandom(), BIAS::ImageAlignment::Align(), BIAS::ExampleDebug::func(), BIAS::FMatrix::GetEpipoles(), BIAS::GuiGTK::MouseMotionCallback_(), BIAS::Image< StorageType >::operator=(), operator=(), BIAS::ExampleDebug::ResetDebugLevelFromGlobal(), BIAS::TrackerBaseAffine2< StorageType >::TrackAffine_(), and BIAS::TrackerBaseAffine< StorageType >::TrackAffine_().

void BIAS::Debug::GetDebugStream ( std::ostream & os ) const [inline, inherited]

Definition at line 415 of file Debug.hh.

std::ostream& BIAS::Debug::GetDebugStream ( ) const [inline, inherited]

Definition at line 406 of file Debug.hh.

Referenced by BIAS::MSAC< SolutionType >::_GenerateSamplesRandom(), BIAS::RANSAC< SolutionType >::GenerateSamplesRandom(), and BIAS::GuiGTK::MouseMotionCallback_().

unsigned int BIAS::ImageBase::GetDepth ( ) const [inline]

returns the bytes per channel, which is the sizeof(StorageType) Should match GetSizeDepth(GetStorageType()).

Examples:: ExampleImageLoad.cpp.

Definition at line 308 of file ImageBase.hh.

Referenced by BIAS::ImagePackage::AddImage(), BIAS::BVWXMainFrame::AddInfo(), BIAS::MainFrame::AddInfo(), CopyIn_NoInit(), BIAS::ImgObjGL::CreateGLTexture(), Cut2ROI(), BIAS::ImageIO::ExportDevIL(), Flip(), FlipHorizontal(), FormatMatch(), BIAS::ImageConvert::GetChannel(), GetChannel(), GetCopyOfROI(), GetCopyOfROI2(), BIAS::ImgObjGL::GetGLInternalFormat(), BIAS::GuiEnhanced::GetZoomImage(), BIAS::VideoSource_DCAM::GrabSingleAndConvertForGrey(), BIAS::ImageIO::ImportDevIL(), BIAS::ImageIO::ImportMagickPP(), BIAS::VideoSource_Net::OpenDevice(), operator=(), Pad(), Paste2ROI(), BIAS::OpenGLCanvasBase::ScreenShot(), SetOutsideROIZero(), and StealImage().

static long int BIAS::Debug::GetGlobalDebugLevel ( ) [inline, static, inherited]

Definition at line 432 of file Debug.hh.

Referenced by BIAS::ExampleDebug::func(), and BIAS::ExampleDebug::ResetDebugLevelFromGlobal().

unsigned int BIAS::ImageBase::GetHeight ( ) const [inline]

Examples:: ExampleDeMosaic.cpp, ExampleHSVConversion2.cpp, ExampleImageLoad.cpp, ExampleImageWinApi.cpp, and ExampleMixtureOfGaussians.cpp.

Definition at line 299 of file ImageBase.hh.

void* BIAS::ImageBase::GetImageData ( ) [inline]

Reimplemented in BIAS::Image< StorageType >, BIAS::Image< InputST >, BIAS::Image< InputStorageType >, BIAS::Image< LABEL_CALC_TYPE >, BIAS::Image< float >, BIAS::Image< CONV_FLOAT >, BIAS::Image< unsigned char >, BIAS::Image< OutputStorageType >, BIAS::Image< CONV_INT >, BIAS::Image< CalculationType >, and BIAS::Image< OutputST >.

Definition at line 267 of file ImageBase.hh.

const void* BIAS::ImageBase::GetImageData ( ) const [inline]

Reimplemented in BIAS::Image< StorageType >, BIAS::Image< InputST >, BIAS::Image< InputStorageType >, BIAS::Image< LABEL_CALC_TYPE >, BIAS::Image< float >, BIAS::Image< CONV_FLOAT >, BIAS::Image< unsigned char >, BIAS::Image< OutputStorageType >, BIAS::Image< CONV_INT >, BIAS::Image< CalculationType >, and BIAS::Image< OutputST >.

Definition at line 260 of file ImageBase.hh.

Referenced by BIAS::WrapBias2Ipl::Consistent(), BIAS::ImageConvert::ConvertST(), BIAS::glfTexture2D::CopyChannelsToImage(), BIAS::glfCubeMap::CopyChannelsToImage(), CopyIn_NoInit(), BIAS::glfTexture2D::CopyToImage(), BIAS::glfRenderbuffer::CopyToImage(), BIAS::glfCubeMap::CopyToImage(), BIAS::ImgObjGL::CreateGLTexture(), BIAS::GuiCV::CreateIplImageShared(), BIAS::WrapBias2Ipl::CreateIplImageShared(), BIAS::ImageIO::ExportDevIL(), BIAS::ImageConvert::FloatToUC_(), BIAS::ImageConvert::GetChannel(), GetChannel(), BIAS::FFMPEGVideo::GetFrame(), BIAS::ROI::GetMaskImage(), BIAS::GuiEnhanced::GetZoomImage(), BIAS::ImageIO::ImportDevIL(), BIAS::ImageIO::ImportImageViff_(), BIAS::ImageIO::ImportMagickPP(), BIAS::ImageIO::ImportMagickPPAutoconvert(), BIAS::ImageIO::ImportReal32(), BIAS::GuiGTK::MouseMotionCallback_(), operator=(), operator==(), BIAS::glfRenderTarget::ReadBuffer(), BIAS::ImageConvert::RGBToI1I2I3(), BIAS::OpenGLCanvasBase::ScreenShot(), BIAS::BlobDetectorLevelSet< StorageType >::Set(), BIAS::ROI::SetMaskImage(), SetOutsideROIZero(), StealImage(), BIAS::HistoImageCanvas::UpdateHistogramm(), UpdateImageDataArrayFromImageData_(), BIAS::glfTexture2D::UploadImage(), and BIAS::glfCubeMap::UploadImage().

void** BIAS::ImageBase::GetImageDataArray ( ) const [inline]

Get an array of pointers to image data.

A pixel can be accessed by GetImageDataArray()[row][col] or GetImageDataArray()[y][x]
For multi channel images with interleaved data order, access with GetImageDataArray()[row][col * GetChannelCount() + Channel]
For multi channel images with planar data order, access with GetImageDataArray()[row + GetHeight * Channel][col]

Author:: Felix Woelk

Returns:: array with pointer to the first pixels in every row.

Reimplemented in BIAS::Image< StorageType >, BIAS::Image< InputST >, BIAS::Image< InputStorageType >, BIAS::Image< LABEL_CALC_TYPE >, BIAS::Image< float >, BIAS::Image< CONV_FLOAT >, BIAS::Image< unsigned char >, BIAS::Image< OutputStorageType >, BIAS::Image< CONV_INT >, BIAS::Image< CalculationType >, and BIAS::Image< OutputST >.

Examples:: ExampleProjectionParametersPerspective.cpp.

Definition at line 285 of file ImageBase.hh.

Referenced by Cut2ROI(), BIAS::ImageConvert::DeinterleaveHorizontal(), GetChannel(), GetCopyOfROI(), GetCopyOfROI2(), GetValue(), BIAS::GuiEnhanced::GetZoomImage(), BIAS::ImageIO::ImportRADIANCE(), Pad(), Paste2ROI(), SetChannel(), SetValue(), and StealImage().

const MetaData* BIAS::ImageBase::GetMetaData ( ) const [inline]

Definition at line 443 of file ImageBase.hh.

MetaData* BIAS::ImageBase::GetMetaData ( ) [inline]

Examples:: EvaluateAlignment.cpp, ExampleAlignment.cpp, ExampleTrackerBase.cpp, and ExampleTrackerBaseInterface.cpp.

Definition at line 436 of file ImageBase.hh.

Referenced by BIAS::ImagePackage::AddImage(), BIAS::VideoSource_PMD::CalcAmplitudesFromSourceData(), BIAS::VideoSource_PMD::CalcDistancesFromSourceData(), BIAS::VideoSource_PMD::CalcIntensitiesFromSourceData(), BIAS::OpenEXRInterface::Export(), BIAS::IOUtils::GetProjection(), BIAS::OpenEXRInterface::Import(), BIAS::ImageIO::ImportMagickPP(), BIAS::IOUtils::LoadFloat(), BiasShowEpiApp::OnInit(), and BIAS::ImageIO::WriteUnbuffered().

unsigned long int BIAS::ImageBase::GetPixelCount ( ) const [inline]

returns number of pixels in image

Definition at line 402 of file ImageBase.hh.

unsigned int BIAS::ImageBase::GetPixelPosition	(	unsigned int	x,
		unsigned int	y,
		unsigned short int	channel = `0`
	)			const `[inline]`

returns the Position (index from array start) in ImageData Warning: until 2005-01-04 the position inbyte was returned but used as position in <StorageType> (ImageDraw).

Changed this method to return position in StorageType Jan-Friso Evers

Definition at line 1180 of file ImageBase.hh.

void ImageBase::GetROI	(	int &	UpperLeftX,
		int &	UpperLeftY,
		int &	LowerRightX,
		int &	LowerRightY
	)			const

deprecated, use GetROICorners()

Definition at line 992 of file ImageBase.cpp.

References GetROICorners().

void ImageBase::GetROI	(	unsigned int &	UpperLeftX,
		unsigned int &	UpperLeftY,
		unsigned int &	LowerRightX,
		unsigned int &	LowerRightY
	)			const

deprecated, use GetROICorners()

Definition at line 980 of file ImageBase.cpp.

References GetROICorners().

const ROI* BIAS::ImageBase::GetROI ( ) const [inline]

Definition at line 601 of file ImageBase.hh.

ROI* BIAS::ImageBase::GetROI ( ) [inline]

Returns a pointer to the roi object.

Author:: woelk 07/2005

Definition at line 595 of file ImageBase.hh.

void ImageBase::GetROICorners	(	int &	UpperLeftX,
		int &	UpperLeftY,
		int &	LowerRightX,
		int &	LowerRightY
	)			const

access region of interest rectangle JW

Definition at line 997 of file ImageBase.cpp.

References BIAS::ROI::GetCorners(), and GetROI().

void ImageBase::GetROICorners	(	unsigned int &	UpperLeftX,
		unsigned int &	UpperLeftY,
		unsigned int &	LowerRightX,
		unsigned int &	LowerRightY
	)			const

access region of interest rectangle JW

Definition at line 985 of file ImageBase.cpp.

References BIAS::ROI::GetCorners(), and GetROI().

Referenced by BIAS::Image< StorageType >::AbsDiff(), BIAS::BackwardMapping< InputStorageType, OutputStorageType >::ClipBoundingBoxToROICorners_(), BIAS::TestFilterBase< FILTER, InputStorageType, OutputStorageType >::CompareImageData_(), BIAS::CylindricDepthTrackingPanorama::doPanorama(), BIAS::CylindricDepthTrackingPanorama::doTrack(), BIAS::Convolution< InputStorageType, OutputStorageType >::FilterFloat(), BIAS::Convolution< InputStorageType, OutputStorageType >::FilterInt(), BIAS::BackwardMapping< InputStorageType, OutputStorageType >::GetImageValue_(), GetROI(), BIAS::Image< StorageType >::operator*=(), BIAS::Image< StorageType >::operator+=(), BIAS::Image< StorageType >::operator-=(), BIAS::Image< StorageType >::operator/=(), and BIAS::TestFilterBase< FILTER, InputStorageType, OutputStorageType >::TestBorderHandling_().

const unsigned int ImageBase::GetROILowerRightX ( ) const

deprecated, use GetROI()->GetCorners()

Definition at line 1024 of file ImageBase.cpp.

References BIAS::ROI::GetCorners(), and GetROI().

Referenced by BIAS::Image< StorageType >::BinaryThreshold().

const unsigned int ImageBase::GetROILowerRightY ( ) const

deprecated, use GetROI()->GetCorners()

Definition at line 1031 of file ImageBase.cpp.

References BIAS::ROI::GetCorners(), and GetROI().

Referenced by BIAS::Image< StorageType >::BinaryThreshold().

const unsigned int ImageBase::GetROIUpperLeftX ( ) const

deprecated, use GetROI()->GetCorners()

Definition at line 1010 of file ImageBase.cpp.

References BIAS::ROI::GetCorners(), and GetROI().

Referenced by BIAS::Image< StorageType >::BinaryThreshold().

const unsigned int ImageBase::GetROIUpperLeftY ( ) const

deprecated, use GetROI()->GetCorners()

Definition at line 1017 of file ImageBase.cpp.

References BIAS::ROI::GetCorners(), and GetROI().

Referenced by BIAS::Image< StorageType >::BinaryThreshold().

unsigned int BIAS::ImageBase::GetSize ( ) const [inline]

returns the image size in bytes = count - NOT the dimension DEPRECATED Please use GetSizeByte instead to avoid storage type confusion on pointers and char/wideChar unicode

Definition at line 341 of file ImageBase.hh.

Referenced by BIAS::VideoSource_DCAM::GrabSingle().

int ImageBase::GetSizeByte ( const enum BIAS::ImageBase::EStorageType & storagetype ) [static]

get the size in Byte of the type corresponding to a storagetype uses sizeof(type) internally.

Useful for allocation calculations.

Author:: Jan Woetzel

Definition at line 1215 of file ImageBase.cpp.

References ST_char, ST_double, ST_float, ST_int, ST_invalid, ST_shortint, ST_unsignedchar, ST_unsignedint, and ST_unsignedshortint.

unsigned int BIAS::ImageBase::GetSizeByte ( ) const [inline]

returns the nr.

of image data Bytes - NOT the dimension

Definition at line 332 of file ImageBase.hh.

int ImageBase::GetSizeUnits ( const enum BIAS::ImageBase::EColorModel & colormodel ) [static]

get the number of (packed) data values of color model E.g: CM_Grey : 1 CM_YUYV422 : 2 packs 3 channel YUV into 2 Bytes CM_RGB : 3 CM_BGRA : 4 CM_Bayer_GBRG : 1 packed Bayer pattern CM_PGR_XB3_F7M3_GBRG : 3 packed three Bayer patterns w.

9 values in tri-image Useful for allocation calculations. Returns the number of data units, not Bytes!

Author:: Jan Woetzel

Definition at line 1247 of file ImageBase.cpp.

References CM_Bayer_BGGR, CM_Bayer_GBRG, CM_Bayer_GRBG, CM_Bayer_RGGB, CM_BGR, CM_BGRA, CM_Grey, CM_GreyA, CM_hsL, CM_HSL, CM_HSV, CM_PGR_XB3_F7M3_GBRG, CM_RGB, and CM_RGBA.

int ImageBase::GetStorageSizeByte	(	const unsigned int &	width,
		const unsigned int &	height,
		const unsigned int	nChannels,
		const enum EStorageType	storageType
	)			`[static]`

computes the storage data size in Byte required for a given video format.

Author:: Jan Woetzel

Definition at line 114 of file ImageBase.cpp.

References GetSizeByte().

Referenced by ReInit().

enum EStorageType BIAS::ImageBase::GetStorageType ( ) const [inline]

Examples:: ExampleBilateral.cpp, ExampleCannyEdge.cpp, and ExampleTracker.cpp.

Definition at line 394 of file ImageBase.hh.

const BIAS::UUID& BIAS::ImageBase::GetUID ( ) const [inline]

returns the UUID of the image

Examples:: ExampleImageLoad.cpp.

Definition at line 429 of file ImageBase.hh.

Referenced by BIAS::ImageBlender::AddCamera(), BIAS::BVWXMainFrame::AddInfo(), BIAS::MainFrame::AddInfo(), BIAS::ImageBlender::ConvertImageToRGBA(), BIAS::VideoSource_ShmPMD::GrabSingle(), BIAS::VideoSource_DiskZessPMD::GrabSingle(), BIAS::VideoSource_DiskPMD::GrabSingle(), BIAS::VideoSource_DcamPMD::GrabSingle(), BIAS::BVWXMainFrame::LoadImageFromList(), BIAS::MainFrame::LoadImageFromList(), operator=(), BIAS::VideoStream::SplitIntoFiles(), and BIAS::ImageIO::WriteUnbuffered().

template<class castType>

castType BIAS::ImageBase::GetValue	(	const ImageBase &	im,
		const unsigned int	x,
		const unsigned int	y,
		const unsigned int	channel
	)			`[inline]`

Definition at line 193 of file ImageBaseInline.hh.

References GetChannelCount(), GetImageDataArray(), GetStorageType(), IsInterleaved(), ST_char, ST_double, ST_float, ST_int, ST_shortint, ST_unsignedchar, ST_unsignedint, and ST_unsignedshortint.

template<class castType>

castType BIAS::ImageBase::GetValue	(	const ImageBase &	im,
		const unsigned int	x,
		const unsigned int	y,
		const unsigned int	channel = `0`
	)			`[inline, static]`

Determines the internale ImageBase type and casts it to the output type.

Attention:: im and input coordinates are not checked for validity! Only for interleaved images.

Definition at line 1275 of file ImageBase.hh.

int BIAS::ImageBase::GetVersionNumber ( ) const [inline]

Definition at line 457 of file ImageBase.hh.

Referenced by BIAS::BVWXMainFrame::AddInfo(), and BIAS::MainFrame::AddInfo().

unsigned int BIAS::ImageBase::GetWidth ( ) const [inline]

Examples:: ExampleDeMosaic.cpp, ExampleHSVConversion2.cpp, ExampleImageLoad.cpp, ExampleImageWinApi.cpp, and ExampleMixtureOfGaussians.cpp.

Definition at line 292 of file ImageBase.hh.

unsigned int BIAS::ImageBase::GetWidthStep ( ) const [inline]

returns the number of bytes per line

returns the number of bytes per line, not the number of StorageTypes

interleaved data order: = Width * Depth * ChannelCount planar data order: = Width * Depth

Useful for memory aligned images (e.g. 4/8 Byte) and packing of textures. JW

Definition at line 380 of file ImageBase.hh.

Referenced by BIAS::ImageConvert::BayerToRGBSlow_(), BIAS::Histogram2D::Draw(), BIAS::Histogram::Draw(), BIAS::Histogram2D::DrawLog(), BIAS::Histogram::DrawLog(), FormatMatch(), SetOutsideROIZero(), StealImage(), and BIAS::Rescale< InputStorageType, OutputStorageType >::UpsampleBy2().

void ImageBase::Init	(	unsigned int	width,
		unsigned int	height,
		unsigned int	nChannels = `1`,
		enum EStorageType	storageType = `ST_unsignedchar`,
		const bool	interleaved = `true`
	)

Initialize image size and channels.

Warning:: call this only for empty images, calls new for the image data array. Overwrites the color model with some kind of best guess

Author:: Felix Woelk tested

Parameters:

	width	image width of the new image
	height	image height of the new image
	channels	number of color planes

Reimplemented in BIAS::Image< StorageType >, BIAS::Image< InputST >, BIAS::Image< InputStorageType >, BIAS::Image< LABEL_CALC_TYPE >, BIAS::Image< float >, BIAS::Image< CONV_FLOAT >, BIAS::Image< unsigned char >, BIAS::Image< OutputStorageType >, BIAS::Image< CONV_INT >, BIAS::Image< CalculationType >, and BIAS::Image< OutputST >.

Examples:: ExampleProjectionParametersPerspective.cpp.

Definition at line 156 of file ImageBase.cpp.

References BitDepth_, ChannelCount_, CM_Grey, CM_invalid, CM_RGB, CM_RGBA, CM_YUYV422, Depth_, GetSizeByte(), GetStorageType(), Height_, ImageData_, InterleavedDataOrder_, IsEmpty(), Release(), BIAS::ROI::Resize(), Roi_, SetColorModel(), StorageType_, BIAS::ROI::UnsetROI(), UpdateImageDataArrayFromImageData_(), Width_, and WidthStep_.

Referenced by BIAS::ImageConvert::ConvertST(), BIAS::ImageConvertThreaded::ConvertThreaded(), BIAS::glfTexture2D::CopyChannelsToImage(), BIAS::glfCubeMap::CopyChannelsToImage(), BIAS::glfTexture2D::CopyToImage(), BIAS::glfRenderbuffer::CopyToImage(), BIAS::glfCubeMap::CopyToImage(), BIAS::WrapBias2Ipl::CreateBiasImageCopy(), BIAS::ImageConvert::DeinterleaveHorizontal(), GetChannel(), GetCopyOfROI(), GetCopyOfROI2(), BIAS::ROI::GetMaskImage(), BIAS::GuiEnhanced::GetZoomImage(), BIAS::Image< StorageType >::Image(), ImageBase(), BIAS::OpenEXRInterface::Import(), BIAS::ImageIO::ImportDevIL(), BIAS::ImageIO::ImportImageViff_(), BIAS::ImageIO::ImportMagickPP(), BIAS::ImageIO::ImportMagickPPAutoconvert(), BIAS::ImageIO::ImportRADIANCE(), BIAS::ImageIO::ImportRAWwithHeader(), BIAS::ImageIO::ImportReal32(), BIAS::Image< StorageType >::Init(), BIAS::VideoSource_usbPMD::Init2DImage(), BIAS::VideoSource_SwissRanger::InitDepthImage(), BIAS::VideoSource_usbPMD::InitImage(), BIAS::VideoSource_uEye::InitImage(), BIAS::VideoSource_SwissRanger::InitImage(), BIAS::VideoSource_DSHOW::InitImage(), BIAS::VideoSource_DcamPMD::InitImage(), BIAS::VideoSource_Centaurus::InitImage(), BIAS::VideoSource::InitImage(), BIAS::VideoSource_PMD::InitImage_(), BIAS::Image< StorageType >::InitWithForeignData(), operator=(), BIAS::glfRenderTarget::ReadBuffer(), ReInit(), and BIAS::OpenGLCanvasBase::ScreenShot().

void BIAS::ImageBase::InvalidateUID ( ) [inline]

sets the image's uid to invalid

Definition at line 577 of file ImageBase.hh.

References BIAS::UUID::Invalidate().

Referenced by BIAS::VideoSource_V4L::GrabSingle(), BIAS::VideoSource_ShmPMD::GrabSingle(), BIAS::VideoSource_Shm::GrabSingle(), BIAS::VideoSource_DV2::GrabSingle(), BIAS::VideoSource_DV::GrabSingle(), and BIAS::VideoSource_DCAM::GrabSingle().

bool BIAS::ImageBase::IsEmpty ( ) const [inline]

check if ImageData_ points to allocated image buffer or not

Examples:: ExampleBilateral.cpp, and ExampleMixtureOfGaussians.cpp.

Definition at line 225 of file ImageBase.hh.

const bool BIAS::ImageBase::IsInROI	(	const double &	x,
		const double &	y
	)			const `[inline]`

Definition at line 681 of file ImageBase.hh.

bool BIAS::ImageBase::IsInterleaved ( ) const [inline]

Definition at line 471 of file ImageBase.hh.

bool BIAS::ImageBase::IsPlanar ( ) const [inline]

Definition at line 464 of file ImageBase.hh.

bool BIAS::ImageBase::IsPositionInImage	(	const int &	x,
		const int &	y
	)			const `[inline]`

check if image contains that pixel position

Definition at line 1191 of file ImageBase.hh.

Referenced by BIAS::AffineMapping< InputStorageType, OutputStorageType >::BilinearGrey(), BIAS::LocalAffineFrame::Draw(), BIAS::EpipolarLine::DrawDistortedLine(), BIAS::EpipolarLine::DrawWhole(), BIAS::AffineMapping< InputStorageType, OutputStorageType >::MapDirectAgain(), and BIAS::AffineMapping< InputStorageType, OutputStorageType >::TrilinearGreyAgain().

bool ImageBase::IsPowerOfTwoSize	(	const unsigned int	w,
		const unsigned int	h
	)			`[static]`

Definition at line 868 of file ImageBase.cpp.

bool ImageBase::IsPowerOfTwoSize ( ) const

Returns:: true if image size is a power of two JW

Definition at line 858 of file ImageBase.cpp.

References GetHeight(), and GetWidth().

Referenced by BIAS::ImgObjGL::CreateGLCubemap(), BIAS::ImgObjGL::CreateGLCubemapEmpty(), BIAS::ImgObjGL::CreateGLTexture(), and BIAS::ImageCanvasGLBase::ValidTexobj().

int BIAS::ImageBase::Mirror ( ) [inline]

interface for the above JW

Definition at line 749 of file ImageBase.hh.

int BIAS::ImageBase::MoveToClosestPositionInImage	(	int &	x,
		int &	y
	)			const `[inline]`

find closest valid pixel position to x,y

Author:: koeser 01/2005

Returns:: 0=was correct 3,4=y out of range, 1,2 x out of range

Definition at line 1195 of file ImageBase.hh.

long int BIAS::Debug::Name2DebugLevel ( const std::string & name ) const [inline, inherited]

looks up a debuglevel in the internal map, returns 0 if not found

Author:: woelk 09/2006

Definition at line 455 of file Debug.hh.

long int BIAS::Debug::NewDebugLevel ( const std::string & name ) [inline, inherited]

creates a new debuglevel

Author:: woelk 09/2006

Examples:: ExampleDebug.cpp.

Definition at line 475 of file Debug.hh.

Referenced by BIAS::Condensation::Condensation(), BIAS::COSAC< SolutionType >::COSAC(), BIAS::Histogram::Histogram(), BIAS::MonteCarloTransform::MonteCarloTransform(), myclass::myclass(), BIAS::PMatrixEstimation::PMatrixEstimation(), BIAS::PMatrixLinear::PMatrixLinear(), BIAS::PreemptiveRANSAC< SolutionType >::PreemptiveRANSAC(), BIAS::RANSAC< SolutionType >::RANSAC(), BIAS::RANSACPreKnowledge< SolutionType >::RANSACPreKnowledge(), BIAS::ROI::ROI(), BIAS::SceneOpenSceneGraph::SceneOpenSceneGraph(), BIAS::ThreeDOutOpenSceneGraph::ThreeDOutOpenSceneGraph(), BIAS::Triangulation::Triangulation(), and BIAS::UnscentedTransform::UnscentedTransform().

bool BIAS::ImageBase::NotBiggerPixelAndSameChannelCount ( const ImageBase & Image ) const [inline]

checks if data area has bigger or the same "size" as Image of other type

Definition at line 1159 of file ImageBase.hh.

Referenced by BIAS::CornerDetectorKLT< StorageType, CalculationType >::_ComputeCornerness(), and BIAS::StructureTensor< InputStorageType, OutputStorageType >::_GradientProducts().

ImageBase & ImageBase::operator= ( const ImageBase & Source )

assignment operator, allocates memory structure via Init only if necessary

Author:: Felix Woelk

always copy the members that do not depend on image data to allow feeding Image* into ImageBase*. JW 01/2005

Reimplemented in BIAS::Image< StorageType >, BIAS::Image< InputST >, BIAS::Image< InputStorageType >, BIAS::Image< LABEL_CALC_TYPE >, BIAS::Image< float >, BIAS::Image< CONV_FLOAT >, BIAS::Image< unsigned char >, BIAS::Image< OutputStorageType >, BIAS::Image< CONV_INT >, BIAS::Image< CalculationType >, and BIAS::Image< OutputST >.

Definition at line 663 of file ImageBase.cpp.

References BIAS::Debug::_liDebugLevel, _MetaData, _UID, BitDepth_, ChannelCount_, ColorModel_, Depth_, GetBitDepth(), GetChannelCount(), GetColorModel(), BIAS::Debug::GetDebugLevel(), GetDepth(), GetHeight(), GetImageData(), GetPixelCount(), GetROI(), GetStorageType(), GetUID(), GetWidth(), Height_, Init(), InterleavedDataOrder_, IsEmpty(), IsPlanar(), Release(), Roi_, SamePixelAndChannelCount(), ST_invalid, StorageType_, UpdateImageDataArrayFromImageData_(), Width_, and WidthStep_.

Referenced by BIAS::Image< StorageType >::Image(), and BIAS::Image< StorageType >::operator=().

bool BIAS::ImageBase::operator== ( const ImageBase & img ) const [inline]

comparison operator, based upon the adresses of the actual image data

Author:: Ingo Thomsen tested

Definition at line 718 of file ImageBase.hh.

References GetImageData().

int ImageBase::Pad	(	const unsigned int &	newwidth,
		const unsigned int &	newheight,
		const int &	padVal = `0`
	)

Definition at line 1100 of file ImageBase.cpp.

References GetHeight(), GetWidth(), and Pad().

int ImageBase::Pad	(	BIAS::ImageBase &	dest,
		const unsigned int &	newwidth,
		const unsigned int &	newheight,
		const int &	padVal = `0`
	)			const

Definition at line 1125 of file ImageBase.cpp.

References GetBitDepth(), GetChannelCount(), GetColorModel(), GetDepth(), GetHeight(), GetImageDataArray(), GetStorageType(), GetWidth(), ImageBase(), IsInterleaved(), SetBitDepth(), and SetColorModel().

Referenced by Pad(), PadToPowerOfTwo(), BIAS::glfTexture2D::UploadImage(), BIAS::glfCubeMap::UploadImage(), and ZeroPad().

int ImageBase::PadToPowerOfTwo ( const int & padVal = 0 )

in place version of the above

Author:: JW

Definition at line 1049 of file ImageBase.cpp.

References PadToPowerOfTwo(), and PowerOfTwoSize().

int ImageBase::PadToPowerOfTwo	(	BIAS::ImageBase &	dest,
		const int &	padVal = `0`
	)			const

increase the size of this image to next power of two (e.g.

384x100>512x128) the original image S is set to upper left rectangle

Parameters:

padVal

used by memset to pad the right and lower added pixels No scale, just padding!

        orig xx
        xxxxxxx

Author:: Jan Woetzel 09/2003 - 11/2005

Definition at line 1072 of file ImageBase.cpp.

References ImageBase(), IsInterleaved(), Pad(), and PowerOfTwoSize().

Referenced by BIAS::ImgObjGL::CreateGLTexture(), BIAS::ImageIO::ExportDevIL(), BIAS::SceneBGImage::InitializeTexture_(), BIAS::ThreeDOut::OpenGLOutIndexedFaceSets(), PadToPowerOfTwo(), PadToPowerOfTwoAndFlip(), and BIAS::SceneBGImage::SetImage().

int ImageBase::PadToPowerOfTwoAndFlip ( const int & padVal = 0 )

first pad, then flip.

useful for OpenGL texture image which must be pow2 size and Y-flipped ics. example:

Todo:: more efficient in place with memmove

Author:: Jan Woetzel

Todo:: replace with linewise memmov

Definition at line 1200 of file ImageBase.cpp.

References Flip(), and PadToPowerOfTwo().

Referenced by BIAS::ImgObjGL::CreateGLTexture().

int ImageBase::Paste2ROI ( const ImageBase & Image )

paste Image to current ROI

Author:: Felix Woelk 02 2003

Definition at line 527 of file ImageBase.cpp.

References GetChannelCount(), GetColorModel(), BIAS::ROI::GetCorners(), GetDepth(), GetHeight(), GetImageDataArray(), GetROI(), and GetWidth().

Referenced by BIAS::Label::Filter(), BIAS::Erosion< InputStorageType, OutputStorageType >::Filter(), BIAS::Dilation< InputStorageType, OutputStorageType >::Filter(), BIAS::ShowCamWxFrame::InitCameras(), BIAS::Label::Label4Neighbour(), and BIAS::ImageConvertThreaded::MergeImage_().

void * ImageBase::PixelValueBase	(	unsigned	x,
		unsigned	y,
		unsigned	channel = `0`
	)

Definition at line 937 of file ImageBase.cpp.

References ChannelCount_, Depth_, Height_, ImageData_, InterleavedDataOrder_, Width_, and WidthStep_.

bool ImageBase::PowerOfTwoSize	(	unsigned int &	width2,
		unsigned int &	height2
	)			const

Returns:: true if both, width and height are already a power of two. The next power of two size >= actual size is computed and stored in args. useful for OpenGL texture enlargement for 'power of two' textures.

Author:: Jan Woetzel 09/2003

Definition at line 879 of file ImageBase.cpp.

References GetHeight(), GetWidth(), and PowerOfTwoSize().

unsigned int ImageBase::PowerOfTwoSize ( const unsigned int & val ) [static]

Returns:: next pow2 >= val JW

Definition at line 889 of file ImageBase.cpp.

Referenced by BIAS::ThreeDOut::AddTriangleMesh(), BIAS::ImgObjGL::CreateGLTexture(), BIAS::GeometryGL::GetImgCorner2d(), PadToPowerOfTwo(), and PowerOfTwoSize().

void BIAS::Debug::PrintDebugLevel ( std::ostream & os = std::cout ) const [inline, inherited]

Examples:: ExampleDebug.cpp.

Definition at line 384 of file Debug.hh.

void BIAS::ImageBase::PrintHeader ( std::ostream & os = std::cout ) const

Referenced by BIAS::ImageIO::ImportMagickPP().

void BIAS::ImageBase::PrintPixelValue	(	const ImageBase &	im,
		const unsigned int	x,
		const unsigned int	y,
		const unsigned short	channel = `0`,
		std::ostream &	os = `std::cout`
	)			`[static]`

Definition at line 1837 of file ImageBase.cpp.

References GetStorageType(), BIAS::Image< StorageType >::PixelValue(), ST_char, ST_double, ST_float, ST_int, ST_shortint, ST_unsignedchar, ST_unsignedint, and ST_unsignedshortint.

Referenced by BIAS::ZoomImageCanvas::UpdateStatusBar(), and BIAS::ImageCanvas::UpdateStatusBar().

void ImageBase::PrintROI ( std::ostream & os = std::cout ) const

deprecated, use 'os << *GetROI()'

Definition at line 1005 of file ImageBase.cpp.

References GetROI().

void BIAS::ImageBase::RedirectImageDataPointer ( void * data ) [inline]

This method takes data and set the internal image data pointer to this.

You should really know what you are doing using this method. Don't say you haven't been warned.

Author:: Friso Evers

Definition at line 839 of file ImageBase.hh.

Referenced by BIAS::Image< StorageType >::AppendChannel(), Cut2ROI(), BIAS::Dilation< InputStorageType, OutputStorageType >::Dilate(), BIAS::Rescale< InputStorageType, OutputStorageType >::DownsampleBPoT(), Flip(), FlipHorizontal(), BIAS::Image< StorageType >::InitWithForeignData(), BIAS::ImageConvert::ToPlanarRGB_(), BIAS::ImageConvert::ToPlanarYUYV422_(), BIAS::Rescale< InputStorageType, OutputStorageType >::Upsample(), BIAS::Rescale< InputStorageType, OutputStorageType >::UpsampleGrey(), BIAS::ImageConvert::YUV422ToGrey_(), and BIAS::ImageConvert::YUV422ToRGB_().

void ImageBase::ReInit	(	const unsigned int &	width,
		const unsigned int &	height,
		const unsigned int	nChannels = `1`,
		const enum EStorageType	storageType = `ST_unsignedchar`,
		const bool	interleaved = `true`,
		const EColorModel	colormodel = `CM_Grey`
	)

(Re-)Initialize Image data if required.

Contains logic to re-allocate only if required. Keep existing data area if data layout fits. The idea is to reuse a previously initialized image with no need to check it has been initialized exactly once.

Author:: Jan Woetzel

Definition at line 130 of file ImageBase.cpp.

References GetChannelCount(), GetHeight(), GetStorageSizeByte(), GetStorageType(), GetWidth(), Init(), IsEmpty(), IsInterleaved(), Release(), SetColorModel(), SetInterleaved(), and SetStorageType().

Referenced by BIAS::VideoSource_SwissRanger::ConvertImageFloatToCharNormalized_(), BIAS::BlobDetectorBFS< StorageType >::Detect(), BIAS::TukeyWindow< InputStorageType, OutputStorageType >::FilterFloat(), BIAS::MixtureOfGaussians< StorageType >::GetWeightImage(), and BIAS::MixtureOfGaussians< StorageType >::Init_().

void ImageBase::Release ( const bool reset_storage_type = false )

Free the allocated data structures Hands off: Do !!NOT!! change the default of reset_storage_type: ImageBase::Release() is also implicitly called for templated images when releasing the storage type here, it becomes possible to assign a float image to an unsigned char image via ImageBase: Image<float> f; Image<unsigned char> uc; ImageBase *ibf = dynamic_cast<ImageBase *>(f); ImageBase *ibuc = dynamic_cast<ImageBase *>(uc); (*ibf) = (*ibuc);.

Definition at line 275 of file ImageBase.cpp.

References _MetaData, BitDepth_, ChannelCount_, CM_invalid, ColorModel_, Depth_, Height_, ImageData_, ImageDataArray_, IsEmpty(), BIAS::ROI::Release(), Roi_, ST_invalid, StorageType_, Width_, and WidthStep_.

Referenced by BIAS::ImageConvert::ConvertST(), BIAS::ImageConvertThreaded::ConvertThreaded(), BIAS::glfTexture2D::CopyChannelsToImage(), BIAS::glfCubeMap::CopyChannelsToImage(), BIAS::glfCubeMap::CopyToImage(), BIAS::WrapBias2Ipl::CreateBiasImageCopy(), BIAS::ImageConvert::DeinterleaveHorizontal(), GetCopyOfROI(), GetCopyOfROI2(), BIAS::ROI::GetMaskImage(), BIAS::ImagePackage::GetNextImage(), BIAS::GuiEnhanced::GetZoomImage(), BIAS::OpenEXRInterface::Import(), BIAS::ImageIO::ImportDevIL(), BIAS::ImageIO::ImportImageViff_(), BIAS::ImageIO::ImportMagickPP(), BIAS::ImageIO::ImportMagickPPAutoconvert(), BIAS::ImageIO::ImportRADIANCE(), BIAS::ImageIO::ImportRAWwithHeader(), BIAS::ImageIO::ImportReal32(), Init(), BIAS::VideoSource_usbPMD::Init2DImage(), BIAS::VideoSource_SwissRanger::InitDepthImage(), BIAS::VideoSource_usbPMD::InitImage(), BIAS::VideoSource_SwissRanger::InitImage(), BIAS::VideoSource_PMD::InitImage_(), operator=(), BIAS::glfRenderTarget::ReadBuffer(), ReInit(), BIAS::OpenGLCanvasBase::ScreenShot(), and StealImage().

void BIAS::ImageBase::ReleaseImageDataPointer ( ) [inline]

Releases ImageData_ (to be used together with RedirectImageDataPointer).

Author:: Felix woelk

Definition at line 1171 of file ImageBase.hh.

Referenced by BIAS::Image< StorageType >::AppendChannel(), Cut2ROI(), BIAS::Rescale< InputStorageType, OutputStorageType >::DownsampleBPoT(), Flip(), FlipHorizontal(), BIAS::Image< StorageType >::InitWithForeignData(), BIAS::ImageConvert::ToPlanarRGB_(), BIAS::ImageConvert::ToPlanarYUYV422_(), BIAS::Rescale< InputStorageType, OutputStorageType >::Upsample(), BIAS::Rescale< InputStorageType, OutputStorageType >::UpsampleGrey(), BIAS::ImageConvert::YUV422ToGrey_(), and BIAS::ImageConvert::YUV422ToRGB_().

void BIAS::Debug::RemoveDebugLevel ( const std::string & name ) [inline, inherited]

Definition at line 377 of file Debug.hh.

void BIAS::Debug::RemoveDebugLevel ( const long int lv ) [inline, inherited]

Definition at line 370 of file Debug.hh.

bool BIAS::ImageBase::SamePixelAndChannelCount ( const ImageBase & Image ) const [inline]

checks if data area has same "size" as Image of other type

Definition at line 1154 of file ImageBase.hh.

void BIAS::ImageBase::SetBitDepth ( unsigned bitdepth ) [inline]

needed by ImageIO

Definition at line 561 of file ImageBase.hh.

Referenced by BIAS::DeMosaicing< StorageType >::DeMosaic(), BIAS::ImageIO::ImportMagickPP(), and Pad().

template<class inputType>

void BIAS::ImageBase::SetChannel	(	const BIAS::ImageBase &	im,
		const unsigned int	channelId,
		const inputType *	channelIn
	)			`[inline]`

Definition at line 339 of file ImageBaseInline.hh.

References GetChannelCount(), GetHeight(), GetImageDataArray(), GetStorageType(), GetWidth(), IsInterleaved(), ST_char, ST_double, ST_float, ST_int, ST_shortint, ST_unsignedchar, ST_unsignedint, and ST_unsignedshortint.

template<class inputType>

void BIAS::ImageBase::SetChannel	(	const ImageBase &	im,
		const unsigned int	channelId,
		const inputType *	channelIn
	)			`[inline, static]`

Copy channel, determines the internal ImageBase type and casts the input type to the type foreseen in im.

Attention:: im and channel both have to be initialized and of compatible size! Only for interleaved images.

Definition at line 1421 of file ImageBase.hh.

Referenced by BIAS::Bilateral< InputStorageType, OutputStorageType >::FilterColorImg(), and BIAS::OpenEXRInterface::Import().

void BIAS::ImageBase::SetColorModel ( EColorModel Model ) [inline]

Examples:: ExampleMixtureOfGaussians.cpp.

Definition at line 541 of file ImageBase.hh.

void BIAS::Debug::SetDebugLevel ( const std::string & name ) [inline, inherited]

Definition at line 326 of file Debug.hh.

void BIAS::Debug::SetDebugLevel ( const long int lv ) [inline, inherited]

void BIAS::Debug::SetDebugStream ( const std::ostream & os ) [inline, inherited]

Examples:: DebugMyMain.cpp.

Definition at line 399 of file Debug.hh.

static void BIAS::Debug::SetGlobalDebugLevel ( long int lev ) [inline, static, inherited]

Examples:: DebugMyMain.cpp.

Definition at line 425 of file Debug.hh.

void BIAS::ImageBase::SetInterleaved ( bool interleaved ) [inline]

Definition at line 548 of file ImageBase.hh.

Referenced by BIAS::ImageConvert::BGRAToHSL_(), BIAS::ImageConvert::BGRToHSL_(), BIAS::StereoRedGreen::Combine(), BIAS::ImageConvert::HSLToRGB_(), ReInit(), BIAS::ImageConvert::RGBTohsL_(), BIAS::ImageConvert::RGBToHSL_(), BIAS::ImageConvert::RGBToHSV_(), BIAS::ImageConvert::ToInterleavedRGB(), BIAS::ImageConvert::ToInterleavedRGB_(), BIAS::ImageConvert::ToPlanar(), BIAS::ImageConvert::ToPlanarRGB_(), and BIAS::ImageConvert::ToPlanarYUYV422_().

void BIAS::ImageBase::SetMetaData ( const MetaData & m ) [inline]

Definition at line 450 of file ImageBase.hh.

Referenced by BIAS::VideoSource_PMD::GrabSourceData(), BIAS::IOUtils::LoadFloat(), and BiasShowEpiApp::OnInit().

void ImageBase::SetOutsideROIZero ( )

sets all pixel not in ROI to zero

Author:: woelk 10/2004

Definition at line 593 of file ImageBase.cpp.

References GetChannelCount(), BIAS::ROI::GetCorners(), GetDepth(), GetHeight(), GetImageData(), GetROI(), GetWidth(), GetWidthStep(), and BIAS::ROI::IsInROI().

int ImageBase::SetROI ( const ROI & roi )

Definition at line 960 of file ImageBase.cpp.

References GetROI().

int ImageBase::SetROI	(	unsigned int	UpperLeftX,
		unsigned int	UpperLeftY,
		unsigned int	LowerRightX,
		unsigned int	LowerRightY
	)

deprecated, use SetROICorners()

JW: there's no reason to drop this interface - be API backward compatible!

Examples:: ExampleMixtureOfGaussians.cpp.

Definition at line 951 of file ImageBase.cpp.

References SetROICorners().

Referenced by BIAS::ThreeDOut::AddImage(), BIAS::ImageConvert::BayerToRGBSlow_(), BIAS::GradientSobel3x3< InputStorageType, OutputStorageType >::Filter(), BIAS::ExampleMixtureOfGaussiansFrame::OnTimer(), BIAS::ExampleMixtureOfGaussiansFrame::processImages_(), BIAS::VideoSource::SoftwareWhiteBalance(), BIAS::ImageConvert::ToGrey(), and BIAS::ConvertHDR< StorageType >::ToUnsignedCharGamma().

int ImageBase::SetROICorners	(	unsigned int	UpperLeftX,
		unsigned int	UpperLeftY,
		unsigned int	LowerRightX,
		unsigned int	LowerRightY
	)

Definition at line 966 of file ImageBase.cpp.

References GetROI(), and BIAS::ROI::SetCorners().

Referenced by BIAS::Convolution< InputStorageType, OutputStorageType >::FilterInt(), BIAS::TriangleMesh::GenerateDenseMesh(), BIAS::ContourDetectorBSpline< StorageType >::GetFeatImage_(), BIAS::ShowCamWxFrame::InitCameras(), BIAS::CylindricDepthTrackingPanorama::ProcessCylindricProjection(), SetROI(), and BIAS::TestFilterBase< FILTER, InputStorageType, OutputStorageType >::TestBorderHandling_().

void BIAS::ImageBase::SetStorageType ( const EStorageType st ) [inline, protected]

changes StorageType data mmeber

Definition at line 1028 of file ImageBase.hh.

Referenced by ReInit().

void BIAS::ImageBase::SetUID ( const BIAS::UUID & id ) [inline]

Definition at line 569 of file ImageBase.hh.

template<class inputType>

void BIAS::ImageBase::SetValue	(	const ImageBase &	im,
		const unsigned int	x,
		const unsigned int	y,
		const unsigned int	channel,
		const inputType	val
	)			`[inline]`

Definition at line 265 of file ImageBaseInline.hh.

References GetChannelCount(), GetImageDataArray(), GetStorageType(), IsInterleaved(), ST_char, ST_double, ST_float, ST_int, ST_shortint, ST_unsignedchar, ST_unsignedint, and ST_unsignedshortint.

template<class inputType>

void BIAS::ImageBase::SetValue	(	const ImageBase &	im,
		const unsigned int	x,
		const unsigned int	y,
		const unsigned int	channel,
		const inputType	val
	)			`[inline, static]`

Determines the internal ImageBase type and casts the input type to the type foreseen in im.

Attention:: im and input coordinates are not checked for validity! Only for interleaved images.

Definition at line 1347 of file ImageBase.hh.

void BIAS::ImageBase::SetZero ( ) [inline]

zeroes the image

Definition at line 1164 of file ImageBase.hh.

Referenced by BIAS::ImageAlignment::Align(), BIAS::BackwardMapping< InputStorageType, OutputStorageType >::ChangeImgSize_(), BIAS::RectificationViaProjectionMappingBase< InputStorageType, OutputStorageType >::Disp2Depth(), BIAS::PMDImageProc::FitDepthTo2DImage(), BIAS::PMDImageProc::FitDepthTo2DImageFree_(), BIAS::TriangleMesh::GenerateTexturedCamera(), BIAS::VideoSource_usbPMD::ImageUcharFromDouble_(), BIAS::VideoSource_usbPMD::ImageUcharFromShort_(), BIAS::BackwardMapping< InputStorageType, OutputStorageType >::Map(), BIAS::TrackerBaseAffine2< StorageType >::TrackAffine_(), and BIAS::TrackerBaseAffine< StorageType >::TrackAffine_().

void BIAS::Debug::ShowDebugLevel ( std::ostream & os = std::cout ) const [inline, inherited]

prints all internally known debuglevels

Author:: woelk 09/2006

Examples:: ExampleDebug.cpp.

Definition at line 497 of file Debug.hh.

int ImageBase::StealImage ( ImageBase & source )

steals the image data array from source, after releasing the actual image data and sets source image data to NULL

Warning:: Important for template: Steal images only, if u know the storageTypes are euqal!

Author:: Daniel Grest tested

Definition at line 319 of file ImageBase.cpp.

References _MetaData, BitDepth_, ChannelCount_, ColorModel_, Depth_, GetBitDepth(), GetChannelCount(), GetColorModel(), GetDepth(), GetHeight(), GetImageData(), GetImageDataArray(), GetROI(), GetStorageType(), GetWidth(), GetWidthStep(), Height_, ImageData_, ImageDataArray_, InterleavedDataOrder_, IsEmpty(), IsPlanar(), Release(), Roi_, StorageType_, Width_, and WidthStep_.

Referenced by BIAS::ImageConvert::Convert(), BIAS::Bilateral< InputStorageType, OutputStorageType >::Filter(), BIAS::Median< InputStorageType, OutputStorageType >::Filter(), BIAS::Median< InputStorageType, OutputStorageType >::FilterRemoveSaltAndPepper(), BIAS::MainFrame::LoadImageFromList(), BIAS::BVWXMainFrame::LoadImageFromList(), BIAS::ColorSegmentationThreaded::Segment(), BIAS::GuiBase::ShowImage(), and BIAS::ImageConvert::ToGrey().

void BIAS::ImageBase::StringToColorModel	(	const std::string &	str,
		ImageBase::EColorModel &	cm
	)			`[static]`

Definition at line 1513 of file ImageBase.cpp.

References CM_Bayer_BGGR, CM_Bayer_GBRG, CM_Bayer_GRBG, CM_Bayer_RGGB, CM_BGR, CM_BGRA, CM_Depth, CM_DepthAndVariance, CM_Disparity, CM_DV, CM_Grey, CM_GreyA, CM_HSI_OBS, CM_HSL, CM_hsL, CM_HSV, CM_invalid, CM_LAB, CM_LUV, CM_PGR_XB3_F7M3_GBRG, CM_RGB, CM_RGBA, CM_RGBE, CM_SymTensor2x2, CM_UYVY422, CM_XYZ, CM_YUV411, CM_YUV420P, CM_YUV444, CM_YUYV, and CM_YUYV422.

Referenced by BIAS::OpenEXRInterface::Import().

void BIAS::ImageBase::StringToStorageType	(	const std::string &	str,
		ImageBase::EStorageType &	st
	)			`[static]`

Definition at line 1550 of file ImageBase.cpp.

References ST_char, ST_double, ST_float, ST_int, ST_invalid, ST_shortint, ST_unsignedchar, ST_unsignedint, and ST_unsignedshortint.

void BIAS::ImageBase::TextureToBIASCoordinates	(	const double &	gl_x,
		const double &	gl_y,
		double &	biasx,
		double &	biasy
	)			const `[inline]`

transfer GL texture coordinates [0.

.1[ x [0..1[ to BIAS image coordinates [0..w-1] x [0..h-1]

GL coordinates are relative to image size of *this (must be valid) !

Please note that this is only one of many possible bias to gl coord transformations which may be particularly different for pow2, non-pow2, rectangle, padded, scaled, bordered, offset etc. OpenGL textures.

BIASASSERT(Equal(gl_x2, gl_x)); BIASASSERT(Equal(gl_y2, gl_y));

Definition at line 1249 of file ImageBase.hh.

void ImageBase::UnsetROI ( )

deprecated, use GetROI()->UnsetROI()

Definition at line 975 of file ImageBase.cpp.

References GetROI(), and BIAS::ROI::UnsetROI().

Referenced by Cut2ROI(), BIAS::Gauss< InputStorageType, OutputStorageType >::FilterGrey(), and BIAS::ContourDetectorBSpline< StorageType >::GetFeatImage_().

int ImageBase::UpdateImageDataArrayFromImageData_ ( ) [protected]

recomputes pointer array returned by GetImageDataArray

Definition at line 227 of file ImageBase.cpp.

References ChannelCount_, Depth_, GetChannelCount(), GetHeight(), GetImageData(), GetPixelCount(), GetWidth(), ImageDataArray_, InterleavedDataOrder_, IsEmpty(), IsPlanar(), Width_, and WidthStep_.

Referenced by BIAS::ImageConvert::GetChannel(), BIAS::ImageIO::ImportDevIL(), Init(), BIAS::ImageConvert::IP_ToGrey(), operator=(), and BIAS::ImageConvert::ToGrey().

int ImageBase::ZeroPad	(	const unsigned int	newwidth,
		const unsigned int	newheight,
		unsigned char	bgcolor = `0`
	)

backward compatibility interface for Pad.

DEPRECATED

Author:: Jan Woetzel 2005

Definition at line 1040 of file ImageBase.cpp.

References Pad().

Referenced by BIAS::FFT2D_Tiles< InputStorageType, OutputStorageType >::TransformAbs().

Friends And Related Function Documentation

friend class ImageConvert [friend]

Definition at line 104 of file ImageBase.hh.

friend class ImageIO [friend]

Definition at line 105 of file ImageBase.hh.

BIASImageBase_EXPORT std::ostream& operator<<	(	std::ostream &	os,
		const ImageBase &	img
	)			`[friend]`

Definition at line 1395 of file ImageBase.cpp.

BIASImageBase_EXPORT std::istream& operator>>	(	std::istream &	is,
		ImageBase &	img
	)			`[friend]`

Definition at line 1565 of file ImageBase.cpp.

friend class WrapBias2Ipl [friend]

Definition at line 106 of file ImageBase.hh.

Member Data Documentation

long int BIAS::Debug::_liDebugLevel [protected, inherited]

Definition at line 511 of file Debug.hh.

Referenced by BIAS::GuiGTK::DeleteEvent_(), BIAS::GuiGTK::Destroy_(), BIAS::GuiGTK::DrawingAreaExposeCallback_(), BIAS::GuiGTK::GtkMain(), BIAS::GuiGTK::KeyPressEventCallback_(), BIAS::GuiGTK::LabelExposeCallback_(), BIAS::GuiGTK::MouseButtonPressCallback_(), BIAS::GuiGTK::MouseButtonReleaseCallback_(), BIAS::GuiGTK::MouseMotionCallback_(), BIAS::Image< StorageType >::operator=(), operator=(), and BIAS::Debug::operator=().

long int BIAS::Debug::_liNextDebugLevel [protected, inherited]

new concept, debuglevel are managed here in the debug class

Definition at line 517 of file Debug.hh.

Referenced by BIAS::Debug::operator=().

MetaData BIAS::ImageBase::_MetaData [protected]

additional data block, handled by derived classes

Definition at line 1066 of file ImageBase.hh.

Referenced by ImageBase(), operator=(), BIAS::Camera< StorageType >::ParseMetaData(), BIAS::Image< StorageType >::Release(), Release(), StealImage(), and BIAS::Camera< StorageType >::UpdateMetaData().

std::map<std::string, long int> BIAS::Debug::_String2Debuglevel [protected, inherited]

Definition at line 518 of file Debug.hh.

Referenced by BIAS::Debug::operator=().

BIAS::UUID BIAS::ImageBase::_UID [protected]

unique id for every image

Definition at line 1064 of file ImageBase.hh.

Referenced by ImageBase(), and operator=().

std::ostream BIAS::Debug::_zDebugStream [static, protected, inherited]

Definition at line 512 of file Debug.hh.

Referenced by BIAS::GuiGTK::DeleteEvent_(), BIAS::GuiGTK::Destroy_(), BIAS::GuiGTK::DrawingAreaExposeCallback_(), BIAS::GuiGTK::GtkMain(), BIAS::GuiGTK::KeyPressEventCallback_(), BIAS::GuiGTK::LabelExposeCallback_(), BIAS::GuiGTK::MouseButtonPressCallback_(), BIAS::GuiGTK::MouseButtonReleaseCallback_(), BIAS::GuiGTK::MouseMotionCallback_(), and BIAS::Debug::operator=().

unsigned int BIAS::ImageBase::BitDepth_ [protected]

relevant bits per pixel per channel

Definition at line 1048 of file ImageBase.hh.

Referenced by BIAS::Image< StorageType >::Image(), ImageBase(), Init(), operator=(), BIAS::Image< StorageType >::Release(), Release(), and StealImage().

unsigned int BIAS::ImageBase::ChannelCount_ [protected]

number of channels per pixel

Definition at line 1044 of file ImageBase.hh.

Referenced by BIAS::Image< StorageType >::AppendChannel(), BIAS::Image< StorageType >::BicubicInterpolation(), Cut2ROI(), BIAS::ImageConvert::GetChannel(), ImageBase(), Init(), BIAS::ImageConvert::IP_ToGrey(), BIAS::ImageConvert::IP_YUV422ToGrey_(), operator=(), PixelValueBase(), BIAS::Image< StorageType >::Release(), Release(), StealImage(), BIAS::ImageConvert::ToGrey(), UpdateImageDataArrayFromImageData_(), BIAS::ImageConvert::YUV422ToGrey_(), and BIAS::ImageConvert::YUV422ToRGB_().

enum EColorModel BIAS::ImageBase::ColorModel_ [protected]

the color model of the pixels

Definition at line 1040 of file ImageBase.hh.

Referenced by BIAS::Histogram::Histogram(), ImageBase(), operator=(), BIAS::Image< StorageType >::Release(), Release(), StealImage(), and BIAS::ImageConvert::YUV422ToRGB_().

unsigned int BIAS::ImageBase::Depth_ [protected]

size of one channel of one pixel in bytes

Definition at line 1046 of file ImageBase.hh.

Referenced by BIAS::Image< StorageType >::AppendChannel(), Cut2ROI(), BIAS::ImageConvert::GetChannel(), BIAS::Image< StorageType >::Image(), ImageBase(), Init(), BIAS::ImageConvert::IP_ToGrey(), operator=(), PixelValueBase(), Release(), BIAS::Image< StorageType >::Release(), StealImage(), BIAS::ImageConvert::ToGrey(), and UpdateImageDataArrayFromImageData_().

long int BIAS::Debug::GlobalDebugLevel = 0 [static, protected, inherited]

Definition at line 514 of file Debug.hh.

unsigned int BIAS::ImageBase::Height_ [protected]

image height in pixels

Definition at line 1052 of file ImageBase.hh.

Referenced by Cut2ROI(), Flip(), FlipHorizontal(), ImageBase(), Init(), operator=(), PixelValueBase(), Release(), BIAS::Image< StorageType >::Release(), and StealImage().

void* BIAS::ImageBase::ImageData_ [protected]

a pointer to the image data

Definition at line 1062 of file ImageBase.hh.

Referenced by BIAS::ImageConvert::GetChannel(), ImageBase(), Init(), PixelValueBase(), BIAS::Image< StorageType >::PrintData(), BIAS::Image< StorageType >::PrintPointer(), Release(), BIAS::Image< StorageType >::Release(), StealImage(), and ~ImageBase().

void** BIAS::ImageBase::ImageDataArray_ [protected]

array of pointers to the first byte in an image row

Definition at line 1060 of file ImageBase.hh.

Referenced by Flip(), FlipHorizontal(), ImageBase(), BIAS::Image< StorageType >::PrintPointer(), Release(), BIAS::Image< StorageType >::Release(), StealImage(), UpdateImageDataArrayFromImageData_(), and ~ImageBase().

bool BIAS::ImageBase::InterleavedDataOrder_ [protected]

planar or interleaved: planar means we have several image planes, e.g.

for a 3x3 RGB image data is RRRRRRRRRGGGGGGGGGGBBBBBBBB while interleaved means RGBRGBRGBRGBRGBRGBRGBRGBRGB

Definition at line 1056 of file ImageBase.hh.

Referenced by BIAS::Image< StorageType >::AppendChannel(), Flip(), FlipHorizontal(), BIAS::Histogram::Histogram(), ImageBase(), Init(), operator=(), PixelValueBase(), StealImage(), and UpdateImageDataArrayFromImageData_().

ROI BIAS::ImageBase::Roi_ [protected]

roi object

Definition at line 1068 of file ImageBase.hh.

Referenced by ImageBase(), Init(), operator=(), Release(), and StealImage().

enum EStorageType BIAS::ImageBase::StorageType_ [protected]

the storage type in a pixel channel

Definition at line 1042 of file ImageBase.hh.

Referenced by BIAS::WrapBias2Ipl::CreateBiasImageCopy(), BIAS::Image< StorageType >::Image(), ImageBase(), BIAS::Image< StorageType >::Init(), Init(), BIAS::Image< StorageType >::InitWithForeignData(), operator=(), Release(), and StealImage().

const int BIAS::ImageBase::Version_ = VERSION_NUMBER [static, protected]

version number of imagebase class

Definition at line 1038 of file ImageBase.hh.

unsigned int BIAS::ImageBase::Width_ [protected]

image width in pixels

Definition at line 1050 of file ImageBase.hh.

Referenced by BIAS::Image< StorageType >::AppendChannel(), Cut2ROI(), FlipHorizontal(), BIAS::ImageConvert::GetChannel(), ImageBase(), Init(), BIAS::ImageConvert::IP_ToGrey(), operator=(), PixelValueBase(), BIAS::Image< StorageType >::Release(), Release(), StealImage(), BIAS::ImageConvert::ToGrey(), and UpdateImageDataArrayFromImageData_().

unsigned int BIAS::ImageBase::WidthStep_ [protected]

size of a line in bytes for interleaved, NOT nr . of pixels (but size a line in one plane for planar)

Definition at line 1058 of file ImageBase.hh.

Referenced by BIAS::Image< StorageType >::AppendChannel(), Cut2ROI(), FlipHorizontal(), BIAS::ImageConvert::GetChannel(), ImageBase(), Init(), BIAS::ImageConvert::IP_ToGrey(), operator=(), PixelValueBase(), BIAS::Image< StorageType >::Release(), Release(), StealImage(), BIAS::ImageConvert::ToGrey(), and UpdateImageDataArrayFromImageData_().

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

Base/Image/ImageBase.hh
Base/Image/ImageBase.cpp
Base/Image/ImageBaseInline.hh


Get functions
BIASImageBase_EXPORT std::ostream &	operator<< (std::ostream &os, const ImageBase &img)
BIASImageBase_EXPORT std::istream &	operator>> (std::istream &is, ImageBase &img)
bool	DimensionMatch (const BIAS::ImageBase &other) const
bool	FormatMatch (const BIAS::ImageBase &d) const
unsigned int	GetBitDepth () const
	returns the bits per channel Is not necessairily 8*sizeof(StorageType), could be fewer bits, eg.
unsigned int	GetByteDepth () const
int	GetChannel (const ImageBase &source, const unsigned int channel)
	copies one specific channel from source to Image can only be called from an planar image, so call ToPlanar() before so far only implemented for CM_YUYV422, BGR and RGB
unsigned int	GetChannelCount () const
	returns the number of Color channels, e.g.
enum EColorModel	GetColorModel () const
unsigned int	GetDepth () const
	returns the bytes per channel, which is the sizeof(StorageType) Should match GetSizeDepth(GetStorageType()).
unsigned int	GetHeight () const
void *	GetImageData ()
const void *	GetImageData () const
void **	GetImageDataArray () const
	Get an array of pointers to image data.
const MetaData *	GetMetaData () const
MetaData *	GetMetaData ()
unsigned long int	GetPixelCount () const
	returns number of pixels in image
unsigned int	GetPixelPosition (unsigned int x, unsigned int y, unsigned short int channel=0) const
	returns the Position (index from array start) in ImageData Warning: until 2005-01-04 the position inbyte was returned but used as position in <StorageType> (ImageDraw).
unsigned int	GetSize () const
	returns the image size in bytes = count - NOT the dimension DEPRECATED Please use GetSizeByte instead to avoid storage type confusion on pointers and char/wideChar unicode
unsigned int	GetSizeByte () const
	returns the nr.
enum EStorageType	GetStorageType () const
const BIAS::UUID &	GetUID () const
	returns the UUID of the image
int	GetVersionNumber () const
unsigned int	GetWidth () const
unsigned int	GetWidthStep () const
	returns the number of bytes per line
bool	IsInterleaved () const
bool	IsPlanar () const
void	SetMetaData (const MetaData &m)
static void	PrintPixelValue (const ImageBase &im, const unsigned int x, const unsigned int y, const unsigned short channel=0, std::ostream &os=std::cout)
Misc functions
void	BIASToTextureCoordinates (const double &biasx, const double &biasy, double &gl_x, double &gl_y) const
	transfer BIAS image coordinates [0.
void	ClearDataPointer ()
	set data pointer to NULL, such that image IsEmpty _without_ deletion of data.
int	Display () const
	display image simple signature interface for Debugger usage This function can be used to display an (intermediate) image "interactively" with the MS Visual Studio Debugger in "Watch+Debug" expert mode.
int	Display (const bool &waitForKey, const unsigned int &delayMsec, const float &scale) const
	DEPRECATED to avoid interface conflict between char* and bool.
int	Display (const std::string &DestWin) const
	simpler interface for the above.
int	Display (const std::string &DestWin, const bool &autoresize, const bool &moveToTopLeft, const bool &waitForKey, const unsigned int &delayMsec=DEFAULT_Display_delay, const float &scale=DEFAULT_32to8_scale, const bool &allowAlphaWindow=false) const
	OpenCV onscreen popup display, very useful for fast debugging. (JW).
bool	IsPositionInImage (const int &x, const int &y) const
	check if image contains that pixel position
bool	IsPowerOfTwoSize () const
int	MoveToClosestPositionInImage (int &x, int &y) const
	find closest valid pixel position to x,y
bool	NotBiggerPixelAndSameChannelCount (const ImageBase &Image) const
	checks if data area has bigger or the same "size" as Image of other type
void *	PixelValueBase (unsigned x, unsigned y, unsigned channel=0)
bool	PowerOfTwoSize (unsigned int &width2, unsigned int &height2) const
void	PrintHeader (std::ostream &os=std::cout) const
void	RedirectImageDataPointer (void *data)
	This method takes data and set the internal image data pointer to this.
void	ReleaseImageDataPointer ()
	Releases ImageData_ (to be used together with RedirectImageDataPointer).
bool	SamePixelAndChannelCount (const ImageBase &Image) const
	checks if data area has same "size" as Image of other type
void	SetZero ()
	zeroes the image
void	TextureToBIASCoordinates (const double &gl_x, const double &gl_y, double &biasx, double &biasy) const
	transfer GL texture coordinates [0.
static int	GetChannelcount (const enum BIAS::ImageBase::EColorModel &colormodel)
	get the number of channels corresponding to the enum ColorModel Determines the number of (packed) data values.
static int	GetSizeByte (const enum BIAS::ImageBase::EStorageType &storagetype)
	get the size in Byte of the type corresponding to a storagetype uses sizeof(type) internally.
static int	GetSizeUnits (const enum BIAS::ImageBase::EColorModel &colormodel)
	get the number of (packed) data values of color model E.g: CM_Grey : 1 CM_YUYV422 : 2 packs 3 channel YUV into 2 Bytes CM_RGB : 3 CM_BGRA : 4 CM_Bayer_GBRG : 1 packed Bayer pattern CM_PGR_XB3_F7M3_GBRG : 3 packed three Bayer patterns w.
static int	GetStorageSizeByte (const unsigned int &width, const unsigned int &height, const unsigned int nChannels, const enum EStorageType storageType)
	computes the storage data size in Byte required for a given video format.
static bool	IsPowerOfTwoSize (const unsigned int w, const unsigned int h)
static unsigned int	PowerOfTwoSize (const unsigned int &val)
static void	StringToColorModel (const std::string &str, ImageBase::EColorModel &cm)
static void	StringToStorageType (const std::string &str, ImageBase::EStorageType &st)
Public Types
enum	EColorModel { CM_invalid = -1, CM_Grey, CM_RGB, CM_BGR, CM_YUYV422, CM_UYVY422, CM_YUV420P, CM_YUV444, CM_YUV411, CM_HSV, CM_HSI_OBS, CM_DV, CM_RGBA, CM_GreyA, CM_Bayer_RGGB, CM_Bayer_GBRG, CM_Bayer_GRBG, CM_Bayer_BGGR, CM_HSL, CM_hsL, CM_SymTensor2x2, CM_BGRA, CM_RGBE, CM_PGR_XB3_F7M3_GBRG, CM_DepthAndVariance, CM_YUYV, CM_LUV, CM_XYZ, CM_LAB, CM_Disparity, CM_Depth, CM_I1I2I3, CM_DOES_NOT_EXIST }
	These are the most often used color models. More...
enum	EStorageType { ST_invalid = -1, ST_unsignedchar, ST_char, ST_unsignedshortint, ST_shortint, ST_unsignedint, ST_int, ST_float, ST_double }
Public Member Functions
void	AddDebugLevel (const std::string &name)
void	AddDebugLevel (const long int lv)
virtual ImageBase *	Clone () const
	virtual covariant copy constructor which produces the same type of object as the template object (Image, Camera, .
void	CopyIn_NoInit (void *data)
	Take some data and fill it into the Image.
bool	DebugLevelIsSet (const std::string &name) const
bool	DebugLevelIsSet (const long int lv) const
template<class outputType>
void	GetChannel (const BIAS::ImageBase &im, const unsigned int channelId, outputType *channelOut)
int	GetDebugLevel () const
void	GetDebugStream (std::ostream &os) const
std::ostream &	GetDebugStream () const
template<class castType>
castType	GetValue (const ImageBase &im, const unsigned int x, const unsigned int y, const unsigned int channel)
	ImageBase (unsigned int width, unsigned int height, unsigned int channels=1, enum EStorageType storageType=ST_unsignedchar, const bool interleaved=true)
	Constructor, initializing image size and channels.
	ImageBase (const ImageBase &im)
	ImageBase ()
void	Init (unsigned int width, unsigned int height, unsigned int nChannels=1, enum EStorageType storageType=ST_unsignedchar, const bool interleaved=true)
	Initialize image size and channels.
bool	IsEmpty () const
	check if ImageData_ points to allocated image buffer or not
long int	Name2DebugLevel (const std::string &name) const
	looks up a debuglevel in the internal map, returns 0 if not found
long int	NewDebugLevel (const std::string &name)
	creates a new debuglevel
void	PrintDebugLevel (std::ostream &os=std::cout) const
void	ReInit (const unsigned int &width, const unsigned int &height, const unsigned int nChannels=1, const enum EStorageType storageType=ST_unsignedchar, const bool interleaved=true, const EColorModel colormodel=CM_Grey)
	(Re-)Initialize Image data if required.
void	Release (const bool reset_storage_type=false)
	Free the allocated data structures Hands off: Do !!NOT!! change the default of reset_storage_type: ImageBase::Release() is also implicitly called for templated images when releasing the storage type here, it becomes possible to assign a float image to an unsigned char image via ImageBase: Image<float> f; Image<unsigned char> uc; ImageBase ibf = dynamic_cast<ImageBase >(f); ImageBase ibuc = dynamic_cast<ImageBase >(uc); (ibf) = (ibuc);.
void	RemoveDebugLevel (const std::string &name)
void	RemoveDebugLevel (const long int lv)
template<class inputType>
void	SetChannel (const BIAS::ImageBase &im, const unsigned int channelId, const inputType *channelIn)
void	SetDebugLevel (const std::string &name)
void	SetDebugLevel (const long int lv)
void	SetDebugStream (const std::ostream &os)
template<class inputType>
void	SetValue (const ImageBase &im, const unsigned int x, const unsigned int y, const unsigned int channel, const inputType val)
void	ShowDebugLevel (std::ostream &os=std::cout) const
	prints all internally known debuglevels
int	StealImage (ImageBase &source)
	steals the image data array from source, after releasing the actual image data and sets source image data to NULL
virtual	~ImageBase ()
Region of Interest Functions
Important: the ROI has a size of (lrx-ulx)*(lry-uly) that means the lower right point is not part of the ROI!
int	Cut2ROI ()
	reduces image to current ROI, !!! image size changes !!!
int	GetCopyOfROI (ImageBase &copy) const
	returns a copy of ROI (a new image) lower right point excluded, only interleaved images !
int	GetCopyOfROI2 (ImageBase &copy) const
	like GetCopyOfROI, but with lower right point included only interleaved images !
void	GetROI (int &UpperLeftX, int &UpperLeftY, int &LowerRightX, int &LowerRightY) const
	deprecated, use GetROICorners()
void	GetROI (unsigned int &UpperLeftX, unsigned int &UpperLeftY, unsigned int &LowerRightX, unsigned int &LowerRightY) const
	deprecated, use GetROICorners()
const ROI *	GetROI () const
ROI *	GetROI ()
	Returns a pointer to the roi object.
void	GetROICorners (int &UpperLeftX, int &UpperLeftY, int &LowerRightX, int &LowerRightY) const
	access region of interest rectangle JW
void	GetROICorners (unsigned int &UpperLeftX, unsigned int &UpperLeftY, unsigned int &LowerRightX, unsigned int &LowerRightY) const
	access region of interest rectangle JW
const unsigned int	GetROILowerRightX () const
	deprecated, use GetROI()->GetCorners()
const unsigned int	GetROILowerRightY () const
	deprecated, use GetROI()->GetCorners()
const unsigned int	GetROIUpperLeftX () const
	deprecated, use GetROI()->GetCorners()
const unsigned int	GetROIUpperLeftY () const
	deprecated, use GetROI()->GetCorners()
const bool	IsInROI (const double &x, const double &y) const
int	Paste2ROI (const ImageBase &Image)
	paste Image to current ROI
void	PrintROI (std::ostream &os=std::cout) const
	deprecated, use 'os << *GetROI()'
void	SetOutsideROIZero ()
	sets all pixel not in ROI to zero
int	SetROI (const ROI &roi)
int	SetROI (unsigned int UpperLeftX, unsigned int UpperLeftY, unsigned int LowerRightX, unsigned int LowerRightY)
	deprecated, use SetROICorners()
int	SetROICorners (unsigned int UpperLeftX, unsigned int UpperLeftY, unsigned int LowerRightX, unsigned int LowerRightY)
void	UnsetROI ()
	deprecated, use GetROI()->UnsetROI()
Padding and Appending
int	Flip ()
	flips the image vertically (row order is inverted) In place function return 0 in case of success, -1 otherwise
int	FlipHorizontal ()
	flips the image horizontal (column order is inverted) In place function return 0 in case of success, -1 otherwise
int	Mirror ()
	interface for the above JW
int	Pad (const unsigned int &newwidth, const unsigned int &newheight, const int &padVal=0)
int	Pad (BIAS::ImageBase &dest, const unsigned int &newwidth, const unsigned int &newheight, const int &padVal=0) const
int	PadToPowerOfTwo (const int &padVal=0)
	in place version of the above
int	PadToPowerOfTwo (BIAS::ImageBase &dest, const int &padVal=0) const
	increase the size of this image to next power of two (e.g.
int	PadToPowerOfTwoAndFlip (const int &padVal=0)
	first pad, then flip.
int	ZeroPad (const unsigned int newwidth, const unsigned int newheight, unsigned char bgcolor=0)
	backward compatibility interface for Pad.
Set functions
void	InvalidateUID ()
	sets the image's uid to invalid
void	SetBitDepth (unsigned bitdepth)
	needed by ImageIO
void	SetColorModel (EColorModel Model)
void	SetInterleaved (bool interleaved)
void	SetUID (const BIAS::UUID &id)
Operators
ImageBase &	operator= (const ImageBase &Source)
	assignment operator, allocates memory structure via Init only if necessary
bool	operator== (const ImageBase &img) const
	comparison operator, based upon the adresses of the actual image data
Static Public Member Functions
static void	GetChannel (const ImageBase &im, const unsigned int channelId, half *channelOut)
template<class outputType>
static void	GetChannel (const ImageBase &im, const unsigned int channelId, outputType *channelOut)
	Copy channel, determines the internal ImageBase type and casts it to the output type.
static long int	GetGlobalDebugLevel ()
template<class castType>
static castType	GetValue (const ImageBase &im, const unsigned int x, const unsigned int y, const unsigned int channel=0)
	Determines the internale ImageBase type and casts it to the output type.
template<class inputType>
static void	SetChannel (const ImageBase &im, const unsigned int channelId, const inputType *channelIn)
	Copy channel, determines the internal ImageBase type and casts the input type to the type foreseen in im.
static void	SetGlobalDebugLevel (long int lev)
template<class inputType>
static void	SetValue (const ImageBase &im, const unsigned int x, const unsigned int y, const unsigned int channel, const inputType val)
	Determines the internal ImageBase type and casts the input type to the type foreseen in im.
Protected Member Functions
long	ConsumeNextFreeDebuglevel_ ()
	returns the next available debuglevel
void	SetStorageType (const EStorageType st)
	changes StorageType data mmeber
int	UpdateImageDataArrayFromImageData_ ()
	recomputes pointer array returned by GetImageDataArray
Protected Attributes
long int	_liDebugLevel
long int	_liNextDebugLevel
	new concept, debuglevel are managed here in the debug class
MetaData	_MetaData
	additional data block, handled by derived classes
std::map< std::string, long int >	_String2Debuglevel
BIAS::UUID	_UID
	unique id for every image
unsigned int	BitDepth_
	relevant bits per pixel per channel
unsigned int	ChannelCount_
	number of channels per pixel
enum EColorModel	ColorModel_
	the color model of the pixels
unsigned int	Depth_
	size of one channel of one pixel in bytes
unsigned int	Height_
	image height in pixels
void *	ImageData_
	a pointer to the image data
void **	ImageDataArray_
	array of pointers to the first byte in an image row
bool	InterleavedDataOrder_
	planar or interleaved: planar means we have several image planes, e.g.
ROI	Roi_
	roi object
enum EStorageType	StorageType_
	the storage type in a pixel channel
unsigned int	Width_
	image width in pixels
unsigned int	WidthStep_
	size of a line in bytes for interleaved, NOT nr . of pixels (but size a line in one plane for planar)
Static Protected Attributes
static std::ostream	_zDebugStream
static long int	GlobalDebugLevel = 0
static const int	Version_ = VERSION_NUMBER
	version number of imagebase class
Friends
class	ImageConvert
class	ImageIO
class	WrapBias2Ipl

BIAS::ImageBase Class Reference [Image and Image Base]

Get functions

Misc functions

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Friends

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation

BIAS::ImageBase Class Reference
[Image and Image Base]