include/gpac/internal/scte35.h

/*
 *			GPAC - Multimedia Framework C SDK
 *
 *			Authors: Romain Bouqueau
 *			Copyright (c) Motion Spell 2026
 *					All rights reserved
 *
 *  This file is part of GPAC / Filters sub-project
 *
 *  GPAC is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU Lesser General Public License as published by
 *  the Free Software Foundation; either version 2, or (at your option)
 *  any later version.
 *
 *  GPAC is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; see the file COPYING.  If not, write to
 *  the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 *
 */

#ifndef _GF_SCTE35_DEV_H_
#define _GF_SCTE35_DEV_H_

#include <gpac/tools.h>

/*! SCTE-35 DASH-IF binary scheme URI for emsg / InbandEventStream signaling */
#define GF_SCTE35_SCHEME_URI_INBAND "urn:scte:scte35:2013:bin"

/*! SCTE-35 DASH-IF scheme URI for out-of-band (in the manifest) signaling */
#define GF_SCTE35_SCHEME_URI_OUTBAND "urn:scte:scte35:2014:xml+bin"

/*! SCTE-35 parsing of the MPEG2-TS splice_info_section to extract timing and event information
 *
 * \param data the entire SCTE 35 splice_info_section
 * \param size size of the section
 * \param pts [out] effective splice PTS in 90kHz timescale (if function returns true)
 * \param dur [out] break_duration in 90kHz timescale (if function returns true)
 * \param splice_event_id [out] splice event id (if function returns true)
 * \param needs_idr [out] set to true when the splice point requires an IDR
 * \return GF_TRUE if timing was successfully extracted, GF_FALSE otherwise
 */
Bool scte35dec_get_timing(const u8 *data, u32 size, u64 *pts, u64 *dur, u32 *splice_event_id, Bool *needs_idr);


// SCTE-35 signalling
GF_OPT_ENUM (Scte35Mode,
    SCTE35_DASH_AUTO,
    SCTE35_DASH_XML_BIN,
    SCTE35_INBAND,
    SCTE35_ALL,
    SCTE35_NONE,
);

#define SCTE35_ARG { OFFS(scte35), "SCTE-35 signalling\n" \
    "- auto: 'xmlbin' or 'evte' depending on the input\n" \
    "- xmlbin: out-of-band (MPD) EventStream with xml+bin (recommended)\n" \
    "- inband: in-band `emsg` boxes\n" \
    "- all: signal everywhere detected\n" \
    "- none: no EventStream nor `emsg` boxes", GF_PROP_UINT, "auto", "auto|xmlbin|inband|all|none", GF_FS_ARG_HINT_EXPERT }

#endif /*_GF_SCTE35_DEV_H_*/