contrib/mul/vimt/vimt_image_pyramid_builder.h

Go to the documentation of this file.

// This is mul/vimt/vimt_image_pyramid_builder.h
#ifndef vimt_image_pyramid_builder_h_
#define vimt_image_pyramid_builder_h_
#ifdef VCL_NEEDS_PRAGMA_INTERFACE
#pragma interface
#endif
//:
//  \file
//  \brief Base class for objects which build image pyramids.
//  \author Tim Cootes

#include <vsl/vsl_binary_io.h>
#include <vcl_string.h>
#include <vcl_iosfwd.h>

class vimt_image;
class vimt_image_pyramid;

//: Base class for objects which build image pyramids
class vimt_image_pyramid_builder
{
 public:

    //: Dflt ctor
    vimt_image_pyramid_builder();

    //: Destructor
    virtual ~vimt_image_pyramid_builder();

    //: Create new (empty) pyramid on heap
    //  Caller responsible for its deletion
    virtual vimt_image_pyramid* new_image_pyramid() const =0;

    //: Define maximum number of levels to build
    //  Limits levels built in subsequent calls to build()
    //  Useful efficiency measure.  As build() only takes
    //  a shallow copy of the original image, using
    //  max_l=1 avoids any copying or smoothing.
    virtual void set_max_levels(int max_l) =0;

    //: Get the current maximum number levels allowed
    virtual int max_levels() const =0;

    //: Build pyramid
    virtual void build(vimt_image_pyramid&, const vimt_image&) const = 0;

    //: Extend pyramid
    // The first layer of the pyramid must already be set.
    virtual void extend(vimt_image_pyramid&) const = 0;

    //: Scale step between levels
    virtual double scale_step() const = 0;

    //: Version number for I/O
    short version_no() const;

    //: Name of the class
    virtual vcl_string is_a() const;

    //: Does the name of the class match the argument?
    virtual bool is_class(vcl_string const& s) const;

    //: Create a copy on the heap and return base class pointer
    virtual vimt_image_pyramid_builder* clone() const = 0;

    //: Print class to os
    virtual void print_summary(vcl_ostream& os) const = 0;

    //: Save class to binary file stream
    virtual void b_write(vsl_b_ostream& bfs) const = 0;

    //: Load class from binary file stream
    virtual void b_read(vsl_b_istream& bfs) = 0;
};

//: Allows derived class to be loaded by base-class pointer
//  A loader object exists which is invoked by calls
//  of the form "vsl_b_read(bfs,base_ptr);".  This loads derived class
//  objects from the disk, places them on the heap and
//  returns a base class pointer.
//  In order to work the loader object requires
//  an instance of each derived class that might be
//  found.  This function gives the model class to
//  the appropriate loader.
void vsl_add_to_binary_loader(const vimt_image_pyramid_builder& b);

//: Binary file stream output operator for class reference
void vsl_b_write(vsl_b_ostream& bfs, const vimt_image_pyramid_builder& b);

//: Binary file stream input operator for class reference
void vsl_b_read(vsl_b_istream& bfs, vimt_image_pyramid_builder& b);

//: Stream output operator for class reference
vcl_ostream& operator<<(vcl_ostream& os,const vimt_image_pyramid_builder& b);

//: Stream output operator for class pointer
vcl_ostream& operator<<(vcl_ostream& os,const vimt_image_pyramid_builder* b);

#endif // vimt_image_pyramid_builder_h_