write_bar_code_modelT_write_bar_code_modelWriteBarCodeModelWriteBarCodeModel (Operator)

Name

write_bar_code_modelT_write_bar_code_modelWriteBarCodeModelWriteBarCodeModel — Schreibt ein Barcode-Modell in eine Datei.

Signatur

Beschreibung

Der Operator write_bar_code_modelwrite_bar_code_modelWriteBarCodeModelWriteBarCodeModelWriteBarCodeModel schreibt ein Barcode-Modell in eine Datei mit dem Namen FileNameFileNameFileNameFileNamefileName. Das so gesicherte Modell kann mit read_bar_code_modelread_bar_code_modelReadBarCodeModelReadBarCodeModelReadBarCodeModel später wieder eingelesen und wiederverwendet werden. Gespeichert werden alle generischen und spezifischen Parameter des Modells (siehe set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParam, bzw. set_bar_code_param_specificset_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecificSetBarCodeParamSpecific). Wenn das Modell im Training-Modus läuft (siehe set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParam mit Parameter 'train'"train""train""train""train"), wird der Training-Stand des Modells mitgespeichert. Dadurch kann das Training nach dem Einlesen des Modells fortgesetzt werden (siehe Beispiel). Außer dem Training-Stand werden keine weiteren Ergebnisse des Operators find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCode in die Datei gespeichert.

Die Dateiendung für das Barcode-Modell ist in HALCON 'bcm'. Der Handle des zu schreibenden Barcode-Modells ist in BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandle zu übergeben.

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Beispiel (HDevelop)

*
* Create the bar code model in the training mode
create_bar_code_model ('train', 'all', BarCodeHandle)
*
* Set all additional, non-trained parameters in advance:
* Here, we specify that the training images have check characters
set_bar_code_param (BarCodeHandle, 'check_char', 'present')
*
* Train the model with several images
for I := 1 to 7 by 1
    FileName := 'barcode/25interleaved/25interleaved' + I$'.02'
    read_image (Image, FileName)
    *
    * Apply the training
    find_bar_code (Image, SymbolRegion, BarCodeHandle, '2/5 Interleaved', \
                   DecodedDataStrings)
endfor
*
* The training may be interrupted and the intermediate state
* of the model can be stored in a file
write_bar_code_model (BarCodeHandle, 'bar_code_model.bcm')
*
* RESTORE TRAINING:
* Later, when, e.g., new images are available, the training
* may be restored
read_bar_code_model ('bar_code_model.bcm', BarCodeHandle)
FileName := 'barcode/25interleaved/25interleaved08'
read_image (Image, FileName)
*
* Apply the training to the new image
find_bar_code (Image, SymbolRegion, BarCodeHandle, '2/5 Interleaved', \
               DecodedDataStrings)
*
* Finally, the training can be completed
set_bar_code_param (BarCodeHandle, 'train', '~all')
*
* The trained model can be stored for ONLINE use
write_bar_code_model (BarCodeHandle, 'trained_bar_code_model.bcm')
*
* ONLINE USE:
read_bar_code_model ('trained_bar_code_model.bcm', BarCodeHandle)
* ...

Ergebnis

write_bar_code_modelwrite_bar_code_modelWriteBarCodeModelWriteBarCodeModelWriteBarCodeModel liefert den Wert 2 (H_MSG_TRUE), falls der übergebene Handle gültig ist und das Modell in die Datei mit dem angegebenen Namen geschrieben werden kann. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_bar_code_modelcreate_bar_code_modelCreateBarCodeModelCreateBarCodeModelCreateBarCodeModel, set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParam

Siehe auch

create_bar_code_modelcreate_bar_code_modelCreateBarCodeModelCreateBarCodeModelCreateBarCodeModel, set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParam, find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCode

Modul

Bar Code