|
Basic Image AlgorithmS Library
2.8.0
|
|
Basic Image AlgorithmS Library
2.8.0
|
Abstract base class to map an image (texture) src to an image sink with an arbitrary continuous function (e.g. More...
#include <Image/BackwardMapping.hh>
Inheritance diagram for BIAS::BackwardMapping< InputStorageType, OutputStorageType >: Collaboration diagram for BIAS::BackwardMapping< InputStorageType, OutputStorageType >:Public Member Functions | |
| BackwardMapping () | |
| Constructor. More... | |
| virtual int | GetBoundingBox (unsigned int, unsigned int, unsigned int sinkwidth, unsigned int sinkheight, int &tlx, int &tly, int &brx, int &bry) |
| calculates the bounding box in sink image, where to do the backward mapping. More... | |
| int | GetJacobian (const HomgPoint2D &sink, Matrix2x2< double > &Jacobian) const |
| get jacobian (including concatenated mappings) More... | |
| int | GetSourceCoordinates (const HomgPoint2D &sink, HomgPoint2D &source) const |
| wrapper function to allow the lookup implementation to be shared with other algorithms. More... | |
| void | SetConcatenation (BIAS::BackwardMapping< InputStorageType, OutputStorageType > *pCon) |
| avoid intermediate image and concatenate two backward mappings More... | |
| void | SetPyramidSize (const int newsize) |
| sets pyramid size to pyramid and updates if neccessary More... | |
| virtual void | UpdatePyramidSize (const ROI &ROIsink, int srcwidth, int srcheight) |
| uses corners of sink roi (and few other sample points) to estimate maximum local scaling (and thus required pyramid level) More... | |
| virtual | ~BackwardMapping () |
| Destructor. More... | |
User interfaces | |
| int | Map (const Image< InputStorageType > &src, Image< OutputStorageType > &sink, InterpolationMethod=MapTrilinear, bool newSink=false, double SuperSampling=1.0) |
| backward mapping with various interpolations More... | |
| int | Map (Image< OutputStorageType > &sink) |
| use this for subsequent calls to avoid pyramid recalculation when using tri-filtering More... | |
| int | GetDisplacementMap (Image< float > &dismap, int width, int height) |
| precomputes lookup coordinates and computes displacement map int TEXTURE coordinates, according to the size of src (or width,height) More... | |
| int | GetDisplacementMap (Image< float > &dismap, Image< InputStorageType > &src) |
| int | PrepareLookupTableMapping (const Image< InputStorageType > &src, Image< OutputStorageType > &sink, InterpolationMethod method, bool newSink=false) |
| precomputes lookup coordinates for accessing src More... | |
| int | MapWithLookupTable (const Image< InputStorageType > &src, Image< OutputStorageType > &sink, InterpolationMethod method) |
| applies precomputed coordinates in src, fast for repeated usages of same mapping function More... | |
| int | GetLookupTable (const std::string &filename, InterpolationMethod method) |
| Returns the LUT generated by PrepareLookupTableMapping() as an file. More... | |
| int | GetLookupTable (float *lutImageRow, InterpolationMethod method) |
| int | GetLookupTableSize (unsigned int &width, unsigned int &channels, InterpolationMethod method) |
| returns the size of the current LUT. More... | |
| int | SetLookupTable (const std::string &filename, InterpolationMethod &method) |
| Loads the LUT from a file, replaces the call to PrepareLookupTableMapping(). More... | |
| int | SetLookupTable (const float *lutImageRow, unsigned int width, InterpolationMethod &method) |
Static Public Member Functions | |
| static void | GenerateTestImage (Image< InputStorageType > &testimage, bool highFrequencyCross=true, InputStorageType dark=5, InputStorageType bright=127, const Matrix3x3< double > &Hinv=Matrix3x3< double >(MatrixIdentity)) |
| generates a siemens star like test image with lots of different frequencies to test backward mapping More... | |
Protected Member Functions | |
| virtual void | BuildPyramid_ (const Image< InputStorageType > &source, bool forceInit=true, int numlayers=-1) |
| compute maximum number of pyramid levels needed More... | |
| virtual int | CalcCoordOffset_ (const Image< OutputStorageType > &sink, const Image< InputStorageType > &source) |
| result in offsetX_,offsetY_ More... | |
| virtual int | ChangeImgSize_ (Image< OutputStorageType > &, const Image< InputStorageType > &) |
| void | ClipBoundingBoxToROICorners_ (const BIAS::Image< OutputStorageType > &sink, int &tlx, int &tly, int &brx, int &bry) const |
| clip computed region in dest image to roi More... | |
| void | ClipValue_ (const double &value, OutputStorageType &newvalue) |
| clip interpolated value to outputstoragetype and merge old and new value according to alpha More... | |
| template<> | |
| void | ClipValue_ (const double &value, unsigned char &newvalue) |
| template<> | |
| void | ClipValue_ (const double &value, float &newvalue) |
| template<> | |
| void | ClipValue_ (const double &value, unsigned char &newvalue) |
| template<> | |
| void | ClipValue_ (const double &value, float &newvalue) |
geometrical coordinate mapping functions | |
| virtual int | GetSourceCoordinates_ (const HomgPoint2D &sink, HomgPoint2D &source) const |
| actual mapping function which takes a point from sink and computes a point in source and a local sampling frequency More... | |
| virtual int | GetJacobian_ (const HomgPoint2D &sink, Matrix2x2< double > &Jacobian) const |
| numeric approximation of jacobian, reimplement in derived class to make an analytic jacobian More... | |
| void | ComputeLocalPyramidLayer_ (const HomgPoint2D &p_sink, double &localscale) |
| computes pyramid layer for trilinear filtering, e.g. More... | |
pixel-value-mapping worker functions | |
| int | MapTri_ (Image< OutputStorageType > &sink) |
| map image avoiding aliasing More... | |
| int | MapTrilinearGreySimple_ (Image< OutputStorageType > &sink) |
| fast trilinear grey without special features More... | |
| int | MapBi_ (const Image< InputStorageType > &source, Image< OutputStorageType > &sink, InterpolationMethod interpolationQuality) |
| bilinear, bicubc and nearest neighbor interpolation More... | |
| int | GetImageValue_ (const double &xsource, const double &ysource, const Image< InputStorageType > &im, unsigned int channel, double &result) |
| worker function, which handles bilinear/bicubic interpolation, borders and weights More... | |
| int | GetTrilinearImageValue_ (const double &xsource, const double &ysource, const double &scale, unsigned int channel, double &result) |
| worker function, which handles bilinear/bicubic interpolation, pyramid levels, borders and weights More... | |
| int | GetAnisotropicImageValue_ (const double &xsource, const double &ysource, Matrix2x2< double > &Jacobian, unsigned int channel, double &thereturnvalue) |
| use jacobian of mapping function to do anisotropic antialiasing More... | |
Protected Attributes | |
| bool | aliasing_ |
| set to true if possibility of aliasing is detected during mapping More... | |
| BIAS::Image< float > | alphaImg_ |
| has same size as overlap region used for blending More... | |
| bool | autoPyramidSize_ |
| pyramid size set by user or computed automatically ? More... | |
| double | height_ |
| source image height More... | |
| bool | incomplete_ |
| set to true if not every pixel could be computed More... | |
| InterpolationMethod | interpolationType_ |
| which interpolation method are we using More... | |
| int | offsetX_ |
| needed for newDist More... | |
| int | offsetY_ |
| BackwardMapping < InputStorageType, OutputStorageType > * | pConcatenation_ |
| BWM_LUT_Entry_Anisotropic * | pLUT_Ani_ |
| NOT IMPLEMENTED (YET ?) More... | |
| BWM_LUT_Entry_Bicubic * | pLUT_Bic_ |
| BWM_LUT_Entry_Bilinear * | pLUT_Bil_ |
| int | pLUT_Bil_size |
| BWM_LUT_Entry_Nearest * | pLUT_Nea_ |
| lookup-tables for precomputed positions in source, same size as dst.PixelCount More... | |
| int | pLUT_Nea_size |
| BWM_LUT_Entry_Trilinear * | pLUT_Tri_ |
| int | pLUT_Tri_size |
| PyramidImage< InputStorageType > | pyramid_ |
| this contains a pyramid of the last source image for anti-aliasing More... | |
| unsigned | pyramidSize_ |
| bool | rangeChecked_ |
| The interpolated value is computed in double; if clipped value is not specialized for your output storage type (e.g. More... | |
| ROI | ROI_ |
| the roi of the last source image More... | |
| double | superSampling_ |
| if larger than 1, super resolution is active More... | |
| double | width_ |
| source image width More... | |
Abstract base class to map an image (texture) src to an image sink with an arbitrary continuous function (e.g.
rotation, homography, undistortion, rectification, ...). Provides interpolation, border checking and anti-aliasing.
If you want to learn more about texture handling, a good source is Paul Heckbert: "Fundamentals of Texture Mapping and Image Warping", Master's thesis, UCB/CSD 89/516, CS Division, U.C. Berkeley, June 1989 available at http://www.cs.cmu.edu/~ph/texfund/texfund.pdf
This class implements a backward mapping and runs over all(*) pixels of some output image. For each pixel it calls GetSourceCoordinates (which you have to implement in your derived class) to compute the coordinates in the source image. The local sampling frequency can be computed to avoid aliasing. Either you make an analytic implementation or simply use the good (but maybe slow) numerical approximation from BackwardMapping.
For instance if you scale an image by factor 2, you would implement GetSourceCoordinates as source_coord = 0.5 * sink_coord and the local sampling frequency would be 0.5. Sampling frequencies below 1 wont introduce aliasing, while those larger than 1 can. Therefore local low pass filtering is simulated by using a pyramid of the input image.
The local sampling frequency of your mapping function can be approximated analyzing the jacobian of the function as a R^2->R^2 mapping, see HomographyMapping for an example or simply use the numerical solution in this class if you are not interested in speed. However, using an image pyramid, isotropic scaling is assumed, if you resample by 0.3 in x-direction and 5.0 in y direction, both dirs are smoothed with the same sigma and you will lose image information. If you want to remove such effects, use anisotropic filtering. This is the (by far) slowest but best technique. If you use highly nonlinear mapping functions, the quality of your result can improve if you compute a larger image and reduce size by subsequent subsamping in destination space. This technique is called super-sampling.
To make a pyramid of correct size, Backwardmapping::UpdatePyramidSize maps the corners of your sink image and computes the local scale at these corners assuming maximum scale at one corner. If your derived mapping function has a maximum scale somewhere else (e.g. cylindircal rectification), you must override UpdatePyramidSize.
If possible,bicubic interpolation is done in the image, at borders (high pyramid levels) only bilinear. For efficiency (**) or comparison, you can disable the usage of pyramids, speeding up the computation (bicubic, bilinear, nearest neighbor).
(*) "all" means: getboundingbox forward-maps src-corners to sink with inverse mapping (has to be implmented in derived class !) and these corners are clipped against the ROI of sink.
(**)The first goal of this source code is that it is generic and correct. Therefore, in the most inner loop the number of color channels is evaluated and weighting factors are computed several times. If you want to be fast, add specialized functions for grey, and exploit the structure of your problem (see e.g. AffineMapping which has a constant Jacobian, ..). You might as well consider using the GPU if your mapping is "fixed" (radial undistortion with always the same parameters) or use the lookup table interfaces if you can afford precomputing your coefficients (e.g. for a constant mapping applied hundereds of times)
OPENMP - open multiprocessing support: In the most generic trilinear and anisotropic loop, openmp is enabled if it is enabled at all in BIAS (should be by default). So far it is not implmented for grey(!) and for bilinear/bicubic mappings (but this is only enumerating the right variables in 3 lines of code and some tests).
Definition at line 123 of file BackwardMapping.hh.
|
inline |
Constructor.
Definition at line 130 of file BackwardMapping.hh.
|
inlinevirtual |
Destructor.
Definition at line 154 of file BackwardMapping.hh.
|
protectedvirtual |
compute maximum number of pyramid levels needed
Definition at line 219 of file BackwardMapping.cpp.
References BIAS::ImageBase::GetHeight(), and BIAS::ImageBase::GetWidth().
|
protectedvirtual |
result in offsetX_,offsetY_
Definition at line 1042 of file BackwardMapping.cpp.
References BIAS::ImageBase::GetHeight(), and BIAS::ImageBase::GetWidth().
|
protectedvirtual |
Definition at line 1070 of file BackwardMapping.cpp.
References BIAS::ImageBase::GetChannelCount(), BIAS::ImageBase::GetHeight(), BIAS::Image< StorageType >::GetImageDataArray(), BIAS::ImageBase::GetWidth(), BIAS::Image< StorageType >::Init(), and BIAS::ImageBase::SetZero().
|
protected |
clip computed region in dest image to roi
Definition at line 1026 of file BackwardMapping.cpp.
References BIAS::ImageBase::GetROICorners().
|
inlineprotected |
clip interpolated value to outputstoragetype and merge old and new value according to alpha
This function must be inplemented for diferent template types rather than for derived classes, e.g. if bicubic interpolation estimates the grey value 257.8 for an unsinged char image, this is rounded and clipped here to 255.0 since this is the maximum allowed uchar.
Definition at line 598 of file BackwardMapping.hh.
|
inlineprotected |
Definition at line 613 of file BackwardMapping.hh.
|
inlineprotected |
Definition at line 622 of file BackwardMapping.hh.
|
inlineprotected |
Definition at line 629 of file BackwardMapping.hh.
|
inlineprotected |
Definition at line 638 of file BackwardMapping.hh.
|
inlineprotected |
computes pyramid layer for trilinear filtering, e.g.
localscale 0.5 means best resolution and second best are averaged
Definition at line 366 of file BackwardMapping.hh.
|
static |
generates a siemens star like test image with lots of different frequencies to test backward mapping
| testimage | initialized image of user defined size which will be filled |
| highFrequencyCross | generates an additional high frequency line |
| dark | black image value, e.g. close to 0 |
| dark | white image value, e.g. close to 255 |
| Hinv | homography to transform pattern (if desired) |
Definition at line 2004 of file BackwardMapping.cpp.
References BIAS::ImageBase::GetChannelCount(), BIAS::ImageBase::GetHeight(), BIAS::Image< StorageType >::GetImageDataArray(), BIAS::ImageBase::GetWidth(), BIAS::Image< StorageType >::Init(), and BIAS::ImageBase::IsEmpty().
|
protected |
use jacobian of mapping function to do anisotropic antialiasing
Definition at line 978 of file BackwardMapping.cpp.
References BIAS::Matrix2x2< T >::EigenvalueDecomposition(), and BIAS::Matrix< T >::GetSystemMatrix().
|
inlinevirtual |
calculates the bounding box in sink image, where to do the backward mapping.
The resulting coordinates can be negative ! The br position is the first pixel outside the region(as for a ROI). Implement this in a derived class for speeding up calculation.
Reimplemented in BIAS::ProjectionMapping< InputStorageType, OutputStorageType >, BIAS::ProjectionMapping< float, float >, BIAS::ProjectionMapping< unsigned char, unsigned char >, BIAS::AffineMapping< InputStorageType, OutputStorageType >, BIAS::HomographyMapping< InputStorageType, OutputStorageType >, and BIAS::TextureMapping< InputStorageType, OutputStorageType >.
Definition at line 248 of file BackwardMapping.hh.
| int BIAS::BackwardMapping< InputStorageType, OutputStorageType >::GetDisplacementMap | ( | Image< float > & | dismap, |
| int | width, | ||
| int | height | ||
| ) |
precomputes lookup coordinates and computes displacement map int TEXTURE coordinates, according to the size of src (or width,height)
Definition at line 1125 of file BackwardMapping.cpp.
| int BIAS::BackwardMapping< InputStorageType, OutputStorageType >::GetDisplacementMap | ( | Image< float > & | dismap, |
| Image< InputStorageType > & | src | ||
| ) |
|
inlineprotected |
worker function, which handles bilinear/bicubic interpolation, borders and weights
Definition at line 548 of file BackwardMapping.hh.
References BIAS::Image< StorageType >::BicubicInterpolation(), BIAS::Image< StorageType >::BilinearInterpolation(), BIAS::ROI::CheckBicubicInterpolation(), BIAS::ROI::CheckBilinearInterpolation(), and BIAS::ImageBase::GetROI().
|
inline |
get jacobian (including concatenated mappings)
Definition at line 302 of file BackwardMapping.hh.
|
protectedvirtual |
numeric approximation of jacobian, reimplement in derived class to make an analytic jacobian
Reimplemented in BIAS::AffineMapping< InputStorageType, OutputStorageType >, BIAS::TextureMapping< InputStorageType, OutputStorageType >, and BIAS::HomographyMapping< InputStorageType, OutputStorageType >.
Definition at line 69 of file BackwardMapping.cpp.
| int BIAS::BackwardMapping< InputStorageType, OutputStorageType >::GetLookupTable | ( | const std::string & | filename, |
| InterpolationMethod | method | ||
| ) |
Returns the LUT generated by PrepareLookupTableMapping() as an file.
Definition at line 1241 of file BackwardMapping.cpp.
References BIAS::MapBilinear, BIAS::MapNearestNeighbor, and BIAS::MapTrilinear.
| int BIAS::BackwardMapping< InputStorageType, OutputStorageType >::GetLookupTable | ( | float * | lutImageRow, |
| InterpolationMethod | method | ||
| ) |
Definition at line 1334 of file BackwardMapping.cpp.
References BIAS::MapBilinear, BIAS::MapNearestNeighbor, and BIAS::MapTrilinear.
| int BIAS::BackwardMapping< InputStorageType, OutputStorageType >::GetLookupTableSize | ( | unsigned int & | width, |
| unsigned int & | channels, | ||
| InterpolationMethod | method | ||
| ) |
returns the size of the current LUT.
Definition at line 1195 of file BackwardMapping.cpp.
References BIAS::MapBilinear, BIAS::MapNearestNeighbor, and BIAS::MapTrilinear.
|
inline |
wrapper function to allow the lookup implementation to be shared with other algorithms.
Definition at line 272 of file BackwardMapping.hh.
Referenced by BIAS::RectificationViaProjectionMappingBase< InputStorageType, OutputStorageType >::Disp2Depth().
|
protectedvirtual |
actual mapping function which takes a point from sink and computes a point in source and a local sampling frequency
Reimplemented in BIAS::ProjectionMapping< InputStorageType, OutputStorageType >, BIAS::ProjectionMapping< float, float >, BIAS::ProjectionMapping< unsigned char, unsigned char >, BIAS::AffineMapping< InputStorageType, OutputStorageType >, BIAS::TextureMapping< InputStorageType, OutputStorageType >, BIAS::HomographyMapping< InputStorageType, OutputStorageType >, BIAS::CylinderMapping, BIAS::DisplacementMapping< InputStorageType, OutputStorageType >, and BIAS::LogPolarMapping< InputStorageType, OutputStorageType >.
Definition at line 56 of file BackwardMapping.cpp.
|
protected |
worker function, which handles bilinear/bicubic interpolation, pyramid levels, borders and weights
Definition at line 913 of file BackwardMapping.cpp.
| int BIAS::BackwardMapping< InputStorageType, OutputStorageType >::Map | ( | const Image< InputStorageType > & | src, |
| Image< OutputStorageType > & | sink, | ||
| InterpolationMethod | interpolationQuality = MapTrilinear, |
||
| bool | newSink = false, |
||
| double | SuperSampling = 1.0 |
||
| ) |
backward mapping with various interpolations
Sink must be initialized with correct size and background color for invalid pixels. This way you can call it several times to create a panorama from several source images. For each pixel in sink, GetSourceCoordinates is called and the value in source interpolated.
| newSink,if | true a new sink image is created that is large enough to hold the old sink and the new mapped src img. |
| SuperSampling | if > 1.0, intermediate image with isotropically enlarged width and height (by factor SuperSampling) is created and downsampled for the final image (most useful for nonlinear mappings) |
Definition at line 257 of file BackwardMapping.cpp.
References BIAS::ImageBase::GetChannelCount(), BIAS::ImageBase::GetColorModel(), BIAS::ImageBase::GetHeight(), BIAS::ImageBase::GetROI(), BIAS::ImageBase::GetWidth(), BIAS::ImageBase::IsEmpty(), BIAS::ImageBase::IsPlanar(), BIAS::BackwardMapping< InputStorageType, OutputStorageType >::Map(), BIAS::MapAnisotropic, BIAS::MapBicubic, BIAS::MapBilinear, BIAS::MapNearestNeighbor, BIAS::MapTrilinear, BIAS::AffineMapping< InputStorageType, OutputStorageType >::SetAffineTransformation(), and BIAS::ImageBase::SetZero().
Referenced by BIAS::ImageBlender::BlendImages(), BIAS::PMDImageProc::FitDepthTo2DImageHomogr_(), BIAS::PMDImageProc::FitDepthTo2DImageKOnly_(), and BIAS::BackwardMapping< InputStorageType, OutputStorageType >::Map().
| int BIAS::BackwardMapping< InputStorageType, OutputStorageType >::Map | ( | Image< OutputStorageType > & | sink | ) |
use this for subsequent calls to avoid pyramid recalculation when using tri-filtering
Definition at line 362 of file BackwardMapping.cpp.
References BIAS::MapTrilinear.
|
protected |
bilinear, bicubc and nearest neighbor interpolation
Definition at line 382 of file BackwardMapping.cpp.
References BIAS::Image< StorageType >::BilinearInterpolationRGBInterleaved(), BIAS::ImageBase::GetChannelCount(), BIAS::ImageBase::GetHeight(), BIAS::Image< StorageType >::GetImageDataArray(), BIAS::ImageBase::GetWidth(), BIAS::MapBicubic, BIAS::MapBilinear, and BIAS::MapNearestNeighbor.
|
protected |
map image avoiding aliasing
This is almost correct regarding the sampling theorem, because it uses trilinear or anisotropic filtering over a pyramid. The local sampling frequency is estimated by analyzing the jacobian of the homography as a R^2->R^2 mapping. This is very slow. If possible, bicubic interpolation is done in the image, at borders (high pyramid levels) only bilinear.
In auto mode pyramid size is checked
Definition at line 527 of file BackwardMapping.cpp.
References BIAS::Image< StorageType >::FillImageWithConstValue(), BIAS::ImageBase::GetChannelCount(), BIAS::ImageBase::GetHeight(), BIAS::Image< StorageType >::GetImageDataArray(), BIAS::ImageBase::GetWidth(), BIAS::MapTrilinear, BIAS::ROI::Resize(), and BIAS::ROI::SetCorners().
|
protected |
fast trilinear grey without special features
assumes one channel grey image, no alpha blending, no concatenation, no 2d offset (from auto image size) and no super sampling
Definition at line 741 of file BackwardMapping.cpp.
References BIAS::Image< StorageType >::BicubicInterpolation(), BIAS::Image< StorageType >::FastBilinearInterpolationGrey(), BIAS::Image< StorageType >::FillImageWithConstValue(), BIAS::ImageBase::GetChannelCount(), BIAS::ROI::GetCornerLowerRightX(), BIAS::ROI::GetCornerLowerRightY(), BIAS::ROI::GetCornerUpperLeftX(), BIAS::ROI::GetCornerUpperLeftY(), BIAS::ImageBase::GetHeight(), BIAS::Image< StorageType >::GetImageDataArray(), BIAS::ImageBase::GetROI(), BIAS::ROI::GetWidth(), and BIAS::ImageBase::GetWidth().
| int BIAS::BackwardMapping< InputStorageType, OutputStorageType >::MapWithLookupTable | ( | const Image< InputStorageType > & | src, |
| Image< OutputStorageType > & | sink, | ||
| InterpolationMethod | method | ||
| ) |
applies precomputed coordinates in src, fast for repeated usages of same mapping function
Definition at line 1805 of file BackwardMapping.cpp.
References BIAS::ImageBase::GetChannelCount(), BIAS::ImageBase::GetHeight(), BIAS::Image< StorageType >::GetImageData(), BIAS::ImageBase::GetROI(), BIAS::ImageBase::GetWidth(), BIAS::BWM_LUT_Entry_Nearest::index, BIAS::BWM_LUT_Entry_Bilinear::index_0_0, BIAS::BWM_LUT_Entry_Bilinear::index_0_1, BIAS::BWM_LUT_Entry_Bilinear::index_1_0, BIAS::BWM_LUT_Entry_Bilinear::index_1_1, BIAS::ImageBase::IsPlanar(), BIAS::MapAnisotropic, BIAS::MapBicubic, BIAS::MapBilinear, BIAS::MapNearestNeighbor, BIAS::BWM_LUT_Entry_Bilinear::mapped, BIAS::MapTrilinear, BIAS::BWM_LUT_Entry_Bilinear::xy_weight, BIAS::BWM_LUT_Entry_Bilinear::xY_weight, BIAS::BWM_LUT_Entry_Bilinear::Xy_weight, and BIAS::BWM_LUT_Entry_Bilinear::XY_weight.
| int BIAS::BackwardMapping< InputStorageType, OutputStorageType >::PrepareLookupTableMapping | ( | const Image< InputStorageType > & | src, |
| Image< OutputStorageType > & | sink, | ||
| InterpolationMethod | method, | ||
| bool | newSink = false |
||
| ) |
precomputes lookup coordinates for accessing src
If you want to apply the same mapping function over and over again, e.g. radial undistortion for a series of images, call this function once and MapWithLookupTable every time. sink must be of correct size !
Definition at line 1483 of file BackwardMapping.cpp.
References BIAS::ImageBase::GetChannelCount(), BIAS::ImageBase::GetHeight(), BIAS::ImageBase::GetPixelCount(), BIAS::ImageBase::GetROI(), BIAS::ImageBase::GetWidth(), BIAS::BWM_LUT_Entry_Nearest::index, BIAS::BWM_LUT_Entry_Bilinear::index_0_0, BIAS::BWM_LUT_Entry_Bilinear::index_0_1, BIAS::BWM_LUT_Entry_Bilinear::index_1_0, BIAS::BWM_LUT_Entry_Bilinear::index_1_1, BIAS::InterpolationMethod_UNKNOWN, BIAS::MapAnisotropic, BIAS::MapBicubic, BIAS::MapBilinear, BIAS::MapNearestNeighbor, BIAS::BWM_LUT_Entry_Nearest::mapped, BIAS::BWM_LUT_Entry_Bilinear::mapped, BIAS::BWM_LUT_Entry_Trilinear::mapped, BIAS::MapTrilinear, BIAS::BWM_LUT_Entry_Trilinear::pyr_diff, BIAS::BWM_LUT_Entry_Trilinear::pyr_diff_inv, BIAS::BWM_LUT_Entry_Trilinear::pyr_level_high, BIAS::BWM_LUT_Entry_Trilinear::pyr_level_low, BIAS::BWM_LUT_Entry_Trilinear::stage_0, BIAS::BWM_LUT_Entry_Trilinear::stage_1, BIAS::BWM_LUT_Entry_Bilinear::xy_weight, BIAS::BWM_LUT_Entry_Bilinear::xY_weight, BIAS::BWM_LUT_Entry_Bilinear::Xy_weight, and BIAS::BWM_LUT_Entry_Bilinear::XY_weight.
|
inline |
avoid intermediate image and concatenate two backward mappings
Imagine that the source image is transformed with pcon into the intermediate image, which is then transformed by this into the sink
Definition at line 319 of file BackwardMapping.hh.
| int BIAS::BackwardMapping< InputStorageType, OutputStorageType >::SetLookupTable | ( | const std::string & | filename, |
| InterpolationMethod & | method | ||
| ) |
Loads the LUT from a file, replaces the call to PrepareLookupTableMapping().
Definition at line 1387 of file BackwardMapping.cpp.
| int BIAS::BackwardMapping< InputStorageType, OutputStorageType >::SetLookupTable | ( | const float * | lutImageRow, |
| unsigned int | width, | ||
| InterpolationMethod & | method | ||
| ) |
Definition at line 1436 of file BackwardMapping.cpp.
References BIAS::MapBilinear, BIAS::MapNearestNeighbor, BIAS::MapTrilinear, BIAS::BWM_LUT_Entry_Bilinear::SerializedIn(), and BIAS::BWM_LUT_Entry_Trilinear::SerializedIn().
| void BIAS::BackwardMapping< InputStorageType, OutputStorageType >::SetPyramidSize | ( | const int | newsize | ) |
sets pyramid size to pyramid and updates if neccessary
Definition at line 194 of file BackwardMapping.cpp.
|
virtual |
uses corners of sink roi (and few other sample points) to estimate maximum local scaling (and thus required pyramid level)
Definition at line 99 of file BackwardMapping.cpp.
References BIAS::ROI::GetCorners(), and BIAS::Random::GetUniformDistributed().
|
protected |
set to true if possibility of aliasing is detected during mapping
Definition at line 509 of file BackwardMapping.hh.
|
protected |
has same size as overlap region used for blending
Definition at line 538 of file BackwardMapping.hh.
|
protected |
pyramid size set by user or computed automatically ?
Definition at line 491 of file BackwardMapping.hh.
|
protected |
source image height
Definition at line 535 of file BackwardMapping.hh.
|
protected |
set to true if not every pixel could be computed
Definition at line 512 of file BackwardMapping.hh.
|
protected |
which interpolation method are we using
Definition at line 495 of file BackwardMapping.hh.
|
protected |
needed for newDist
Definition at line 529 of file BackwardMapping.hh.
|
protected |
Definition at line 529 of file BackwardMapping.hh.
|
protected |
Definition at line 540 of file BackwardMapping.hh.
|
protected |
NOT IMPLEMENTED (YET ?)
Definition at line 525 of file BackwardMapping.hh.
|
protected |
Definition at line 526 of file BackwardMapping.hh.
|
protected |
Definition at line 517 of file BackwardMapping.hh.
|
protected |
Definition at line 521 of file BackwardMapping.hh.
|
protected |
lookup-tables for precomputed positions in source, same size as dst.PixelCount
Definition at line 516 of file BackwardMapping.hh.
|
protected |
Definition at line 520 of file BackwardMapping.hh.
|
protected |
Definition at line 518 of file BackwardMapping.hh.
|
protected |
Definition at line 522 of file BackwardMapping.hh.
|
protected |
this contains a pyramid of the last source image for anti-aliasing
Definition at line 486 of file BackwardMapping.hh.
|
protected |
Definition at line 492 of file BackwardMapping.hh.
|
protected |
The interpolated value is computed in double; if clipped value is not specialized for your output storage type (e.g.
ushort), this boolean indicates that the generic conversion (e.g. double->ushort) could have introduced artefacts (65536.0 -> 1).
Definition at line 505 of file BackwardMapping.hh.
|
protected |
the roi of the last source image
Definition at line 488 of file BackwardMapping.hh.
|
protected |
if larger than 1, super resolution is active
Definition at line 498 of file BackwardMapping.hh.
|
protected |
source image width
Definition at line 532 of file BackwardMapping.hh.
1.8.5
