MIL_CONST_TEXT_PTR FileName, | //in |
MIL_ID SystemId, | //in |
MIL_INT64 ControlFlag, | //in |
MIL_ID *ContextIdPtr | //out |
This function restores a Model Finder context that was previously saved to a file, using MmodSave() or MmodStream(). This function restores all of the Model Finder context's settings that were in effect when the Model Finder context was saved. A restored Model Finder context is not preprocessed, therefore you must call MmodPreprocess() before performing a search with MmodFind().
If you had associated camera calibration contexts with the models in your Model Finder context and you did not save them with the context, you must re-associate the camera calibration contexts, using MmodControl() with M_ASSOCIATED_CALIBRATION. Moreover, if you had previously set drawing control types, using MgraControl() with M_DRAW_..., then you must reset them since they were not saved with the context.
Specifies the name and path of the file from which to restore the Model Finder context. The function handles (internally) the opening and closing of the file.
This parameter can be set to one of the following:
For specifying the file name and path
|
|||||||||||||||||||||||||||||||||||||||
Value | Description | ||||||||||||||||||||||||||||||||||||||
M_INTERACTIVE |
[This is
only applicable to Windows]
Opens the File Open dialog box from which you can interactively specify the drive, directory, and name of the file. |
||||||||||||||||||||||||||||||||||||||
MIL_TEXT("FileName") 1 |
Specifies the drive, directory, and name of the file (for example, "C:\mydirectory\myfile"). Typically, Model Finder context files have an MMF 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)Specifies the drive, directory, and name of the file (for example, "C:\mydirectory\myfile"). (more details...) |
1 If you are passing the value in a variable, don't enclose it in MIL_TEXT().
Specifies the system on which to restore the Model Finder context.
This parameter should be set to one of the following values:
For specifying the system identifier
|
|||||||||||||||||||||||||||||||||||||||
Value | Description | ||||||||||||||||||||||||||||||||||||||
M_DEFAULT_HOST |
Specifies the default Host system of the current MIL application. |
||||||||||||||||||||||||||||||||||||||
MIL system identifier |
Specifies a valid system identifier, previously allocated using MsysAlloc(). |
Specifies whether to restore, from the Model Finder context, the camera calibration contexts associated with the models.
For specifying whether to restore the camera
calibration contexts associated with the models
|
|||||||||||||||||||||||||||||||||||||||
Value | Description | ||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies that the camera calibration contexts are not restored. |
||||||||||||||||||||||||||||||||||||||
M_WITH_CALIBRATION |
Specifies that the camera calibration contexts are restored. In this case, the camera calibration contexts must have been previously saved with the context, using MmodSave() or MmodStream() with M_WITH_CALIBRATION. Note that the camera calibration contexts associated with synthetic models are not saved or restored. The camera calibration information is restored from the same file as the Model Finder context. The camera calibration cannot be managed independently from the Model Finder context. When the Model Finder context is freed, the camera calibration is automatically freed as well. (summarize)Specifies that the camera calibration contexts are restored. (more details...) |
Header | Include mil.h. |
Library | Use mil.lib; milmod.lib. |
DLL | Requires mil.dll; milmod.dll. |