libcamera_metadata: Minor fixes

Add method to get read-only metadata entry by index.
Update some function descriptions to show return values.

Change-Id: Ib79ec1aab8f44f4ee7122fd56064514b2d6f78b4
libcamera_metadata: document return values

Change-Id: I940dc7c90f1b1491194e03120c70af4c3893defe
camera_metadata: hide some face metadata

Face ids, scores, rectangels, landmarks are not needed to be exposed to API.

Bug: 11082745
Change-Id: Iaf89f0d6c3e0391ba907a2167d1b56ad10fc6e98
am 82ce3311: Camera: Add partialResult quirk metadata fields

* commit '82ce3311c9430610330456412b0dfab208a7dee3':
  Camera: Add partialResult quirk metadata fields
am 52a64a57: Camera: Make partialResult quirk fields hidden, not system.

* commit '52a64a571f037c5b519b98c69a3b47466d4accce':
  Camera: Make partialResult quirk fields hidden, not system.
libcamera_metadata: assert correct state on exit

Change-Id: I2d9138f61665baa6695ac086184246334038236d
camera_metadata: update metadata type in metadata test

android.colorCorrection.transform was updated to rational type in metadata
change.

Also cleanup the code a little bit.

Bug: 11691467
Change-Id: I71daefdfdf733d65016c51c90e04d9ac0b4b1d4a
Merge "camera_metadata: update metadata type in metadata test"
libcamera_metadata: export include dir

Change-Id: I7327205cceecc429ee048c1620d5ba9b660141f0
camera_metadata: fix metadata clone bug

clone_camera_metadata fails at validation during camera start, then crashes
camera.

Bug: 11879762
Change-Id: I9437c6724dd290aec162ae8b68be898b2f9a5b9e
camera_metadata: add API to query metadata alignment

Bug: 12010193
Change-Id: I7d190a183fa89d96cc3cbd59228df3f2a2347c2e
camera_metadata: add markdown support to rendering HTML/javadoc

- Also update the android.blackLevel.lock description
  (as an example of using markdown)

Change-Id: I1107cfc2a024d0dd8227ec6afa76f9fbc7f473ad
Merge "camera_metadata: add markdown support to rendering HTML/javadoc"
camera_metadata: Add support for embedding images into html/javadoc

- Also finishes specifying the lensShadingMap related fields

Bug: 12135317
Change-Id: I488f76db4650fcc4f8ce6d45e420217016837fbc
camera_metadata: Update metadata tag specs

Below tag specs are updated:
- android.control.mode
- android.control.aeMode
- android.control.afMode
- android.control.awbMode

Bug: 12135317
Change-Id: I187d4d404b5c30f0179bf85724c72f5303905fb7
camera_metadata: Update metadata tag specs

Below tags are updated:
- android.edge.mode
- android.noiseReduction.mode

Bug: 12135317
Change-Id: I0d3f1d920f37d3513ed64eeb5740a8017bf8f451
audio_route: fix crash with unsupported control types

Check if control type is supported before accessing xxx_value
fields in mixer_state structure.

Also remove unused parameter warning.

Change-Id: I9005d4760e55f0798d576bd4507700e198900311
am c5b5f6b3: audio_route: fix crash with unsupported control types

* commit 'c5b5f6b344e3d8448e436835e5214364469614f6':
  audio_route: fix crash with unsupported control types
camera_metadata: update jpeg thumbnail related specs

Below tags are updated:
- android.jpeg.thumbnailSize
- android.jpeg.availableThumbnailSizes

Bug: 12135317
Change-Id: I8dc9122fd009051d5b83de3d8c14fc4903ade3c5
camera_metadata: Move notes to its own row.

Since the notes field is the majority of the docs, give it more room, to
roughly match the width of the javadoc.

Change-Id: I44e206ec1c6411f57f26235fc8b18a7407d07c22