fg_avimake()Win32 DirectX Fastgraph/Light Prototype int fg_avimake (char *filename, void *context, int compressor, int width, int height, int depth, int quality, int rate); Function fg_avimake (ByVal filename As String, context() As Any, ByVal compressor As Long, ByVal width As Long, ByVal height As Long, ByVal depth As Long, ByVal quality As Long, ByVal rate As Long) As Long function fg_avimake (filename : string; var context; compressor, width, height, depth, quality, rate : integer) : integer; Description The fg_avimake() function creates an empty AVI file that will be built with fg_aviframe(). Parameters filename is the name of the AVI file. A device and path name may be included as part of the file name. The file name must be terminated by a zero byte. context is the name of a 24-byte buffer that will receive the AVI file context descriptor. The descriptor values will only be meaningful if the return value is zero. compressor is the four-character code (FourCC) for the compressor that will be used to compress the video data. It can instead be zero for no compression, or -1 to display a dialog box to select compression options at run time. Here are the FourCC values for some of the more popular codecs supplied with Video for Windows:
width is the AVI image width in pixels. height is the AVI image height in pixels. depth is the suggested AVI color depth in bits per pixel. quality is the compression quality, between 0 and 10,000. A value of 10,000 indicates lossless compression; lower values result in increasing degrees of lossy compression. The quality value is not used if compressor is 0 or -1. rate is the video rate in frames per second. Return value 0 = AVI file created successfully -1 = Error creating the AVI file -2 = Error creating the AVI video stream -3 = User pressed Cancel on the compress options dialog box Restrictions none See also fg_avidone(), fg_aviframe(), fg_aviopen() Examples
|
 
copyright 2001 Ted Gruber Software, Inc.