read_surface_model — Read a surface model from a file.
read_surface_model reads the surface model, which has
been written with
write_surface_model, from the file
The handle of the surface model is returned in
If no absolute path is given in
FileName, the file is searched
in the current directory of the HALCON process.
The default HALCON file extension for the surface model (SFM) file is
If no file named
FileName exists, the default file extension is
This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.
Name of the SFM file.
File extension: .
Handle of the read surface model.
read_surface_model returns 2 (H_MSG_TRUE) if all parameters are
correct and the file can be read.
If the file is not a surface model file, the error 9506 is raised.
If the file has a version that can not be read by this version of HALCON,
the error 9507 is raised.
If necessary, an exception is raised.