FFmpeg
Loading...
Searching...
No Matches
samplefmt.c
Go to the documentation of this file.
1/*
2 * This file is part of FFmpeg.
3 *
4 * FFmpeg is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
8 *
9 * FFmpeg is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with FFmpeg; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17 */
18
19#include <errno.h>
20#include <limits.h>
21#include <stdio.h>
22#include <string.h>
23
24#include "libavutil/error.h"
25#include "libavutil/mem.h"
26#include "libavutil/samplefmt.h"
27
28int main(void)
29{
30 char buf[64];
31
32 /* av_get_sample_fmt_name and av_get_sample_fmt round-trip */
33 printf("Testing name/format round-trip\n");
34 for (int i = 0; i < AV_SAMPLE_FMT_NB; i++) {
35 const char *name = av_get_sample_fmt_name(i);
36 enum AVSampleFormat fmt = av_get_sample_fmt(name);
37 printf("%2d: name=%-5s roundtrip=%s\n", i, name, fmt == i ? "OK" : "FAIL");
38 }
39
40 /* boundary: NONE and out-of-range */
41 printf("NONE name: %s\n", av_get_sample_fmt_name(AV_SAMPLE_FMT_NONE) == NULL ? "(null)" : "?");
42 printf("NB name: %s\n", av_get_sample_fmt_name(AV_SAMPLE_FMT_NB) == NULL ? "(null)" : "?");
43 printf("unknown: %d\n", av_get_sample_fmt("nonexistent"));
44
45 /* av_get_bytes_per_sample */
46 printf("\nTesting av_get_bytes_per_sample()\n");
47 for (int i = 0; i < AV_SAMPLE_FMT_NB; i++)
48 printf("%s: %d\n", av_get_sample_fmt_name(i), av_get_bytes_per_sample(i));
49 printf("NONE: %d\n", av_get_bytes_per_sample(AV_SAMPLE_FMT_NONE));
50
51 /* av_sample_fmt_is_planar */
52 printf("\nTesting av_sample_fmt_is_planar()\n");
53 for (int i = 0; i < AV_SAMPLE_FMT_NB; i++)
54 printf("%s: %d\n", av_get_sample_fmt_name(i), av_sample_fmt_is_planar(i));
55 printf("NONE: %d\n", av_sample_fmt_is_planar(AV_SAMPLE_FMT_NONE));
56
57 /* av_get_packed_sample_fmt and av_get_planar_sample_fmt */
58 printf("\nTesting packed/planar conversions\n");
59 for (int i = 0; i < AV_SAMPLE_FMT_NB; i++) {
60 enum AVSampleFormat packed = av_get_packed_sample_fmt(i);
61 enum AVSampleFormat planar = av_get_planar_sample_fmt(i);
62 printf("%s: packed=%-4s planar=%s\n",
63 av_get_sample_fmt_name(i),
64 av_get_sample_fmt_name(packed),
65 av_get_sample_fmt_name(planar));
66 }
67
68 /* av_get_alt_sample_fmt */
69 printf("\nTesting av_get_alt_sample_fmt()\n");
70 for (int i = 0; i < AV_SAMPLE_FMT_NB; i++) {
71 enum AVSampleFormat alt_packed = av_get_alt_sample_fmt(i, 0);
72 enum AVSampleFormat alt_planar = av_get_alt_sample_fmt(i, 1);
73 printf("%s: alt_packed=%-4s alt_planar=%s\n",
74 av_get_sample_fmt_name(i),
75 av_get_sample_fmt_name(alt_packed),
76 av_get_sample_fmt_name(alt_planar));
77 }
78
79 /* av_get_sample_fmt_string */
80 printf("\nTesting av_get_sample_fmt_string()\n");
81 av_get_sample_fmt_string(buf, sizeof(buf), -1);
82 printf("header: %s\n", buf);
83 for (int i = 0; i < AV_SAMPLE_FMT_NB; i++) {
84 av_get_sample_fmt_string(buf, sizeof(buf), i);
85 printf("%s\n", buf);
86 }
87
88 /* av_samples_get_buffer_size */
89 printf("\nTesting av_samples_get_buffer_size()\n");
90 {
91 int linesize;
92 printf("2ch 1024smp s16: %d\n",
93 av_samples_get_buffer_size(NULL, 2, 1024, AV_SAMPLE_FMT_S16, 1));
94 printf("2ch 1024smp s16p: %d\n",
95 av_samples_get_buffer_size(NULL, 2, 1024, AV_SAMPLE_FMT_S16P, 1));
96 printf("6ch 512smp s32: %d\n",
97 av_samples_get_buffer_size(NULL, 6, 512, AV_SAMPLE_FMT_S32, 1));
98 av_samples_get_buffer_size(&linesize, 2, 1024, AV_SAMPLE_FMT_S16, 0);
99 printf("linesize (2ch 1024smp s16 align=0): %d\n", linesize);
100 printf("0ch error: %d\n",
101 av_samples_get_buffer_size(NULL, 0, 1024, AV_SAMPLE_FMT_S16, 1) < 0);
102 }
103
104 /* av_samples_alloc and av_samples_fill_arrays */
105 printf("\nTesting av_samples_alloc()\n");
106 {
107 uint8_t *data[8] = { 0 };
108 int linesize, ret;
109
110 ret = av_samples_alloc(data, &linesize, 2, 1024, AV_SAMPLE_FMT_S16, 0);
111 printf("alloc 2ch s16: ret=%d linesize=%d data[0]=%s\n",
112 ret > 0, linesize, data[0] ? "set" : "null");
113 av_freep(&data[0]);
114
115 ret = av_samples_alloc(data, &linesize, 2, 1024, AV_SAMPLE_FMT_S16P, 0);
116 printf("alloc 2ch s16p: ret=%d linesize=%d data[0]=%s data[1]=%s\n",
117 ret > 0, linesize,
118 data[0] ? "set" : "null", data[1] ? "set" : "null");
119 av_freep(&data[0]);
120 }
121
122 /* av_samples_alloc_array_and_samples */
123 printf("\nTesting av_samples_alloc_array_and_samples()\n");
124 {
125 uint8_t **data = NULL;
126 int linesize, ret;
127
128 ret = av_samples_alloc_array_and_samples(&data, &linesize, 2, 1024,
129 AV_SAMPLE_FMT_S16P, 0);
130 printf("alloc_array 2ch s16p: ret=%d linesize=%d data[0]=%s data[1]=%s\n",
131 ret > 0, linesize,
132 data[0] ? "set" : "null", data[1] ? "set" : "null");
133 if (data)
134 av_freep(&data[0]);
135 av_freep(&data);
136 }
137
138 /* av_samples_copy */
139 printf("\nTesting av_samples_copy()\n");
140 {
141 uint8_t *src[1] = { 0 }, *dst[1] = { 0 };
142 int linesize;
143
144 av_samples_alloc(src, &linesize, 1, 4, AV_SAMPLE_FMT_S16, 1);
145 av_samples_alloc(dst, &linesize, 1, 4, AV_SAMPLE_FMT_S16, 1);
146 if (src[0] && dst[0]) {
147 memset(src[0], 0xAB, 8);
148 av_samples_copy(dst, src, 0, 0, 4, 1, AV_SAMPLE_FMT_S16);
149 printf("copy: %s\n", memcmp(src[0], dst[0], 8) == 0 ? "OK" : "FAIL");
150 }
151 av_freep(&src[0]);
152 av_freep(&dst[0]);
153 }
154
155 /* OOM paths via av_max_alloc */
156 printf("\nTesting OOM paths\n");
157 {
158 uint8_t *data[8] = { 0 };
159 uint8_t **array_data = NULL;
160 int linesize, ret;
161
162 av_max_alloc(1);
163
164 ret = av_samples_alloc(data, &linesize, 2, 1024, AV_SAMPLE_FMT_S16, 0);
165 printf("alloc OOM: ret=%d data[0]=%s\n",
166 ret == AVERROR(ENOMEM), data[0] ? "set" : "null");
167
168 ret = av_samples_alloc_array_and_samples(&array_data, &linesize, 2, 1024,
169 AV_SAMPLE_FMT_S16P, 0);
170 printf("alloc_array OOM: ret=%d data=%s\n",
171 ret == AVERROR(ENOMEM), array_data ? "set" : "null");
172
173 av_max_alloc(INT_MAX);
174 }
175
176 /* av_samples_set_silence */
177 printf("\nTesting av_samples_set_silence()\n");
178 {
179 uint8_t *data[1] = { 0 };
180 int linesize;
181
182 av_samples_alloc(data, &linesize, 1, 4, AV_SAMPLE_FMT_S16, 1);
183 if (data[0]) {
184 memset(data[0], 0xFF, 8);
185 av_samples_set_silence(data, 0, 4, 1, AV_SAMPLE_FMT_S16);
186 /* silence for s16 is zero */
187 int silent = 1;
188 for (int i = 0; i < 8; i++)
189 if (data[0][i] != 0) silent = 0;
190 printf("silence s16: %s\n", silent ? "OK" : "FAIL");
191 }
192 av_freep(&data[0]);
193
194 av_samples_alloc(data, &linesize, 1, 4, AV_SAMPLE_FMT_U8, 1);
195 if (data[0]) {
196 memset(data[0], 0xFF, 4);
197 av_samples_set_silence(data, 0, 4, 1, AV_SAMPLE_FMT_U8);
198 /* silence for u8 is 0x80 */
199 int silent = 1;
200 for (int i = 0; i < 4; i++)
201 if (data[0][i] != 0x80) silent = 0;
202 printf("silence u8: %s\n", silent ? "OK" : "FAIL");
203 }
204 av_freep(&data[0]);
205 }
206
207 return 0;
208}
dst
uint8_t ptrdiff_t const uint8_t ptrdiff_t int intptr_t intptr_t int int16_t * dst
Definition dsp.h:87
i
#define i(width, name, range_min, range_max)
Definition cbs_h264.c:63
NULL
#define NULL
Definition coverity.c:32
printf
__device__ int printf(const char *,...)
error.h
error code definitions
AVERROR
#define AVERROR(e)
Definition error.h:45
av_max_alloc
void av_max_alloc(size_t max)
Set the maximum size that may be allocated in one block.
Definition mem.c:76
av_sample_fmt_is_planar
int av_sample_fmt_is_planar(enum AVSampleFormat sample_fmt)
Check if the sample format is planar.
Definition samplefmt.c:115
av_get_bytes_per_sample
int av_get_bytes_per_sample(enum AVSampleFormat sample_fmt)
Return number of bytes per sample.
Definition samplefmt.c:109
av_get_sample_fmt
enum AVSampleFormat av_get_sample_fmt(const char *name)
Return a sample format corresponding to name, or AV_SAMPLE_FMT_NONE on error.
Definition samplefmt.c:59
av_get_packed_sample_fmt
enum AVSampleFormat av_get_packed_sample_fmt(enum AVSampleFormat sample_fmt)
Get the packed alternative form of the given sample format.
Definition samplefmt.c:78
av_get_planar_sample_fmt
enum AVSampleFormat av_get_planar_sample_fmt(enum AVSampleFormat sample_fmt)
Get the planar alternative form of the given sample format.
Definition samplefmt.c:87
av_get_alt_sample_fmt
enum AVSampleFormat av_get_alt_sample_fmt(enum AVSampleFormat sample_fmt, int planar)
Return the planar<->packed alternative form of the given sample format, or AV_SAMPLE_FMT_NONE on erro...
Definition samplefmt.c:69
av_samples_get_buffer_size
int av_samples_get_buffer_size(int *linesize, int nb_channels, int nb_samples, enum AVSampleFormat sample_fmt, int align)
Get the required buffer size for the given audio parameters.
Definition samplefmt.c:122
av_get_sample_fmt_string
char * av_get_sample_fmt_string(char *buf, int buf_size, enum AVSampleFormat sample_fmt)
Generate a string corresponding to the sample format with sample_fmt, or a header if sample_fmt is ne...
Definition samplefmt.c:96
av_get_sample_fmt_name
const char * av_get_sample_fmt_name(enum AVSampleFormat sample_fmt)
Return the name of sample_fmt, or NULL if sample_fmt is not recognized.
Definition samplefmt.c:52
AVSampleFormat
AVSampleFormat
Audio sample formats.
Definition samplefmt.h:55
AV_SAMPLE_FMT_S16P
@ AV_SAMPLE_FMT_S16P
signed 16 bits, planar
Definition samplefmt.h:64
AV_SAMPLE_FMT_NB
@ AV_SAMPLE_FMT_NB
Number of sample formats. DO NOT USE if linking dynamically.
Definition samplefmt.h:79
AV_SAMPLE_FMT_S32
@ AV_SAMPLE_FMT_S32
signed 32 bits
Definition samplefmt.h:59
AV_SAMPLE_FMT_NONE
@ AV_SAMPLE_FMT_NONE
Definition samplefmt.h:56
AV_SAMPLE_FMT_U8
@ AV_SAMPLE_FMT_U8
unsigned 8 bits
Definition samplefmt.h:57
AV_SAMPLE_FMT_S16
@ AV_SAMPLE_FMT_S16
signed 16 bits
Definition samplefmt.h:58
av_samples_alloc
int av_samples_alloc(uint8_t **audio_data, int *linesize, int nb_channels, int nb_samples, enum AVSampleFormat sample_fmt, int align)
Allocate a samples buffer for nb_samples samples, and fill data pointers and linesize accordingly.
Definition samplefmt.c:183
av_samples_set_silence
int av_samples_set_silence(uint8_t *const *audio_data, int offset, int nb_samples, int nb_channels, enum AVSampleFormat sample_fmt)
Fill an audio buffer with silence.
Definition samplefmt.c:247
av_samples_copy
int av_samples_copy(uint8_t *const *dst, uint8_t *const *src, int dst_offset, int src_offset, int nb_samples, int nb_channels, enum AVSampleFormat sample_fmt)
Copy samples from src to dst.
Definition samplefmt.c:223
av_samples_alloc_array_and_samples
int av_samples_alloc_array_and_samples(uint8_t ***audio_data, int *linesize, int nb_channels, int nb_samples, enum AVSampleFormat sample_fmt, int align)
Allocate a data pointers array, samples buffer for nb_samples samples, and fill data pointers and lin...
Definition samplefmt.c:208
mem.h
Memory handling functions.
data
const char data[16]
Definition mxf.c:149
name
const char * name
Definition qsvenc.c:142
av_freep
#define av_freep(p)
Definition tableprint_vlc.h:35
src
#define src
Definition vp8dsp.c:248
main
int main(void)
Definition samplefmt.c:28
Generated on Thu Sep 10 2026 19:21:11 for FFmpeg by doxygen 1.13.2