References ▼
Saves a vector image to a file in memory. The output can be in any of the supported compressed or uncompressed file formats.
#include "ltvkrn.h"
L_LVKRN_API L_INT L_VecSaveMemory(phHandle, pVector, nFormat, puSize, pSaveOptions)
Pointer to the memory handle. Set this to NULL. This function uses the handle to allocate the memory. It unlocks the memory upon completion of the save.
Pointer to a vector handle that references the vector image to be saved.
Output file format. For valid values, refer to Formats of Output Files.
For possible values, refer to Compression Quality Factors.
Pointer to a variable to be updated with the size of the saved file.
Pointer to optional extended save options. Reserved for future use. Pass NULL.
| Value | Meaning |
|---|---|
| SUCCESS | The function was successful. |
| < 1 | An error occurred. Refer to Return Codes. |
To use this function, do the following:
Declare a memory handle. You can then pass its address in this function, which will allocate the memory, save the vector handle, and unlock the memory.
Declare a long integer (L_UINT32) variable for the file-size. You can then pass its address in this function, which will update its value with the size of the file.
Call this function, to save the vector handle in the specified memory handle.
This function cannot be used in combination with L_RedirectIO.
For an example, refer to L_VecLoadMemory.