NumImageC<class PixelT> - Extension of ImageC that provides numerical operations

User Documentation

Centre for Vision, Speech & Signal Processing

Comments:
The member functions of this class are designed to work with real pixel types. However, since the class is templated, they will work with other pixel types provided the necessary pixel operations are available. If the combination of member function and pixel type you require is not available, please request it.

Parent Classes:

ImageC

Methods:

NumImageC(): Creates an empty image.
NumImageC(IStreamC & inS,BooleanT useHeader = false): Creates an image from the input stream.
NumImageC(SizeT rows,SizeT columns): Creates a new image.
NumImageC(const ImageRectangleC & rect): Creates a new image.
NumImageC(const NumImageC<PixelT> & image,const ImageRectangleC & rect): Creates a new access to the subimage.
NumImageC(const NumImageC<PixelT> & image): Creates a new identifier for the image.
NumImageC(SizeT rows,SizeT columns,PixelT * value,BooleanT rm = FALSE): Creates a new image which is connected to the memory pointed by "value".
Use it to create a NumImageC object from image data stored in a "C"-style 1-D array.
If "rm" is TRUE, the memory pointed to by the pointer "value" is deallocated using delete function during destruction.
NumImageC(SizeT rows,SizeT columns,const BufferRC<PixelT> & buff): Creates a new image which is connected to the memory in "buff".
Can be used to access data stored in other amma arrays as an image.
NumImageC(const ImageC<PixelT> & img): Constructor from ImageC.
NumImageC<ByteGreyValueT> ClipToFitByte() const: Creates image by clipping this image to fit in range [0..255]
N.B.: PixelT must support "<" and ">" operators
NumImageC<PixelT> ScaleToFitByte() const: Creates image by scaling this image to fit in range [0..255]
N.B.: PixelT must support "<" and ">" operators
PixelT MaxValue() const: Find the maximum value in the image
N.B.: PixelT must support "<" and ">" operators
PixelT MinValue() const: Find the minimum value in the image
N.B.: PixelT must support "<" and ">" operators
NumImageC<PixelT> operator-(): Returns the negative of this image (unary minus operator)
NumImageC<PixelT> operator+(const TypeT & pix) const: Adds "pix" to each pixel of "this" image.
NumImageC<PixelT> operator-(const TypeT & pix) const: Subtracts "pix" from each pixel of "this" image.
NumImageC<PixelT> operator*(const TypeT & alpha) const: Multiplies each pixel of "this" image by alpha.
NumImageC<PixelT> operator/(const TypeT & alpha) const: Divides each pixel of "this" image by alpha.
NumImageC<PixelT> operator+(const ImageC<Pixel2T> & image) const: Adds `image' values pixel by pixel to `this' image.
NumImageC<PixelT> operator+(const NumImageC<Pixel2T> & image) const: Adds `image' values pixel by pixel to `this' image.
NumImageC<PixelT> operator-(const ImageC<Pixel2T> & image) const: Subtracts `image' values pixel by pixel from `this' image.
NumImageC<PixelT> operator-(const NumImageC<Pixel2T> & image) const: Subtracts `image' values pixel by pixel from `this' image.
void operator+=(const TypeT & alpha): Adds `alpha' to all pixel values.
void operator-=(const TypeT & alpha): Subtracts `alpha' from all pixel values.
void operator*=(const TypeT & alpha): Multiplies all pixel values by `alpha'.
void operator/=(const TypeT & alpha): Divides all pixel values by `alpha'.
void operator+=(const ImageC<Pixel2T> & image): Adds `image' values pixel by pixel to `this' image.
void operator+=(const NumImageC<Pixel2T> & image): Adds `image' values pixel by pixel to `this' image.
void operator-=(const ImageC<Pixel2T> & image): Subtracts `image' values pixel by pixel from `this' image.
void operator-=(const NumImageC<Pixel2T> & image): Subtracts `image' values pixel by pixel from `this' image.
void operator*=(const ImageC<Pixel2T> & image): Multiplies all values of `this' image pixel-by-pixel.
void operator*=(const NumImageC<Pixel2T> & image): Multiplies all values of `this' image pixel-by-pixel.
void operator/=(const ImageC<Pixel2T> & image): Divides all values of `this' image pixel-by-pixel.
void operator/=(const NumImageC<Pixel2T> & image): Divides all values of `this' image pixel-by-pixel.
PixelT BiLinear(const Point2dC & pnt) const: Get a bi linearly interpolated pixel value.

