Click here to show toolbars of the Web Online Help System: show toolbars |
Table: | For specifying the file format |
Table: | For specifying the frame rate |
MIL_CONST_TEXT_PTR FileName, | //in |
MIL_INT64 FileFormat, | //in |
const MIL_ID *BufArrayPtrOrSystemIdPtr, | //in |
MIL_INT NumOfIds, | //in |
MIL_DOUBLE FrameRate, | //in |
MIL_INT64 ControlFlag | //in |
This function exports a sequence of image buffers to an audio video interleave (AVI) file.
This function creates a new AVI file, or appends to an existing AVI file. If all your images have been acquired, call this function a single time (M_APPEND or M_DEFAULT) to automatically open (or create) the file, write to it, and then close the file. If your images are being acquired over time, call this function to open (or create) the file (M_OPEN or M_OPEN + M_APPEND), call the function again each time you want to write new images to the file (M_WRITE), and call the function once more to close the file (M_CLOSE).
Specifies the name and path of the AVI file.
This parameter can be set to the following value:
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the drive, directory, and name of the file (for example, "C:\mydirectory\myfile"). |
1 If you are passing the value in a variable, don't enclose it in MIL_TEXT().
Specifies the format of the file. This parameter can be set to one of the values below.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that MIL automatically decides the appropriate format. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies an AVI format used to hold non-compressed DIB image buffers. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies an AVI format used to hold image buffers in their MIL format. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
[For
essential MIL-Lite information, see remarks ]
Specifies an AVI format used to hold JPEG compressed sequences. |
Specifies the image buffers to export or, when opening or closing (M_OPEN, M_OPEN + M_APPEND, or M_CLOSE) a file on a remote computer, a MIL system allocated on the remote computer.
See the Parameter associations section for possible values that can be specified.
Specifies the number of MIL identifiers passed to the BufArrayPtrOrSystemIdPtr parameter (image buffers or system identifiers).
See the Parameter associations section for possible values that can be specified.
Specifies the frame rate (number of images/sec) of the sequence. The frame rate can be specified with any (or every) call to MbufExportSequence(), but it is only checked for validity when closing the AVI file (using M_CLOSE, M_APPEND, or M_DEFAULT). The last call that specifies a valid frame rate will be used.
Specifies whether to write, overwrite, or append the image buffers to the AVI file.
See the Parameter associations section for possible values that can be specified.
The table below lists possible values for the BufArrayPtrOrSystemIdPtr, NumOfIds, and ControlFlag parameters.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
BufArrayPtrOrSystemIdPtr | |||||||||||||||||||||||||||||||||||||||
NumOfIds | |||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Opens the AVI file, overwriting it in the process. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the address of an array containing the identifiers of the image buffers to export. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the number of image buffers to export. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Appends the image buffers to the file without overwriting it. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the address of an array containing the identifiers of the image buffers to export. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the number of image buffers to export. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Closes the AVI file. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the computer on which the file is located. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the file to be closed is on a local computer. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the address of a variable containing the identifier of a remote system that is on the same remote computer as the AVI file. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the number of system identifiers passed to the BufArrayPtrOrSystemIdPtr parameter (either a single one, or none). |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Opens the AVI file, overwriting it in the process. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the computer on which the file is located. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the file to be opened is on a local computer. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the address of a variable containing the identifier of a remote system that is on the same remote computer as the AVI file. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the number of system identifiers passed to the BufArrayPtrOrSystemIdPtr parameter (either a single one, or none). |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Opens the AVI file, and sets the pointer to the end of the file without overwriting the existing images. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the computer on which the file is located. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the file to be opened is on a local computer. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the address of a variable containing the identifier of a remote system that is on the same remote computer as the AVI file. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the number of system identifiers passed to the BufArrayPtrOrSystemIdPtr parameter (either a single one, or none). |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Writes the specified number of images in the file starting from the current file pointer position. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the address of an array containing the identifiers of the image buffers to export. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the number of image buffers to export. |
Header | Include mil.h. |
Library | Use mil.lib. |
DLL | Requires mil.dll. |