mp4_muxer.hpp

Go to the documentation of this file.

//
//  mp4_muxer.hpp
//  ChapterForge
//
//  Created by Till Toenshoff on 12/9/25.
//  Copyright © 2025 Till Toenshoff. All rights reserved.
//
 
#pragma once
 
#include <cstdint>
#include <memory>
#include <string>
#include <vector>
#include <utility>
 
#include "aac_extractor.hpp"
#include "metadata_set.hpp"
#include "mp4_atoms.hpp"
#include "mp4a_builder.hpp"
#include "stbl_image_builder.hpp"
#include "stbl_text_builder.hpp"
 
// Complete MP4 writer: takes raw AAC (ADTS) bytes, chapter text/image samples,
// audio config, and metadata.
// Exposed for embedding; prefer the higher-level helper in chapterforge.hpp when linking externally.
bool write_mp4(const std::string &path, const AacExtractResult &aac,
               const std::vector<ChapterTextSample> &text_chapters,
               const std::vector<ChapterImageSample> &image_chapters, Mp4aConfig audio_cfg,
               const MetadataSet &meta, bool fast_start = true,
               const std::vector<std::pair<std::string, std::vector<ChapterTextSample>>>
                   &extra_text_tracks = {},
               const std::vector<uint8_t> *ilst_payload = nullptr,
               const std::vector<uint8_t> *meta_payload = nullptr);
 
#ifdef CHAPTERFORGE_TESTING
namespace chapterforge::testing {
struct TestDurationInfo {
    uint32_t audio_timescale = 0;
    uint64_t audio_duration_ts = 0;
    uint32_t audio_duration_ms = 0;
    std::vector<uint32_t> text_ms;
    std::vector<uint32_t> image_ms;
};
 
std::vector<uint32_t> build_audio_chunk_plan_for_test(uint32_t sample_count);
std::vector<uint32_t> derive_chunk_plan_for_test(const std::vector<uint8_t> &stsc_payload,
                                                 uint32_t sample_count);
std::vector<uint8_t> encode_tx3g_sample_for_test(const ChapterTextSample &sample);
std::vector<std::vector<uint8_t>> encode_tx3g_track_for_test(
    const std::vector<ChapterTextSample> &chapters);
TestDurationInfo compute_durations_for_test(
    const AacExtractResult &aac, Mp4aConfig audio_cfg,
    const std::vector<ChapterTextSample> &text_chapters,
    const std::vector<ChapterImageSample> &image_chapters);
}  // namespace chapterforge::testing
#endif