Bug 1611431 - Generate mp4parse-rust bindings as part of mach build. r=kinetik

Now that cbindgen.toml is a required file, update-rust.sh must be
updated to avoid clobbering it.

Differential Revision: https://phabricator.services.mozilla.com/D60971

--HG--
extra : moz-landing-system : lando
This commit is contained in:
Jon Bauman 2020-01-28 14:04:37 +00:00
parent e8274a71f3
commit cf9ced0277
4 changed files with 45 additions and 318 deletions

View File

@ -8,4 +8,20 @@ EXPORTS += [
'mp4parse.h',
]
if CONFIG['COMPILE_ENVIRONMENT']:
GENERATED_FILES += [
'mp4parse_ffi_generated.h',
]
EXPORTS += [ # Should this be namespaced? EXPORTS.mozilla.media
'!mp4parse_ffi_generated.h',
]
ffi_generated = GENERATED_FILES['mp4parse_ffi_generated.h']
ffi_generated.script = '/layout/style/RunCbindgen.py:generate'
ffi_generated.inputs = [
'/media/mp4parse-rust/mp4parse_capi',
]
FINAL_LIBRARY = 'xul'

View File

@ -2,320 +2,11 @@
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at https://mozilla.org/MPL/2.0/.
#ifdef __cplusplus
extern "C" {
#endif
#ifndef MP4PARSE_CAPI_H
#define MP4PARSE_CAPI_H
// THIS FILE IS AUTOGENERATED BY mp4parse_capi/build.rs - DO NOT EDIT
#include <stdint.h>
#include <stdlib.h>
#include <stdbool.h>
typedef enum {
MP4_PARSE_ENCRYPTION_SCHEME_TYPE_NONE,
MP4_PARSE_ENCRYPTION_SCHEME_TYPE_CENC,
MP4_PARSE_ENCRYPTION_SCHEME_TYPE_CBC1,
MP4_PARSE_ENCRYPTION_SCHEME_TYPE_CENS,
MP4_PARSE_ENCRYPTION_SCHEME_TYPE_CBCS,
} Mp4ParseEncryptionSchemeType;
typedef enum {
MP4PARSE_CODEC_UNKNOWN,
MP4PARSE_CODEC_AAC,
MP4PARSE_CODEC_FLAC,
MP4PARSE_CODEC_OPUS,
MP4PARSE_CODEC_AVC,
MP4PARSE_CODEC_VP9,
MP4PARSE_CODEC_AV1,
MP4PARSE_CODEC_MP3,
MP4PARSE_CODEC_MP4V,
MP4PARSE_CODEC_JPEG,
MP4PARSE_CODEC_AC3,
MP4PARSE_CODEC_EC3,
MP4PARSE_CODEC_ALAC,
} Mp4parseCodec;
typedef enum {
MP4PARSE_STATUS_OK = 0,
MP4PARSE_STATUS_BAD_ARG = 1,
MP4PARSE_STATUS_INVALID = 2,
MP4PARSE_STATUS_UNSUPPORTED = 3,
MP4PARSE_STATUS_EOF = 4,
MP4PARSE_STATUS_IO = 5,
MP4PARSE_STATUS_OOM = 6,
} Mp4parseStatus;
typedef enum {
MP4PARSE_TRACK_TYPE_VIDEO = 0,
MP4PARSE_TRACK_TYPE_AUDIO = 1,
MP4PARSE_TRACK_TYPE_METADATA = 2,
} Mp4parseTrackType;
typedef struct Mp4parseParser Mp4parseParser;
typedef struct {
uint64_t fragment_duration;
} Mp4parseFragmentInfo;
typedef struct {
/*
* The byte offset in the file where the indexed sample begins.
*/
uint64_t start_offset;
/*
* The byte offset in the file where the indexed sample ends. This is
* equivalent to `start_offset` + the length in bytes of the indexed
* sample. Typically this will be the `start_offset` of the next sample
* in the file.
*/
uint64_t end_offset;
/*
* The time in microseconds when the indexed sample should be displayed.
* Analogous to the concept of presentation time stamp (pts).
*/
int64_t start_composition;
/*
* The time in microseconds when the indexed sample should stop being
* displayed. Typically this would be the `start_composition` time of the
* next sample if samples were ordered by composition time.
*/
int64_t end_composition;
/*
* The time in microseconds that the indexed sample should be decoded at.
* Analogous to the concept of decode time stamp (dts).
*/
int64_t start_decode;
/*
* Set if the indexed sample is a sync sample. The meaning of sync is
* somewhat codec specific, but essentially amounts to if the sample is a
* key frame.
*/
bool sync;
} Mp4parseIndice;
typedef struct {
uint32_t length;
const uint8_t *data;
const Mp4parseIndice *indices;
} Mp4parseByteData;
typedef struct {
Mp4parseByteData data;
} Mp4parsePsshInfo;
typedef struct {
Mp4ParseEncryptionSchemeType scheme_type;
uint8_t is_encrypted;
uint8_t iv_size;
Mp4parseByteData kid;
uint8_t crypt_byte_block;
uint8_t skip_byte_block;
Mp4parseByteData constant_iv;
} Mp4parseSinfInfo;
typedef struct {
Mp4parseCodec codec_type;
uint16_t channels;
uint16_t bit_depth;
uint32_t sample_rate;
uint16_t profile;
uint16_t extended_profile;
Mp4parseByteData codec_specific_config;
Mp4parseByteData extra_data;
Mp4parseSinfInfo protected_data;
} Mp4parseTrackAudioSampleInfo;
typedef struct {
uint32_t sample_info_count;
const Mp4parseTrackAudioSampleInfo *sample_info;
} Mp4parseTrackAudioInfo;
typedef struct {
Mp4parseTrackType track_type;
uint32_t track_id;
uint64_t duration;
int64_t media_time;
} Mp4parseTrackInfo;
typedef struct {
Mp4parseCodec codec_type;
uint16_t image_width;
uint16_t image_height;
Mp4parseByteData extra_data;
Mp4parseSinfInfo protected_data;
} Mp4parseTrackVideoSampleInfo;
typedef struct {
uint32_t display_width;
uint32_t display_height;
uint16_t rotation;
uint32_t sample_info_count;
const Mp4parseTrackVideoSampleInfo *sample_info;
} Mp4parseTrackVideoInfo;
typedef struct {
intptr_t (*read)(uint8_t*, uintptr_t, void*);
void *userdata;
} Mp4parseIo;
// THIS FILE IS AUTOGENERATED BY mp4parse_capi/build.rs - DO NOT EDIT
/*
* Free an `Mp4parseParser*` allocated by `mp4parse_new()`.
*
* # Safety
*
* This function is unsafe because it creates a box from a raw pointer.
* Callers should ensure that the parser pointer points to a valid
* `Mp4parseParser` created by `mp4parse_new`.
*/
void mp4parse_free(Mp4parseParser *parser);
/*
* Fill the supplied `Mp4parseFragmentInfo` with metadata from fragmented file.
*
* # Safety
*
* This function is unsafe because it dereferences the the parser and
* info raw pointers passed to it. Callers should ensure the parser
* pointer points to a valid `Mp4parseParser` and that the info pointer points
* to a valid `Mp4parseFragmentInfo`.
*/
Mp4parseStatus mp4parse_get_fragment_info(Mp4parseParser *parser, Mp4parseFragmentInfo *info);
/*
* Fill the supplied `Mp4parseByteData` with index information from `track`.
*
* # Safety
*
* This function is unsafe because it dereferences the the parser and indices
* raw pointers passed to it. Callers should ensure the parser pointer points
* to a valid `Mp4parseParser` and that the indices pointer points to a valid
* `Mp4parseByteData`.
*/
Mp4parseStatus mp4parse_get_indice_table(Mp4parseParser *parser,
uint32_t track_id,
Mp4parseByteData *indices);
/*
* Get 'pssh' system id and 'pssh' box content for eme playback.
*
* The data format of the `info` struct passed to gecko is:
*
* - system id (16 byte uuid)
* - pssh box size (32-bit native endian)
* - pssh box content (including header)
*
* # Safety
*
* This function is unsafe because it dereferences the the parser and
* info raw pointers passed to it. Callers should ensure the parser
* pointer points to a valid `Mp4parseParser` and that the fragmented pointer
* points to a valid `Mp4parsePsshInfo`.
*/
Mp4parseStatus mp4parse_get_pssh_info(Mp4parseParser *parser, Mp4parsePsshInfo *info);
/*
* Fill the supplied `Mp4parseTrackAudioInfo` with metadata for `track`.
*
* # Safety
*
* This function is unsafe because it dereferences the the parser and info raw
* pointers passed to it. Callers should ensure the parser pointer points to a
* valid `Mp4parseParser` and that the info pointer points to a valid
* `Mp4parseTrackAudioInfo`.
*/
Mp4parseStatus mp4parse_get_track_audio_info(Mp4parseParser *parser,
uint32_t track_index,
Mp4parseTrackAudioInfo *info);
/*
* Return the number of tracks parsed by previous `mp4parse_read()` call.
*
* # Safety
*
* This function is unsafe because it dereferences both the parser and count
* raw pointers passed into it. Callers should ensure the parser pointer
* points to a valid `Mp4parseParser`, and that the count pointer points an
* appropriate memory location to have a `u32` written to.
*/
Mp4parseStatus mp4parse_get_track_count(const Mp4parseParser *parser, uint32_t *count);
/*
* Fill the supplied `Mp4parseTrackInfo` with metadata for `track`.
*
* # Safety
*
* This function is unsafe because it dereferences the the parser and info raw
* pointers passed to it. Callers should ensure the parser pointer points to a
* valid `Mp4parseParser` and that the info pointer points to a valid
* `Mp4parseTrackInfo`.
*/
Mp4parseStatus mp4parse_get_track_info(Mp4parseParser *parser,
uint32_t track_index,
Mp4parseTrackInfo *info);
/*
* Fill the supplied `Mp4parseTrackVideoInfo` with metadata for `track`.
*
* # Safety
*
* This function is unsafe because it dereferences the the parser and info raw
* pointers passed to it. Callers should ensure the parser pointer points to a
* valid `Mp4parseParser` and that the info pointer points to a valid
* `Mp4parseTrackVideoInfo`.
*/
Mp4parseStatus mp4parse_get_track_video_info(Mp4parseParser *parser,
uint32_t track_index,
Mp4parseTrackVideoInfo *info);
/*
* Determine if an mp4 file is fragmented. A fragmented file needs mvex table
* and contains no data in stts, stsc, and stco boxes.
*
* # Safety
*
* This function is unsafe because it dereferences the the parser and
* fragmented raw pointers passed to it. Callers should ensure the parser
* pointer points to a valid `Mp4parseParser` and that the fragmented pointer
* points to an appropriate memory location to have a `u8` written to.
*/
Mp4parseStatus mp4parse_is_fragmented(Mp4parseParser *parser,
uint32_t track_id,
uint8_t *fragmented);
/*
* Allocate an `Mp4parseParser*` to read from the supplied `Mp4parseIo`.
*
* # Safety
*
* This function is unsafe because it dereferences the io pointer given to it.
* The caller should ensure that the `Mp4ParseIo` struct passed in is a valid
* pointer. The caller should also ensure the members of io are valid: the
* `read` function should be sanely implemented, and the `userdata` pointer
* should be valid.
*/
Mp4parseParser *mp4parse_new(const Mp4parseIo *io);
/*
* Run the `Mp4parseParser*` allocated by `mp4parse_new()` until EOF or error.
*
* # Safety
*
* This function is unsafe because it dereferences the raw parser pointer
* passed to it. Callers should ensure that the parser pointer points to a
* valid `Mp4parseParser`.
*/
Mp4parseStatus mp4parse_read(Mp4parseParser *parser);
// THIS FILE IS AUTOGENERATED BY mp4parse_capi/build.rs - DO NOT EDIT
#endif /* MP4PARSE_CAPI_H */
#ifdef __cplusplus
} /* extern "C" */
#ifndef mozilla_media_mp4parse_rust_mp4parse_h
#define mozilla_media_mp4parse_rust_mp4parse_h
#include "mp4parse_ffi_generated.h" // prepend mozilla/media when we namespace this
// Add any non-generated support code here
#endif

