write_shape_model_3dwrite_shape_model_3dWriteShapeModel3dWriteShapeModel3dwrite_shape_model_3dT_write_shape_model_3d
Short description
write_shape_model_3dwrite_shape_model_3dWriteShapeModel3dWriteShapeModel3dwrite_shape_model_3dT_write_shape_model_3d — Write a 3D shape model to a file.
Signature
write_shape_model_3d( shape_model_3d ShapeModel3DID, filename.write FileName )write_shape_model_3d( : : ShapeModel3DID, FileName : )void WriteShapeModel3d( const HTuple& ShapeModel3DID, const HTuple& FileName )static void HOperatorSet.WriteShapeModel3d( HTuple shapeModel3DID, HTuple fileName )def write_shape_model_3d( shape_model_3did: HHandle, file_name: str ) -> None
Herror T_write_shape_model_3d( const Htuple ShapeModel3DID, const Htuple FileName )
void HShapeModel3D::WriteShapeModel3d( const HString& FileName ) const
void HShapeModel3D::WriteShapeModel3d( const char* FileName ) const
void HShapeModel3D::WriteShapeModel3d( const wchar_t* FileName ) const (Windows only)
void HShapeModel3D.WriteShapeModel3d( string fileName )
Description
The operator write_shape_model_3dWriteShapeModel3d writes a 3D shape model to
the file FileNamefileNamefile_name. The model can be read again with
read_shape_model_3dReadShapeModel3d. 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
ShapeModel3DIDshapeModel3DIDshape_model_3did (input_control) shape_model_3d → (handle)(handle)HTuple (HHandle)HShapeModel3D, HTuple (IntPtr)HHandleHtuple (handle)
Handle of the 3D shape model.
FileNamefileNamefile_name (input_control) filename.write → (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)
File name.
File extension: .sm3
Result
If the file name is valid (write permission), the operator
write_shape_model_3dWriteShapeModel3d returns the value 2 (H_MSG_TRUE). If necessary
an exception is raised.
Combinations with other operators
Combinations
Possible predecessors
create_shape_model_3dCreateShapeModel3d
Module
3D Metrology