a/v per track data height, boxblur power fix, add french expanders
[goodguy/cinelerra.git] / cinelerra-5.1 / cinelerra / asset.h
1 /*
2  * CINELERRA
3  * Copyright (C) 2010 Adam Williams <broadcast at earthling dot net>
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation; either version 2 of the License, or
8  * (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
18  *
19  */
20
21 #ifndef ASSET_H
22 #define ASSET_H
23
24 #include <stdio.h>
25 #include <stdint.h>
26
27 #include "arraylist.h"
28 #include "bcwindowbase.inc"
29 #include "bchash.inc"
30 #include "edl.inc"
31 #include "filexml.inc"
32 #include "indexable.h"
33 #include "indexfile.inc"
34 #include "indexstate.inc"
35 #include "linklist.h"
36 #include "pluginserver.inc"
37
38
39 // Time code formats
40 #define TC_DROPFRAME 0
41 #define TC_NONDROPFRAME 1
42 #define TC_PAL 2
43 #define TC_FILM 3
44
45 class Asset : public Indexable, public ListItem<Asset>
46 {
47 public:
48         Asset();
49         Asset(Asset &asset);
50         Asset(const char *path);
51         Asset(const int plugin_type, const char *plugin_path);
52         ~Asset();
53
54         int init_values();
55         int dump(FILE *fp=stdout);
56         void boundaries();
57
58         void copy_from(Asset *asset, int do_index);
59         void copy_location(Asset *asset);
60         void copy_format(Asset *asset, int do_index = 1);
61         void copy_index(Asset *asset);
62         int64_t get_index_offset(int channel);
63         int64_t get_index_size(int channel);
64 // Get an english description of the compression.  Used by AssetEdit
65         char* get_compression_text(int audio, int video);
66
67 // Load and save parameters for a render dialog
68 // Used by render, record, menueffects, preferences
69         void load_defaults(BC_Hash *defaults,
70                 const char *prefix /* = 0 */,
71                 int do_format /* = 0 */,
72                 int do_compression,
73                 int do_path,
74                 int do_data_types,
75                 int do_bits);
76         void save_defaults(BC_Hash *defaults,
77                 const char *prefix /* = 0 */,
78                 int do_format,     /* Don't save format which is autodetected by file loader */
79                 int do_compression,    /* Don't save compression which is fixed by driver */
80                 int do_path,
81                 int do_data_types,
82                 int do_bits);
83         char* construct_param(const char *param, const char *prefix, char *return_value);
84
85
86
87
88 // Executed during index building only
89         int equivalent(Asset &asset, int test_audio, int test_video, EDL *edl=0);
90 // Return 1 if the paths match
91         int test_path(const char *path);
92         int read(FileXML *file,
93                 int expand_relative = 1);
94         int read_audio(FileXML *xml);
95         int read_video(FileXML *xml);
96         int read_format(FileXML *xml);
97         int read_index(FileXML *xml);
98         void reset_audio();
99         void reset_video();
100
101 // Output path is the path of the output file if name truncation is desired.
102 // It is a "" if; complete names should be used.
103         int write(FileXML *file, int include_index, const char *output_path);
104
105 // For Indexable
106         int get_audio_channels();
107         int get_sample_rate();
108         int64_t get_audio_samples();
109         int have_audio();
110         int have_video();
111         int get_w();
112         int get_h();
113         double get_frame_rate();
114         int get_video_layers();
115         int64_t get_video_frames();
116         int get_program();
117         void write_index(char *path, int data_bytes);
118
119 // Necessary for renderfarm to get encoding parameters
120         int write_audio(FileXML *xml);
121         int write_video(FileXML *xml);
122         int write_index(FileXML *xml);
123
124         double total_length_framealigned(double fps);
125
126 // Format of file.  An enumeration from file.inc.
127         int format;
128
129 // contains audio data
130         int audio_data;
131         int channels;
132         int sample_rate;
133         int bits;
134         int byte_order;
135         int signed_;
136         int header;
137         int dither;
138 // String or FourCC describing compression
139         char acodec[BCTEXTLEN];
140
141         int64_t audio_length;
142
143 // contains video data, single frame data set
144         int video_data, single_frame;
145         int layers, program;
146         double frame_rate;
147
148         int actual_width, actual_height;
149         int width, height;
150 // scale factor or 0 if not proxy
151         int proxy_scale;
152 // String or FourCC describing compression
153         char vcodec[BCTEXTLEN];
154
155 // Length in frames
156 // -1 means a still photo
157         int64_t video_length;
158
159
160
161 // mp3 compression
162         int mp3_bitrate;
163
164 // mpeg audio information
165         int ampeg_bitrate;
166 // 2 - 3
167         int ampeg_derivative;
168
169 // Vorbis compression
170         int vorbis_min_bitrate;
171         int vorbis_bitrate;
172         int vorbis_max_bitrate;
173         int vorbis_vbr;
174
175 // Theora compression
176         int theora_fix_bitrate;
177         int theora_bitrate;
178         int theora_quality;
179         int theora_sharpness;
180         int theora_keyframe_frequency;
181         int theora_keyframe_force_frequency;
182
183
184 // Set by package render during file creation. -1 means square pixels.
185         double aspect_ratio;
186
187 // for the interlace mode
188         int interlace_mode;
189 // for jpeg compression
190         int jpeg_quality;
191
192
193 // for mpeg video compression
194         int vmpeg_iframe_distance;
195         int vmpeg_progressive;
196         int vmpeg_denoise;
197         int vmpeg_seq_codes;
198         int vmpeg_bitrate;
199 // 1 - 2
200         int vmpeg_derivative;
201         int vmpeg_quantization;
202         int vmpeg_cmodel;
203         int vmpeg_fix_bitrate;
204
205 // mjpegtools
206         int vmpeg_preset;
207 // top field first
208         int vmpeg_field_order;
209         int vmpeg_pframe_distance;
210
211 // ffmpeg
212         char fformat[BCSTRLEN];
213         char ff_format_options[BCTEXTLEN];
214         char ff_video_options[BCTEXTLEN];
215         char ff_pixel_format[BCSTRLEN];
216         int ff_video_bitrate, ff_video_quality;
217         int ff_color_space, ff_color_range;
218         char ff_audio_options[BCTEXTLEN];
219         char ff_sample_format[BCSTRLEN];
220         int ff_audio_bitrate, ff_audio_quality;
221
222 // PNG video compression
223         int png_use_alpha;
224         int png_depth;
225         int png_compression;
226 // EXR video compression
227         int exr_use_alpha;
228         int exr_compression;
229
230 // TIFF video compression.  An enumeration from filetiff.h
231         int tiff_cmodel;
232         int tiff_compression;
233
234         int ac3_bitrate;
235
236 // Insert tag for spherical playback
237         int mov_sphere, jpeg_sphere;
238
239 // Image file sequences.  Background rendering doesn't want to write a
240 // sequence header but instead wants to start the sequence numbering at a certain
241 // number.  This ensures deletion of all the frames which aren't being used.
242 // We still want sequence headers sometimes because loading a directory full of images
243 // for editing would create new assets for every image.
244         int use_header;
245 };
246
247
248 #endif