read_memory_blockT_read_memory_blockReadMemoryBlockReadMemoryBlockread_memory_block (Operator)
Name
read_memory_blockT_read_memory_blockReadMemoryBlockReadMemoryBlockread_memory_block — Lesen eines Speicherblocks aus einer Datei.
Signatur
def read_memory_block(file_name: str) -> HHandle
Beschreibung
Der Operator read_memory_blockread_memory_blockReadMemoryBlockReadMemoryBlockReadMemoryBlockread_memory_block liest die Datei FileNameFileNameFileNameFileNamefileNamefile_name und
legt in MemoryBlockHandleMemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle einen neuen Speicherblock an, der eine
exakte Kopie der Bytes in der Datei ist.
Die HALCON Standard-Dateiendung eines Speicherblocks ist '.bin'.
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.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
Parameter
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der Datei.
Defaultwert:
'memory_block.bin'
"memory_block.bin"
"memory_block.bin"
"memory_block.bin"
"memory_block.bin"
"memory_block.bin"
Dateiendung: .bin
MemoryBlockHandleMemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle (output_control) memory_block → HMemoryBlock, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Speicherblocks.
Ergebnis
read_memory_blockread_memory_blockReadMemoryBlockReadMemoryBlockReadMemoryBlockread_memory_block liefert den Wert 2 (H_MSG_TRUE), falls eine Datei mit dem
angegebenen Namen gefunden wurde und korrekt eingelesen werden konnte.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
Nachfolger
get_memory_block_ptrget_memory_block_ptrGetMemoryBlockPtrGetMemoryBlockPtrGetMemoryBlockPtrget_memory_block_ptr,
compare_memory_blockcompare_memory_blockCompareMemoryBlockCompareMemoryBlockCompareMemoryBlockcompare_memory_block,
memory_block_to_imagememory_block_to_imageMemoryBlockToImageMemoryBlockToImageMemoryBlockToImagememory_block_to_image
Siehe auch
write_memory_blockwrite_memory_blockWriteMemoryBlockWriteMemoryBlockWriteMemoryBlockwrite_memory_block
Modul
Foundation