im.im_format_avi source code

1 /** \file
2  * \brief Register the AVI Format
3  *
4  * See Copyright Notice in im_lib.h
5  */
6 module im.im_format_avi;
7 
8 version(IM) :
9 version(Windows) :
10 
11 version(DigitalMars) { pragma(lib, "im_avi.lib"); }
12 
13 extern(C) @nogc nothrow :
14 
15 /** \defgroup avi AVI - Windows Audio-Video Interleaved RIFF
16  * \section Description
17  * 
18  * \par
19  * Windows Copyright Microsoft Corporation.
20  * \par
21  * Access to the AVI format uses Windows AVIFile library. Available in Windows Only. \n
22  * When writing a new file you must use an ".avi" extension, or the Windows API will fail. \n
23  * You must link the application with "im_avi.lib" 
24  * and you must call the function \ref imFormatRegisterAVI once 
25  * to register the format into the IM core library. 
26  * In Lua call require"imlua_avi". \n
27  * Depends also on the VFW library (vfw32.lib).
28  * When using the "im_avi.dll" this extra library is not necessary. \n
29  * If using Cygwin or MingW must link with "-lvfw32". 
30  * Old versions of Cygwin and MingW use the "-lvfw_ms32" and "-lvfw_avi32".
31  * \par
32  * See \ref im_format_avi.h
33  *
34  * \section Features
35  *
36 \verbatim
37     Data Types: Byte
38     Color Spaces: RGB, MAP and Binary (Gray saved as MAP)
39     Compressions (installed in Windows XP by default):
40       NONE     - no compression [default]
41       RLE      - Microsoft RLE (8bpp only)
42       CINEPACK - Cinepak Codec by Radius
43       MSVC     - Microsoft Video 1 (old)  (8bpp and 16bpp only)
44       M261     - Microsoft H.261 Video Codec
45       M263     - Microsoft H.263 Video Codec
46       I420     - Intel 4:2:0 Video Codec (same as M263)
47       IV32     - Intel Indeo Video Codec 3.2 (old)
48       IV41     - Intel Indeo Video Codec 4.5 (old)
49       IV50     - Intel Indeo Video 5.1
50       IYUV     - Intel IYUV Codec
51       MPG4     - Microsoft MPEG-4 Video Codec V1 (not MPEG-4 compliant) (old)
52       MP42     - Microsoft MPEG-4 Video Codec V2 (not MPEG-4 compliant)
53       CUSTOM   - (show compression dialog)
54       DIVX     - DivX 5.0.4 Codec (DivX must be installed)
55       (others, must be the 4 charaters of the fourfcc code)
56     Can have more than one image. 
57     Can have an alpha channel (only for RGB)
58     Internally the components are always packed.
59     Lines arranged from top down to bottom or bottom up to top. But are saved always as bottom up.
60     Handle(0) returns NULL. imBinFile is not supported.
61     Handle(1) returns PAVIFILE.
62     Handle(2) returns PAVISTREAM.
63  
64     Attributes:
65       FPS IM_FLOAT (1) (should set when writing, default 15)
66       AVIQuality IM_INT (1) [1-10000, default -1] (write only) [unsed if compression=CUSTOM]
67       KeyFrameRate IM_INT (1) (write only) [key frame frequency, if 0 not using key frames, default 15, unsed if compression=CUSTOM]
68       DataRate IM_INT (1) (write only) [kilobits/second, default 2400, unsed if compression=CUSTOM]
69 
70     Comments:
71       Reads only the first video stream. Other streams are ignored.
72       All the images have the same size, you must call imFileReadImageInfo/imFileWriteImageInfo 
73         at least once.
74       For codecs comparsion and download go to:
75         http://graphics.lcs.mit.edu/~tbuehler/video/codecs/
76         http://www.fourcc.org
77 \endverbatim
78  * \ingroup format */
79  
80 /** Register the AVI Format. \n
81  * In Lua, when using require"imlua_avi" this function will be automatically called.
82  * \ingroup avi */
83 void imFormatRegisterAVI();