write_shape_model_3dwrite_shape_model_3dWriteShapeModel3dWriteShapeModel3d (Operator)

Name

write_shape_model_3dwrite_shape_model_3dWriteShapeModel3dWriteShapeModel3d — Write a 3D shape model to a file.

Signature

write_shape_model_3d( : : ShapeModel3DID, FileName : )

The operator write_shape_model_3dwrite_shape_model_3dWriteShapeModel3dWriteShapeModel3dWriteShapeModel3d writes a 3D shape model to the file FileNameFileNameFileNameFileNamefileName. The model can be read again with read_shape_model_3dread_shape_model_3dReadShapeModel3dReadShapeModel3dReadShapeModel3d. The default HALCON file extension for the 3D shape model is 'sm3'.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

ShapeModel3DIDShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DID (input_control) shape_model_3d → (integer)

Handle of the 3D shape model.

FileNameFileNameFileNameFileNamefileName (input_control) filename.write → (string)

File name.

File extension: .sm3

Result

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

Possible Predecessors

create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3d

Module

3D Metrology

Operators