View File

@ -0,0 +1,19 @@
header = """/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */"""
autogen_warning = """/* DO NOT MODIFY THIS MANUALLY! This file was generated using cbindgen. See RunCbindgen.py */
#ifndef mozilla_media_mp4parse_rust_mp4parse_h
#error "Don't include this file directly, instead include mp4parse.h"
#endif
"""
include_version = true
braces = "SameLine"
line_length = 100
tab_width = 2
language = "C"
# If we change the language to C++, it would be nice to namespace it
# namespaces = ["mozilla", "media", "ffi"]
[enum]
rename_variants = "QualifiedScreamingSnakeCase"

View File

@ -27,11 +27,12 @@ cp _upstream/mp4parse/mp4parse/src/*.rs mp4parse/src/
mkdir -p mp4parse/tests
cp _upstream/mp4parse/mp4parse/tests/*.rs mp4parse/tests/
cp _upstream/mp4parse/mp4parse/tests/*.mp4 mp4parse/tests/
rm -rf mp4parse_capi
# Remove everything but the cbindgen.toml, since it's needed to configure the
# creation of the bindings as part of moz.build
find mp4parse_capi -not -name cbindgen.toml -delete
mkdir -p mp4parse_capi/src
cp _upstream/mp4parse/mp4parse_capi/Cargo.toml mp4parse_capi/
cp _upstream/mp4parse/mp4parse_capi/build.rs mp4parse_capi/
cp _upstream/mp4parse/mp4parse_capi/include/mp4parse.h ./
cp _upstream/mp4parse/mp4parse_capi/src/*.rs mp4parse_capi/src/
rm -rf mp4parse_fallible
mkdir -p mp4parse_fallible