tree: 7e7b9851f66f540a240bf15d62ca8fb0fdc62f72 [path history] [tgz]
  1. aidl/
  2. images/
  3. .gitignore
  4. __init__.py
  5. ACameraMetadata.mako
  6. camera_device_info.mako
  7. camera_device_info.proto
  8. camera_metadata_asserts.mako
  9. camera_metadata_tag_info.mako
  10. camera_metadata_tags.mako
  11. CameraCharacteristicsKeys.mako
  12. CameraDeviceInfo.mako
  13. CameraMetadataEnums.mako
  14. CameraMetadataKeys.mako
  15. CaptureRequestKeys.mako
  16. CaptureResultKeys.mako
  17. CaptureResultTest.mako
  18. docs.html
  19. extension_camera_metadata_tags.mako
  20. HidlMetadata.mako
  21. html.mako
  22. metadata-check-dependencies
  23. metadata-generate
  24. metadata-parser-validity-check
  25. metadata-validate
  26. metadata_definitions.xml
  27. metadata_definitions.xsd
  28. metadata_enums.py
  29. metadata_helpers.py
  30. metadata_helpers_test.py
  31. metadata_model.py
  32. metadata_model_test.py
  33. metadata_parser_xml.py
  34. metadata_template.mako
  35. metadata_validate.py
  36. ndk_camera_metadata_tags.mako
  37. plots.py
  38. README.md
  39. vndk_camera_metadata_tags.mako
  40. zoom_ratio_diagrams.graffle
camera/docs/README.md

Camera Metadata XML

Introduction

This is a set of scripts to manipulate the camera metadata in an XML form.

Generated Files

Many files can be generated from XML, such as the documentation (html/pdf), C code, Java code, and even XML itself (as a round-trip validity check).

Dependencies

  • Python 2.7.x+
  • Beautiful Soup 4+ - HTML/XML parser, used to parse metadata_definitions.xml
  • Mako 0.7+ - Template engine, needed to do file generation.
  • Markdown 2.1+ - Plain text to HTML converter, for docs formatting.
  • Tidy - Cleans up the XML/HTML files.
  • XML Lint - Validates XML against XSD schema.

Quick Setup (Debian Rodete):

NOTE: Debian (and most Linux distros) no longer package Python 2. Python 3 dependencies are listed below.

sudo apt install python3-mako \
                 python3-bs4 \
                 python3-markdown \
                 tidy \
                 libxml2-utils

Quick Usage:

  1. Modify or add to metadata_definition.xml
  2. Execute metadata-generate
  3. Run m ds-docs to make sure the javadoc is correctly generated
  4. Commit and Upload the repos listed at the end of metadata-generate