Home Page Toolkit Overview Using GML   User Input Services     Finger Tracker     Calibrator     Frame Grabber     Service protocol Obtaining GML   Installing GML   Licence Developer Documentation   Tcl/Tk API     The GML Canvas     Image processing   Tcl Scripts Library     List of Classes     List of Files   C/C++ API     List of Classes     List of Files

gml_FingerFinderPlus.h // gml_FingerFinderPlus.h -- // // Define the gml_TFingerFinderPlus class. // // Copyright (c) 2003-2004 CLIPS-IMAG // // See the file "gml_LicenseTerms.txt" for information on usage and redistribution // of this file, and for a DISCLAIMER OF ALL WARRANTIES. // // Created in April 2003 (JL). // Revamped in February 2004 (JL). #ifndef __GML_FINGER_FINDER_PLUS__ #define __GML_FINGER_FINDER_PLUS__ #include "gml/base/gml_Errors.h" #include "gml/base/gml_Types.h" #include "gml/image/gml_Geometry.h" #include "gml/image/gml_Bitmap.h" #include "gml/vision/gml_Connexer.h" //////////////////////////////////////////////////////////////////////////////// // // // gml_TFinger class declaration // // // //////////////////////////////////////////////////////////////////////////////// /// /// Represent fingers found in images /// struct gml_TFinger { gml_TPoint fCenter; ///< position of the fingertip center (pixels) int index; /// hand's index gml_TPointFloat fOrientation; ///< vector giving the finger orientation (pixels) Float32 fRadius; ///< fingertip radius (pixels) } ; //////////////////////////////////////////////////////////////////////////////// // // // gml_TFingerFinderPlus class declaration // // // //////////////////////////////////////////////////////////////////////////////// /// A complex scanner that processes a segmentation map (scalar image) and /// detects fingertip-shaped regions. /// /// @warning /// the data members are made public so the <finger_finder> scanner can /// access them; they are *not* to be modified by client code ! class gml_TFingerFinderPlus { public: /// /// Init -- /// Setup the data structures. /// gml_TError Init (); /// /// Dispose -- /// Release the data structures. /// void Dispose (); /// /// Setup -- /// Setup the data structures for a given view scale. /// If the <reqViewScale> hasn't changed the data structures no /// allocation or computation will occur. /// gml_TError Setup ( Float64 reqViewScale ///< requested view scale (meters/pixel) ); /// /// Process -- /// Process the <source> bitmap and place in <fingers> the detected fingertips. /// gml_TError Process ( gml_TBitmap* source, ///< [in] source bitmap (binary image) gml_TRect* sourceRect, ///< [in] source region of interest gml_TBoolean flagRejectMap, ///< [in] if true, <source> will be overwritten with a rejection map UInt32 reqTipFillFactor, ///< [in] minimal density around a fingertip UInt16 &nbFingers, ///< [inout] input: maximum number of fingers (size of the <finger> array); ///< output: actual number of detected fingers gml_TFinger* fingers ///< [out] detected fingertips ); /// /// Dump -- /// Write the fields' value to stdout. /// void Dump (); public: // // Defaults and constants // /// fingers are between 9 and 20 millimiters wide static Float64 sMinFingerRadius () { return 4.5e-3; } ///< meters //static Float64 sMinFingerRadius () { return 4.8e-3; } ///< meters static Float64 sMaxFingerRadius () { return 10.0e-3; } ///< meters //static Float64 sMaxFingerRadius () { return 14.4e-3; } ///< meters /// default view ratio //static Float64 sDefaultViewScale () { return 2.0e-3; } ///< meters / pixel static Float64 sDefaultViewScale () { return 1.8e-3; } ///< meters / pixel /// default required fill factor for fingertip regions static UInt8 sDefaultTipFillFactor () { return 90; } ///< percentage public: // // Private fields // Float64 fViewScale; ///< the view ratio, expressed in meters / pixel UInt32 fTipFillFactor; ///< the required fill factor of fingertips, percentage UInt32 fMinFingerRadius; ///< the minimum finger radius, pixels UInt32 fMaxFingerRadius; ///< the maximum finger radius, pixels int maxHandArea; SInt32 fDiskDiameter; ///< pixels UInt8 *fDiskMask; ///< as given by gml_Bresenham_DiskMask UInt32 fDiskArea; ///< disk area SInt32 fCircleDiameter; ///< pixels UInt32 fCircleNbPoints; ///< number of contour points gml_TPoint *fCirclePointList; ///< list of relative contour points as given by gml_Bresenham_CirclePoints UInt32 *fPointsBuffer; ///< temporary storage for contour points UInt32 fMinContourPoints; ///< minimum number of contour pixels for a valid finger UInt32 fMaxContourPoints; ///< maximum number of contour pixels for a valid finger protected: gml_TConnexer *fConnexer; ///< analyzer used to pre- and post-process the bitmap gml_TBitmap *fFingerMap; ///< output of the finger-finding scanner gml_TBitmap *fConnexerMap; ///<outpout of the fconnexer, step 1 protected: // // Protected utility methods // /// Allocate <fFingerMap> as a G_8 bitmap the same size as <source> (if necessary) /// and zero it gml_TError AllocateAndZeroMap (gml_TBitmap *source); } ; #endif /* __GML_FINGER_FINDER_PLUS__ */ Generated on Tue Jun 12 14:03:28 2007 for gml by Doxygen 1.5.2.

Contact: julien (dot) letessier (at) gmail (dot) com. Copyright (c) 2000-2007 CLIPS-IMAG Laboratory, Grenoble, France. All rights reserved. W3CXHTML 1.0 W3CCSS 2.0