mirror of
https://repo.dactyloidae.xyz/Dactyloidae/UXP.git
synced 2026-09-29 20:07:30 +09:00
Update aom to v1.0.0
Update aom to commit id d14c5bb4f336ef1842046089849dee4a301fbbf0.
This commit is contained in:
parent
bb61121b44
commit
48f6d2e034
1087 changed files with 154333 additions and 265310 deletions
238
third_party/aom/docs.cmake
vendored
238
third_party/aom/docs.cmake
vendored
|
|
@ -1,14 +1,16 @@
|
|||
##
|
||||
## Copyright (c) 2017, Alliance for Open Media. All rights reserved
|
||||
##
|
||||
## This source code is subject to the terms of the BSD 2 Clause License and
|
||||
## the Alliance for Open Media Patent License 1.0. If the BSD 2 Clause License
|
||||
## was not distributed with this source code in the LICENSE file, you can
|
||||
## obtain it at www.aomedia.org/license/software. 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.
|
||||
##
|
||||
if (NOT AOM_DOCS_CMAKE_)
|
||||
#
|
||||
# Copyright (c) 2017, Alliance for Open Media. All rights reserved
|
||||
#
|
||||
# This source code is subject to the terms of the BSD 2 Clause License and the
|
||||
# Alliance for Open Media Patent License 1.0. If the BSD 2 Clause License was
|
||||
# not distributed with this source code in the LICENSE file, you can obtain it
|
||||
# at www.aomedia.org/license/software. 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.
|
||||
#
|
||||
if(AOM_DOCS_CMAKE_)
|
||||
return()
|
||||
endif() # AOM_DOCS_CMAKE_
|
||||
set(AOM_DOCS_CMAKE_ 1)
|
||||
|
||||
cmake_minimum_required(VERSION 3.5)
|
||||
|
|
@ -18,126 +20,138 @@ set(AOM_DOXYGEN_CONFIG_TEMPLATE "libs.doxy_template")
|
|||
set(AOM_DOXYGEN_OUTPUT_DIR "${AOM_CONFIG_DIR}/dox")
|
||||
set(AOM_DOXYGEN_SECTIONS "av1")
|
||||
|
||||
set(AOM_DOXYGEN_SOURCES
|
||||
"${AOM_ROOT}/aom/aom.h"
|
||||
"${AOM_ROOT}/aom/aom_codec.h"
|
||||
"${AOM_ROOT}/aom/aom_frame_buffer.h"
|
||||
"${AOM_ROOT}/aom/aom_image.h"
|
||||
"${AOM_ROOT}/aom/aom_integer.h"
|
||||
"${AOM_ROOT}/keywords.dox"
|
||||
"${AOM_ROOT}/mainpage.dox"
|
||||
"${AOM_ROOT}/usage.dox")
|
||||
set(AOM_DOXYGEN_SOURCES "${AOM_ROOT}/aom/aom.h" "${AOM_ROOT}/aom/aom_codec.h"
|
||||
"${AOM_ROOT}/aom/aom_frame_buffer.h" "${AOM_ROOT}/aom/aom_image.h"
|
||||
"${AOM_ROOT}/aom/aom_integer.h" "${AOM_ROOT}/keywords.dox"
|
||||
"${AOM_ROOT}/mainpage.dox" "${AOM_ROOT}/usage.dox")
|
||||
|
||||
if (CONFIG_AV1_DECODER)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES
|
||||
${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/aomdec.c"
|
||||
"${AOM_ROOT}/examples/decode_to_md5.c"
|
||||
if(CONFIG_AV1_DECODER)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES ${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/apps/aomdec.c" "${AOM_ROOT}/examples/decode_to_md5.c"
|
||||
"${AOM_ROOT}/examples/decode_with_drops.c"
|
||||
"${AOM_ROOT}/examples/simple_decoder.c")
|
||||
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS
|
||||
${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
"Full featured decoder."
|
||||
"Frame by frame MD5 checksum."
|
||||
"Drops frames while decoding."
|
||||
"Simplified decoder loop.")
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS ${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
"Full featured decoder." "Frame by frame MD5 checksum."
|
||||
"Drops frames while decoding." "Simplified decoder loop.")
|
||||
|
||||
set(AOM_DOXYGEN_SECTIONS ${AOM_DOXYGEN_SECTIONS} "av1_decoder decoder")
|
||||
|
||||
set(AOM_DOXYGEN_SOURCES
|
||||
${AOM_DOXYGEN_SOURCES}
|
||||
"${AOM_ROOT}/aom/aom_decoder.h"
|
||||
"${AOM_ROOT}/aom/aomdx.h"
|
||||
set(AOM_DOXYGEN_SOURCES ${AOM_DOXYGEN_SOURCES}
|
||||
"${AOM_ROOT}/aom/aom_decoder.h" "${AOM_ROOT}/aom/aomdx.h"
|
||||
"${AOM_ROOT}/usage_dx.dox")
|
||||
|
||||
if (CONFIG_ANALYZER)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES
|
||||
${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
if(CONFIG_ANALYZER)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES ${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/examples/analyzer.cc")
|
||||
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS
|
||||
${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS ${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
"Bitstream analyzer.")
|
||||
endif ()
|
||||
endif()
|
||||
|
||||
if (CONFIG_INSPECTION)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES
|
||||
${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/examples/inspect.c")
|
||||
if(CONFIG_INSPECTION)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES ${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/examples/inspect.c")
|
||||
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS
|
||||
${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS ${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
"Bitstream inspector.")
|
||||
endif ()
|
||||
endif ()
|
||||
endif()
|
||||
endif()
|
||||
|
||||
if (CONFIG_AV1_ENCODER)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES
|
||||
${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/aomenc.c"
|
||||
"${AOM_ROOT}/examples/lossless_encoder.c"
|
||||
"${AOM_ROOT}/examples/set_maps.c"
|
||||
"${AOM_ROOT}/examples/simple_encoder.c"
|
||||
if(CONFIG_AV1_ENCODER)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES ${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/apps/aomenc.c" "${AOM_ROOT}/examples/lossless_encoder.c"
|
||||
"${AOM_ROOT}/examples/set_maps.c" "${AOM_ROOT}/examples/simple_encoder.c"
|
||||
"${AOM_ROOT}/examples/twopass_encoder.c")
|
||||
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS
|
||||
${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
"Full featured encoder."
|
||||
"Simplified lossless encoder."
|
||||
"Set active and ROI maps."
|
||||
"Simplified encoder loop."
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS ${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
"Full featured encoder." "Simplified lossless encoder."
|
||||
"Set active and ROI maps." "Simplified encoder loop."
|
||||
"Two-pass encoder loop.")
|
||||
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES ${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/examples/scalable_encoder.c")
|
||||
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS ${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
"Scalable encoder loop.")
|
||||
|
||||
set(AOM_DOXYGEN_SECTIONS ${AOM_DOXYGEN_SECTIONS} "av1_encoder encoder")
|
||||
|
||||
set(AOM_DOXYGEN_SOURCES
|
||||
${AOM_DOXYGEN_SOURCES}
|
||||
"${AOM_ROOT}/aom/aomcx.h"
|
||||
"${AOM_ROOT}/aom/aom_encoder.h"
|
||||
"${AOM_ROOT}/usage_cx.dox")
|
||||
endif ()
|
||||
set(AOM_DOXYGEN_SOURCES ${AOM_DOXYGEN_SOURCES} "${AOM_ROOT}/aom/aomcx.h"
|
||||
"${AOM_ROOT}/aom/aom_encoder.h" "${AOM_ROOT}/usage_cx.dox")
|
||||
endif()
|
||||
|
||||
if (CONFIG_AV1_DECODER AND CONFIG_AV1_ENCODER)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES
|
||||
${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
if(CONFIG_AV1_DECODER AND CONFIG_AV1_ENCODER)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES ${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/examples/aom_cx_set_ref.c")
|
||||
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS
|
||||
${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS ${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
"Set encoder reference frame.")
|
||||
endif ()
|
||||
endif()
|
||||
|
||||
if(CONFIG_AV1_ENCODER)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES ${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/examples/lightfield_encoder.c")
|
||||
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS ${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
"Lightfield encoder example.")
|
||||
endif()
|
||||
|
||||
if(CONFIG_AV1_DECODER)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES ${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/examples/lightfield_tile_list_decoder.c")
|
||||
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS ${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
"Lightfield tile list decoder example.")
|
||||
endif()
|
||||
|
||||
if(CONFIG_AV1_DECODER)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES ${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/examples/lightfield_decoder.c")
|
||||
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS ${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
"Lightfield decoder example.")
|
||||
endif()
|
||||
|
||||
if(CONFIG_AV1_DECODER AND CONFIG_AV1_ENCODER)
|
||||
set(AOM_DOXYGEN_EXAMPLE_SOURCES ${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_ROOT}/examples/lightfield_bitstream_parsing.c")
|
||||
|
||||
set(AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS ${AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS}
|
||||
"Lightfield bitstream parsing example.")
|
||||
endif()
|
||||
|
||||
# Iterates over list named by $list_name and appends each item to $AOM_DOXYFILE
|
||||
# as values assigned to $var_name with no line breaks between list items.
|
||||
# Appends a new line after the entire config variable is expanded.
|
||||
function (write_cmake_list_to_doxygen_config_var var_name list_name)
|
||||
function(write_cmake_list_to_doxygen_config_var var_name list_name)
|
||||
unset(output_string)
|
||||
foreach (list_item ${${list_name}})
|
||||
foreach(list_item ${${list_name}})
|
||||
set(output_string "${output_string} ${list_item} ")
|
||||
endforeach ()
|
||||
endforeach()
|
||||
string(STRIP "${output_string}" output_string)
|
||||
file(APPEND "${AOM_DOXYFILE}" "${var_name} += ${output_string}\n")
|
||||
endfunction ()
|
||||
endfunction()
|
||||
|
||||
function (get_name file_path name_var)
|
||||
get_filename_component(file_basename ${file_path} NAME)
|
||||
get_filename_component(${name_var} ${file_basename} NAME_WE)
|
||||
set(${name_var} ${${name_var}} PARENT_SCOPE)
|
||||
endfunction ()
|
||||
function(get_name file_path name_var)
|
||||
get_filename_component(file_basename ${file_path} NAME)
|
||||
get_filename_component(${name_var} ${file_basename} NAME_WE)
|
||||
set(${name_var} ${${name_var}} PARENT_SCOPE)
|
||||
endfunction()
|
||||
|
||||
function(setup_documentation_targets)
|
||||
|
||||
function (setup_documentation_targets)
|
||||
# Sanity check: the lengths of these lists must match.
|
||||
list(LENGTH AOM_DOXYGEN_EXAMPLE_SOURCES num_sources)
|
||||
list(LENGTH AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS num_descs)
|
||||
if (NOT ${num_sources} EQUAL ${num_descs})
|
||||
if(NOT ${num_sources} EQUAL ${num_descs})
|
||||
message(FATAL_ERROR "Unqeual example and description totals.")
|
||||
endif ()
|
||||
endif()
|
||||
|
||||
# Take the list of examples and produce example_basename.dox for each file in
|
||||
# the list.
|
||||
file(MAKE_DIRECTORY "${AOM_DOXYGEN_OUTPUT_DIR}")
|
||||
foreach (example_file ${AOM_DOXYGEN_EXAMPLE_SOURCES})
|
||||
foreach(example_file ${AOM_DOXYGEN_EXAMPLE_SOURCES})
|
||||
unset(example_basename)
|
||||
get_name("${example_file}" "example_name")
|
||||
set(example_dox "${AOM_DOXYGEN_OUTPUT_DIR}/${example_name}.dox")
|
||||
|
|
@ -145,25 +159,29 @@ function (setup_documentation_targets)
|
|||
set(dox_string "${dox_string} \\includelineno ${example_file}\n*/\n")
|
||||
file(WRITE "${example_dox}" ${dox_string})
|
||||
set(AOM_DOXYGEN_SOURCES ${AOM_DOXYGEN_SOURCES} "${example_dox}")
|
||||
endforeach ()
|
||||
endforeach()
|
||||
|
||||
# Generate samples.dox, an index page that refers to the example_basename.dox
|
||||
# files that were just created.
|
||||
set(samples_header
|
||||
"
|
||||
set(
|
||||
samples_header
|
||||
"
|
||||
/*!\\page samples Sample Code
|
||||
This SDK includes a number of sample applications. Each sample documents a
|
||||
feature of the SDK in both prose and the associated C code. The following
|
||||
samples are included:
|
||||
")
|
||||
|
||||
set(utils_desc
|
||||
"
|
||||
)
|
||||
|
||||
set(
|
||||
utils_desc
|
||||
"
|
||||
In addition, the SDK contains a number of utilities. Since these utilities are
|
||||
built upon the concepts described in the sample code listed above, they are not
|
||||
documented in pieces like the samples are. Their source is included here for
|
||||
reference. The following utilities are included:
|
||||
")
|
||||
"
|
||||
)
|
||||
|
||||
# Write the description for the samples section.
|
||||
set(samples_dox "${AOM_CONFIG_DIR}/samples.dox")
|
||||
|
|
@ -173,28 +191,28 @@ reference. The following utilities are included:
|
|||
# $AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS and massage example names as required by
|
||||
# AV1's doxygen setup.
|
||||
math(EXPR max_example_index "${num_sources} - 1")
|
||||
foreach (NUM RANGE ${max_example_index})
|
||||
foreach(NUM RANGE ${max_example_index})
|
||||
list(GET AOM_DOXYGEN_EXAMPLE_SOURCES ${NUM} ex_name)
|
||||
get_name("${ex_name}" "ex_name")
|
||||
|
||||
# AV1's doxygen lists aomdec and aomenc as utils apart from the examples.
|
||||
# Save the indexes for another pass.
|
||||
if ("${ex_name}" MATCHES "aomdec\|aomenc")
|
||||
if("${ex_name}" MATCHES "aomdec\|aomenc")
|
||||
set(util_indexes "${util_indexes}" "${NUM}")
|
||||
continue()
|
||||
endif ()
|
||||
endif()
|
||||
list(GET AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS ${NUM} ex_desc)
|
||||
file(APPEND "${samples_dox}" " - \\subpage example_${ex_name} ${ex_desc}\n")
|
||||
endforeach ()
|
||||
endforeach()
|
||||
|
||||
# Write the description and index for the utils.
|
||||
file(APPEND "${samples_dox}" "${utils_desc}\n")
|
||||
foreach (util_index ${util_indexes})
|
||||
foreach(util_index ${util_indexes})
|
||||
list(GET AOM_DOXYGEN_EXAMPLE_SOURCES ${util_index} ex_name)
|
||||
get_name("${ex_name}" "ex_name")
|
||||
list(GET AOM_DOXYGEN_EXAMPLE_DESCRIPTIONS ${util_index} ex_desc)
|
||||
file(APPEND "${samples_dox}" " - \\subpage example_${ex_name} ${ex_desc}\n")
|
||||
endforeach ()
|
||||
endforeach()
|
||||
file(APPEND "${samples_dox}" "*/")
|
||||
|
||||
# Add $samples_dox to the doxygen inputs.
|
||||
|
|
@ -206,11 +224,11 @@ reference. The following utilities are included:
|
|||
file(READ "${AOM_ROOT}/${AOM_DOXYGEN_CONFIG_TEMPLATE}" doxygen_template_data)
|
||||
file(APPEND "${AOM_DOXYFILE}" ${doxygen_template_data})
|
||||
file(APPEND "${AOM_DOXYFILE}"
|
||||
"EXAMPLE_PATH += ${AOM_ROOT} ${AOM_ROOT}/examples\n")
|
||||
file(APPEND
|
||||
"${AOM_DOXYFILE}" "INCLUDE_PATH += ${AOM_CONFIG_DIR} ${AOM_ROOT}\n")
|
||||
"EXAMPLE_PATH += ${AOM_ROOT} ${AOM_ROOT}/examples\n")
|
||||
file(APPEND "${AOM_DOXYFILE}"
|
||||
"STRIP_FROM_PATH += ${AOM_ROOT} ${AOM_CONFIG_DIR}\n")
|
||||
"INCLUDE_PATH += ${AOM_CONFIG_DIR} ${AOM_ROOT}\n")
|
||||
file(APPEND "${AOM_DOXYFILE}"
|
||||
"STRIP_FROM_PATH += ${AOM_ROOT} ${AOM_CONFIG_DIR}\n")
|
||||
write_cmake_list_to_doxygen_config_var("INPUT" "AOM_DOXYGEN_SOURCES")
|
||||
write_cmake_list_to_doxygen_config_var("ENABLED_SECTIONS"
|
||||
"AOM_DOXYGEN_SECTIONS")
|
||||
|
|
@ -219,11 +237,9 @@ reference. The following utilities are included:
|
|||
add_custom_target(docs ALL
|
||||
COMMAND "${DOXYGEN_EXECUTABLE}" "${AOM_DOXYFILE}"
|
||||
DEPENDS "${AOM_DOXYFILE}" ${AOM_DOXYGEN_SOURCES}
|
||||
${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_DOXYGEN_CONFIG_TEMPLATE}"
|
||||
${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_DOXYGEN_CONFIG_TEMPLATE}"
|
||||
SOURCES "${AOM_DOXYFILE}" ${AOM_DOXYGEN_SOURCES}
|
||||
${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_DOXYGEN_CONFIG_TEMPLATE}")
|
||||
endfunction ()
|
||||
|
||||
endif () # AOM_DOCS_CMAKE_
|
||||
${AOM_DOXYGEN_EXAMPLE_SOURCES}
|
||||
"${AOM_DOXYGEN_CONFIG_TEMPLATE}")
|
||||
endfunction()
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue