1## -*- coding: utf-8 -*- 2## 3## Copyright (C) 2013 The Android Open Source Project 4## 5## Licensed under the Apache License, Version 2.0 (the "License"); 6## you may not use this file except in compliance with the License. 7## You may obtain a copy of the License at 8## 9## http://www.apache.org/licenses/LICENSE-2.0 10## 11## Unless required by applicable law or agreed to in writing, software 12## distributed under the License is distributed on an "AS IS" BASIS, 13## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14## See the License for the specific language governing permissions and 15## limitations under the License. 16## 17\ 18## This section of enum integer definitions is inserted into 19## android.hardware.camera2.CameraMetadata. 20 /*@O~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~ 21 * The enum values below this point are generated from metadata 22 * definitions in /system/media/camera/docs. Do not modify by hand or 23 * modify the comment blocks at the start or end. 24 *~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~*/ 25## 26## Generate an enum's integers 27<%def name="generate_enum(entry, target_class)">\ 28 // 29 // Enumeration values for ${target_class}#${entry.name | jkey_identifier} 30 // 31 32 % for value in [v for v in entry.enum.values if v.visibility != 'system']: 33 /** 34 % if value.notes: 35${value.notes | javadoc(metadata)}\ 36 % endif 37 % if value.sdk_notes: 38${value.sdk_notes | javadoc(metadata)}\ 39 % endif 40 * @see ${target_class}#${entry.name | jkey_identifier} 41 % if entry.applied_visibility in ('hidden', 'ndk_public', 'fwk_only', 'extension')\ 42 or value.hidden: 43 * @hide 44 %endif 45 % if value.deprecated: 46 * @deprecated Please refer to this API documentation to find the alternatives 47 % endif 48 */ 49 % if value.deprecated: 50 @Deprecated 51 % endif 52 % if value.visibility == 'test': 53 @TestApi 54 % endif 55 % if value.aconfig_flag: 56 @FlaggedApi(Flags.FLAG_${value.aconfig_flag | jkey_identifier}) 57 % endif 58 public static final int ${jenum_value(entry, value)} = ${enum_calculate_value_string(value)}; 59 60 % endfor 61</%def>\ 62## 63## Generate a list of only Static, Controls, or Dynamic properties. 64<%def name="single_kind_keys(xml_name, target_class)">\ 65% for outer_namespace in metadata.outer_namespaces: ## assumes single 'android' namespace 66 % for section in outer_namespace.sections: 67 % if section.find_first(lambda x: isinstance(x, metadata_model.Entry) and x.kind == xml_name) and \ 68 any_visible(section, xml_name, ('public','hidden', 'ndk_public', 'java_public', \ 69 'fwk_java_public', 'fwk_public', 'fwk_only', 'extension') ): 70 % for inner_namespace in get_children_by_filtering_kind(section, xml_name, 'namespaces'): 71## We only support 1 level of inner namespace, i.e. android.a.b and android.a.b.c works, but not android.a.b.c.d 72## If we need to support more, we should use a recursive function here instead.. but the indentation gets trickier. 73 % for entry in filter_visibility(inner_namespace.entries, ('hidden','public', 'ndk_public', \ 74 'java_public', 'fwk_pubic', 'fwk_only', 'extension')): 75 % if entry.enum \ 76 and not (entry.typedef and entry.typedef.languages.get('java')) \ 77 and not entry.is_clone(): 78${generate_enum(entry, target_class)}\ 79 % endif 80 % endfor 81 % endfor 82 % for entry in filter_visibility( \ 83 get_children_by_filtering_kind(section, xml_name, 'entries'), \ 84 ('hidden', 'public', 'ndk_public', 'java_public', 'fwk_java_public', 'fwk_public', \ 85 'fwk_only', 'extension')): 86 % if entry.enum \ 87 and not (entry.typedef and entry.typedef.languages.get('java')) \ 88 and not entry.is_clone(): 89${generate_enum(entry, target_class)}\ 90 % endif 91 % endfor 92 % endif 93 % endfor 94% endfor 95</%def>\ 96 97## 98## Static properties only 99${single_kind_keys('static','CameraCharacteristics')}\ 100## 101## Controls properties only 102${single_kind_keys('controls','CaptureRequest')}\ 103## 104## Dynamic properties only 105${single_kind_keys('dynamic','CaptureResult')}\ 106 /*~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~ 107 * End generated code 108 *~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~O@*/ 109