| Customize Help
| Save Settings

M3dmapSave


Function Map
Syntax
Description
Parameters
- FileName
Table: For specifying the file name and path
- M3dmapId
- ControlFlag
Compilation information
Synopsis
Save a 3D object to a file.
Syntax
void M3dmapSave(
MIL_CONST_TEXT_PTR FileName, //in
MIL_ID M3dmapId, //in
MIL_INT64 ControlFlag //in
)
Description

This function saves to disk all the information about the previously allocated 3D object. You can only save a 3D reconstruction context or 3D reconstruction result buffer of type M_POINT_CLOUD_RESULT.

For a 3D reconstruction context, all camera calibration information is saved, and the context will be ready to use on reload. You can reload the saved information, using M3dmapRestore() or M3dmapStream().

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.
Parameters
This function is not supported on the selected boards.
This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.
Parameters
FileName

Specifies the name and directory of the file in which to save the 3D object. The recommended extension is M3D.

function map For specifying the file name and path
Click to summarizeValue Description
Click to summarize M_INTERACTIVE
[This is only applicable to Windows]

Opens the File Save As dialog box from which you can interactively specify the drive, directory, and name of the file.
Click to summarize MIL_TEXT("FileName") 1

Specifies the drive, directory, and name of the file (for example, "C:\mydirectory\myfile"). Typically, 3D object files have an M3D file extension.

To specify a file on a remote computer (under Distributed MIL), prefix the specified file name string with "remote:///" (for example, "remote:///C:\mydirectory\myfile").

(summarize)

1 If you are passing the value in a variable, don't enclose it in MIL_TEXT().

M3dmapId

Specifies the identifier of the 3D object to save.

ControlFlag

Reserved for future expansion and must be set to M_DEFAULT.

Compilation information
Header Include mil.h.
Library Use mil.lib; mil3dmap.lib.
DLL Requires mil.dll; mil3dmap.dll.
INTERACTIVE