traind_ocv_projT_traind_ocv_projTraindOcvProjTraindOcvProj (Operator)


traind_ocv_projT_traind_ocv_projTraindOcvProjTraindOcvProj — Training of an OCV tool.


traind_ocv_proj(Pattern : : OCVHandle, Name, Mode : )

Herror T_traind_ocv_proj(const Hobject Pattern, const Htuple OCVHandle, const Htuple Name, const Htuple Mode)

void TraindOcvProj(const HObject& Pattern, const HTuple& OCVHandle, const HTuple& Name, const HTuple& Mode)

void HImage::TraindOcvProj(const HOCV& OCVHandle, const HTuple& Name, const HString& Mode) const

void HImage::TraindOcvProj(const HOCV& OCVHandle, const HString& Name, const HString& Mode) const

void HImage::TraindOcvProj(const HOCV& OCVHandle, const char* Name, const char* Mode) const

void HImage::TraindOcvProj(const HOCV& OCVHandle, const wchar_t* Name, const wchar_t* Mode) const   (Windows only)

void HOCV::TraindOcvProj(const HImage& Pattern, const HTuple& Name, const HString& Mode) const

void HOCV::TraindOcvProj(const HImage& Pattern, const HString& Name, const HString& Mode) const

void HOCV::TraindOcvProj(const HImage& Pattern, const char* Name, const char* Mode) const

void HOCV::TraindOcvProj(const HImage& Pattern, const wchar_t* Name, const wchar_t* Mode) const   (Windows only)

static void HOperatorSet.TraindOcvProj(HObject pattern, HTuple OCVHandle, HTuple name, HTuple mode)

void HImage.TraindOcvProj(HOCV OCVHandle, HTuple name, string mode)

void HImage.TraindOcvProj(HOCV OCVHandle, string name, string mode)

void HOCV.TraindOcvProj(HImage pattern, HTuple name, string mode)

void HOCV.TraindOcvProj(HImage pattern, string name, string mode)


traind_ocv_projtraind_ocv_projTraindOcvProjTraindOcvProjTraindOcvProj trains patterns for an OCV tool that has been created using the operators create_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProjCreateOcvProj or read_ocvread_ocvReadOcvReadOcvReadOcv. For this training one or multiple patterns are provided to the system. Such a pattern consists of an image with a reduced domain (ROI) for the area of the pattern. Note that the pattern should not only contain foreground pixels (e.g. dark pixels of a character) but also background pixels. This can be implemented e.g. by the smallest surrounding rectangle of the pattern. Without this context an evaluation of the pattern is not possible.

If more than one pattern has to be trained this can be achieved by multiple calls (one for each pattern) or by calling traind_ocv_projtraind_ocv_projTraindOcvProjTraindOcvProjTraindOcvProj once with all patterns and a tuple of the corresponding names. The result will be in both cases the same. However using multiple calls will normally result in a longer execution time than using one call with all patterns.

Execution Information

This operator modifies the state of the following input parameter:

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.


PatternPatternPatternPatternpattern (input_object)  singlechannelimage(-array) objectHImageHImageHobject (byte)

Pattern to be trained.

OCVHandleOCVHandleOCVHandleOCVHandleOCVHandle (input_control, state is modified)  ocv HOCV, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the OCV tool to be trained.

NameNameNameNamename (input_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Name(s) of the object(s) to analyse.

Default value: 'a' "a" "a" "a" "a"

ModeModeModeModemode (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Mode for training (only one mode implemented).

Default value: 'single' "single" "single" "single" "single"

List of values: 'single'"single""single""single""single"

Example (C++ (HALCON 5.0-10.0))



traind_ocv_projtraind_ocv_projTraindOcvProjTraindOcvProjTraindOcvProj returns 2 (H_MSG_TRUE), if the handle and the training pattern(s) are correct. Otherwise, an exception is raised.

Possible Predecessors

write_ocr_trainfwrite_ocr_trainfWriteOcrTrainfWriteOcrTrainfWriteOcrTrainf, create_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProjCreateOcvProj, read_ocvread_ocvReadOcvReadOcvReadOcv, thresholdthresholdThresholdThresholdThreshold, connectionconnectionConnectionConnectionConnection, select_shapeselect_shapeSelectShapeSelectShapeSelectShape

Possible Successors


See also