Loading...
Searching...
No Matches
format-utils.h
Go to the documentation of this file.
/* Simple Plugin API */
/* SPDX-FileCopyrightText: Copyright © 2018 Wim Taymans */
/* SPDX-License-Identifier: MIT */
#ifndef SPA_PARAM_AUDIO_FORMAT_UTILS_H
#define SPA_PARAM_AUDIO_FORMAT_UTILS_H
#include <spa/pod/parser.h>
#include <spa/pod/builder.h>
#include <spa/param/audio/format.h>
#include <spa/param/format-utils.h>
#include <spa/param/audio/raw-utils.h>
#include <spa/param/audio/dsp-utils.h>
#include <spa/param/audio/iec958-utils.h>
#include <spa/param/audio/dsd-utils.h>
#include <spa/param/audio/mp3-utils.h>
#include <spa/param/audio/aac-utils.h>
#include <spa/param/audio/vorbis-utils.h>
#include <spa/param/audio/wma-utils.h>
#include <spa/param/audio/ra-utils.h>
#include <spa/param/audio/amr-utils.h>
#include <spa/param/audio/alac-utils.h>
#include <spa/param/audio/flac-utils.h>
#include <spa/param/audio/ape-utils.h>
#include <spa/param/audio/ac3-utils.h>
#include <spa/param/audio/eac3-utils.h>
#include <spa/param/audio/truehd-utils.h>
#include <spa/param/audio/dts-utils.h>
#include <spa/param/audio/mpegh-utils.h>
#ifdef __cplusplus
extern "C" {
#endif
#ifndef SPA_API_AUDIO_FORMAT_UTILS
#ifdef SPA_API_IMPL
#define SPA_API_AUDIO_FORMAT_UTILS SPA_API_IMPL
#else
#define SPA_API_AUDIO_FORMAT_UTILS static inline
#endif
#endif
SPA_API_AUDIO_FORMAT_UTILS bool
spa_format_audio_ext_valid_size(uint32_t media_subtype, size_t size)
{
switch (media_subtype) {
case SPA_MEDIA_SUBTYPE_raw:
return size >= offsetof(struct spa_audio_info, info.raw) &&
SPA_AUDIO_INFO_RAW_VALID_SIZE(size - offsetof(struct spa_audio_info, info.raw));
#define _SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(format) \
case SPA_MEDIA_SUBTYPE_ ## format: \
return size >= offsetof(struct spa_audio_info, info.format) + sizeof(struct spa_audio_info_ ## format);
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(dsp)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(iec958)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(dsd)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(mp3)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(aac)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(vorbis)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(wma)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(ra)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(amr)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(alac)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(flac)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(ape)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(ac3)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(eac3)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(truehd)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(dts)
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(mpegh)
#undef _SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE
}
return false;
}
SPA_API_AUDIO_FORMAT_UTILS int
spa_format_audio_ext_parse(const struct spa_pod *format, struct spa_audio_info *info, size_t size)
{
int res;
uint32_t media_type, media_subtype;
if ((res = spa_format_parse(format, &media_type, &media_subtype)) < 0)
return res;
if (media_type != SPA_MEDIA_TYPE_audio)
return -EINVAL;
if (!spa_format_audio_ext_valid_size(media_subtype, size))
return -EINVAL;
info->media_type = media_type;
info->media_subtype = media_subtype;
switch (media_subtype) {
case SPA_MEDIA_SUBTYPE_raw:
return spa_format_audio_raw_ext_parse(format, &info->info.raw,
size - offsetof(struct spa_audio_info, info.raw));
case SPA_MEDIA_SUBTYPE_dsp:
return spa_format_audio_dsp_parse(format, &info->info.dsp);
case SPA_MEDIA_SUBTYPE_iec958:
return spa_format_audio_iec958_parse(format, &info->info.iec958);
case SPA_MEDIA_SUBTYPE_dsd:
return spa_format_audio_dsd_parse(format, &info->info.dsd);
case SPA_MEDIA_SUBTYPE_mp3:
return spa_format_audio_mp3_parse(format, &info->info.mp3);
case SPA_MEDIA_SUBTYPE_aac:
return spa_format_audio_aac_parse(format, &info->info.aac);
case SPA_MEDIA_SUBTYPE_vorbis:
return spa_format_audio_vorbis_parse(format, &info->info.vorbis);
case SPA_MEDIA_SUBTYPE_wma:
return spa_format_audio_wma_parse(format, &info->info.wma);
case SPA_MEDIA_SUBTYPE_ra:
return spa_format_audio_ra_parse(format, &info->info.ra);
case SPA_MEDIA_SUBTYPE_amr:
return spa_format_audio_amr_parse(format, &info->info.amr);
case SPA_MEDIA_SUBTYPE_alac:
return spa_format_audio_alac_parse(format, &info->info.alac);
case SPA_MEDIA_SUBTYPE_flac:
return spa_format_audio_flac_parse(format, &info->info.flac);
case SPA_MEDIA_SUBTYPE_ape:
return spa_format_audio_ape_parse(format, &info->info.ape);
case SPA_MEDIA_SUBTYPE_ac3:
return spa_format_audio_ac3_parse(format, &info->info.ac3);
case SPA_MEDIA_SUBTYPE_eac3:
return spa_format_audio_eac3_parse(format, &info->info.eac3);
case SPA_MEDIA_SUBTYPE_truehd:
return spa_format_audio_truehd_parse(format, &info->info.truehd);
case SPA_MEDIA_SUBTYPE_dts:
return spa_format_audio_dts_parse(format, &info->info.dts);
case SPA_MEDIA_SUBTYPE_mpegh:
return spa_format_audio_mpegh_parse(format, &info->info.mpegh);
}
return -ENOTSUP;
}
SPA_API_AUDIO_FORMAT_UTILS int
spa_format_audio_parse(const struct spa_pod *format, struct spa_audio_info *info)
{
return spa_format_audio_ext_parse(format, info, sizeof(*info));
}
SPA_API_AUDIO_FORMAT_UTILS struct spa_pod *
spa_format_audio_ext_build(struct spa_pod_builder *builder, uint32_t id,
const struct spa_audio_info *info, size_t size)
{
if (!spa_format_audio_ext_valid_size(info->media_subtype, size)) {
errno = EINVAL;
return NULL;
}
switch (info->media_subtype) {
case SPA_MEDIA_SUBTYPE_raw:
return spa_format_audio_raw_ext_build(builder, id, &info->info.raw,
size - offsetof(struct spa_audio_info, info.raw));
case SPA_MEDIA_SUBTYPE_dsp:
return spa_format_audio_dsp_build(builder, id, &info->info.dsp);
case SPA_MEDIA_SUBTYPE_iec958:
return spa_format_audio_iec958_build(builder, id, &info->info.iec958);
case SPA_MEDIA_SUBTYPE_dsd:
return spa_format_audio_dsd_build(builder, id, &info->info.dsd);
case SPA_MEDIA_SUBTYPE_mp3:
return spa_format_audio_mp3_build(builder, id, &info->info.mp3);
case SPA_MEDIA_SUBTYPE_aac:
return spa_format_audio_aac_build(builder, id, &info->info.aac);
case SPA_MEDIA_SUBTYPE_vorbis:
return spa_format_audio_vorbis_build(builder, id, &info->info.vorbis);
case SPA_MEDIA_SUBTYPE_wma:
return spa_format_audio_wma_build(builder, id, &info->info.wma);
case SPA_MEDIA_SUBTYPE_ra:
return spa_format_audio_ra_build(builder, id, &info->info.ra);
case SPA_MEDIA_SUBTYPE_amr:
return spa_format_audio_amr_build(builder, id, &info->info.amr);
case SPA_MEDIA_SUBTYPE_alac:
return spa_format_audio_alac_build(builder, id, &info->info.alac);
case SPA_MEDIA_SUBTYPE_flac:
return spa_format_audio_flac_build(builder, id, &info->info.flac);
case SPA_MEDIA_SUBTYPE_ape:
return spa_format_audio_ape_build(builder, id, &info->info.ape);
case SPA_MEDIA_SUBTYPE_ac3:
return spa_format_audio_ac3_build(builder, id, &info->info.ac3);
case SPA_MEDIA_SUBTYPE_eac3:
return spa_format_audio_eac3_build(builder, id, &info->info.eac3);
case SPA_MEDIA_SUBTYPE_truehd:
return spa_format_audio_truehd_build(builder, id, &info->info.truehd);
case SPA_MEDIA_SUBTYPE_dts:
return spa_format_audio_dts_build(builder, id, &info->info.dts);
case SPA_MEDIA_SUBTYPE_mpegh:
return spa_format_audio_mpegh_build(builder, id, &info->info.mpegh);
}
errno = ENOTSUP;
return NULL;
}
SPA_API_AUDIO_FORMAT_UTILS struct spa_pod *
spa_format_audio_build(struct spa_pod_builder *builder, uint32_t id,
const struct spa_audio_info *info)
{
return spa_format_audio_ext_build(builder, id, info, sizeof(*info));
}
*/
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif /* SPA_PARAM_AUDIO_FORMAT_UTILS_H */
aac-utils.h
ac3-utils.h
alac-utils.h
amr-utils.h
ape-utils.h
dsp-utils.h
_SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE
#define _SPA_FORMAT_AUDIO_EXT_VALID_SIZE_CASE(format)
raw-utils.h
builder.h
spa/pod/builder.h
dsd-utils.h
dts-utils.h
eac3-utils.h
flac-utils.h
format-utils.h
res
uint32_t int int res
Definition core.h:433
spa_format_audio_amr_build
SPA_API_AUDIO_AMR_UTILS struct spa_pod * spa_format_audio_amr_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_amr *info)
Definition amr-utils.h:51
spa_format_audio_eac3_parse
SPA_API_AUDIO_EAC3_UTILS int spa_format_audio_eac3_parse(const struct spa_pod *format, struct spa_audio_info_eac3 *info)
Definition eac3-utils.h:38
spa_format_audio_dts_parse
SPA_API_AUDIO_DTS_UTILS int spa_format_audio_dts_parse(const struct spa_pod *format, struct spa_audio_info_dts *info)
Definition dts-utils.h:38
spa_format_audio_mp3_parse
SPA_API_AUDIO_MP3_UTILS int spa_format_audio_mp3_parse(const struct spa_pod *format, struct spa_audio_info_mp3 *info)
Definition mp3-utils.h:38
spa_format_audio_dts_build
SPA_API_AUDIO_DTS_UTILS struct spa_pod * spa_format_audio_dts_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_dts *info)
Definition dts-utils.h:50
spa_format_audio_eac3_build
SPA_API_AUDIO_EAC3_UTILS struct spa_pod * spa_format_audio_eac3_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_eac3 *info)
Definition eac3-utils.h:49
spa_format_audio_ac3_parse
SPA_API_AUDIO_AC3_UTILS int spa_format_audio_ac3_parse(const struct spa_pod *format, struct spa_audio_info_ac3 *info)
Definition ac3-utils.h:38
spa_format_audio_alac_build
SPA_API_AUDIO_ALAC_UTILS struct spa_pod * spa_format_audio_alac_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_alac *info)
Definition alac-utils.h:50
spa_format_audio_iec958_build
SPA_API_AUDIO_IEC958_UTILS struct spa_pod * spa_format_audio_iec958_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_iec958 *info)
Definition iec958-utils.h:49
spa_format_audio_ra_build
SPA_API_AUDIO_RA_UTILS struct spa_pod * spa_format_audio_ra_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_ra *info)
Definition ra-utils.h:49
spa_format_audio_build
SPA_API_AUDIO_FORMAT_UTILS struct spa_pod * spa_format_audio_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info *info)
Definition format-utils.h:208
spa_format_audio_dsp_parse
SPA_API_AUDIO_DSP_UTILS int spa_format_audio_dsp_parse(const struct spa_pod *format, struct spa_audio_info_dsp *info)
Definition dsp-utils.h:38
spa_format_audio_ape_parse
SPA_API_AUDIO_APE_UTILS int spa_format_audio_ape_parse(const struct spa_pod *format, struct spa_audio_info_ape *info)
Definition ape-utils.h:38
spa_format_audio_mp3_build
SPA_API_AUDIO_MP3_UTILS struct spa_pod * spa_format_audio_mp3_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_mp3 *info)
Definition mp3-utils.h:50
spa_format_audio_alac_parse
SPA_API_AUDIO_ALAC_UTILS int spa_format_audio_alac_parse(const struct spa_pod *format, struct spa_audio_info_alac *info)
Definition alac-utils.h:39
spa_format_audio_ra_parse
SPA_API_AUDIO_RA_UTILS int spa_format_audio_ra_parse(const struct spa_pod *format, struct spa_audio_info_ra *info)
Definition ra-utils.h:38
spa_format_audio_parse
SPA_API_AUDIO_FORMAT_UTILS int spa_format_audio_parse(const struct spa_pod *format, struct spa_audio_info *info)
Definition format-utils.h:150
spa_format_audio_ext_valid_size
SPA_API_AUDIO_FORMAT_UTILS bool spa_format_audio_ext_valid_size(uint32_t media_subtype, size_t size)
Definition format-utils.h:57
spa_format_audio_mpegh_build
SPA_API_AUDIO_MPEGH_UTILS struct spa_pod * spa_format_audio_mpegh_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_mpegh *info)
Definition mpegh-utils.h:48
spa_format_audio_flac_build
SPA_API_AUDIO_FLAC_UTILS struct spa_pod * spa_format_audio_flac_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_flac *info)
Definition flac-utils.h:49
spa_format_audio_wma_parse
SPA_API_AUDIO_WMA_UTILS int spa_format_audio_wma_parse(const struct spa_pod *format, struct spa_audio_info_wma *info)
Definition wma-utils.h:38
spa_format_audio_vorbis_build
SPA_API_AUDIO_VORBIS_UTILS struct spa_pod * spa_format_audio_vorbis_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_vorbis *info)
Definition vorbis-utils.h:49
spa_format_audio_ape_build
SPA_API_AUDIO_APE_UTILS struct spa_pod * spa_format_audio_ape_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_ape *info)
Definition ape-utils.h:49
spa_format_audio_aac_parse
SPA_API_AUDIO_AAC_UTILS int spa_format_audio_aac_parse(const struct spa_pod *format, struct spa_audio_info_aac *info)
Definition aac-utils.h:38
spa_format_audio_dsd_parse
SPA_API_AUDIO_DSD_UTILS int spa_format_audio_dsd_parse(const struct spa_pod *format, struct spa_audio_info_dsd *info)
Definition dsd-utils.h:39
spa_format_audio_dsp_build
SPA_API_AUDIO_DSP_UTILS struct spa_pod * spa_format_audio_dsp_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_dsp *info)
Definition dsp-utils.h:48
SPA_API_AUDIO_FORMAT_UTILS
#define SPA_API_AUDIO_FORMAT_UTILS
Definition format-utils.h:52
spa_format_audio_truehd_parse
SPA_API_AUDIO_TRUEHD_UTILS int spa_format_audio_truehd_parse(const struct spa_pod *format, struct spa_audio_info_truehd *info)
Definition truehd-utils.h:38
spa_format_audio_amr_parse
SPA_API_AUDIO_AMR_UTILS int spa_format_audio_amr_parse(const struct spa_pod *format, struct spa_audio_info_amr *info)
Definition amr-utils.h:39
spa_format_audio_vorbis_parse
SPA_API_AUDIO_VORBIS_UTILS int spa_format_audio_vorbis_parse(const struct spa_pod *format, struct spa_audio_info_vorbis *info)
Definition vorbis-utils.h:38
spa_format_audio_ext_parse
SPA_API_AUDIO_FORMAT_UTILS int spa_format_audio_ext_parse(const struct spa_pod *format, struct spa_audio_info *info, size_t size)
Definition format-utils.h:90
spa_format_audio_raw_ext_build
SPA_API_AUDIO_RAW_UTILS struct spa_pod * spa_format_audio_raw_ext_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_raw *info, size_t size)
Definition raw-utils.h:73
spa_format_parse
SPA_API_FORMAT_UTILS int spa_format_parse(const struct spa_pod *format, uint32_t *media_type, uint32_t *media_subtype)
Definition format-utils.h:37
spa_format_audio_wma_build
SPA_API_AUDIO_WMA_UTILS struct spa_pod * spa_format_audio_wma_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_wma *info)
Definition wma-utils.h:52
spa_format_audio_mpegh_parse
SPA_API_AUDIO_MPEGH_UTILS int spa_format_audio_mpegh_parse(const struct spa_pod *format, struct spa_audio_info_mpegh *info)
Definition mpegh-utils.h:38
spa_format_audio_ac3_build
SPA_API_AUDIO_AC3_UTILS struct spa_pod * spa_format_audio_ac3_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_ac3 *info)
Definition ac3-utils.h:49
spa_format_audio_flac_parse
SPA_API_AUDIO_FLAC_UTILS int spa_format_audio_flac_parse(const struct spa_pod *format, struct spa_audio_info_flac *info)
Definition flac-utils.h:38
spa_format_audio_truehd_build
SPA_API_AUDIO_TRUEHD_UTILS struct spa_pod * spa_format_audio_truehd_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_truehd *info)
Definition truehd-utils.h:49
spa_format_audio_aac_build
SPA_API_AUDIO_AAC_UTILS struct spa_pod * spa_format_audio_aac_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_aac *info)
Definition aac-utils.h:52
SPA_AUDIO_INFO_RAW_VALID_SIZE
#define SPA_AUDIO_INFO_RAW_VALID_SIZE(size)
Definition raw.h:310
spa_format_audio_ext_build
SPA_API_AUDIO_FORMAT_UTILS struct spa_pod * spa_format_audio_ext_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info *info, size_t size)
Definition format-utils.h:156
spa_format_audio_iec958_parse
SPA_API_AUDIO_IEC958_UTILS int spa_format_audio_iec958_parse(const struct spa_pod *format, struct spa_audio_info_iec958 *info)
Definition iec958-utils.h:38
spa_format_audio_dsd_build
SPA_API_AUDIO_DSD_UTILS struct spa_pod * spa_format_audio_dsd_build(struct spa_pod_builder *builder, uint32_t id, const struct spa_audio_info_dsd *info)
Definition dsd-utils.h:64
spa_format_audio_raw_ext_parse
SPA_API_AUDIO_RAW_UTILS int spa_format_audio_raw_ext_parse(const struct spa_pod *format, struct spa_audio_info_raw *info, size_t size)
Definition raw-utils.h:39
SPA_MEDIA_TYPE_audio
@ SPA_MEDIA_TYPE_audio
Definition format.h:27
SPA_MEDIA_SUBTYPE_alac
@ SPA_MEDIA_SUBTYPE_alac
Definition format.h:56
SPA_MEDIA_SUBTYPE_ra
@ SPA_MEDIA_SUBTYPE_ra
Definition format.h:48
SPA_MEDIA_SUBTYPE_mp3
@ SPA_MEDIA_SUBTYPE_mp3
Definition format.h:44
SPA_MEDIA_SUBTYPE_ac3
@ SPA_MEDIA_SUBTYPE_ac3
since 0.3.68
Definition format.h:60
SPA_MEDIA_SUBTYPE_aac
@ SPA_MEDIA_SUBTYPE_aac
Definition format.h:45
SPA_MEDIA_SUBTYPE_iec958
@ SPA_MEDIA_SUBTYPE_iec958
Definition format.h:40
SPA_MEDIA_SUBTYPE_ape
@ SPA_MEDIA_SUBTYPE_ape
since 0.3.65
Definition format.h:58
SPA_MEDIA_SUBTYPE_wma
@ SPA_MEDIA_SUBTYPE_wma
Definition format.h:47
SPA_MEDIA_SUBTYPE_truehd
@ SPA_MEDIA_SUBTYPE_truehd
since 1.5.1
Definition format.h:62
SPA_MEDIA_SUBTYPE_amr
@ SPA_MEDIA_SUBTYPE_amr
Definition format.h:54
SPA_MEDIA_SUBTYPE_dsp
@ SPA_MEDIA_SUBTYPE_dsp
Definition format.h:39
SPA_MEDIA_SUBTYPE_vorbis
@ SPA_MEDIA_SUBTYPE_vorbis
Definition format.h:46
SPA_MEDIA_SUBTYPE_raw
@ SPA_MEDIA_SUBTYPE_raw
Definition format.h:38
SPA_MEDIA_SUBTYPE_dts
@ SPA_MEDIA_SUBTYPE_dts
since 1.5.1
Definition format.h:63
SPA_MEDIA_SUBTYPE_eac3
@ SPA_MEDIA_SUBTYPE_eac3
since 1.5.1
Definition format.h:61
SPA_MEDIA_SUBTYPE_mpegh
@ SPA_MEDIA_SUBTYPE_mpegh
since 1.5.1
Definition format.h:64
SPA_MEDIA_SUBTYPE_dsd
@ SPA_MEDIA_SUBTYPE_dsd
S/PDIF.
Definition format.h:41
SPA_MEDIA_SUBTYPE_flac
@ SPA_MEDIA_SUBTYPE_flac
since 0.3.65
Definition format.h:57
iec958-utils.h
mp3-utils.h
mpegh-utils.h
format.h
spa/param/audio/format.h
parser.h
spa/pod/parser.h
ra-utils.h
spa_audio_info
Definition format.h:43
spa_audio_info::raw
struct spa_audio_info_raw raw
Definition format.h:47
spa_pod_builder
Definition builder.h:63
spa_pod
Definition pod.h:57
spa_pod::size
uint32_t size
Definition pod.h:58
truehd-utils.h
vorbis-utils.h
wma-utils.h