C++ Library for ISO/IEC 14496-12 - ISO Base Media File Format (QuickTime, MPEG-4, HEIF, etc)
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
Build Project can now be built with make. Oct 4, 2017
Documentation Preparing for doc generator. Nov 1, 2017
Example-Files Removing example. HEVC decoding will happen in a separate project. Oct 4, 2017
ISOBMFF-Dump Changed the copyright as the project will be published as DigiDNA. Oct 25, 2017
ISOBMFF-Tests Changed the copyright as the project will be published as DigiDNA. Oct 25, 2017
ISOBMFF.xcodeproj xcconfig Jan 18, 2018
ISOBMFF Fixed #6 - Fixed point values from BinaryStream. Sep 11, 2018
Submodules Submodules... Apr 10, 2018
VisualStudio Disabled LTCG for release builds (.lib). Feb 27, 2018
.gitignore Support for VisualStudio 2017 - V141XP. Oct 11, 2017
.gitmodules xcconfig Jan 18, 2018
.travis.yml Travis... Oct 26, 2017
ISOBMFF.sln
LICENSE Changed the copyright as the project will be published as DigiDNA. Oct 25, 2017
Makefile Changed the copyright as the project will be published as DigiDNA. Oct 25, 2017
README.md Cleanup... Jan 29, 2018

README.md

ISOBMFF

Build Status Coverage Status Issues Status License Contact

C++ Library for ISO/IEC 14496-12 - ISO Base Media File Format (QuickTime, MPEG-4, HEIF, etc)

About

ISOBMFF is a cross-platform C++ library for reading/parsing files in the ISO Base Media File Format (ISO/IEC 14496-12).

The ISO Base Media File Format is a container format, used by many file types, including:

  • QuickTime (.mov)
  • MPEG-4 (.m4v, .m4a, etc)
  • 3GP (.3g2)
  • HEIF/HEIC (.heif, .heic, etc)
  • ... and many others

Support for editing/writing files is not available at the moment, but the library has been designed for this goal in mind, so writing support will eventually become available.

ISO Base Media File Format

ISO base media file format (ISO/IEC 14496-12 - MPEG-4 Part 12) defines a general structure for time-based multimedia files such as video and audio.
It is designed as a flexible, extensible format that facilitates interchange, management, editing and presentation of the media.
The presentation may be local, or via a network or other stream delivery mechanism.
The file format is designed to be independent of any particular network protocol while enabling support for them in general.
It is used as the basis for other media file formats (e.g. container formats MP4 and 3GP).

Source: Wikipedia

Building

macOS

An Xcode project is provided for convenience, containing the following targets:

  • ISOBMFF: The main cross-platform C++ library.
  • ISOBMFF-Dump: A cross-platform command-line utility for dumping files.

Note that you can also build the library with make, on the command line.

Windows

An VisualStudio solution is provided for convenience, containing the following targets:

  • ISOBMFF Static v120xp: A static library built with the V120XP toolset (VS 2013)
  • ISOBMFF Static v140xp: A static library built with the V140XP toolset (VS 2015)
  • ISOBMFF Static v141xp: A static library built with the V141XP toolset (VS 2017)
  • ISOBMFF DLL v120xp: A dynamic library (DLL) built with the V120XP toolset (VS 2013)
  • ISOBMFF DLL v140xp: A dynamic library (DLL) built with the V140XP toolset (VS 2015)
  • ISOBMFF DLL v141xp: A dynamic library (DLL) built with the V141XP toolset (VS 2017)
  • ISOBMFF-Dump: A cross-platform command-line utility for dumping files.

Linux/Unix

The library can be build with make, on the command line.

Library Usage

Parsing is done with the ISOBMFF::Parser class:

ISOBMFF::Parser parser;

try
{
    parser.Parse( "path/to/some/file" );
}
catch( ... )
{}

When the parser is done, an instance of ISOBMFF::File can be retrieved:

std::shared_ptr< ISOBMFF::File > file = parser.GetFile();

Boxes can then be retrieved the following way, from the file:

std::shared_ptr< ISOBMFF::Box > box = file.GetBox( "ftyp" );

If the box does not exist, it will return nullptr.

A typed box can be retrieved the following way:

std::shared_ptr< ISOBMFF::FTYP > ftyp = file.GetTypedBox< ISOBMFF::FTYP >( "ftyp" );

Here, nullptr will be returned if the box does not exist, or is not of the correct type.

Container boxes acts just the same:

std::shared_ptr< ISOBMFF::ContainerBox > moov = file.GetTypedBox< ISOBMFF::ContainerBox >( "moov" );
std::shared_ptr< ISOBMFF::TRAK         > trak = moov.GetTypedBox< ISOBMFF::TRAK         >( "trak" );

The parser also supports custom boxes:

parser.RegisterBox( "abcd", [ = ]( void ) -> std::shared_ptr< CustomBox > { return std::make_shared< CustomBox >(); } );

It will then create an instance of CustomBox when encountering an abcd box somewhere in the file.

The custom class needs at least to inherit from Box:

class CustomBox: public ISOBMFF::Box
{
    public:
        
        CustomBox( void ): Box( "abcd" )
        {}
        
        void CustomBox::ReadData( Parser & parser, BinaryStream & stream )
        {
            /* Read box data here... */
        }
        
        std::vector< std::pair< std::string, std::string > > CustomBox::GetDisplayableProperties( void ) const
        {
            /* Returns box properties, to support output... */
            return {};
        }
};

License

ISOBMFF is released under the terms of the MIT License.

Repository Infos

Owner:          DigiDNA
Web:            www.digidna.net
Blog:           imazing.com/blog
Twitter:        @DigiDNA
GitHub:         github.com/DigiDNA