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') or value.hidden:
42     * @hide
43    %endif
44    % if value.deprecated:
45     * @deprecated Please refer to this API documentation to find the alternatives
46    % endif
47     */
48    % if value.deprecated:
49    @Deprecated
50    % endif
51    % if value.visibility == 'test':
52    @TestApi
53    % endif
54    public static final int ${jenum_value(entry, value)} = ${enum_calculate_value_string(value)};
55
56  % endfor
57</%def>\
58##
59## Generate a list of only Static, Controls, or Dynamic properties.
60<%def name="single_kind_keys(xml_name, target_class)">\
61% for outer_namespace in metadata.outer_namespaces: ## assumes single 'android' namespace
62  % for section in outer_namespace.sections:
63    % if section.find_first(lambda x: isinstance(x, metadata_model.Entry) and x.kind == xml_name) and \
64         any_visible(section, xml_name, ('public','hidden', 'ndk_public', 'java_public') ):
65      % for inner_namespace in get_children_by_filtering_kind(section, xml_name, 'namespaces'):
66## 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
67## If we need to support more, we should use a recursive function here instead.. but the indentation gets trickier.
68        % for entry in filter_visibility(inner_namespace.entries, ('hidden','public', 'ndk_public', 'java_public')):
69          % if entry.enum \
70              and not (entry.typedef and entry.typedef.languages.get('java')) \
71              and not entry.is_clone():
72${generate_enum(entry, target_class)}\
73          % endif
74        % endfor
75      % endfor
76      % for entry in filter_visibility( \
77          get_children_by_filtering_kind(section, xml_name, 'entries'), \
78                                         ('hidden', 'public', 'ndk_public', 'java_public')):
79        % if entry.enum \
80             and not (entry.typedef and entry.typedef.languages.get('java')) \
81             and not entry.is_clone():
82${generate_enum(entry, target_class)}\
83        % endif
84      % endfor
85    % endif
86  % endfor
87% endfor
88</%def>\
89
90##
91## Static properties only
92${single_kind_keys('static','CameraCharacteristics')}\
93##
94## Controls properties only
95${single_kind_keys('controls','CaptureRequest')}\
96##
97## Dynamic properties only
98${single_kind_keys('dynamic','CaptureResult')}\
99    /*~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~
100     * End generated code
101     *~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~O@*/
102