Click here to show toolbars of the Web Online Help System: show toolbars |
MIL_TEXT_PTR MemPtrOrFileName, | //in-out |
MIL_ID SysId, | //in |
MIL_INT64 Operation, | //in |
MIL_INT64 StreamType, | //in |
MIL_DOUBLE Version, | //in |
MIL_INT64 ControlFlag, | //in |
MIL_ID *GeometryOrMatrix3dgeoIdPtr, | //in-out |
MIL_INT *SizeByteVarPtr | //out |
This function can load, restore, or save a 3D geometry object or transformation matrix object from/to a file or memory stream.
To inquire the number of bytes necessary to save a 3D geometry object or transformation matrix object to a memory stream, you should first call this function (M3dgeoStream()) with M_INQUIRE_SIZE_BYTE.
The content saved to memory stream is equivalent to the content saved to file. This function is equivalent to a file saved using M3dgeoSave().
You can use this and other MIL stream functions, for example, to save all required MIL objects, as well as any other custom data, for your application to a memory stream. Once in a memory stream, you can write the stream to a single file or transfer it over a network. You are responsible for concatenating the streams and for saving the stream to file.
Specifies the file or memory stream.
See the Parameter associations section for possible values that can be returned/specified.
Specifies the system on which to restore the 3D geometry object or transformation matrix object.
See the Parameter associations section for possible values that can be specified.
Specifies the operation to perform.
See the Parameter associations section for possible values that can be specified.
Specifies the type of stream in which to store/from which to restore the 3D geometry object or transformation matrix object. This parameter must be set to one of the following values:
Specifies the MIL version of the 3D geometry object or transformation matrix object.
See the Parameter associations section for possible values that can be specified.
Specifies the address of the variable in which to write or from which to read the identifier of the 3D geometry object or transformation matrix object. If the M_RESTORE operation is not successful, M_NULL is returned.
See the Parameter associations section for possible values that can be returned/specified.
Specifies the address of the variable in which to write the size of the 3D geometry object or transformation matrix object, in bytes.
If the size is not required, you can set this parameter to M_NULL.
Note that the size of the 3D geometry object or transformation matrix object will vary depending on the MIL version specified.
The table below lists possible values for the MemPtrOrFileName, SysId, Operation, Version, and GeometryOrMatrix3dgeoIdPtr parameters.
For performing the stream operation.
|
|||||||||||||||||||||||||||||||||||||||
|
Description | ||||||||||||||||||||||||||||||||||||||
MemPtrOrFileName - Possible values passed or returned |
|||||||||||||||||||||||||||||||||||||||
SysId | |||||||||||||||||||||||||||||||||||||||
Version | |||||||||||||||||||||||||||||||||||||||
GeometryOrMatrix3dgeoIdPtr - Possible values passed or returned |
|||||||||||||||||||||||||||||||||||||||
M_INQUIRE_SIZE_BYTE |
Inquires the number of bytes required to save a 3D geometry object or transformation matrix object to memory stream. |
||||||||||||||||||||||||||||||||||||||
MemPtrOrFileName |
This parameter must be set to M_NULL. |
||||||||||||||||||||||||||||||||||||||
SysId |
This parameter must be set to M_NULL. |
||||||||||||||||||||||||||||||||||||||
Version |
Specifies the MIL version with which the 3D geometry object or transformation matrix object must be compatible when saved. |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the current version of MIL. |
||||||||||||||||||||||||||||||||||||||
M_PROC_VERSION_100_SP4 |
Specifies the version as being MIL 10.0 Service Pack 4. |
||||||||||||||||||||||||||||||||||||||
GeometryOrMatrix3dgeoIdPtr |
Specifies the address of the variable containing the identifier of the 3D geometry object or transformation matrix object. |
||||||||||||||||||||||||||||||||||||||
M_LOAD |
Loads the content of a specified file or memory stream into a previously allocated 3D geometry object or transformation matrix object. |
||||||||||||||||||||||||||||||||||||||
MemPtrOrFileName |
Specifies the file or memory stream from which to load the 3D geometry object or transformation matrix object. |
||||||||||||||||||||||||||||||||||||||
M_INTERACTIVE |
[This is
only applicable to Windows]
Opens a dialog box from which you can interactively specify the drive, directory, and name of the file, when the StreamType parameter is set to M_FILE. |
||||||||||||||||||||||||||||||||||||||
MIL_TEXT("FileName") 1 |
Specifies the drive, directory, and name of the file (for example, "C:\mydirectory\myfile"), when the StreamType parameter is set to M_FILE. |
||||||||||||||||||||||||||||||||||||||
MemPtr |
Specifies the address of the block of memory, when the StreamType parameter is set to M_MEMORY. |
||||||||||||||||||||||||||||||||||||||
SysId |
This parameter must be set to M_NULL. |
||||||||||||||||||||||||||||||||||||||
Version |
This parameter must be set to M_DEFAULT. |
||||||||||||||||||||||||||||||||||||||
GeometryOrMatrix3dgeoIdPtr |
Specifies the address of the variable containing the identifier of the 3D geometry object or transformation matrix object. |
||||||||||||||||||||||||||||||||||||||
M_RESTORE |
Restores a 3D geometry object or transformation matrix object from a file or memory stream and assigns it a MIL identifier. |
||||||||||||||||||||||||||||||||||||||
MemPtrOrFileName |
Specifies the file or memory stream from which to restore the 3D geometry object or transformation matrix object. |
||||||||||||||||||||||||||||||||||||||
M_INTERACTIVE |
[This is
only applicable to Windows]
Opens a dialog box from which you can interactively specify the drive, directory, and name of the file, when the StreamType parameter is set to M_FILE. |
||||||||||||||||||||||||||||||||||||||
MIL_TEXT("FileName") 1 |
Specifies the drive, directory, and name of the file (for example, "C:\mydirectory\myfile"), when the StreamType parameter is set to M_FILE. |
||||||||||||||||||||||||||||||||||||||
MemPtr |
Specifies the address of the block of memory, when the StreamType parameter is set to M_MEMORY. |
||||||||||||||||||||||||||||||||||||||
SysId |
Specifies the system on which to allocate the 3D geometry object or transformation matrix object. |
||||||||||||||||||||||||||||||||||||||
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(). |
||||||||||||||||||||||||||||||||||||||
Version |
This parameter must be set to M_DEFAULT. |
||||||||||||||||||||||||||||||||||||||
GeometryOrMatrix3dgeoIdPtr |
Specifies the address of the variable in which to write the identifier of the 3D geometry object or transformation matrix object. |
||||||||||||||||||||||||||||||||||||||
M_SAVE |
Saves a 3D geometry object or transformation matrix object to a specified file or memory stream. |
||||||||||||||||||||||||||||||||||||||
MemPtrOrFileName |
Specifies the file or memory stream. |
||||||||||||||||||||||||||||||||||||||
M_INTERACTIVE |
[This is
only applicable to Windows]
Opens a dialog box from which you can interactively specify the drive, directory, and name of the file, when the StreamType parameter is set to M_FILE. |
||||||||||||||||||||||||||||||||||||||
MIL_TEXT("FileName") 1 |
Specifies the drive, directory, and name of the file (for example, "C:\mydirectory\myfile"), when the StreamType parameter is set to M_FILE. |
||||||||||||||||||||||||||||||||||||||
MemPtr |
Specifies the address of the block of memory, when the StreamType parameter is set to M_MEMORY. |
||||||||||||||||||||||||||||||||||||||
SysId |
This parameter must be set to M_NULL. |
||||||||||||||||||||||||||||||||||||||
Version |
Specifies the MIL version with which the 3D geometry object or transformation matrix object must be compatible when saved. |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the current version of MIL. |
||||||||||||||||||||||||||||||||||||||
M_PROC_VERSION_100_SP4 |
Specifies the version as being MIL 10.0 Service Pack 4. |
||||||||||||||||||||||||||||||||||||||
GeometryOrMatrix3dgeoIdPtr |
Specifies the address of the variable containing the identifier of the 3D geometry object or transformation matrix object to save. |
1 If you are passing the value in a variable, don't enclose it in MIL_TEXT().
Header | Include mil.h. |
Library | Use mil.lib; mil3d.lib. |
DLL | Requires mil.dll; mil3d.dll. |