ddimage_Filter.h

Go to the documentation of this file.

/* ---------------------------------------------------------------------------
    Phission :
        Realtime Vision Processing System

    Copyright (C) 2002-2006 Philip D.S. Thoren (pthoren@cs.uml.edu)
    University of Massachusetts at Lowell,
    Laboratory for Artificial Intelligence and Robotics

    Copyright (C) 2005 Mike Baker

    This file is part of Phission.

    Phission is free software; you can redistribute it and/or modify
    it under the terms of the GNU Lesser General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    Phission is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public License
    along with Phission; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

 ---------------------------------------------------------------------------*/
#ifndef _DDIMAGE_FILTER_H
#define _DDIMAGE_FILTER_H

#include <phFilter.h>

/* ------------------------------------------------------------------------ */
#define ddimage_BlockStandard 1

#define ddimage_BlockKernel   2
 /* ImageProcessing */

/* ------------------------------------------------------------------------ */
PHAPI(class) ddimage_Filter : public phFilter
{
private:
    uint8_t   **m_history;
    uint32_t   *m_history_size;
    uint32_t    m_history_count;

    uint8_t    *m_temp_frame;
    uint32_t    m_temp_frame_size;
    
    uint8_t   **m_diff;
    uint32_t   *m_diff_size;
    uint32_t    m_diff_count;
    uint32_t    m_diff_index;
    
    uint32_t    m_stride;
    
    phImage    *m_mask_image;
    uint8_t    *m_mask;
    uint32_t    m_mask_size;
    int         m_domask;

    uint32_t    m_threshold;
    uint32_t    m_pixel_threshold;
    uint32_t    m_block_filter;

protected:
    int filter();

public:
    ddimage_Filter( uint32_t threshold      = 15,
                    uint32_t stride         = 2,
                    uint32_t pixel_threshold= 0,
                    uint32_t block_filter   = ddimage_BlockKernel );
    ~ddimage_Filter();

    int         get(uint32_t *threshold, 
                    uint32_t *stride,
                    uint32_t *pixel_threshold,
                    uint32_t *block_filter );
    
    int setThreshold        ( uint32_t threshold        );
    int setStride           ( uint32_t stride           );
    int setPixelThreshold   ( uint32_t pixel_threshold  );
    int setBlockFilter      ( uint32_t block_filter     );
    
    int set(uint32_t threshold, 
            uint32_t stride,
            uint32_t pixel_threshold,
            uint32_t block_filter);

    int enableMotionMask    ( int enable = 1 );
    int disableMotionMask   ( int disable = 1);

    phImage *getMaskImage();  

    phFilter *cloneFilter();
    
};
 /* ImageProcessing */

#endif /* _DDIMAGE_FILTER_H */

/* Old documentation for when stride == 1 */

/* We only need to do the difference once for each loop.
 * Since this is a series of streaming frames (3),
 * we've also a series of streaming difference frames (2)
 * of which we can use 1 during a future loop */

/* Since we're saving the difference image from two future frames,
 * we no longer need 1 of the history frame buffers */

/*  Loop 0 
 *      Frames   0   1   2
 *      DFrames    X   Y
 *
 *  Save Y for the next loop around.
 *
 *  Loop 1
 *      Frames   1   2   3
 *      DFrames    Y   Z   
 *
 *  Since we're using the saved Y values, we don't need #1.
 *
 *  Also, #3 is the current frame, so we really only need to save
 *  the frame from the last loop.
 */

Copyright (C) 2002 - 2007

Philip D.S. Thoren ( pthoren@users.sourceforge.net ) University Of Massachusetts at Lowell Robotics Lab

---