L_VecSaveMemory

#include "ltvkrn.h"

L_LTVKRN_API L_INT L_VecSaveMemory(phHandle, pVector, nFormat, puSize, pSaveOptions)

Saves a vector image to a file in memory. The output can be in any of the supported compressed or uncompressed file formats.

Parameters

L_HANDLE * phHandle

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.

pVECTORHANDLE pVector

Pointer to a vector handle that references the vector image to be saved.

L_INT nFormat

Output file format. For valid values, refer to Formats of Output Files.

For possible values, refer to Compression Quality Factors.

L_UINT32 *puSize

Pointer to a variable to be updated with the size of the saved file.

pSAVEFILEOPTION pSaveOptions

Pointer to optional extended save options. Reserved for future use. Pass NULL.

Returns

Value Meaning
SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.

Comments

To use this function, do the following:

  1. 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.

  2. 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.

  3. Call this function, to save the vector handle in the specified memory handle.

This function cannot be used in combination with L_RedirectIO.

Required DLLs and Libraries

See Also

Functions

Example

For an example, refer to L_VecLoadMemory.

Help Version 21.0.2021.4.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Vector C API Help