#include "amma/Image.hh"

ImageC<PixelT> Copy() const: Creates another physical copy of this image.
void Copy(const ImageC<PixelT> & image): Copies the contents of image "img" into this image.
void Copy(const ImageRectangleC & rect,const PixelC & newOrigin): Copies the region of the image defined by rectangle "rect" into the region whose origin is "newOrigin".
ImageAC * ACopy() const: A physical copy of this image.
ImageAC * AnotherImage() const: Creates a new empty image of the same type and size as this image is.
const ImageC<PixelT> & operator=(const ImageC<PixelT> & image): Assigment of a big object.
void ReflectUp(const ImageRectangleC & rect): Mirrors the image rectangle along its top edge.
void ReflectDown(const ImageRectangleC & rect): Mirrors the image rectangle along its bottom edge.
void ReflectLeft(const ImageRectangleC & rect): Mirrors the image rectangle along its left edge.
void ReflectRight(const ImageRectangleC & rect): Mirrors the image rectangle along its right edge.
void ReflectFrom(const ImageRectangleC & rect): Mirrors the image rectangle "rect" along its sides to fill the whole image.
void Rotate90(const ImageC<PixelT> & originalImage): The values of image "originalImage" rotated about PI/2 rad and shifted to have the original upper-left corner and are saved into this image.
void Rotate180(const ImageC<PixelT> & originalImage): The values of image "originalImage" rotated about PI rad and shifted to have the original upper-left corner and are saved into this image.
void Rotate270(const ImageC<PixelT> & originalImage): The values of image "originalImage" rotated about 3/2*PI rad and shifted to have the original upper-left corner and are saved into this image.
ImageC<PixelT> Rotate(const Point2dC & center,RealT angle,PixelT background) const: The values of this image are rotated about "angle" (in rad) and saved to the result image.
Note the AMMA convention that the 1st or "x" coordinate of Point2dC is associated with the image row no., and the 2nd or "y" coordinate with the image column no.
void Rotate(const ImageC<PixelT> & originalImage,const Point2dC & center,RealT angle,PixelT background): The values of image "originalImage" rotated about "angle" rad are saved into this image.
Note the AMMA convention that the 1st or "x" coordinate of Point2dC is associated with the image row no., and the 2nd or "y" coordinate with the image column no.
void ShiftRowIndexes(const IndexT offset): Row indices of the items will be shifted by "offset".
There must be only one reference to this image.
For +ve "offset", the image is shifted down, or the coordinate system is shifted up.
void ShiftColIndexes(const IndexT offset): Column indices of the items will be shifted by "offset".
There must be only one reference to this image.
For +ve "offset", the image is shifted down, or the coordinate system is shifted up.
ImageC<PixelT> Subsample(IntT factor = 2) const: returns an image subsampled by a factor of "factor"
void SetOrigin(const PixelC & newOrigin): The image coordinates are changed so that the top left pixel will have coordinates of "newOrigin".
There must be only one reference to this image.

Grey level operations.
ImageC<PixelT> & Fill(PixelT value): Fills the image with "value"
ImageC<PixelT> & Frame(PixelT value): Fills a 1-pixel-wide border around the image with "value"
ImageC<PixelT> & Frame(PixelT v,const ImageRectangleC & rect): Fills a 1-pixel-wide rectangle with "v";
the rectangle is the intersection of "this" with "rect".
ImageC<PixelT> Pad(const ImageRectangleC & rect) const: Creates a new image whose frame is from "rect", with pixels copied from "this".
Where the new image lies outside "this", it is padded out with the nearest value from "this".

Logical conditions.
BooleanT IsValid() const: Returns FALSE if the image does not have a valid data area allocated

