Camera2: Deprecate LENS_RADIAL_DISTORTION, add LENS_DISTORTION

LENS_RADIAL_DISTORTION is inconsistently defined: in some places, it
is documented to operate on the range [-1...1], and in others, on a
range dependent on the camera lens's intrinsic calibration and focal
length.

Since fixing just the definition will not fix any existing devices
that define this value, deprecate the old key and add a new consistent
one to make sure applications only reference the consistent
definition.

Also add support for adding a deprecation description to the metadata
entries, and add descriptions for all the existing deprecated entries.

Test: Adjusted camera CTS passes
Bug: 74641761

Change-Id: I410cef73974bdd02f89051812730424b50fb9430
11 files changed