ImageArgs.h

# ifndef Conjecture_ImageArgs_h
# define Conjecture_ImageArgs_h Conjecture_ImageArgs_h

// Insert SVN header substitution variable here
// Class Champion: Wade

# include "Root.h"
# include "Coord.h"  // uint8_t, uint16_t

namespace Conjecture {
    class Image;
    // FUTURE FIX: Should the max values of 'threshold' and 'quantize'
    // be downgraded to 255? Currently uint16_t values to support max
    // intensities up to 65535, but this is probably entirely
    // unnecessary. If we put them down to uint8_t's, the structure as-is
    // would fit in a word.  But more fields are likely to be added.
    
    // FUTURE FIX: Should we add a 'verbose' field to this class?
    // Would help in Image::Image.

    class ImageArgs : public Root {
        
      public:
        ImageArgs(uint8_t magnification = 1, uint16_t threshold = 0, uint16_t quantize = 0, uint8_t filter = 0, uint8_t dustsize = 0);
        
        uint8_t  magnification() const   { return this->_magnification; }
        uint16_t threshold()     const   { return this->_threshold;     }
        uint16_t quantize()      const   { return this->_quantize;      }
        uint8_t  filter()        const   { return this->_filter;        }
        uint8_t  dustsize()      const   { return this->_dustsize;      }
        
        uint8_t&  magnification()        { return this->_magnification; }
        uint16_t& threshold()            { return this->_threshold;     }
        uint16_t& quantize()             { return this->_quantize;      }
        uint8_t&  filter()               { return this->_filter;        }
        uint8_t&  dustsize()             { return this->_dustsize;      }
        
        uint16_t apply(const Image* image, const Coord& pos) const;

        static const uint16_t MaxVal;
        static const uint16_t MinVal;

      private:
        uint8_t _magnification;

        uint16_t _threshold;

        uint16_t _quantize;

        uint8_t _filter;
        
        uint8_t _dustsize;

        std::string str() const; // printable representation
    };
};

# endif // Conjecture_ImageArgs_h

---