ICSeqCompressFrame

  • Article

The ICSeqCompressFrame function compresses one frame in a sequence of frames.

LPVOID ICSeqCompressFrame(
  PCOMPVARS pc,  
  UINT uiFlags,  
  LPVOID lpBits, 
  BOOL * pfKey,  
  LONG * plSize  
);

Parameters

pc

Pointer to a COMPVARS structure initialized with information about the compression.

uiFlags

Reserved; must be zero.

lpBits

Pointer to the data bits to compress. (The data bits exclude header or format information.)

pfKey

Returns whether or not the frame was compressed into a key frame.

plSize

Maximum size desired for the compressed image. The compressor might not be able to compress the data to fit within this size. When the function returns, the parameter points to the size of the compressed image. Images sizes are specified in bytes.

Return Values

Returns the address of the compressed bits if successful or NULL otherwise.

Remarks

This function uses a COMPVARS structure to provide settings for the specified compressor and intersperses key frames at the rate specified by the ICSeqCompressorFrameStart function. You can specify values for the data rate for the sequence and the key-frame frequency by using the appropriate members of COMPVARS.

Use this function instead of the ICCompress function to compress a video sequence.

You can allow the user to specify a compressor and initialize a COMPVARS structure by using the ICCompressorChoose function. Or, you can initialize a COMPVARS structure manually.

Use the ICSeqCompressFrameStart, ICSeqCompressFrame, and ICSeqCompressFrameEnd functions to compress a sequence of frames to a specified data rate and number of key frames. Use ICSeqCompressFrame once for each frame to be compressed.

When finished with compression, use the ICCompressorFree function to release the resources specified by COMPVARS.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.
**  Library:** Use Vfw32.lib.

See Also

Video Compression Manager, Video Compression Functions, COMPVARS, ICCompress, ICCompressorChoose, ICSeqCompressFrameStart, ICSeqCompressFrameEnd, ICCompressorFree