## -*- coding: utf-8 -*-
-/*
- * Copyright (C) 2013 The Android Open Source Project
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package android.hardware.photography;
-
-import static android.hardware.photography.CameraMetadata.Key;
-
-/**
- * ! Do not edit this file directly !
- *
- * Generated automatically from ${java_class}Keys.mako
- *
- * TODO: Include a hash of the input files here that the build can check.
- */
-
-<%page args="java_class, xml_kind" />\
-/**
- * The base class for camera controls and information.
- *
- * This class defines the basic key/value map used for querying for camera
- * characteristics or capture results, and for setting camera request
- * parameters.
- *
- * @see ${java_class}
- * @see CameraMetadata
- * @hide
- **/
##
-## Function to generate an enum
-<%def name="generate_enum(entry)">
- public static final class ${entry.get_name_minimal() | pascal_case}Key extends Key<${jtype(entry)}> {
- public enum Enum {
- % for value,last in enumerate_with_last(entry.enum.values):
- ${value.name | jidentifier}${"," if not last else ";"}
- % endfor
- }
-
- % for value in entry.enum.values:
- public static final Enum ${value.name | jidentifier} = Enum.${value.name | jidentifier};
- % endfor
+## Copyright (C) 2013 The Android Open Source Project
+##
+## Licensed under the Apache License, Version 2.0 (the "License");
+## you may not use this file except in compliance with the License.
+## You may obtain a copy of the License at
+##
+## http://www.apache.org/licenses/LICENSE-2.0
+##
+## Unless required by applicable law or agreed to in writing, software
+## distributed under the License is distributed on an "AS IS" BASIS,
+## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+## See the License for the specific language governing permissions and
+## limitations under the License.
+##
+\
+## These sections of metadata Key definitions are inserted into the middle of
+## android.hardware.camera2.CameraCharacteristics, CaptureRequest, and CaptureResult.
+<%page args="java_class, xml_kind" />\
+ /*@O~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~
+ * The key entries below this point are generated from metadata
+ * definitions in /system/media/camera/docs. Do not modify by hand or
+ * modify the comment blocks at the start or end.
+ *~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~*/
- // TODO: remove requirement for constructor by making Key an interface
- private ${entry.get_name_minimal() | pascal_case}Key(String name) {
- super(name, ${jtype(entry)}.class);
- }
+##
+## Generate a single key and docs
+<%def name="generate_key(entry)">\
+ /**
+<%
+ # Dedent fixes markdown not to generate code blocks. Then do the rest.
+ description = ""
+ if entry.description:
+ description = dedent(entry.description) + "\n\n"
+ details = ""
+ if entry.details:
+ details = dedent(entry.details)
+ # Unconditionally add extra information if necessary
+ extra_detail = generate_extra_javadoc_detail(entry)("")
- % if entry.enum.has_values_with_id:
- static {
- CameraMetadata.registerEnumValues(${jenum(entry.enum)}.class, new int[] {
- % for (value, last) in enumerate_with_last(entry.enum.values):
- ${enum_calculate_value_string(value)}${"," if not last else ""} // ${value.name | jidentifier}
- % endfor
- });
- }
- % endif
- }
+ concatenated_info = description + details + extra_detail
+%>\
+## Glue description and details together before javadoc-izing. Otherwise @see in middle of javadoc.
+${concatenated_info | javadoc(metadata)}\
+ % if entry.enum and not (entry.typedef and entry.typedef.languages.get('java')):
+ % for value in entry.enum.values:
+ % if not value.hidden:
+ * @see #${jenum_value(entry, value)}
+ % endif
+ % endfor
+ % endif
+ % if entry.deprecated:
+ * @deprecated
+${entry.deprecation_description | javadoc(metadata)}
+ % endif
+ % if entry.applied_visibility in ('hidden', 'ndk_public'):
+ * @hide
+ % endif
+ */
+ % if entry.deprecated:
+ @Deprecated
+ % endif
+ % if entry.applied_visibility in ('public', 'java_public'):
+ @PublicKey
+ % endif
+ % if entry.synthetic:
+ @SyntheticKey
+ % endif
+ public static final Key<${jtype_boxed(entry)}> ${entry.name | jkey_identifier} =
+ new Key<${jtype_boxed(entry)}>("${entry.name}", ${jkey_type_token(entry)});
</%def>\
##
## Generate a list of only Static, Controls, or Dynamic properties.
<%def name="single_kind_keys(java_name, xml_name)">\
-public final class ${java_name}Keys {
% for outer_namespace in metadata.outer_namespaces: ## assumes single 'android' namespace
% for section in outer_namespace.sections:
- % if section.find_first(lambda x: isinstance(x, metadata_model.Entry) and x.kind == xml_name):
- public static final class ${section.name | pascal_case} {
+ % if section.find_first(lambda x: isinstance(x, metadata_model.Entry) and x.kind == xml_name) and \
+ any_visible(section, xml_name, ('public','hidden','ndk_public','java_public') ):
% for inner_namespace in get_children_by_filtering_kind(section, xml_name, 'namespaces'):
## 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
## If we need to support more, we should use a recursive function here instead.. but the indentation gets trickier.
- public static final class ${inner_namespace.name| pascal_case} {
- % for entry in inner_namespace.merged_entries:
- % if entry.enum:
-${generate_enum(entry)}
- public static final Key<${jtype(entry)}> ${entry.get_name_minimal() | csym} =
- new ${entry.get_name_minimal() | pascal_case}Key("${entry.name}");
- % else:
- public static final Key<${jtype(entry)}> ${entry.get_name_minimal() | csym} =
- new Key<${jtype(entry)}>("${entry.name}", ${jclass(entry)});
- % endif
- % endfor
- }
- % endfor
-
- % for entry in get_children_by_filtering_kind(section, xml_name, 'merged_entries'):
- % if entry.enum:
-${generate_enum(entry)}
- public static final Key<${jtype(entry)}> ${entry.get_name_minimal() | csym} =
- new ${entry.get_name_minimal() | pascal_case}Key("${entry.name}");
- % else:
- public static final Key<${jtype(entry)}> ${entry.get_name_minimal() | csym} =
- new Key<${jtype(entry)}>("${entry.name}", ${jclass(entry)});
- % endif
- % endfor
-
- }
+ % for entry in filter_visibility(inner_namespace.merged_entries, ('hidden','public', 'ndk_public', 'java_public')):
+${generate_key(entry)}
+ % endfor
+ % endfor
+ % for entry in filter_visibility( \
+ get_children_by_filtering_kind(section, xml_name, 'merged_entries'), \
+ ('hidden', 'public', 'ndk_public', 'java_public')):
+${generate_key(entry)}
+ % endfor
% endif
% endfor
% endfor
-}
</%def>\
##
## Static properties only
-##${single_kind_keys('CameraPropertiesKeys', 'static')}
+##${single_kind_keys('CameraCharacteristicsKeys', 'static')}
##
## Controls properties only
##${single_kind_keys('CaptureRequestKeys', 'controls')}
##
## Dynamic properties only
##${single_kind_keys('CaptureResultKeys', 'dynamic')}
-${single_kind_keys(java_class, xml_kind)}
+${single_kind_keys(java_class, xml_kind)}\
+ /*~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~
+ * End generated code
+ *~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~O@*/
\ No newline at end of file