gavl
gavl.h
Go to the documentation of this file.
1/*****************************************************************
2 * gavl - a general purpose audio/video processing library
3 *
4 * Copyright (c) 2001 - 2011 Members of the Gmerlin project
5 * gmerlin-general@lists.sourceforge.net
6 * http://gmerlin.sourceforge.net
7 *
8 * This program is free software: you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation, either version 2 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program. If not, see <http://www.gnu.org/licenses/>.
20 * *****************************************************************/
21
27#ifndef GAVL_H_INCLUDED
28#define GAVL_H_INCLUDED
29
30#include <inttypes.h>
31
32#include <gavl/gavldefs.h>
33#include <gavl/gavltime.h>
34
35#ifdef __cplusplus
36extern "C" {
37#endif
38
39#include <gavl/timecode.h>
40
41
64typedef void (*gavl_video_process_func)(void * data, int start, int end);
65
80 void * gavl_data,
81 int start, int end,
82 void * client_data, int thread);
83
92typedef void (*gavl_video_stop_func)(void * client_data, int thread);
93
103
104
105/* Quality levels */
106
130#define GAVL_QUALITY_FASTEST 1
131
138#define GAVL_QUALITY_BEST 5
139
146#define GAVL_QUALITY_DEFAULT 2
147
159#define GAVL_ACCEL_MMX (1<<0)
160#define GAVL_ACCEL_MMXEXT (1<<1)
161#define GAVL_ACCEL_SSE (1<<2)
162#define GAVL_ACCEL_SSE2 (1<<3)
163#define GAVL_ACCEL_SSE3 (1<<4)
164#define GAVL_ACCEL_3DNOW (1<<5)
165#define GAVL_ACCEL_3DNOWEXT (1<<6)
166#define GAVL_ACCEL_SSSE3 (1<<7)
167
172GAVL_PUBLIC int gavl_accel_supported();
173
182/* Sample formats: all multibyte numbers are native endian */
183
196#define GAVL_MAX_CHANNELS 128
197
204typedef enum
205 {
215
221typedef enum
222 {
227
235typedef enum
236 {
251
260typedef struct
261 {
274
275
276/* Audio format -> string conversions */
277
285GAVL_PUBLIC
287
296GAVL_PUBLIC
298
304GAVL_PUBLIC
306
313GAVL_PUBLIC
315
322GAVL_PUBLIC
324
325
332GAVL_PUBLIC
334
341GAVL_PUBLIC
343
352GAVL_PUBLIC
354
361GAVL_PUBLIC
363
370GAVL_PUBLIC
372
379GAVL_PUBLIC
381
388GAVL_PUBLIC
390
391
392
399GAVL_PUBLIC
401
409GAVL_PUBLIC
411 const gavl_audio_format_t * src);
412
421GAVL_PUBLIC
423 const gavl_audio_format_t * format_2);
424
436GAVL_PUBLIC
438
445GAVL_PUBLIC
447
462typedef union
463 {
464 uint8_t * u_8;
465 int8_t * s_8;
467 uint16_t * u_16;
468 int16_t * s_16;
470 uint32_t * u_32;
471 int32_t * s_32;
473 float * f;
474 double * d;
476
482typedef union
483 {
484 uint8_t * u_8[GAVL_MAX_CHANNELS];
485 int8_t * s_8[GAVL_MAX_CHANNELS];
487 uint16_t * u_16[GAVL_MAX_CHANNELS];
488 int16_t * s_16[GAVL_MAX_CHANNELS];
490 uint32_t * u_32[GAVL_MAX_CHANNELS];
491 int32_t * s_32[GAVL_MAX_CHANNELS];
494 double * d[GAVL_MAX_CHANNELS];
497
514typedef struct
515 {
519 int64_t timestamp;
522
534GAVL_PUBLIC
536
548GAVL_PUBLIC
550
560GAVL_PUBLIC
562
572GAVL_PUBLIC
574 const gavl_audio_format_t * format);
575
586GAVL_PUBLIC
588 const gavl_audio_format_t * format,
589 int num_samples);
590
591
592
603GAVL_PUBLIC
605 const gavl_audio_format_t * format,
606 int channel);
607
628GAVL_PUBLIC
630 gavl_audio_frame_t * dst,
631 const gavl_audio_frame_t * src,
632 int dst_pos,
633 int src_pos,
634 int dst_size,
635 int src_size);
636
649GAVL_PUBLIC
651 gavl_audio_frame_t * dst,
652 const gavl_audio_frame_t * src);
653
671GAVL_PUBLIC
673 gavl_audio_frame_t * src,
674 gavl_audio_frame_t * dst,
675 int start, int len);
676
689GAVL_PUBLIC
691 const gavl_audio_frame_t * f1,
692 const gavl_audio_frame_t * f2);
693
713GAVL_PUBLIC
715 const gavl_audio_frame_t * frame,
716 const char * name_base);
717
718
733#define GAVL_AUDIO_FRONT_TO_REAR_COPY (1<<0)
738#define GAVL_AUDIO_FRONT_TO_REAR_MUTE (1<<1)
743#define GAVL_AUDIO_FRONT_TO_REAR_DIFF (1<<2)
748#define GAVL_AUDIO_FRONT_TO_REAR_MASK \
749(GAVL_AUDIO_FRONT_TO_REAR_COPY | \
750GAVL_AUDIO_FRONT_TO_REAR_MUTE | \
751 GAVL_AUDIO_FRONT_TO_REAR_DIFF)
753/* Options for mixing stereo to mono */
754
757#define GAVL_AUDIO_STEREO_TO_MONO_LEFT (1<<3)
760#define GAVL_AUDIO_STEREO_TO_MONO_RIGHT (1<<4)
763#define GAVL_AUDIO_STEREO_TO_MONO_MIX (1<<5)
767#define GAVL_AUDIO_STEREO_TO_MONO_MASK \
768(GAVL_AUDIO_STEREO_TO_MONO_LEFT | \
769GAVL_AUDIO_STEREO_TO_MONO_RIGHT | \
770GAVL_AUDIO_STEREO_TO_MONO_MIX)
775#define GAVL_AUDIO_NORMALIZE_MIX_MATRIX (1<<6)
782typedef enum
783 {
784 GAVL_AUDIO_DITHER_NONE = 0,
785 GAVL_AUDIO_DITHER_AUTO = 1,
786 GAVL_AUDIO_DITHER_RECT = 2,
787 GAVL_AUDIO_DITHER_TRI = 3,
788 GAVL_AUDIO_DITHER_SHAPED = 4,
790
795typedef enum
796 {
804
811typedef struct gavl_audio_options_s gavl_audio_options_t;
812
819GAVL_PUBLIC
821
828GAVL_PUBLIC
830
837GAVL_PUBLIC
839
846GAVL_PUBLIC
848
849
856GAVL_PUBLIC
858
865GAVL_PUBLIC
867
874GAVL_PUBLIC
876 int flags);
877
884GAVL_PUBLIC
886
892GAVL_PUBLIC
894
911GAVL_PUBLIC
913 const double ** matrix);
914
923GAVL_PUBLIC
925
935GAVL_PUBLIC
937
944GAVL_PUBLIC
946 const gavl_audio_options_t * src);
947
953GAVL_PUBLIC
955
956
957
958/* Audio converter */
959
993typedef struct gavl_audio_converter_s gavl_audio_converter_t;
994
1000GAVL_PUBLIC
1002
1008GAVL_PUBLIC
1010
1019GAVL_PUBLIC
1021
1022
1037GAVL_PUBLIC
1039 const gavl_audio_format_t * input_format,
1040 const gavl_audio_format_t * output_format);
1041
1056GAVL_PUBLIC
1058 const gavl_audio_format_t * format);
1059
1074GAVL_PUBLIC
1076
1077
1091GAVL_PUBLIC
1093 const gavl_audio_frame_t * input_frame,
1094 gavl_audio_frame_t * output_frame);
1095
1096
1115GAVL_PUBLIC
1117 double ratio ) ;
1118
1119
1135GAVL_PUBLIC
1137 gavl_audio_frame_t * input_frame,
1138 gavl_audio_frame_t * output_frame,
1139 double ratio);
1140
1141
1155typedef struct gavl_volume_control_s gavl_volume_control_t;
1156
1157/* Create / destroy */
1158
1164GAVL_PUBLIC
1166
1172GAVL_PUBLIC
1174
1182GAVL_PUBLIC
1184 const gavl_audio_format_t * format);
1185
1192GAVL_PUBLIC
1194 float volume);
1195
1202GAVL_PUBLIC
1204 gavl_audio_frame_t * frame);
1205
1221typedef struct gavl_peak_detector_s gavl_peak_detector_t;
1222
1223/* Create / destroy */
1224
1230GAVL_PUBLIC
1232
1238GAVL_PUBLIC
1240
1250GAVL_PUBLIC
1252 const gavl_audio_format_t * format);
1253
1260GAVL_PUBLIC
1262 gavl_audio_frame_t * frame);
1263
1276GAVL_PUBLIC
1278 double * min, double * max,
1279 double * abs);
1280
1293GAVL_PUBLIC
1295 double * min, double * max,
1296 double * abs);
1297
1303GAVL_PUBLIC
1305
1315#define GAVL_MAX_PLANES 4
1327typedef struct
1328 {
1329 int x;
1330 int y;
1331 int w;
1332 int h;
1334
1339typedef struct
1340 {
1341 double x;
1342 double y;
1343 double w;
1344 double h;
1346
1353GAVL_PUBLIC
1355 const gavl_video_format_t * format);
1356
1363GAVL_PUBLIC
1365 const gavl_video_format_t * format);
1366
1381GAVL_PUBLIC
1383 gavl_rectangle_i_t * dst_rect,
1384 const gavl_video_format_t * src_format,
1385 const gavl_video_format_t * dst_format);
1386
1398GAVL_PUBLIC
1400 gavl_rectangle_i_t * dst_rect,
1401 const gavl_video_format_t * src_format,
1402 const gavl_video_format_t * dst_format);
1403
1404
1405
1412GAVL_PUBLIC
1414
1421GAVL_PUBLIC
1423
1430GAVL_PUBLIC
1432
1439GAVL_PUBLIC
1441
1448GAVL_PUBLIC
1450
1457GAVL_PUBLIC
1459
1466GAVL_PUBLIC
1468
1475GAVL_PUBLIC
1477
1484GAVL_PUBLIC
1486
1493GAVL_PUBLIC
1495
1509GAVL_PUBLIC
1510void gavl_rectangle_i_align(gavl_rectangle_i_t * r, int h_align, int v_align);
1511
1521GAVL_PUBLIC
1523 const gavl_video_format_t * format);
1524
1525
1532GAVL_PUBLIC
1534
1541GAVL_PUBLIC
1543
1544
1545
1552GAVL_PUBLIC
1554
1561GAVL_PUBLIC
1563
1572GAVL_PUBLIC
1574
1583GAVL_PUBLIC
1585
1613GAVL_PUBLIC
1615 const gavl_video_format_t * src_format,
1616 const gavl_rectangle_f_t * src_rect,
1617 const gavl_video_format_t * dst_format,
1618 float zoom, float squeeze);
1619
1624GAVL_PUBLIC
1626
1631GAVL_PUBLIC
1633
1634
1644#define GAVL_PIXFMT_PLANAR (1<<8)
1645
1649#define GAVL_PIXFMT_RGB (1<<9)
1650
1654#define GAVL_PIXFMT_YUV (1<<10)
1655
1659#define GAVL_PIXFMT_YUVJ (1<<11)
1660
1664#define GAVL_PIXFMT_ALPHA (1<<12)
1665
1669#define GAVL_PIXFMT_GRAY (1<<13)
1670
1675typedef enum
1676 {
1680
1684
1688
1692
1696
1700
1704
1736
1743
1750
1766
1770
1787
1797
1804
1806
1809#define GAVL_PIXELFORMAT_1D_8 GAVL_GRAY_8
1812#define GAVL_PIXELFORMAT_2D_8 GAVL_GRAYA_16
1815#define GAVL_PIXELFORMAT_3D_8 GAVL_RGB_24
1818#define GAVL_PIXELFORMAT_4D_8 GAVL_RGBA_32
1819
1822#define GAVL_PIXELFORMAT_1D_16 GAVL_GRAY_16
1825#define GAVL_PIXELFORMAT_2D_16 GAVL_GRAYA_32
1828#define GAVL_PIXELFORMAT_3D_16 GAVL_RGB_48
1831#define GAVL_PIXELFORMAT_4D_16 GAVL_RGBA_64
1832
1835#define GAVL_PIXELFORMAT_1D_FLOAT GAVL_GRAY_FLOAT
1838#define GAVL_PIXELFORMAT_2D_FLOAT GAVL_GRAYA_FLOAT
1841#define GAVL_PIXELFORMAT_3D_FLOAT GAVL_RGB_FLOAT
1844#define GAVL_PIXELFORMAT_4D_FLOAT GAVL_RGBA_FLOAT
1845
1852typedef enum
1853 {
1862
1863/*
1864 * Colormodel related functions
1865 */
1866
1873#define gavl_pixelformat_is_gray(fmt) ((fmt) & GAVL_PIXFMT_GRAY)
1874
1875
1882#define gavl_pixelformat_is_rgb(fmt) ((fmt) & GAVL_PIXFMT_RGB)
1883
1890#define gavl_pixelformat_is_yuv(fmt) ((fmt) & GAVL_PIXFMT_YUV)
1891
1898#define gavl_pixelformat_is_jpeg_scaled(fmt) ((fmt) & GAVL_PIXFMT_YUVJ)
1899
1906#define gavl_pixelformat_has_alpha(fmt) ((fmt) & GAVL_PIXFMT_ALPHA)
1907
1914#define gavl_pixelformat_is_planar(fmt) ((fmt) & GAVL_PIXFMT_PLANAR)
1915
1922GAVL_PUBLIC
1924
1934GAVL_PUBLIC
1935void gavl_pixelformat_chroma_sub(gavl_pixelformat_t pixelformat, int * sub_h, int * sub_v);
1936
1943GAVL_PUBLIC
1945
1952GAVL_PUBLIC
1954
1961GAVL_PUBLIC
1963
1978GAVL_PUBLIC
1980 gavl_pixelformat_t dst);
1981
1995GAVL_PUBLIC gavl_pixelformat_t
1997 const gavl_pixelformat_t * dst_supported,
1998 int * penalty);
1999
2000
2001
2008GAVL_PUBLIC
2010
2017GAVL_PUBLIC
2019
2025GAVL_PUBLIC
2027
2034GAVL_PUBLIC
2036
2037/* */
2038
2047typedef enum
2048 {
2053
2060GAVL_PUBLIC
2062
2067/* Changing the values alters the gmerlin-avdecoder index format */
2068
2069typedef enum
2070 {
2076
2083GAVL_PUBLIC
2085
2090/* Changing the values alters the gmerlin-avdecoder index format */
2091
2092typedef enum
2093 {
2102
2109GAVL_PUBLIC
2111
2112
2113/* Video format structure */
2114
2120 {
2127 /* Support for nonsquare pixels */
2128
2144 };
2145
2153GAVL_PUBLIC
2155 const gavl_video_format_t * src);
2156
2165GAVL_PUBLIC
2167 const gavl_video_format_t * format_2);
2168
2169
2180GAVL_PUBLIC
2181void gavl_video_format_get_chroma_offset(const gavl_video_format_t * format, int field, int plane,
2182 float * off_x, float * off_y);
2183
2184
2185
2198GAVL_PUBLIC
2200 const gavl_video_format_t * src);
2201
2209GAVL_PUBLIC
2211
2227GAVL_PUBLIC
2229 gavl_video_format_t * channel_format,
2231
2232
2246GAVL_PUBLIC
2248 gavl_video_format_t * field_format,
2249 int field);
2250
2251
2258GAVL_PUBLIC
2260
2261
2284typedef struct
2285 {
2286 uint8_t * planes[GAVL_MAX_PLANES];
2287 int strides[GAVL_MAX_PLANES];
2289 void * user_data;
2290 int64_t timestamp;
2291 int64_t duration;
2295
2296
2308GAVL_PUBLIC
2310
2321GAVL_PUBLIC
2323
2324
2325
2335GAVL_PUBLIC
2337
2349GAVL_PUBLIC
2351
2360GAVL_PUBLIC
2362 const gavl_video_format_t * format);
2363
2373GAVL_PUBLIC
2375 const gavl_video_format_t * format,
2376 const float * color);
2377
2390GAVL_PUBLIC
2392 const gavl_video_frame_t * src1,
2393 const gavl_video_frame_t * src2,
2394 const gavl_video_format_t * format);
2395
2408GAVL_PUBLIC
2409void gavl_video_frame_psnr(double * psnr,
2410 const gavl_video_frame_t * src1,
2411 const gavl_video_frame_t * src2,
2412 const gavl_video_format_t * format);
2413
2440GAVL_PUBLIC
2442 const gavl_video_frame_t * src2,
2443 gavl_video_frame_t * dst,
2444 const gavl_video_format_t * format);
2445
2459GAVL_PUBLIC
2461 gavl_video_frame_t * dst,
2462 const gavl_video_frame_t * src);
2463
2476GAVL_PUBLIC
2478 gavl_video_frame_t * dst,
2479 const gavl_video_frame_t * src, int plane);
2480
2492GAVL_PUBLIC
2494 gavl_video_frame_t * dst,
2495 const gavl_video_frame_t * src);
2496
2508GAVL_PUBLIC
2510 gavl_video_frame_t * dst,
2511 const gavl_video_frame_t * src);
2512
2524GAVL_PUBLIC
2526 gavl_video_frame_t * dst,
2527 const gavl_video_frame_t * src);
2528
2541GAVL_PUBLIC
2543 const gavl_video_frame_t * src);
2544
2545
2563GAVL_PUBLIC
2565 const gavl_video_frame_t * src,
2566 gavl_video_frame_t * dst,
2567 gavl_rectangle_i_t * src_rect);
2568
2584GAVL_PUBLIC
2586 const gavl_video_frame_t * src,
2587 gavl_video_frame_t * dst,
2588 int field);
2589
2590
2591
2604GAVL_PUBLIC
2606 const gavl_video_format_t * format,
2607 const char * namebase);
2608
2619GAVL_PUBLIC
2621 const gavl_video_format_t * format);
2622
2635GAVL_PUBLIC
2637 const gavl_video_format_t * format,
2638 uint8_t * buffer);
2639
2654GAVL_PUBLIC
2657 const gavl_video_frame_t * src,
2658 gavl_video_frame_t * dst);
2659
2675GAVL_PUBLIC
2678 const gavl_video_frame_t * src,
2679 gavl_video_frame_t * dst);
2680
2681
2693GAVL_PUBLIC
2695 const gavl_video_frame_t * f1,
2696 const gavl_video_frame_t * f2);
2697
2698
2699/*****************************
2700 Conversion options
2701******************************/
2702
2718#define GAVL_FORCE_DEINTERLACE (1<<0)
2719
2724#define GAVL_CONVOLVE_CHROMA (1<<1)
2725
2730#define GAVL_CONVOLVE_NORMALIZE (1<<2)
2731
2739#define GAVL_RESAMPLE_CHROMA (1<<3)
2740
2748typedef enum
2749 {
2753
2760typedef enum
2761 {
2767
2774typedef enum
2775 {
2779
2784typedef enum
2785 {
2796
2806typedef enum
2807 {
2813
2820typedef struct gavl_video_options_s gavl_video_options_t;
2821
2822/* Default Options */
2823
2829GAVL_PUBLIC
2831
2841GAVL_PUBLIC
2843
2850GAVL_PUBLIC
2852 const gavl_video_options_t * src);
2853
2859GAVL_PUBLIC
2861
2862
2877GAVL_PUBLIC
2879 const gavl_rectangle_f_t * src_rect,
2880 const gavl_rectangle_i_t * dst_rect);
2881
2889GAVL_PUBLIC
2891 gavl_rectangle_f_t * src_rect,
2892 gavl_rectangle_i_t * dst_rect);
2893
2900GAVL_PUBLIC
2902
2909GAVL_PUBLIC
2911
2912
2919GAVL_PUBLIC
2921 int conversion_flags);
2922
2929GAVL_PUBLIC
2931
2938GAVL_PUBLIC
2940 gavl_alpha_mode_t alpha_mode);
2941
2948GAVL_PUBLIC gavl_alpha_mode_t
2950
2951
2958GAVL_PUBLIC
2960 gavl_scale_mode_t scale_mode);
2961
2968GAVL_PUBLIC gavl_scale_mode_t
2970
2971
2978GAVL_PUBLIC
2980 int order);
2981
2988GAVL_PUBLIC
2990
2991
2998GAVL_PUBLIC
3000 const float * color);
3001
3008GAVL_PUBLIC
3010 float * color);
3011
3018GAVL_PUBLIC
3020 gavl_deinterlace_mode_t deinterlace_mode);
3021
3028GAVL_PUBLIC gavl_deinterlace_mode_t
3030
3037GAVL_PUBLIC
3039 gavl_deinterlace_drop_mode_t deinterlace_drop_mode);
3040
3049
3058GAVL_PUBLIC
3061
3062
3071GAVL_PUBLIC gavl_downscale_filter_t
3073
3091GAVL_PUBLIC
3093 float f);
3094
3103GAVL_PUBLIC
3105
3114GAVL_PUBLIC
3116
3117
3126GAVL_PUBLIC
3128
3138GAVL_PUBLIC
3141 void * client_data);
3142
3152GAVL_PUBLIC
3154 void ** client_data);
3155
3165GAVL_PUBLIC
3168 void * client_data);
3169
3179GAVL_PUBLIC
3181 void ** client_data);
3182
3183
3184/***************************************************
3185 * Create and destroy video converters
3186 ***************************************************/
3187
3220typedef struct gavl_video_converter_s gavl_video_converter_t;
3221
3227GAVL_PUBLIC
3229
3235GAVL_PUBLIC
3237
3238/**************************************************
3239 * Get options. Change the options with the gavl_video_options_set_*
3240 * functions above
3241 **************************************************/
3242
3251GAVL_PUBLIC gavl_video_options_t *
3253
3254
3268GAVL_PUBLIC
3270 const gavl_video_format_t * input_format,
3271 const gavl_video_format_t * output_format);
3272
3285GAVL_PUBLIC
3287
3288
3289/***************************************************
3290 * Convert a frame
3291 ***************************************************/
3292
3300GAVL_PUBLIC
3302 const gavl_video_frame_t * input_frame,
3303 gavl_video_frame_t * output_frame);
3304
3336typedef struct gavl_video_scaler_s gavl_video_scaler_t;
3337
3343GAVL_PUBLIC
3345
3351GAVL_PUBLIC
3353
3362GAVL_PUBLIC gavl_video_options_t *
3364
3377GAVL_PUBLIC
3379 const gavl_video_format_t * src_format,
3380 const gavl_video_format_t * dst_format);
3381
3403GAVL_PUBLIC
3405 const gavl_video_format_t * format,
3406 int h_radius, const float * h_coeffs,
3407 int v_radius, const float * v_coeffs);
3408
3416GAVL_PUBLIC
3418 const gavl_video_frame_t * input_frame,
3419 gavl_video_frame_t * output_frame);
3420
3436typedef struct gavl_video_deinterlacer_s gavl_video_deinterlacer_t;
3437
3443GAVL_PUBLIC
3445
3451GAVL_PUBLIC
3453
3462GAVL_PUBLIC gavl_video_options_t *
3464
3475GAVL_PUBLIC
3477 const gavl_video_format_t * src_format);
3478
3479
3487GAVL_PUBLIC
3489 const gavl_video_frame_t * input_frame,
3490 gavl_video_frame_t * output_frame);
3491
3492
3493
3494/**************************************************
3495 * Transparent overlays
3496 **************************************************/
3497
3498/* Overlay struct */
3499
3527typedef struct
3528 {
3531 int dst_x;
3532 int dst_y;
3534
3541typedef struct gavl_overlay_blend_context_s gavl_overlay_blend_context_t;
3542
3548GAVL_PUBLIC
3550
3556GAVL_PUBLIC
3558
3565GAVL_PUBLIC gavl_video_options_t *
3567
3583GAVL_PUBLIC
3585 const gavl_video_format_t * frame_format,
3586 gavl_video_format_t * overlay_format);
3587
3597GAVL_PUBLIC
3599 gavl_overlay_t * ovl);
3600
3607GAVL_PUBLIC
3609 gavl_video_frame_t * dst_frame);
3610
3632typedef struct gavl_image_transform_s gavl_image_transform_t;
3633
3647typedef void (*gavl_image_transform_func)(void * priv,
3648 double xdst,
3649 double ydst,
3650 double * xsrc,
3651 double * ysrc);
3652
3653
3660GAVL_PUBLIC
3662
3668GAVL_PUBLIC
3670
3689GAVL_PUBLIC
3691 gavl_video_format_t * format,
3692 gavl_image_transform_func func, void * priv);
3693
3701GAVL_PUBLIC
3703 gavl_video_frame_t * in_frame,
3704 gavl_video_frame_t * out_frame);
3705
3716GAVL_PUBLIC gavl_video_options_t *
3718
3741typedef struct
3742 {
3743 int64_t offset;
3744 /* Primary */
3745 int64_t num_entries;
3747
3748 struct
3749 {
3750 int64_t num_frames;
3751 int64_t duration;
3752 } * entries;
3753
3756
3757 struct
3758 {
3759 int64_t pts;
3761 } * timecodes;
3762
3763 /* Secondary */
3764
3766
3773
3784GAVL_PUBLIC gavl_frame_table_t *
3785gavl_frame_table_create_audio(int samplerate, int64_t offset, int64_t duration,
3786 gavl_timecode_format_t * fmt_ret);
3787
3798GAVL_PUBLIC gavl_frame_table_t *
3799gavl_frame_table_create_cfr(int64_t offset, int64_t frame_duration,
3800 int64_t num_frames,
3801 gavl_timecode_t start_timecode);
3802
3810GAVL_PUBLIC gavl_frame_table_t *
3812
3813
3814
3822
3830GAVL_PUBLIC void gavl_frame_table_append_entry(gavl_frame_table_t * t, int64_t duration);
3831
3840GAVL_PUBLIC void
3842 int64_t pts, gavl_timecode_t tc);
3843
3854GAVL_PUBLIC int64_t
3856 int64_t frame, int * duration);
3857
3868GAVL_PUBLIC int64_t
3870 int64_t time,
3871 int64_t * start_time);
3872
3883GAVL_PUBLIC gavl_timecode_t
3885 int64_t time,
3886 int64_t * start_time,
3887 const gavl_timecode_format_t * fmt);
3888
3898GAVL_PUBLIC int64_t
3900 gavl_timecode_t tc,
3901 const gavl_timecode_format_t * fmt);
3902
3903
3914GAVL_PUBLIC gavl_timecode_t
3916 int64_t frame,
3917 int64_t * start_time,
3918 const gavl_timecode_format_t * fmt);
3919
3920
3921
3929GAVL_PUBLIC int64_t
3931
3939GAVL_PUBLIC int64_t
3941
3949GAVL_PUBLIC int64_t
3951
3960GAVL_PUBLIC
3962 const char * filename);
3963
3971GAVL_PUBLIC
3973
3980GAVL_PUBLIC void
3982
3983
3984
3985
3986
3987
3993#ifdef __cplusplus
3994}
3995#endif
3996
3997#endif /* GAVL_H_INCLUDED */
GAVL_PUBLIC void gavl_video_options_set_deinterlace_mode(gavl_video_options_t *opt, gavl_deinterlace_mode_t deinterlace_mode)
Set the deinterlace mode.
GAVL_PUBLIC gavl_deinterlace_mode_t gavl_video_options_get_deinterlace_mode(gavl_video_options_t *opt)
Get the deinterlace mode.
GAVL_PUBLIC int gavl_accel_supported()
Get the supported acceleration flags.
GAVL_PUBLIC gavl_audio_options_t * gavl_audio_converter_get_options(gavl_audio_converter_t *cnv)
gets options of an audio converter
GAVL_PUBLIC void gavl_audio_converter_resample(gavl_audio_converter_t *cnv, gavl_audio_frame_t *input_frame, gavl_audio_frame_t *output_frame, double ratio)
Convert audio.
GAVL_PUBLIC void gavl_audio_converter_destroy(gavl_audio_converter_t *cnv)
Destroys an audio converter and frees all associated memory.
GAVL_PUBLIC gavl_audio_converter_t * gavl_audio_converter_create()
Creates an audio converter.
struct gavl_audio_converter_s gavl_audio_converter_t
Opaque audio converter structure.
Definition: gavl.h:993
GAVL_PUBLIC void gavl_audio_convert(gavl_audio_converter_t *cnv, const gavl_audio_frame_t *input_frame, gavl_audio_frame_t *output_frame)
Convert audio.
GAVL_PUBLIC int gavl_audio_converter_init(gavl_audio_converter_t *cnv, const gavl_audio_format_t *input_format, const gavl_audio_format_t *output_format)
Initialize an audio converter.
GAVL_PUBLIC int gavl_audio_converter_init_resample(gavl_audio_converter_t *cnv, const gavl_audio_format_t *format)
Initialize an audio converter just for resampling.
GAVL_PUBLIC int gavl_audio_converter_set_resample_ratio(gavl_audio_converter_t *cnv, double ratio)
Set samplerate converstion ratio.
GAVL_PUBLIC int gavl_audio_converter_reinit(gavl_audio_converter_t *cnv)
Reinitialize an audio converter.
gavl_channel_id_t
Audio channel setup.
Definition: gavl.h:236
gavl_sample_format_t
Format of one audio sample.
Definition: gavl.h:205
GAVL_PUBLIC void gavl_audio_format_copy(gavl_audio_format_t *dst, const gavl_audio_format_t *src)
Copy one audio format to another.
GAVL_PUBLIC int gavl_channel_index(const gavl_audio_format_t *format, gavl_channel_id_t id)
Get the index of a particular channel for a given format.
GAVL_PUBLIC int gavl_side_channels(const gavl_audio_format_t *format)
Get number of side channels for a given format.
GAVL_PUBLIC void gavl_set_channel_setup(gavl_audio_format_t *format)
Set the default channel setup and indices.
GAVL_PUBLIC int gavl_lfe_channels(const gavl_audio_format_t *format)
Get number of LFE channels for a given format.
GAVL_PUBLIC gavl_sample_format_t gavl_get_sample_format(int index)
Get the sample format from index.
GAVL_PUBLIC const char * gavl_channel_id_to_string(gavl_channel_id_t id)
Convert a gavl_channel_id_t to a human readable string.
GAVL_PUBLIC const char * gavl_sample_format_to_string(gavl_sample_format_t format)
Convert a gavl_sample_format_t to a human readable string.
GAVL_PUBLIC int gavl_num_sample_formats()
Get total number of supported sample formats.
gavl_interleave_mode_t
Definition: gavl.h:222
GAVL_PUBLIC gavl_sample_format_t gavl_string_to_sample_format(const char *str)
Convert a string to a sample format.
GAVL_PUBLIC int gavl_front_channels(const gavl_audio_format_t *format)
Get number of front channels for a given format.
GAVL_PUBLIC int gavl_bytes_per_sample(gavl_sample_format_t format)
Get the number of bytes per sample for a given sample format.
GAVL_PUBLIC void gavl_audio_format_dump(const gavl_audio_format_t *format)
Dump an audio format to stderr.
GAVL_PUBLIC int gavl_aux_channels(const gavl_audio_format_t *format)
Get number of aux channels for a given format.
GAVL_PUBLIC int gavl_rear_channels(const gavl_audio_format_t *format)
Get number of rear channels for a given format.
GAVL_PUBLIC const char * gavl_interleave_mode_to_string(gavl_interleave_mode_t mode)
Convert a gavl_interleave_mode_t to a human readable string.
GAVL_PUBLIC int gavl_audio_formats_equal(const gavl_audio_format_t *format_1, const gavl_audio_format_t *format_2)
Compare 2 audio formats.
#define GAVL_MAX_CHANNELS
Maximum number of audio channels.
Definition: gavl.h:196
@ GAVL_CHID_SIDE_RIGHT
Definition: gavl.h:247
@ GAVL_CHID_FRONT_RIGHT
Definition: gavl.h:240
@ GAVL_CHID_FRONT_LEFT
Definition: gavl.h:239
@ GAVL_CHID_REAR_LEFT
Definition: gavl.h:243
@ GAVL_CHID_SIDE_LEFT
Definition: gavl.h:246
@ GAVL_CHID_NONE
Definition: gavl.h:237
@ GAVL_CHID_FRONT_CENTER_LEFT
Definition: gavl.h:241
@ GAVL_CHID_REAR_CENTER
Definition: gavl.h:245
@ GAVL_CHID_LFE
Definition: gavl.h:248
@ GAVL_CHID_REAR_RIGHT
Definition: gavl.h:244
@ GAVL_CHID_AUX
Definition: gavl.h:249
@ GAVL_CHID_FRONT_CENTER_RIGHT
Definition: gavl.h:242
@ GAVL_CHID_FRONT_CENTER
Definition: gavl.h:238
@ GAVL_SAMPLE_FLOAT
Definition: gavl.h:212
@ GAVL_SAMPLE_NONE
Definition: gavl.h:206
@ GAVL_SAMPLE_U8
Definition: gavl.h:207
@ GAVL_SAMPLE_S8
Definition: gavl.h:208
@ GAVL_SAMPLE_U16
Definition: gavl.h:209
@ GAVL_SAMPLE_S16
Definition: gavl.h:210
@ GAVL_SAMPLE_DOUBLE
Definition: gavl.h:213
@ GAVL_SAMPLE_S32
Definition: gavl.h:211
@ GAVL_INTERLEAVE_2
Definition: gavl.h:224
@ GAVL_INTERLEAVE_ALL
Definition: gavl.h:225
@ GAVL_INTERLEAVE_NONE
Definition: gavl.h:223
GAVL_PUBLIC void gavl_audio_frame_destroy(gavl_audio_frame_t *frame)
Destroy an audio frame.
GAVL_PUBLIC void gavl_audio_frame_mute(gavl_audio_frame_t *frame, const gavl_audio_format_t *format)
Mute an audio frame.
GAVL_PUBLIC void gavl_audio_frame_null(gavl_audio_frame_t *frame)
Zero all pointers in the audio frame.
GAVL_PUBLIC void gavl_audio_frame_mute_samples(gavl_audio_frame_t *frame, const gavl_audio_format_t *format, int num_samples)
Mute a number of samples at the start of an audio frame.
GAVL_PUBLIC int gavl_audio_frame_copy(const gavl_audio_format_t *format, gavl_audio_frame_t *dst, const gavl_audio_frame_t *src, int dst_pos, int src_pos, int dst_size, int src_size)
Copy audio data from one frame to another.
GAVL_PUBLIC gavl_audio_frame_t * gavl_audio_frame_create(const gavl_audio_format_t *format)
Create audio frame.
GAVL_PUBLIC void gavl_audio_frame_get_subframe(const gavl_audio_format_t *format, gavl_audio_frame_t *src, gavl_audio_frame_t *dst, int start, int len)
Set an audio frame to a subframe of another frame.
GAVL_PUBLIC void gavl_audio_frame_mute_channel(gavl_audio_frame_t *frame, const gavl_audio_format_t *format, int channel)
Mute a single channel of an audio frame.
GAVL_PUBLIC int gavl_audio_frame_plot(const gavl_audio_format_t *format, const gavl_audio_frame_t *frame, const char *name_base)
Plot an audio frame to an ASCII file.
GAVL_PUBLIC int gavl_audio_frames_equal(const gavl_audio_format_t *format, const gavl_audio_frame_t *f1, const gavl_audio_frame_t *f2)
Check if 2 audio frames are bit-identical.
GAVL_PUBLIC void gavl_audio_frame_copy_ptrs(const gavl_audio_format_t *format, gavl_audio_frame_t *dst, const gavl_audio_frame_t *src)
Copy audio data from one frame to another.
struct gavl_audio_options_s gavl_audio_options_t
Opaque container for audio conversion options.
Definition: gavl.h:811
GAVL_PUBLIC void gavl_audio_options_set_resample_mode(gavl_audio_options_t *opt, gavl_resample_mode_t mode)
Set the resample mode for the converter.
GAVL_PUBLIC const double ** gavl_audio_options_get_mix_matrix(gavl_audio_options_t *opt)
Get the mix matrix.
GAVL_PUBLIC int gavl_audio_options_get_quality(gavl_audio_options_t *opt)
Get the quality level for a converter.
GAVL_PUBLIC void gavl_audio_options_copy(gavl_audio_options_t *dst, const gavl_audio_options_t *src)
Copy audio options.
GAVL_PUBLIC gavl_audio_dither_mode_t gavl_audio_options_get_dither_mode(gavl_audio_options_t *opt)
Get the dither mode for the converter.
GAVL_PUBLIC gavl_audio_options_t * gavl_audio_options_create()
Create an options container.
gavl_audio_dither_mode_t
Dither mode.
Definition: gavl.h:783
GAVL_PUBLIC void gavl_audio_options_set_conversion_flags(gavl_audio_options_t *opt, int flags)
Set the conversion flags.
GAVL_PUBLIC void gavl_audio_options_set_defaults(gavl_audio_options_t *opt)
Set all options to their defaults.
GAVL_PUBLIC gavl_resample_mode_t gavl_audio_options_get_resample_mode(gavl_audio_options_t *opt)
Get the resample mode for the converter.
GAVL_PUBLIC void gavl_audio_options_set_mix_matrix(gavl_audio_options_t *opt, const double **matrix)
Set a user defined mix matrix.
GAVL_PUBLIC void gavl_audio_options_set_dither_mode(gavl_audio_options_t *opt, gavl_audio_dither_mode_t mode)
Set the dither mode for the converter.
gavl_resample_mode_t
Resample mode.
Definition: gavl.h:796
GAVL_PUBLIC int gavl_audio_options_get_conversion_flags(gavl_audio_options_t *opt)
Get the conversion flags.
GAVL_PUBLIC void gavl_audio_options_destroy(gavl_audio_options_t *opt)
Destroy audio options.
GAVL_PUBLIC void gavl_audio_options_set_quality(gavl_audio_options_t *opt, int quality)
Set the quality level for the converter.
@ GAVL_RESAMPLE_SINC_BEST
Definition: gavl.h:802
@ GAVL_RESAMPLE_ZOH
Definition: gavl.h:798
@ GAVL_RESAMPLE_LINEAR
Definition: gavl.h:799
@ GAVL_RESAMPLE_AUTO
Definition: gavl.h:797
@ GAVL_RESAMPLE_SINC_MEDIUM
Definition: gavl.h:801
@ GAVL_RESAMPLE_SINC_FAST
Definition: gavl.h:800
GAVL_PUBLIC int gavl_frame_table_save(const gavl_frame_table_t *t, const char *filename)
Save a frame table to a file.
GAVL_PUBLIC int64_t gavl_frame_table_end_time(const gavl_frame_table_t *t)
get the end time of the last frame
GAVL_PUBLIC gavl_frame_table_t * gavl_frame_table_load(const char *filename)
Load a frame table from a file.
GAVL_PUBLIC int64_t gavl_frame_table_frame_to_time(const gavl_frame_table_t *t, int64_t frame, int *duration)
Convert a frame index to a timestamp.
GAVL_PUBLIC gavl_timecode_t gavl_frame_table_frame_to_timecode(const gavl_frame_table_t *t, int64_t frame, int64_t *start_time, const gavl_timecode_format_t *fmt)
Convert a frame index to a timecode.
GAVL_PUBLIC void gavl_frame_table_dump(const gavl_frame_table_t *t)
Dump a frame table to stderr for debugging.
GAVL_PUBLIC gavl_timecode_t gavl_frame_table_time_to_timecode(const gavl_frame_table_t *t, int64_t time, int64_t *start_time, const gavl_timecode_format_t *fmt)
Convert a timestamp to a timecode.
GAVL_PUBLIC int64_t gavl_frame_table_time_to_frame(const gavl_frame_table_t *t, int64_t time, int64_t *start_time)
Convert a timestamp to a frame index.
GAVL_PUBLIC int64_t gavl_frame_table_duration(const gavl_frame_table_t *t)
get the total duration of all frames
GAVL_PUBLIC void gavl_frame_table_destroy(gavl_frame_table_t *t)
Destroy a frame table and free all memory.
GAVL_PUBLIC int64_t gavl_frame_table_num_frames(const gavl_frame_table_t *t)
get the total number of frames
GAVL_PUBLIC gavl_frame_table_t * gavl_frame_table_create_cfr(int64_t offset, int64_t frame_duration, int64_t num_frames, gavl_timecode_t start_timecode)
Create a frame table for constant framerate video.
GAVL_PUBLIC void gavl_frame_table_append_entry(gavl_frame_table_t *t, int64_t duration)
Append an entry.
GAVL_PUBLIC void gavl_frame_table_append_timecode(gavl_frame_table_t *t, int64_t pts, gavl_timecode_t tc)
Append a timecodes.
GAVL_PUBLIC gavl_frame_table_t * gavl_frame_table_create()
Create a frame table.
GAVL_PUBLIC gavl_frame_table_t * gavl_frame_table_create_audio(int samplerate, int64_t offset, int64_t duration, gavl_timecode_format_t *fmt_ret)
Create a frame table for an audio stream.
GAVL_PUBLIC int64_t gavl_frame_table_timecode_to_time(const gavl_frame_table_t *t, gavl_timecode_t tc, const gavl_timecode_format_t *fmt)
Convert a timecode to a timestamp.
GAVL_PUBLIC gavl_frame_table_t * gavl_frame_table_copy(const gavl_frame_table_t *tab)
Copy a frame table to another.
void(* gavl_video_stop_func)(void *client_data, int thread)
Wait until a piece of a calculation finished.
Definition: gavl.h:92
void(* gavl_video_process_func)(void *data, int start, int end)
Prototype of a process function.
Definition: gavl.h:64
void(* gavl_video_run_func)(gavl_video_process_func func, void *gavl_data, int start, int end, void *client_data, int thread)
Run a piece of a calculation.
Definition: gavl.h:79
struct gavl_peak_detector_s gavl_peak_detector_t
Opaque structure for peak detector.
Definition: gavl.h:1221
GAVL_PUBLIC void gavl_peak_detector_get_peaks(gavl_peak_detector_t *pd, double *min, double *max, double *abs)
Get the peak volume for all channels separate.
GAVL_PUBLIC gavl_peak_detector_t * gavl_peak_detector_create()
Create peak detector.
GAVL_PUBLIC void gavl_peak_detector_set_format(gavl_peak_detector_t *pd, const gavl_audio_format_t *format)
Set format for a peak detector.
GAVL_PUBLIC void gavl_peak_detector_reset(gavl_peak_detector_t *pd)
Reset a peak detector.
GAVL_PUBLIC void gavl_peak_detector_update(gavl_peak_detector_t *pd, gavl_audio_frame_t *frame)
Feed the peak detector with a new frame.
GAVL_PUBLIC void gavl_peak_detector_get_peak(gavl_peak_detector_t *pd, double *min, double *max, double *abs)
Get the peak volume across all channels.
GAVL_PUBLIC void gavl_peak_detector_destroy(gavl_peak_detector_t *pd)
Destroys a peak detector and frees all associated memory.
GAVL_PUBLIC void gavl_rectangle_f_crop_bottom(gavl_rectangle_f_t *r, double num_pixels)
Crop a float rectangle by some pixels from the bottom border.
GAVL_PUBLIC int gavl_rectangle_f_is_empty(const gavl_rectangle_f_t *r)
Check if a float rectangle is empty.
GAVL_PUBLIC int gavl_rectangle_i_is_empty(const gavl_rectangle_i_t *r)
Check if an integer rectangle is empty.
GAVL_PUBLIC void gavl_rectangle_f_crop_left(gavl_rectangle_f_t *r, double num_pixels)
Crop a float rectangle by some pixels from the left border.
GAVL_PUBLIC void gavl_rectangle_i_align(gavl_rectangle_i_t *r, int h_align, int v_align)
Align a rectangle.
GAVL_PUBLIC void gavl_rectangle_crop_to_format_scale(gavl_rectangle_f_t *src_rect, gavl_rectangle_i_t *dst_rect, const gavl_video_format_t *src_format, const gavl_video_format_t *dst_format)
Crop 2 rectangles to their formats when scaling is available.
GAVL_PUBLIC void gavl_rectangle_i_copy(gavl_rectangle_i_t *dst, const gavl_rectangle_i_t *src)
Copy an integer rectangle.
GAVL_PUBLIC void gavl_rectangle_f_crop_right(gavl_rectangle_f_t *r, double num_pixels)
Crop a float rectangle by some pixels from the right border.
GAVL_PUBLIC void gavl_rectangle_i_dump(const gavl_rectangle_i_t *r)
Dump a rectangle to stderr.
GAVL_PUBLIC void gavl_rectangle_i_crop_top(gavl_rectangle_i_t *r, int num_pixels)
Crop an integer rectangle by some pixels from the top border.
GAVL_PUBLIC void gavl_rectangle_i_crop_to_format(gavl_rectangle_i_t *r, const gavl_video_format_t *format)
Crop an integer rectangle so it fits into the image size of a video format.
GAVL_PUBLIC void gavl_rectangle_crop_to_format_noscale(gavl_rectangle_i_t *src_rect, gavl_rectangle_i_t *dst_rect, const gavl_video_format_t *src_format, const gavl_video_format_t *dst_format)
Set 2 rectangles as source and destination when no scaling is available.
GAVL_PUBLIC void gavl_rectangle_fit_aspect(gavl_rectangle_i_t *dst_rect, const gavl_video_format_t *src_format, const gavl_rectangle_f_t *src_rect, const gavl_video_format_t *dst_format, float zoom, float squeeze)
Calculate a destination rectangle for scaling.
GAVL_PUBLIC void gavl_rectangle_i_to_f(gavl_rectangle_f_t *dst, const gavl_rectangle_i_t *src)
Convert an integer rectangle to a floating point rectangle.
GAVL_PUBLIC void gavl_rectangle_i_set_all(gavl_rectangle_i_t *r, const gavl_video_format_t *format)
Let an integer rectangle span the whole image size of a video format.
GAVL_PUBLIC void gavl_rectangle_f_set_all(gavl_rectangle_f_t *r, const gavl_video_format_t *format)
Let a float rectangle span the whole image size of a video format.
GAVL_PUBLIC void gavl_rectangle_f_copy(gavl_rectangle_f_t *dst, const gavl_rectangle_f_t *src)
Copy a float rectangle.
GAVL_PUBLIC void gavl_rectangle_f_to_i(gavl_rectangle_i_t *dst, const gavl_rectangle_f_t *src)
Convert a floating point rectangle to an integer rectangle.
GAVL_PUBLIC void gavl_rectangle_f_crop_top(gavl_rectangle_f_t *r, double num_pixels)
Crop a float rectangle by some pixels from the top border.
GAVL_PUBLIC void gavl_rectangle_f_dump(const gavl_rectangle_f_t *r)
Dump a floating point rectangle to stderr.
GAVL_PUBLIC void gavl_rectangle_i_crop_bottom(gavl_rectangle_i_t *r, int num_pixels)
Crop an integer rectangle by some pixels from the bottom border.
GAVL_PUBLIC void gavl_rectangle_i_align_to_format(gavl_rectangle_i_t *r, const gavl_video_format_t *format)
Align a rectangle to a format.
GAVL_PUBLIC void gavl_rectangle_f_crop_to_format(gavl_rectangle_f_t *r, const gavl_video_format_t *format)
Crop a floating point rectangle so it fits into the image size of a video format.
GAVL_PUBLIC void gavl_rectangle_i_crop_left(gavl_rectangle_i_t *r, int num_pixels)
Crop an integer rectangle by some pixels from the left border.
GAVL_PUBLIC void gavl_rectangle_i_crop_right(gavl_rectangle_i_t *r, int num_pixels)
Crop an integer rectangle by some pixels from the right border.
uint64_t gavl_timecode_t
Typedef for timecodes.
Definition: timecode.h:43
GAVL_PUBLIC void gavl_overlay_blend(gavl_overlay_blend_context_t *ctx, gavl_video_frame_t *dst_frame)
Blend overlay onto video frame.
GAVL_PUBLIC void gavl_overlay_blend_context_set_overlay(gavl_overlay_blend_context_t *ctx, gavl_overlay_t *ovl)
Set a new overlay.
GAVL_PUBLIC int gavl_overlay_blend_context_init(gavl_overlay_blend_context_t *ctx, const gavl_video_format_t *frame_format, gavl_video_format_t *overlay_format)
Initialize the blend context.
GAVL_PUBLIC gavl_overlay_blend_context_t * gavl_overlay_blend_context_create()
Create a blend context.
struct gavl_overlay_blend_context_s gavl_overlay_blend_context_t
Opaque blend context.
Definition: gavl.h:3541
GAVL_PUBLIC void gavl_overlay_blend_context_destroy(gavl_overlay_blend_context_t *ctx)
Destroy a blend context and free all associated memory.
GAVL_PUBLIC gavl_video_options_t * gavl_overlay_blend_context_get_options(gavl_overlay_blend_context_t *ctx)
Get options from a blend context.
GAVL_PUBLIC gavl_video_converter_t * gavl_video_converter_create()
Creates a video converter.
GAVL_PUBLIC int gavl_video_converter_init(gavl_video_converter_t *cnv, const gavl_video_format_t *input_format, const gavl_video_format_t *output_format)
Initialize a video converter.
struct gavl_video_converter_s gavl_video_converter_t
Opaque video converter structure.
Definition: gavl.h:3220
GAVL_PUBLIC void gavl_video_convert(gavl_video_converter_t *cnv, const gavl_video_frame_t *input_frame, gavl_video_frame_t *output_frame)
Convert video.
GAVL_PUBLIC int gavl_video_converter_reinit(gavl_video_converter_t *cnv)
Reinitialize a video converter.
GAVL_PUBLIC void gavl_video_converter_destroy(gavl_video_converter_t *cnv)
Destroys a video converter and frees all associated memory.
GAVL_PUBLIC gavl_video_options_t * gavl_video_converter_get_options(gavl_video_converter_t *cnv)
gets options of a video converter
GAVL_PUBLIC int gavl_video_deinterlacer_init(gavl_video_deinterlacer_t *deinterlacer, const gavl_video_format_t *src_format)
Initialize a video deinterlacer.
struct gavl_video_deinterlacer_s gavl_video_deinterlacer_t
Opaque deinterlacer structure.
Definition: gavl.h:3436
GAVL_PUBLIC void gavl_video_deinterlacer_destroy(gavl_video_deinterlacer_t *deinterlacer)
Destroy a video deinterlacer.
GAVL_PUBLIC gavl_video_options_t * gavl_video_deinterlacer_get_options(gavl_video_deinterlacer_t *deinterlacer)
gets options of a deinterlacer
GAVL_PUBLIC void gavl_video_deinterlacer_deinterlace(gavl_video_deinterlacer_t *deinterlacer, const gavl_video_frame_t *input_frame, gavl_video_frame_t *output_frame)
Deinterlace video.
GAVL_PUBLIC gavl_video_deinterlacer_t * gavl_video_deinterlacer_create()
Create a video deinterlacer.
#define GAVL_PIXFMT_PLANAR
Definition: gavl.h:1644
#define GAVL_PIXFMT_ALPHA
Definition: gavl.h:1664
GAVL_PUBLIC int gavl_pixelformat_conversion_penalty(gavl_pixelformat_t src, gavl_pixelformat_t dst)
Get the conversion penalty for pixelformat conversions.
GAVL_PUBLIC int gavl_pixelformat_bytes_per_pixel(gavl_pixelformat_t pixelformat)
Get bytes per pixel for packed formats.
gavl_chroma_placement_t
Chroma placement.
Definition: gavl.h:2048
#define GAVL_PIXFMT_GRAY
Definition: gavl.h:1669
GAVL_PUBLIC int gavl_get_color_channel_format(const gavl_video_format_t *frame_format, gavl_video_format_t *channel_format, gavl_color_channel_t ch)
Get the video format for extracting/merging one channel.
gavl_framerate_mode_t
Framerate mode.
Definition: gavl.h:2070
GAVL_PUBLIC int gavl_video_formats_equal(const gavl_video_format_t *format_1, const gavl_video_format_t *format_2)
Compare 2 video formats.
GAVL_PUBLIC void gavl_video_format_get_chroma_offset(const gavl_video_format_t *format, int field, int plane, float *off_x, float *off_y)
Get the chroma offsets relative to the luma samples.
GAVL_PUBLIC const char * gavl_pixelformat_to_string(gavl_pixelformat_t pixelformat)
Translate a pixelformat into a human readable string.
GAVL_PUBLIC void gavl_video_format_dump(const gavl_video_format_t *format)
Dump a video format to stderr.
GAVL_PUBLIC int gavl_video_format_get_image_size(const gavl_video_format_t *format)
Get the unpadded image size.
GAVL_PUBLIC gavl_pixelformat_t gavl_get_pixelformat(int index)
Get the pixelformat from index.
GAVL_PUBLIC const char * gavl_interlace_mode_to_string(gavl_interlace_mode_t mode)
Translate an interlace mode into a human readable string.
GAVL_PUBLIC const char * gavl_chroma_placement_to_string(gavl_chroma_placement_t mode)
Translate a chroma placement into a human readable string.
GAVL_PUBLIC gavl_pixelformat_t gavl_string_to_pixelformat(const char *name)
Translate a pixelformat name into a pixelformat.
gavl_interlace_mode_t
Interlace mode.
Definition: gavl.h:2093
#define GAVL_PIXFMT_RGB
Definition: gavl.h:1649
GAVL_PUBLIC const char * gavl_framerate_mode_to_string(gavl_framerate_mode_t mode)
Translate a framerate mode into a human readable string.
GAVL_PUBLIC int gavl_pixelformat_bits_per_pixel(gavl_pixelformat_t pixelformat)
Get the effective number of bits for one pixel.
#define GAVL_PIXFMT_YUV
Definition: gavl.h:1654
GAVL_PUBLIC int gavl_pixelformat_num_planes(gavl_pixelformat_t pixelformat)
Get the number of planes.
gavl_color_channel_t
Color channel definitions.
Definition: gavl.h:1853
GAVL_PUBLIC int gavl_num_pixelformats()
Get total number of supported pixelformats.
#define GAVL_PIXFMT_YUVJ
Definition: gavl.h:1659
GAVL_PUBLIC void gavl_video_format_fit_to_source(gavl_video_format_t *dst, const gavl_video_format_t *src)
Set the image size of a destination format from a source format.
GAVL_PUBLIC void gavl_video_format_copy(gavl_video_format_t *dst, const gavl_video_format_t *src)
Copy one video format to another.
GAVL_PUBLIC gavl_pixelformat_t gavl_pixelformat_get_best(gavl_pixelformat_t src, const gavl_pixelformat_t *dst_supported, int *penalty)
Get the best destination format for a given source format.
GAVL_PUBLIC int gavl_pixelformat_bytes_per_component(gavl_pixelformat_t pixelformat)
Get bytes per component for planar formats.
GAVL_PUBLIC void gavl_get_field_format(const gavl_video_format_t *frame_format, gavl_video_format_t *field_format, int field)
Get the video format of one field.
gavl_pixelformat_t
Pixelformat definition.
Definition: gavl.h:1676
GAVL_PUBLIC void gavl_pixelformat_chroma_sub(gavl_pixelformat_t pixelformat, int *sub_h, int *sub_v)
Get the horizontal and vertical subsampling factors.
@ GAVL_CHROMA_PLACEMENT_DVPAL
Definition: gavl.h:2051
@ GAVL_CHROMA_PLACEMENT_MPEG2
Definition: gavl.h:2050
@ GAVL_CHROMA_PLACEMENT_DEFAULT
Definition: gavl.h:2049
@ GAVL_FRAMERATE_UNKNOWN
Definition: gavl.h:2071
@ GAVL_FRAMERATE_CONSTANT
Definition: gavl.h:2072
@ GAVL_FRAMERATE_STILL
Definition: gavl.h:2074
@ GAVL_FRAMERATE_VARIABLE
Definition: gavl.h:2073
@ GAVL_INTERLACE_MIXED_BOTTOM
Definition: gavl.h:2100
@ GAVL_INTERLACE_MIXED_TOP
Definition: gavl.h:2099
@ GAVL_INTERLACE_NONE
Definition: gavl.h:2095
@ GAVL_INTERLACE_BOTTOM_FIRST
Definition: gavl.h:2097
@ GAVL_INTERLACE_UNKNOWN
Definition: gavl.h:2094
@ GAVL_INTERLACE_MIXED
Definition: gavl.h:2098
@ GAVL_INTERLACE_TOP_FIRST
Definition: gavl.h:2096
@ GAVL_CCH_Y
Luminance (also grayscale)
Definition: gavl.h:1857
@ GAVL_CCH_RED
Red.
Definition: gavl.h:1854
@ GAVL_CCH_CR
Chrominance red (aka V)
Definition: gavl.h:1859
@ GAVL_CCH_GREEN
Green.
Definition: gavl.h:1855
@ GAVL_CCH_ALPHA
Transparency (or, to be more precise opacity)
Definition: gavl.h:1860
@ GAVL_CCH_CB
Chrominance blue (aka U)
Definition: gavl.h:1858
@ GAVL_CCH_BLUE
Blue.
Definition: gavl.h:1856
@ GAVL_YUVJ_420_P
Definition: gavl.h:1790
@ GAVL_YUV_422_P
Definition: gavl.h:1777
@ GAVL_BGR_24
Definition: gavl.h:1726
@ GAVL_YUV_410_P
Definition: gavl.h:1786
@ GAVL_RGB_48
Definition: gavl.h:1739
@ GAVL_RGB_32
Definition: gavl.h:1729
@ GAVL_YUV_420_P
Definition: gavl.h:1774
@ GAVL_GRAYA_32
Definition: gavl.h:1699
@ GAVL_YUVA_32
Definition: gavl.h:1759
@ GAVL_RGB_16
Definition: gavl.h:1716
@ GAVL_UYVY
Definition: gavl.h:1756
@ GAVL_YUV_422_P_16
Definition: gavl.h:1803
@ GAVL_YUV_444_P
Definition: gavl.h:1780
@ GAVL_RGB_FLOAT
Definition: gavl.h:1746
@ GAVL_YUVJ_422_P
Definition: gavl.h:1793
@ GAVL_GRAY_8
Definition: gavl.h:1683
@ GAVL_RGB_24
Definition: gavl.h:1723
@ GAVL_RGBA_64
Definition: gavl.h:1742
@ GAVL_YUY2
Definition: gavl.h:1753
@ GAVL_YUVA_FLOAT
Definition: gavl.h:1769
@ GAVL_YUVJ_444_P
Definition: gavl.h:1796
@ GAVL_GRAYA_FLOAT
Definition: gavl.h:1703
@ GAVL_BGR_15
Definition: gavl.h:1712
@ GAVL_YUV_444_P_16
Definition: gavl.h:1800
@ GAVL_PIXELFORMAT_NONE
Undefined.
Definition: gavl.h:1679
@ GAVL_GRAYA_16
Definition: gavl.h:1695
@ GAVL_YUV_411_P
Definition: gavl.h:1783
@ GAVL_GRAY_FLOAT
Definition: gavl.h:1691
@ GAVL_YUV_FLOAT
Definition: gavl.h:1765
@ GAVL_RGBA_32
Definition: gavl.h:1735
@ GAVL_GRAY_16
Definition: gavl.h:1687
@ GAVL_BGR_16
Definition: gavl.h:1720
@ GAVL_YUVA_64
Definition: gavl.h:1762
@ GAVL_RGB_15
Definition: gavl.h:1708
@ GAVL_RGBA_FLOAT
Definition: gavl.h:1749
@ GAVL_BGR_32
Definition: gavl.h:1732
GAVL_PUBLIC void gavl_video_frame_copy(const gavl_video_format_t *format, gavl_video_frame_t *dst, const gavl_video_frame_t *src)
Copy one video frame to another.
GAVL_PUBLIC void gavl_video_frame_copy_plane(const gavl_video_format_t *format, gavl_video_frame_t *dst, const gavl_video_frame_t *src, int plane)
Copy a single plane from one video frame to another.
GAVL_PUBLIC void gavl_video_frame_destroy(gavl_video_frame_t *frame)
Destroy a video frame.
GAVL_PUBLIC void gavl_video_frame_copy_flip_x(const gavl_video_format_t *format, gavl_video_frame_t *dst, const gavl_video_frame_t *src)
Copy one video frame to another with horizontal flipping.
GAVL_PUBLIC void gavl_video_frame_set_strides(gavl_video_frame_t *frame, const gavl_video_format_t *format)
Set the strides according to the format.
GAVL_PUBLIC void gavl_video_frame_get_subframe(gavl_pixelformat_t pixelformat, const gavl_video_frame_t *src, gavl_video_frame_t *dst, gavl_rectangle_i_t *src_rect)
Get a subframe of another frame.
GAVL_PUBLIC int gavl_video_frame_insert_channel(const gavl_video_format_t *format, gavl_color_channel_t ch, const gavl_video_frame_t *src, gavl_video_frame_t *dst)
Insert one channel from a grayscale image into a video frame.
GAVL_PUBLIC void gavl_video_frame_set_planes(gavl_video_frame_t *frame, const gavl_video_format_t *format, uint8_t *buffer)
Set the frames according to the format.
GAVL_PUBLIC void gavl_video_frame_copy_flip_xy(const gavl_video_format_t *format, gavl_video_frame_t *dst, const gavl_video_frame_t *src)
Copy one video frame to another with horizontal and vertical flipping.
GAVL_PUBLIC void gavl_video_frame_copy_metadata(gavl_video_frame_t *dst, const gavl_video_frame_t *src)
Copy metadata of one video frame to another.
GAVL_PUBLIC void gavl_video_frame_fill(gavl_video_frame_t *frame, const gavl_video_format_t *format, const float *color)
Fill the frame with a user spefified color.
GAVL_PUBLIC void gavl_video_frame_dump(gavl_video_frame_t *frame, const gavl_video_format_t *format, const char *namebase)
Dump a video frame to files.
GAVL_PUBLIC void gavl_video_frame_copy_flip_y(const gavl_video_format_t *format, gavl_video_frame_t *dst, const gavl_video_frame_t *src)
Copy one video frame to another with vertical flipping.
GAVL_PUBLIC void gavl_video_frame_get_field(gavl_pixelformat_t pixelformat, const gavl_video_frame_t *src, gavl_video_frame_t *dst, int field)
Get a field from a frame.
GAVL_PUBLIC void gavl_video_frame_psnr(double *psnr, const gavl_video_frame_t *src1, const gavl_video_frame_t *src2, const gavl_video_format_t *format)
Calculate the PSNR of 2 source frames.
GAVL_PUBLIC void gavl_video_frame_absdiff(gavl_video_frame_t *dst, const gavl_video_frame_t *src1, const gavl_video_frame_t *src2, const gavl_video_format_t *format)
Fill the frame with the absolute differene of 2 source frames.
GAVL_PUBLIC int gavl_video_frame_ssim(const gavl_video_frame_t *src1, const gavl_video_frame_t *src2, gavl_video_frame_t *dst, const gavl_video_format_t *format)
Calculate the SSIM of 2 source frames.
GAVL_PUBLIC int gavl_video_frame_extract_channel(const gavl_video_format_t *format, gavl_color_channel_t ch, const gavl_video_frame_t *src, gavl_video_frame_t *dst)
Extract one channel of a video frame into a grayscale image.
GAVL_PUBLIC gavl_video_frame_t * gavl_video_frame_create(const gavl_video_format_t *format)
Create video frame.
GAVL_PUBLIC void gavl_video_frame_null(gavl_video_frame_t *frame)
Zero all pointers in the video frame.
GAVL_PUBLIC void gavl_video_frame_clear(gavl_video_frame_t *frame, const gavl_video_format_t *format)
Fill the frame with black color.
GAVL_PUBLIC int gavl_video_frames_equal(const gavl_video_format_t *format, const gavl_video_frame_t *f1, const gavl_video_frame_t *f2)
Check if 2 video frames are bit-identical.
GAVL_PUBLIC gavl_video_frame_t * gavl_video_frame_create_nopad(const gavl_video_format_t *format)
Create video frame without padding.
GAVL_PUBLIC void gavl_video_options_set_run_func(gavl_video_options_t *opt, gavl_video_run_func func, void *client_data)
Set function to be passed to each thread.
GAVL_PUBLIC void gavl_video_options_set_quality(gavl_video_options_t *opt, int quality)
Set the quality level for the converter.
GAVL_PUBLIC void gavl_video_options_set_alpha_mode(gavl_video_options_t *opt, gavl_alpha_mode_t alpha_mode)
Set the alpha mode.
GAVL_PUBLIC void gavl_video_options_set_rectangles(gavl_video_options_t *opt, const gavl_rectangle_f_t *src_rect, const gavl_rectangle_i_t *dst_rect)
Set source and destination rectangles.
GAVL_PUBLIC void gavl_video_options_destroy(gavl_video_options_t *opt)
Destroy video options.
GAVL_PUBLIC int gavl_video_options_get_quality(gavl_video_options_t *opt)
Get the quality level for the converter.
GAVL_PUBLIC void gavl_video_options_get_background_color(gavl_video_options_t *opt, float *color)
Get the background color for alpha blending.
GAVL_PUBLIC void gavl_video_options_set_num_threads(gavl_video_options_t *opt, int n)
Set number of threads.
GAVL_PUBLIC void gavl_video_options_set_scale_mode(gavl_video_options_t *opt, gavl_scale_mode_t scale_mode)
Set the scale mode.
gavl_deinterlace_mode_t
Definition: gavl.h:2761
GAVL_PUBLIC int gavl_video_options_get_num_threads(gavl_video_options_t *opt)
Set number of threads.
GAVL_PUBLIC void gavl_video_options_copy(gavl_video_options_t *dst, const gavl_video_options_t *src)
Copy video options.
GAVL_PUBLIC void gavl_video_options_get_rectangles(gavl_video_options_t *opt, gavl_rectangle_f_t *src_rect, gavl_rectangle_i_t *dst_rect)
Get source and destination rectangles.
gavl_deinterlace_drop_mode_t
Specifies which field to drop when deinterlacing.
Definition: gavl.h:2775
GAVL_PUBLIC gavl_video_options_t * gavl_video_options_create()
Create an options container.
GAVL_PUBLIC gavl_downscale_filter_t gavl_video_options_get_downscale_filter(gavl_video_options_t *opt)
Get the antialiasing filter for downscaling.
struct gavl_video_options_s gavl_video_options_t
Definition: gavl.h:2820
GAVL_PUBLIC gavl_alpha_mode_t gavl_video_options_get_alpha_mode(gavl_video_options_t *opt)
Get the alpha mode.
GAVL_PUBLIC gavl_scale_mode_t gavl_video_options_get_scale_mode(gavl_video_options_t *opt)
Get the scale mode.
GAVL_PUBLIC gavl_video_run_func gavl_video_options_get_run_func(gavl_video_options_t *opt, void **client_data)
Get function to be passed to each thread.
gavl_alpha_mode_t
Definition: gavl.h:2749
GAVL_PUBLIC void gavl_video_options_set_background_color(gavl_video_options_t *opt, const float *color)
Set the background color for alpha blending.
GAVL_PUBLIC void gavl_video_options_set_deinterlace_drop_mode(gavl_video_options_t *opt, gavl_deinterlace_drop_mode_t deinterlace_drop_mode)
Set the deinterlace drop mode.
GAVL_PUBLIC float gavl_video_options_get_downscale_blur(gavl_video_options_t *opt)
Get blur factor for downscaling.
GAVL_PUBLIC void gavl_video_options_set_stop_func(gavl_video_options_t *opt, gavl_video_stop_func func, void *client_data)
Set function to be passed to each thread.
GAVL_PUBLIC gavl_deinterlace_drop_mode_t gavl_video_options_get_deinterlace_drop_mode(gavl_video_options_t *opt)
Get the deinterlace drop mode.
GAVL_PUBLIC void gavl_video_options_set_defaults(gavl_video_options_t *opt)
Set all options to their defaults.
GAVL_PUBLIC void gavl_video_options_set_conversion_flags(gavl_video_options_t *opt, int conversion_flags)
Set the conversion flags.
gavl_scale_mode_t
Definition: gavl.h:2785
GAVL_PUBLIC void gavl_video_options_set_downscale_blur(gavl_video_options_t *opt, float f)
Set blur factor for downscaling.
GAVL_PUBLIC int gavl_video_options_get_scale_order(gavl_video_options_t *opt)
Get the scale order for GAVL_SCALE_SINC_LANCZOS.
GAVL_PUBLIC void gavl_video_options_set_downscale_filter(gavl_video_options_t *opt, gavl_downscale_filter_t f)
Set antialiasing filter for downscaling.
GAVL_PUBLIC int gavl_video_options_get_conversion_flags(gavl_video_options_t *opt)
Get the conversion flags.
GAVL_PUBLIC void gavl_video_options_set_scale_order(gavl_video_options_t *opt, int order)
Set the scale order for GAVL_SCALE_SINC_LANCZOS.
GAVL_PUBLIC gavl_video_stop_func gavl_video_options_get_stop_func(gavl_video_options_t *opt, void **client_data)
Get function to be passed to each thread.
gavl_downscale_filter_t
Definition: gavl.h:2807
@ GAVL_DEINTERLACE_NONE
Definition: gavl.h:2762
@ GAVL_DEINTERLACE_SCALE
Definition: gavl.h:2764
@ GAVL_DEINTERLACE_BLEND
Definition: gavl.h:2765
@ GAVL_DEINTERLACE_COPY
Definition: gavl.h:2763
@ GAVL_DEINTERLACE_DROP_TOP
Definition: gavl.h:2776
@ GAVL_DEINTERLACE_DROP_BOTTOM
Definition: gavl.h:2777
@ GAVL_ALPHA_IGNORE
Definition: gavl.h:2750
@ GAVL_ALPHA_BLEND_COLOR
Definition: gavl.h:2751
@ GAVL_SCALE_NONE
Definition: gavl.h:2794
@ GAVL_SCALE_NEAREST
Definition: gavl.h:2787
@ GAVL_SCALE_CUBIC_MITCHELL
Definition: gavl.h:2791
@ GAVL_SCALE_AUTO
Definition: gavl.h:2786
@ GAVL_SCALE_SINC_LANCZOS
Definition: gavl.h:2793
@ GAVL_SCALE_CUBIC_CATMULL
Definition: gavl.h:2792
@ GAVL_SCALE_CUBIC_BSPLINE
Definition: gavl.h:2790
@ GAVL_SCALE_QUADRATIC
Definition: gavl.h:2789
@ GAVL_SCALE_BILINEAR
Definition: gavl.h:2788
@ GAVL_DOWNSCALE_FILTER_AUTO
Auto selection based on quality.
Definition: gavl.h:2808
@ GAVL_DOWNSCALE_FILTER_NONE
Fastest method, might produce heavy aliasing artifacts.
Definition: gavl.h:2809
@ GAVL_DOWNSCALE_FILTER_WIDE
Widen the filter curve according to the scaling ratio.
Definition: gavl.h:2810
@ GAVL_DOWNSCALE_FILTER_GAUSS
Do a Gaussian preblur.
Definition: gavl.h:2811
GAVL_PUBLIC int gavl_video_scaler_init(gavl_video_scaler_t *scaler, const gavl_video_format_t *src_format, const gavl_video_format_t *dst_format)
Initialize a video scaler.
GAVL_PUBLIC void gavl_video_scaler_destroy(gavl_video_scaler_t *scaler)
Destroy a video scaler.
GAVL_PUBLIC gavl_video_options_t * gavl_video_scaler_get_options(gavl_video_scaler_t *scaler)
gets options of a scaler
GAVL_PUBLIC gavl_video_scaler_t * gavl_video_scaler_create()
Create a video scaler.
struct gavl_video_scaler_s gavl_video_scaler_t
Opaque scaler structure.
Definition: gavl.h:3336
GAVL_PUBLIC void gavl_video_scaler_scale(gavl_video_scaler_t *scaler, const gavl_video_frame_t *input_frame, gavl_video_frame_t *output_frame)
Scale video.
GAVL_PUBLIC int gavl_video_scaler_init_convolve(gavl_video_scaler_t *scaler, const gavl_video_format_t *format, int h_radius, const float *h_coeffs, int v_radius, const float *v_coeffs)
Initialize a video scaler as a generic convolver.
GAVL_PUBLIC void gavl_image_transform_destroy(gavl_image_transform_t *t)
Destroy a transformation engine.
GAVL_PUBLIC int gavl_image_transform_init(gavl_image_transform_t *t, gavl_video_format_t *format, gavl_image_transform_func func, void *priv)
Initialize a transformation engine.
GAVL_PUBLIC gavl_video_options_t * gavl_image_transform_get_options(gavl_image_transform_t *t)
Get transformation options.
struct gavl_image_transform_s gavl_image_transform_t
Opaque image transformation engine.
Definition: gavl.h:3632
void(* gavl_image_transform_func)(void *priv, double xdst, double ydst, double *xsrc, double *ysrc)
Function describing the method.
Definition: gavl.h:3647
GAVL_PUBLIC void gavl_image_transform_transform(gavl_image_transform_t *t, gavl_video_frame_t *in_frame, gavl_video_frame_t *out_frame)
Transform an image.
GAVL_PUBLIC gavl_image_transform_t * gavl_image_transform_create()
Create a transformation engine.
#define GAVL_MAX_PLANES
Definition: gavl.h:1315
GAVL_PUBLIC void gavl_volume_control_set_volume(gavl_volume_control_t *ctrl, float volume)
Set volume for a volume control.
GAVL_PUBLIC void gavl_volume_control_apply(gavl_volume_control_t *ctrl, gavl_audio_frame_t *frame)
Apply a volume control for an audio frame.
GAVL_PUBLIC gavl_volume_control_t * gavl_volume_control_create()
Create volume control.
GAVL_PUBLIC void gavl_volume_control_destroy(gavl_volume_control_t *ctrl)
Destroys a volume control and frees all associated memory.
GAVL_PUBLIC void gavl_volume_control_set_format(gavl_volume_control_t *ctrl, const gavl_audio_format_t *format)
Set format for a volume control.
struct gavl_volume_control_s gavl_volume_control_t
Opaque structure for a volume control.
Definition: gavl.h:1155
Audio Format.
Definition: gavl.h:261
int samples_per_frame
Definition: gavl.h:262
float rear_level
Definition: gavl.h:269
gavl_interleave_mode_t interleave_mode
Definition: gavl.h:266
gavl_sample_format_t sample_format
Definition: gavl.h:265
float center_level
Definition: gavl.h:268
int samplerate
Definition: gavl.h:263
int num_channels
Definition: gavl.h:264
Generic container for audio samples.
Definition: gavl.h:515
int channel_stride
Definition: gavl.h:520
gavl_audio_samples_t samples
Definition: gavl.h:516
int valid_samples
Definition: gavl.h:518
int64_t timestamp
Definition: gavl.h:519
gavl_audio_channels_t channels
Definition: gavl.h:517
frame table structure
Definition: gavl.h:3742
gavl_timecode_t tc
Timecode associated with this timestamp.
Definition: gavl.h:3760
int num_timecodes
Number of timecodes.
Definition: gavl.h:3754
int64_t num_frames
Number of frames.
Definition: gavl.h:3750
int64_t duration
Duration of each of these frames.
Definition: gavl.h:3751
int64_t offset
Timestamp of the first frame.
Definition: gavl.h:3743
int64_t entries_alloc
Number of allocated entries (never touch this)
Definition: gavl.h:3746
int64_t num_entries
Number of entries.
Definition: gavl.h:3745
int64_t pts
Timestamp of this frame.
Definition: gavl.h:3759
int timecodes_alloc
Number of allocated timecodes (never touch this)
Definition: gavl.h:3755
Overlay structure.
Definition: gavl.h:3528
gavl_video_frame_t * frame
Video frame in an alpha capable format *‍/.
Definition: gavl.h:3529
int dst_y
y offset in the destination frame. *‍/
Definition: gavl.h:3532
gavl_rectangle_i_t ovl_rect
Rectangle in the source frame *‍/.
Definition: gavl.h:3530
int dst_x
x offset in the destination frame. *‍/
Definition: gavl.h:3531
Definition: gavl.h:1340
double x
Definition: gavl.h:1341
double y
Definition: gavl.h:1342
double w
Definition: gavl.h:1343
double h
Definition: gavl.h:1344
Definition: gavl.h:1328
int x
Definition: gavl.h:1329
int h
Definition: gavl.h:1332
int y
Definition: gavl.h:1330
int w
Definition: gavl.h:1331
Timecode format.
Definition: timecode.h:60
Video format.
Definition: gavl.h:2120
gavl_chroma_placement_t chroma_placement
Definition: gavl.h:2139
int timescale
Definition: gavl.h:2136
gavl_interlace_mode_t interlace_mode
Definition: gavl.h:2141
gavl_framerate_mode_t framerate_mode
Definition: gavl.h:2138
int pixel_height
Definition: gavl.h:2130
int frame_width
Definition: gavl.h:2121
int frame_duration
Definition: gavl.h:2134
int frame_height
Definition: gavl.h:2122
int image_width
Definition: gavl.h:2124
int pixel_width
Definition: gavl.h:2129
gavl_pixelformat_t pixelformat
Definition: gavl.h:2132
gavl_timecode_format_t timecode_format
Definition: gavl.h:2143
int image_height
Definition: gavl.h:2125
Definition: gavl.h:2285
void * user_data
Definition: gavl.h:2289
gavl_interlace_mode_t interlace_mode
Definition: gavl.h:2292
gavl_timecode_t timecode
Definition: gavl.h:2293
int64_t timestamp
Definition: gavl.h:2290
int64_t duration
Definition: gavl.h:2291
Container for noninterleaved audio samples.
Definition: gavl.h:483
Container for interleaved audio samples.
Definition: gavl.h:463
uint32_t * u_32
Definition: gavl.h:470
int8_t * s_8
Definition: gavl.h:465
uint16_t * u_16
Definition: gavl.h:467
int16_t * s_16
Definition: gavl.h:468
uint8_t * u_8
Definition: gavl.h:464
float * f
Definition: gavl.h:473
double * d
Definition: gavl.h:474
int32_t * s_32
Definition: gavl.h:471