296 lines
12 KiB
C++
296 lines
12 KiB
C++
/***********************************************************
|
|
* File generated by the HALCON-Compiler hcomp version 20.11
|
|
* Usage: Interface to C++
|
|
*
|
|
* Software by: MVTec Software GmbH, www.mvtec.com
|
|
***********************************************************/
|
|
|
|
|
|
#ifndef HCPP_HTEMPLATE
|
|
#define HCPP_HTEMPLATE
|
|
|
|
namespace HalconCpp
|
|
{
|
|
|
|
// Represents an instance of a template for gray value matching.
|
|
class LIntExport HTemplate : public HHandle
|
|
{
|
|
|
|
public:
|
|
|
|
// Create an uninitialized instance
|
|
HTemplate():HHandle() {}
|
|
|
|
// Copy constructor
|
|
HTemplate(const HTemplate& source) : HHandle(source) {}
|
|
|
|
// Copy constructor
|
|
HTemplate(const HHandle& handle);
|
|
|
|
// Create HTemplate from handle, taking ownership
|
|
explicit HTemplate(Hlong handle);
|
|
|
|
bool operator==(const HHandle& obj) const
|
|
{
|
|
return HHandleBase::operator==(obj);
|
|
}
|
|
|
|
bool operator!=(const HHandle& obj) const
|
|
{
|
|
return HHandleBase::operator!=(obj);
|
|
}
|
|
|
|
protected:
|
|
|
|
// Verify matching semantic type ('template')!
|
|
virtual void AssertType(Hphandle handle) const;
|
|
|
|
public:
|
|
|
|
// Deep copy of all data represented by this object instance
|
|
HTemplate Clone() const;
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
* Operator-based class constructors
|
|
*****************************************************************************/
|
|
|
|
// create_template_rot: Preparing a pattern for template matching with rotation.
|
|
explicit HTemplate(const HImage& Template, Hlong NumLevel, double AngleStart, double AngleExtend, double AngleStep, const HString& Optimize, const HString& GrayValues);
|
|
|
|
// create_template_rot: Preparing a pattern for template matching with rotation.
|
|
explicit HTemplate(const HImage& Template, Hlong NumLevel, double AngleStart, double AngleExtend, double AngleStep, const char* Optimize, const char* GrayValues);
|
|
|
|
#ifdef _WIN32
|
|
// create_template_rot: Preparing a pattern for template matching with rotation.
|
|
explicit HTemplate(const HImage& Template, Hlong NumLevel, double AngleStart, double AngleExtend, double AngleStep, const wchar_t* Optimize, const wchar_t* GrayValues);
|
|
#endif
|
|
|
|
// create_template: Preparing a pattern for template matching.
|
|
explicit HTemplate(const HImage& Template, Hlong FirstError, Hlong NumLevel, const HString& Optimize, const HString& GrayValues);
|
|
|
|
// create_template: Preparing a pattern for template matching.
|
|
explicit HTemplate(const HImage& Template, Hlong FirstError, Hlong NumLevel, const char* Optimize, const char* GrayValues);
|
|
|
|
#ifdef _WIN32
|
|
// create_template: Preparing a pattern for template matching.
|
|
explicit HTemplate(const HImage& Template, Hlong FirstError, Hlong NumLevel, const wchar_t* Optimize, const wchar_t* GrayValues);
|
|
#endif
|
|
|
|
// read_template: Reading a template from file.
|
|
explicit HTemplate(const HString& FileName);
|
|
|
|
// read_template: Reading a template from file.
|
|
explicit HTemplate(const char* FileName);
|
|
|
|
#ifdef _WIN32
|
|
// read_template: Reading a template from file.
|
|
explicit HTemplate(const wchar_t* FileName);
|
|
#endif
|
|
|
|
|
|
|
|
|
|
/***************************************************************************
|
|
* Operators *
|
|
***************************************************************************/
|
|
|
|
// Preparing a pattern for template matching with rotation.
|
|
void CreateTemplateRot(const HImage& Template, Hlong NumLevel, double AngleStart, double AngleExtend, double AngleStep, const HString& Optimize, const HString& GrayValues);
|
|
|
|
// Preparing a pattern for template matching with rotation.
|
|
void CreateTemplateRot(const HImage& Template, Hlong NumLevel, double AngleStart, double AngleExtend, double AngleStep, const char* Optimize, const char* GrayValues);
|
|
|
|
#ifdef _WIN32
|
|
// Preparing a pattern for template matching with rotation.
|
|
void CreateTemplateRot(const HImage& Template, Hlong NumLevel, double AngleStart, double AngleExtend, double AngleStep, const wchar_t* Optimize, const wchar_t* GrayValues);
|
|
#endif
|
|
|
|
// Preparing a pattern for template matching.
|
|
void CreateTemplate(const HImage& Template, Hlong FirstError, Hlong NumLevel, const HString& Optimize, const HString& GrayValues);
|
|
|
|
// Preparing a pattern for template matching.
|
|
void CreateTemplate(const HImage& Template, Hlong FirstError, Hlong NumLevel, const char* Optimize, const char* GrayValues);
|
|
|
|
#ifdef _WIN32
|
|
// Preparing a pattern for template matching.
|
|
void CreateTemplate(const HImage& Template, Hlong FirstError, Hlong NumLevel, const wchar_t* Optimize, const wchar_t* GrayValues);
|
|
#endif
|
|
|
|
// Serialize a template.
|
|
HSerializedItem SerializeTemplate() const;
|
|
|
|
// Deserialize a serialized template.
|
|
void DeserializeTemplate(const HSerializedItem& SerializedItemHandle);
|
|
|
|
// Writing a template to file.
|
|
void WriteTemplate(const HString& FileName) const;
|
|
|
|
// Writing a template to file.
|
|
void WriteTemplate(const char* FileName) const;
|
|
|
|
#ifdef _WIN32
|
|
// Writing a template to file.
|
|
void WriteTemplate(const wchar_t* FileName) const;
|
|
#endif
|
|
|
|
// Reading a template from file.
|
|
void ReadTemplate(const HString& FileName);
|
|
|
|
// Reading a template from file.
|
|
void ReadTemplate(const char* FileName);
|
|
|
|
#ifdef _WIN32
|
|
// Reading a template from file.
|
|
void ReadTemplate(const wchar_t* FileName);
|
|
#endif
|
|
|
|
// Deallocation of the memory of a template.
|
|
void ClearTemplate() const;
|
|
|
|
// Gray value offset for template.
|
|
void SetOffsetTemplate(Hlong GrayOffset) const;
|
|
|
|
// Define reference position for a matching template.
|
|
void SetReferenceTemplate(double Row, double Column) const;
|
|
|
|
// Adapting a template to the size of an image.
|
|
void AdaptTemplate(const HImage& Image) const;
|
|
|
|
// Searching all good gray value matches in a pyramid.
|
|
HRegion FastMatchMg(const HImage& Image, double MaxError, const HTuple& NumLevel) const;
|
|
|
|
// Searching all good gray value matches in a pyramid.
|
|
HRegion FastMatchMg(const HImage& Image, double MaxError, Hlong NumLevel) const;
|
|
|
|
// Searching the best gray value matches in a pre generated pyramid.
|
|
void BestMatchPreMg(const HImage& ImagePyramid, double MaxError, const HString& SubPixel, Hlong NumLevels, const HTuple& WhichLevels, double* Row, double* Column, double* Error) const;
|
|
|
|
// Searching the best gray value matches in a pre generated pyramid.
|
|
void BestMatchPreMg(const HImage& ImagePyramid, double MaxError, const HString& SubPixel, Hlong NumLevels, Hlong WhichLevels, double* Row, double* Column, double* Error) const;
|
|
|
|
// Searching the best gray value matches in a pre generated pyramid.
|
|
void BestMatchPreMg(const HImage& ImagePyramid, double MaxError, const char* SubPixel, Hlong NumLevels, Hlong WhichLevels, double* Row, double* Column, double* Error) const;
|
|
|
|
#ifdef _WIN32
|
|
// Searching the best gray value matches in a pre generated pyramid.
|
|
void BestMatchPreMg(const HImage& ImagePyramid, double MaxError, const wchar_t* SubPixel, Hlong NumLevels, Hlong WhichLevels, double* Row, double* Column, double* Error) const;
|
|
#endif
|
|
|
|
// Searching the best gray value matches in a pyramid.
|
|
void BestMatchMg(const HImage& Image, double MaxError, const HString& SubPixel, Hlong NumLevels, const HTuple& WhichLevels, double* Row, double* Column, double* Error) const;
|
|
|
|
// Searching the best gray value matches in a pyramid.
|
|
void BestMatchMg(const HImage& Image, double MaxError, const HString& SubPixel, Hlong NumLevels, Hlong WhichLevels, double* Row, double* Column, double* Error) const;
|
|
|
|
// Searching the best gray value matches in a pyramid.
|
|
void BestMatchMg(const HImage& Image, double MaxError, const char* SubPixel, Hlong NumLevels, Hlong WhichLevels, double* Row, double* Column, double* Error) const;
|
|
|
|
#ifdef _WIN32
|
|
// Searching the best gray value matches in a pyramid.
|
|
void BestMatchMg(const HImage& Image, double MaxError, const wchar_t* SubPixel, Hlong NumLevels, Hlong WhichLevels, double* Row, double* Column, double* Error) const;
|
|
#endif
|
|
|
|
// Searching all good matches of a template and an image.
|
|
HRegion FastMatch(const HImage& Image, double MaxError) const;
|
|
|
|
// Searching the best matching of a template and a pyramid with rotation.
|
|
void BestMatchRotMg(const HImage& Image, double AngleStart, double AngleExtend, double MaxError, const HString& SubPixel, Hlong NumLevels, HTuple* Row, HTuple* Column, HTuple* Angle, HTuple* Error) const;
|
|
|
|
// Searching the best matching of a template and a pyramid with rotation.
|
|
void BestMatchRotMg(const HImage& Image, double AngleStart, double AngleExtend, double MaxError, const HString& SubPixel, Hlong NumLevels, double* Row, double* Column, double* Angle, double* Error) const;
|
|
|
|
// Searching the best matching of a template and a pyramid with rotation.
|
|
void BestMatchRotMg(const HImage& Image, double AngleStart, double AngleExtend, double MaxError, const char* SubPixel, Hlong NumLevels, double* Row, double* Column, double* Angle, double* Error) const;
|
|
|
|
#ifdef _WIN32
|
|
// Searching the best matching of a template and a pyramid with rotation.
|
|
void BestMatchRotMg(const HImage& Image, double AngleStart, double AngleExtend, double MaxError, const wchar_t* SubPixel, Hlong NumLevels, double* Row, double* Column, double* Angle, double* Error) const;
|
|
#endif
|
|
|
|
// Searching the best matching of a template and an image with rotation.
|
|
void BestMatchRot(const HImage& Image, double AngleStart, double AngleExtend, double MaxError, const HString& SubPixel, HTuple* Row, HTuple* Column, HTuple* Angle, HTuple* Error) const;
|
|
|
|
// Searching the best matching of a template and an image with rotation.
|
|
void BestMatchRot(const HImage& Image, double AngleStart, double AngleExtend, double MaxError, const HString& SubPixel, double* Row, double* Column, double* Angle, double* Error) const;
|
|
|
|
// Searching the best matching of a template and an image with rotation.
|
|
void BestMatchRot(const HImage& Image, double AngleStart, double AngleExtend, double MaxError, const char* SubPixel, double* Row, double* Column, double* Angle, double* Error) const;
|
|
|
|
#ifdef _WIN32
|
|
// Searching the best matching of a template and an image with rotation.
|
|
void BestMatchRot(const HImage& Image, double AngleStart, double AngleExtend, double MaxError, const wchar_t* SubPixel, double* Row, double* Column, double* Angle, double* Error) const;
|
|
#endif
|
|
|
|
// Searching the best matching of a template and an image.
|
|
void BestMatch(const HImage& Image, double MaxError, const HString& SubPixel, HTuple* Row, HTuple* Column, HTuple* Error) const;
|
|
|
|
// Searching the best matching of a template and an image.
|
|
void BestMatch(const HImage& Image, double MaxError, const HString& SubPixel, double* Row, double* Column, double* Error) const;
|
|
|
|
// Searching the best matching of a template and an image.
|
|
void BestMatch(const HImage& Image, double MaxError, const char* SubPixel, double* Row, double* Column, double* Error) const;
|
|
|
|
#ifdef _WIN32
|
|
// Searching the best matching of a template and an image.
|
|
void BestMatch(const HImage& Image, double MaxError, const wchar_t* SubPixel, double* Row, double* Column, double* Error) const;
|
|
#endif
|
|
|
|
};
|
|
|
|
// forward declarations and types for internal array implementation
|
|
|
|
template<class T> class HSmartPtr;
|
|
template<class T> class HHandleBaseArrayRef;
|
|
|
|
typedef HHandleBaseArrayRef<HTemplate> HTemplateArrayRef;
|
|
typedef HSmartPtr< HTemplateArrayRef > HTemplateArrayPtr;
|
|
|
|
|
|
// Represents multiple tool instances
|
|
class LIntExport HTemplateArray : public HHandleBaseArray
|
|
{
|
|
|
|
public:
|
|
|
|
// Create empty array
|
|
HTemplateArray();
|
|
|
|
// Create array from native array of tool instances
|
|
HTemplateArray(HTemplate* classes, Hlong length);
|
|
|
|
// Copy constructor
|
|
HTemplateArray(const HTemplateArray &tool_array);
|
|
|
|
// Destructor
|
|
virtual ~HTemplateArray();
|
|
|
|
// Assignment operator
|
|
HTemplateArray &operator=(const HTemplateArray &tool_array);
|
|
|
|
// Clears array and all tool instances
|
|
virtual void Clear();
|
|
|
|
// Get array of native tool instances
|
|
const HTemplate* Tools() const;
|
|
|
|
// Get number of tools
|
|
virtual Hlong Length() const;
|
|
|
|
// Create tool array from tuple of handles
|
|
virtual void SetFromTuple(const HTuple& handles);
|
|
|
|
// Get tuple of handles for tool array
|
|
virtual HTuple ConvertToTuple() const;
|
|
|
|
protected:
|
|
|
|
// Smart pointer to internal data container
|
|
HTemplateArrayPtr *mArrayPtr;
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|