Files
BPI-CM9-Linux/aml-comp/multimedia/libiamf/proto/test_vector_metadata.proto
T
2026-08-24 10:03:24 +08:00

79 lines
3.2 KiB
Protocol Buffer

// Copyright (c) 2023, Alliance for Open Media. All rights reserved
//
// This source code is subject to the terms of the BSD 3-Clause Clear License
// and the Alliance for Open Media Patent License 1.0. If the BSD 3-Clause Clear
// License was not distributed with this source code in the LICENSE file, you
// can obtain it at www.aomedia.org/license/software-license/bsd-3-c-c. If the
// Alliance for Open Media Patent License 1.0 was not distributed with this
// source code in the PATENTS file, you can obtain it at
// www.aomedia.org/license/patent.
syntax = "proto2";
package libiamf_proto;
enum Leb128GeneratorMode {
GENERATE_LEB_INVALID = 0;
// Generate values using the minimum number of bytes.
GENERATE_LEB_MINIMUM = 1;
// Generate values using the target of bytes.
GENERATE_LEB_FIXED_SIZE = 2;
}
message Leb128Generator {
optional Leb128GeneratorMode mode = 1 [default = GENERATE_LEB_MINIMUM];
// Configures the target number of bytes when using `GENERATE_LEB_FIXED_SIZE`
// mode.
optional int32 fixed_size = 2 [default = 5];
}
message TestVectorMetadata {
optional string human_readable_description = 1;
// Prefix of the output file names. Leave empty to skip writing to output
// files.
optional string file_name_prefix = 2;
// TODO(b/269708630): Rename `is_valid` to `is_valid_to_encode`.
// `true` when all mixes are valid to encode. Mixes may be invalid if they
// contain any mixes that use certain reserved values, or if they exercise any
// features which are not supported by the encoder.
optional bool is_valid = 3;
// `true` when a compliant decoder would decode at least one valid mix. Some
// other mixes may be invalid or use reserved values which may be ignored.
optional bool is_valid_to_decode = 14 [default = true];
optional string mp4_fixed_timestamp = 4;
reserved 5;
// Tags to identify the repository this test vector belongs to. A repository
// could be a git branch or it could refer to some other way to organize a
// test suite.
//
// Some canonical tags are used to identify which GitHub branch(es) the test
// vector should be synchronized with.
//
// `github/aomediacodec/libiamf/main`: Used on the `main` branch of
// https://github.com/AOMediaCodec/libiamf
// `github/aomediacodec/libiamf/v1.0.0-errata`: Used on the `v1.0.0-errata`
// branch of https://github.com/AOMediaCodec/libiamf
repeated string test_repository_tags = 15;
repeated string primary_tested_spec_sections = 6;
optional string base_test = 7;
optional int32 ms_per_fragment = 8 [default = 10000];
optional bool override_computed_recon_gains = 9 [default = false];
// Controls whether to validate the user-provided loudness against the
// computed loudness.
optional bool validate_user_loudness = 13 [default = false];
// An override to control the output bit-depth of the output `rendered` wav
// file.
optional uint32 output_wav_file_bit_depth_override = 12;
// `true` partitions the input mix gain parameter blocks to be aligned with
// single frames. The `param_definition` in the descriptor OBUs must be
// accurate.
optional bool partition_mix_gain_parameter_blocks = 10 [default = true];
// Settings to configure how `Leb128`s are generated.
optional Leb128Generator leb_generator = 11;
}