mvobj.h

机器人程序

// MVObj.h - by Robin Hewitt, 2004
// http://www.robinhewitt.com/mavis
// This is free software. See license at the bottom
// of this file for terms of use.
//

//////////////////////////////////////////////////////////////
// Framework classes for representing visual objects
// in Mavis (called MV objects).
//

//
// Contains definitions for
//     MVObj     - a pure virtual base class for objects to be recognized.
//                 This is the interface that Mavis uses.
//
//     MVObjBase - Extends MVObj and implements a few common capabilities
//                 needed by all MV objects. This is the class that MV
//                 objects would extend.
//
//     MVObjFactory - A factory class for obtaining instances of MV objects.
//

#ifndef __OBJREC_MVOBJ
#define __OBJREC_MVOBJ


#include <windows.h>
#include "../mavistypes.h"
#include "maviscomm.h"
#include "MavisErr.h"
#include <vector>

class Mavis;
struct ImgROI_t;
struct Pixel_t;


//////////////////////////////////////////////////////////////
//  Class: MVObjSighting
//
class MVObjSighting
{

public:
	MVObjSighting();
	virtual ~MVObjSighting() {}

protected:
	int confidence;
};



//////////////////////////////////////////////////////////////
//  Class: MVObj
//
class MVObj
{
public:
	virtual ~MVObj() {}

	virtual int lookOnce(ObjLoc_t *) = 0;
	virtual int getNext(ObjLoc_t *) = 0;
	virtual int getId() = 0;
};



//////////////////////////////////////////////////////////////
//  Class: MVObjBase
//
class MVObjBase : MVObj
{
public:
	virtual int lookOnce(ObjLoc_t *) { return 0; }
	virtual int getNext(ObjLoc_t *);

protected:
	friend class MVObjFactory;

	Mavis * pMavis;

	// Only the factory can create an object searcher
	MVObjBase(Mavis * pM);

	// utility functions
	static void setImageLocation(ObjLoc_t * pObjLoc, ImgROI_t & roi, Mavis * pM);
	//(TODO) static setImageLocation(ObjLoc_t * pObjLoc, Pixel_t px);

private:
	// Prevent access to copy constructor and assignment operator
	MVObjBase(const MVObjBase &);
	MVObjBase & MVObjBase::operator=(const MVObjBase &);
};



//////////////////////////////////////////////////////////////
//  Class: MVObjFactory
//
class MVObjFactory
{
public:
	MVObj * getMVObj(int id, Mavis * pM) throw(MavisErr);
	void releaseMVObj(MVObj * pObj);

protected:
	friend class Mavis;
	MVObjFactory(Mavis * pM) throw(MavisErr);
	~MVObjFactory();

private:
	Mavis * pMavis;
	std::string dataDir;
	std::vector<MVObjBase *> objVect;

	MVObjBase * findByID(int id);
};


#endif

///////////////////////////////////////////////////////////////////////////////////////
// IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
//
// By downloading, copying, installing or using the software you agree to this
// license. If you do not agree to this license, do not download, install, copy or
// use the software.
//
//
//                        Mavis License Agreement
//
// Copyright (c) 2004, Robin Hewitt (http://www.robin-hewitt.com).
// Third party copyrights are property of their respective owners.
//
// Redistribution and use in source and binary forms, with or without modification,
// are permitted provided that the following conditions are met:
//
//   * Redistributions of source code must retain the above copyright notice,
//     this list of conditions and the following disclaimer.
//
//   * Redistributions in binary form must reproduce the above copyright notice,
//     this list of conditions and the following disclaimer in the documentation
//     and/or other materials provided with the distribution.
//
// This software is provided "as is" and any express or implied warranties, including,
// but not limited to, the implied warranties of merchantability and fitness for a
// particular purpose are disclaimed. In no event shall the authors or contributors be
// liable for any direct, indirect, incidental, special, exemplary, or consequential
// damages (including, but not limited to, procurement of substitute goods or services;
// loss of use, data, or profits; or business interruption) however caused and on any
// theory of liability, whether in contract, strict liability, or tort (including
// negligence or otherwise) arising in any way out of the use of this software, even
// if advised of the possibility of such damage.
///////////////////////////////////////////////////////////////////////////////////////