write_bar_code_model
— Schreibt ein Barcode-Modell in eine Datei.
write_bar_code_model( : : BarCodeHandle, FileName : )
Der Operator write_bar_code_model
schreibt ein Barcode-Modell in
eine Datei mit dem Namen FileName
.
Das so gesicherte Modell kann mit read_bar_code_model
später
wieder eingelesen und wiederverwendet werden. Gespeichert werden alle
generischen und spezifischen Parameter des Modells (siehe
set_bar_code_param
, bzw. set_bar_code_param_specific
).
Wenn das Modell im Training-Modus läuft (siehe
set_bar_code_param
mit Parameter '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_code
in die Datei gespeichert.
Die Dateiendung für das Barcode-Modell ist in HALCON 'bcm'.
Der Handle des zu schreibenden Barcode-Modells ist in
BarCodeHandle
zu übergeben.
BarCodeHandle
(input_control) barcode →
(handle)
Handle des zu schreibenden Barcode-Modells.
FileName
(input_control) filename.write →
(string)
Name der zu schreibenden Barcode-Datei.
Defaultwert: 'bar_code_model.bcm'
Dateiendung: .bcm
* * 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) * ...
write_bar_code_model
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.
create_bar_code_model
,
set_bar_code_param
create_bar_code_model
,
set_bar_code_param
,
find_bar_code
Bar Code