Operator Reference

write_shape_model_3dT_write_shape_model_3dWriteShapeModel3dWriteShapeModel3dwrite_shape_model_3d (Operator)

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

Signature

write_shape_model_3d( : : ShapeModel3DID, FileName : )

Herror T_write_shape_model_3d(const Htuple ShapeModel3DID, const Htuple FileName)

void WriteShapeModel3d(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)

static void HOperatorSet.WriteShapeModel3d(HTuple shapeModel3DID, HTuple fileName)

void HShapeModel3D.WriteShapeModel3d(string fileName)

def write_shape_model_3d(shape_model_3did: HHandle, file_name: str) -> None

Description

The operator write_shape_model_3dwrite_shape_model_3dWriteShapeModel3dWriteShapeModel3dwrite_shape_model_3d writes a 3D shape model to the file FileNameFileNameFileNamefileNamefile_name. The model can be read again with read_shape_model_3dread_shape_model_3dReadShapeModel3dReadShapeModel3dread_shape_model_3d. 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

ShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DIDshape_model_3did (input_control)  shape_model_3d HShapeModel3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the 3D shape model.

FileNameFileNameFileNamefileNamefile_name (input_control)  filename.write HTuplestrHTupleHtuple (string) (string) (HString) (char*)

File name.

File extension: .sm3

Result

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

Possible Predecessors

create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dcreate_shape_model_3d

Module

3D Metrology