Access to pixels values.
const RangeBufferAccessC<PixelT> operator[](IndexT r) const: Access to the row of the row of pixels.
RangeBufferAccessC<PixelT> operator[](IndexT r): Access to the row of the row of pixels.
PixelT & operator[](const Index2dC & pxl): Returns the content of the pixel.
const PixelT & operator[](const Index2dC & pxl) const: Returns the content of the pixel.
PixelT & operator[](const PixelC & pxl): Returns the content of the pixel.
const PixelT & operator[](const PixelC & pxl) const: Returns the content of the pixel.
const PixelT * CRow(PixelIndexT row) const: Access to the beginning of the row, eg. t
The returned pointer points to the first pixel of the "row".
PixelT * Row(PixelIndexT row): Access to the beginning of the constant "row"
I.e. the returned pointer points to the first pixel of "row".
void Save(ostream & outS,BooleanT useHeader = TRUE) const: Saves templated image to stream.
For byte images it will save them in either PGM or PPM binary format. For other types it will save them in ascii if a suitable stream operator has been written for the templated class. NB. These treat images of ByteGreyValueT specialy, the image values are read as numbers not as charactors.
void Load(istream & outS,BooleanT useHeader = TRUE): Loads templated image type from ascii stream.
Should not be used for binary PGM/PPM files, but should work on most templated types. NB. These treat images of ByteGreyValueT specialy, the image values are written as numbers not as charactors.
PixelT ** StartAddress() const: Returns the pointer to the table of pointers to image.
This being public is really only a hack! EXPERTS ONLY!
BufferRC<PixelT> & Buffer(): Access buffer where data is stored.
const BufferRC<PixelT> & Buffer() const: Access buffer where data is stored.

#include "amma/BasImage.hh"

const ImageRectangleC & Rectangle() const: Returns the image rectangle.
const Index2dC & Origin() const: Returns the upper-left pixel coordinates of the image rectangle.
const Index2dC & End() const: Returns the lower right pixel coordinates of the image rectangle.
const ImageFileInfoC & ImageFileInfo() const: Access to the origin.
const BaseImageC & BaseImage() const: access to the constant object
BaseImageC & BaseImage(): access to the object
Modification of the object --------------------------
void SetRowSubRange(const IndexT newMin,const IndexT newMax): The range of indexes of the array will be constrained
void SetColSubRange(const IndexT newMin,const IndexT newMax): The range of indexes of the array will be constrained.
void SetSubRange(const ImageRectangleC & range): Constrains the domain of the image.
void SetFullRectangle(): Sets the working rectangle to be allocated rectangle of the image.
void SetImageFileInfo(ImageFileInfoC * newInfo): Sets a new image file information respecting the current size of the image.
BooleanT IsEmpty() const: Returns TRUE if the image has zero size
void ErrDifferentSize(const BaseImageC & image,char * functionName) const: Triggers an error event if this image has different size from `image'.
The functionName should be the name of the function that triggers the error event.
SizeT Rnum() const: Returns number of rows.
SizeT Cnum() const: Returns number of columns.
IndexT TRow() const: Returns the top row index.
IndexT LCol() const: Returns the left side column index.
IndexT BRow() const: Returns the bottom row index.
IndexT RCol() const: Returns the right side column index.
LongIntT Area() const: Returns the area of the image rectangle expressed in number of indexs.
UIntT Count() const: Returns the number of refrences to this object.
NB. The following definition is now obsolete, The value 0 means there is no other reference to this object.
const ImageRectangleC & AllocatedRect() const: Access allocated rectangle.
BooleanT IsBlock() const: Returns TRUE if the image is allocated as one block of memory.

#include "amma/ImageA.hh"

ImageAC * ACopy() const: A physical copy of the image.
ImageAC * AnotherImage() const: Creates a new empty image of the same type and size as this image is.
const ImageRectangleC & Rectangle() const: Returns the working image rectangle.
void ShiftRowIndexes(const IndexT offset): all indexes of the items will be shift by 'offset'
void ShiftColIndexes(const IndexT offset): all indexes of the items will be shift by 'offset'
void SetRowSubRange(const IndexT newMin,const IndexT newMax): the range of indexes of the array will be constrained
void SetColSubRange(const IndexT newMin,const IndexT newMax): the range of indexes of the array will be constrained
const ImageFileInfoC & ImageFileInfo() const: access to the const origin

Programmer:Radek Marik, Documentation by CxxDoc: Tue Mar 20 10:48:08 2001

NumImageC<class PixelT>

Extension of ImageC that provides numerical operations

include	"amma/NumImage.hh"
User Level:	Default
Library:	Image
Example:	doNumClassComb.cc
Section:	Image.Image Representations
In Scope:	std

Grey level operations.

Logical conditions.

Access to pixels values.