Skip to content

write_shape_model_3dWriteShapeModel3dWriteShapeModel3dwrite_shape_model_3dT_write_shape_model_3d🔗

Short description🔗

write_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 )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🔗

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)HTuple (HHandle)HShapeModel3D, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the 3D shape model.

FileNamefileNamefile_name (input_control) filename.write → (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