L_VecSaveMemory

#include "lvkrn.h"

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

L_HANDLE * phHandle;

/* pointer to a memory handle */

pVECTORHANDLE pVector;

/* pointer to a vector handle */

L_INT nFormat;

/* output file format */

L_UINT32 *puSize;

/* pointer to the size of the memory handle */

pSAVEFILEOPTION pSaveOptions

/* pointer to optional extended save options */

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

Parameter

Description

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.

pVector

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

nFormat

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

 

For possible values, refer to Compression Quality Factors.

puSize

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

pSaveOptions

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

Returns

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

LVKRN
LTFIL

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

L_VecSaveFile, L_VecLoadMemory, L_VecLoadFile

Example

For an example, refer to L_VecLoadMemory.