HALCON Website / HALCON Operator Reference / Matching / Gray-Value-Based
ClassesClassesClassesClasses | | | | Operators

read_templateread_templateReadTemplateread_templateReadTemplateReadTemplate (Operator)

Name

read_templateread_templateReadTemplateread_templateReadTemplateReadTemplate — Reading a template from file.

Signature

read_template( : : FileName : TemplateID)

Herror read_template(const char* FileName, Hlong* TemplateID)

Herror T_read_template(const Htuple FileName, Htuple* TemplateID)

Herror read_template(const HTuple& FileName, Hlong* TemplateID)

void HTemplate::ReadTemplate(const HTuple& FileName)

void ReadTemplate(const HTuple& FileName, HTuple* TemplateID)

void HTemplate::HTemplate(const HString& FileName)

void HTemplate::HTemplate(const char* FileName)

void HTemplate::ReadTemplate(const HString& FileName)

void HTemplate::ReadTemplate(const char* FileName)

void HOperatorSetX.ReadTemplate(
[in] VARIANT FileName, [out] VARIANT* TemplateID)

void HTemplateX.ReadTemplate([in] BSTR FileName)

static void HOperatorSet.ReadTemplate(HTuple fileName, out HTuple templateID)

public HTemplate(string fileName)

void HTemplate.ReadTemplate(string fileName)

Description

The operator read_templateread_templateReadTemplateread_templateReadTemplateReadTemplate reads a matching template from file which has been written with write_templatewrite_templateWriteTemplatewrite_templateWriteTemplateWriteTemplate. The default HALCON file extension for a template is 'gvt'.

Parallelization

Parameters

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.read → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

file name.

File extension: .gvt

TemplateIDTemplateIDTemplateIDTemplateIDTemplateIDtemplateID (output_control)  template → HTemplate, HTupleHTupleHTemplate, HTupleHTemplateX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Template number.

Result

If the file name is valid, the operator read_templateread_templateReadTemplateread_templateReadTemplateReadTemplate returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Successors

adapt_templateadapt_templateAdaptTemplateadapt_templateAdaptTemplateAdaptTemplate, set_reference_templateset_reference_templateSetReferenceTemplateset_reference_templateSetReferenceTemplateSetReferenceTemplate, set_offset_templateset_offset_templateSetOffsetTemplateset_offset_templateSetOffsetTemplateSetOffsetTemplate, best_matchbest_matchBestMatchbest_matchBestMatchBestMatch, fast_matchfast_matchFastMatchfast_matchFastMatchFastMatch, best_match_rotbest_match_rotBestMatchRotbest_match_rotBestMatchRotBestMatchRot

Module

Matching

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 11.0.5 Copyright © 1996-2015 MVTec Software GmbH