Message ID | 20190914234806.5205-1-laurent.pinchart@ideasonboard.com |
---|---|
State | Accepted |
Commit | 1e704c84a946f988c290169f060aa088d53fc4a8 |
Headers | show |
Series |
|
Related | show |
Hi Laurent On Sun, Sep 15, 2019 at 02:48:06AM +0300, Laurent Pinchart wrote: > The ipa includes are located in include/libcamera/ipa/. This gives an > incorrect impression that they are a sub-part of the rest of the > libcamera API, while they are the API towards the IPA the same way that > include/libcamera/ contains the API towards applications. To clarify > this, move them to include/ipa/. > > The IPA headers are however still part of libcamera, so installing them > to ${prefix}/include/ipa/ would make little sense. To fix this, move the > application facing API to ${prefix}/include/libcamera/libcamera/ when > installed, and the IPA to ${prefix}/include/libcamera/ipa/. When major > versions of libcamera will be released, they could then be installed > side by side in ${prefix}/include/libcamera-${version}/. > > Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Looks good! Reviewed-by: Jacopo Mondi <jacopo@jmondi.org> Thanks j > --- > Documentation/Doxyfile.in | 4 +++- > Documentation/meson.build | 1 + > include/{libcamera => }/ipa/ipa_interface.h | 0 > include/{libcamera => }/ipa/ipa_module_info.h | 0 > include/ipa/meson.build | 7 +++++++ > include/libcamera/meson.build | 10 +++++----- > include/meson.build | 3 +++ > src/ipa/ipa_dummy.cpp | 4 ++-- > src/ipa/ipa_dummy_isolate.cpp | 4 ++-- > src/libcamera/include/ipa_manager.h | 4 ++-- > src/libcamera/include/ipa_module.h | 4 ++-- > src/libcamera/include/ipa_proxy.h | 2 +- > src/libcamera/ipa_interface.cpp | 2 +- > src/libcamera/meson.build | 2 +- > src/libcamera/pipeline/vimc.cpp | 4 ++-- > src/libcamera/proxy/ipa_proxy_linux.cpp | 4 ++-- > src/libcamera/proxy/worker/ipa_proxy_linux_worker.cpp | 2 +- > 17 files changed, 35 insertions(+), 22 deletions(-) > rename include/{libcamera => }/ipa/ipa_interface.h (100%) > rename include/{libcamera => }/ipa/ipa_module_info.h (100%) > create mode 100644 include/ipa/meson.build > > diff --git a/Documentation/Doxyfile.in b/Documentation/Doxyfile.in > index db939abc8319..ecc058eec683 100644 > --- a/Documentation/Doxyfile.in > +++ b/Documentation/Doxyfile.in > @@ -791,7 +791,9 @@ WARN_LOGFILE = > # spaces. See also FILE_PATTERNS and EXTENSION_MAPPING > # Note: If this tag is empty the current directory is searched. > > -INPUT = "@TOP_SRCDIR@/include/libcamera" "@TOP_SRCDIR@/src/libcamera" > +INPUT = "@TOP_SRCDIR@/include/ipa" \ > + "@TOP_SRCDIR@/include/libcamera" \ > + "@TOP_SRCDIR@/src/libcamera" > > # This tag can be used to specify the character encoding of the source files > # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses > diff --git a/Documentation/meson.build b/Documentation/meson.build > index a560d02abfa5..4ff3fbeb0674 100644 > --- a/Documentation/meson.build > +++ b/Documentation/meson.build > @@ -21,6 +21,7 @@ if doxygen.found() > input : [ > doxyfile, > libcamera_api, > + libcamera_ipa_api, > libcamera_headers, > libcamera_sources, > ], > diff --git a/include/libcamera/ipa/ipa_interface.h b/include/ipa/ipa_interface.h > similarity index 100% > rename from include/libcamera/ipa/ipa_interface.h > rename to include/ipa/ipa_interface.h > diff --git a/include/libcamera/ipa/ipa_module_info.h b/include/ipa/ipa_module_info.h > similarity index 100% > rename from include/libcamera/ipa/ipa_module_info.h > rename to include/ipa/ipa_module_info.h > diff --git a/include/ipa/meson.build b/include/ipa/meson.build > new file mode 100644 > index 000000000000..a0ce96ba96c3 > --- /dev/null > +++ b/include/ipa/meson.build > @@ -0,0 +1,7 @@ > +libcamera_ipa_api = files([ > + 'ipa_interface.h', > + 'ipa_module_info.h', > +]) > + > +install_headers(libcamera_ipa_api, > + subdir: join_paths(libcamera_include_dir, 'ipa')) > diff --git a/include/libcamera/meson.build b/include/libcamera/meson.build > index a8a38a9b1db7..868f1a6bf1ab 100644 > --- a/include/libcamera/meson.build > +++ b/include/libcamera/meson.build > @@ -8,8 +8,6 @@ libcamera_api = files([ > 'event_dispatcher.h', > 'event_notifier.h', > 'geometry.h', > - 'ipa/ipa_interface.h', > - 'ipa/ipa_module_info.h', > 'logging.h', > 'object.h', > 'request.h', > @@ -18,6 +16,8 @@ libcamera_api = files([ > 'timer.h', > ]) > > +include_dir = join_paths(libcamera_include_dir, 'libcamera') > + > gen_header = files('gen-header.sh') > > libcamera_h = custom_target('gen-header', > @@ -25,7 +25,7 @@ libcamera_h = custom_target('gen-header', > output : 'libcamera.h', > command : [gen_header, meson.current_source_dir(), '@OUTPUT@'], > install : true, > - install_dir : 'include/libcamera') > + install_dir : join_paths('include', include_dir)) > > version = libcamera_version.split('.') > libcamera_version_config = configuration_data() > @@ -36,7 +36,7 @@ libcamera_version_config.set('LIBCAMERA_VERSION_PATCH', version[2]) > configure_file(input : 'version.h.in', > output : 'version.h', > configuration : libcamera_version_config, > - install_dir : 'include/libcamera') > + install_dir : join_paths('include', include_dir)) > > install_headers(libcamera_api, > - subdir : 'libcamera') > + subdir : include_dir) > diff --git a/include/meson.build b/include/meson.build > index a89c0d7f9e40..42b2453445b5 100644 > --- a/include/meson.build > +++ b/include/meson.build > @@ -1,2 +1,5 @@ > +libcamera_include_dir = 'libcamera' > + > subdir('android') > +subdir('ipa') > subdir('libcamera') > diff --git a/src/ipa/ipa_dummy.cpp b/src/ipa/ipa_dummy.cpp > index 4c8b6657689d..9313aabd2db8 100644 > --- a/src/ipa/ipa_dummy.cpp > +++ b/src/ipa/ipa_dummy.cpp > @@ -7,8 +7,8 @@ > > #include <iostream> > > -#include <libcamera/ipa/ipa_interface.h> > -#include <libcamera/ipa/ipa_module_info.h> > +#include <ipa/ipa_interface.h> > +#include <ipa/ipa_module_info.h> > > namespace libcamera { > > diff --git a/src/ipa/ipa_dummy_isolate.cpp b/src/ipa/ipa_dummy_isolate.cpp > index 24434e85d318..cd66626df2df 100644 > --- a/src/ipa/ipa_dummy_isolate.cpp > +++ b/src/ipa/ipa_dummy_isolate.cpp > @@ -8,8 +8,8 @@ > > #include <iostream> > > -#include <libcamera/ipa/ipa_interface.h> > -#include <libcamera/ipa/ipa_module_info.h> > +#include <ipa/ipa_interface.h> > +#include <ipa/ipa_module_info.h> > > namespace libcamera { > > diff --git a/src/libcamera/include/ipa_manager.h b/src/libcamera/include/ipa_manager.h > index 310ce7c85e84..126f8babbc8f 100644 > --- a/src/libcamera/include/ipa_manager.h > +++ b/src/libcamera/include/ipa_manager.h > @@ -9,8 +9,8 @@ > > #include <vector> > > -#include <libcamera/ipa/ipa_interface.h> > -#include <libcamera/ipa/ipa_module_info.h> > +#include <ipa/ipa_interface.h> > +#include <ipa/ipa_module_info.h> > > #include "ipa_module.h" > #include "pipeline_handler.h" > diff --git a/src/libcamera/include/ipa_module.h b/src/libcamera/include/ipa_module.h > index 18e9223f028d..97737587ab3a 100644 > --- a/src/libcamera/include/ipa_module.h > +++ b/src/libcamera/include/ipa_module.h > @@ -10,8 +10,8 @@ > #include <memory> > #include <string> > > -#include <libcamera/ipa/ipa_interface.h> > -#include <libcamera/ipa/ipa_module_info.h> > +#include <ipa/ipa_interface.h> > +#include <ipa/ipa_module_info.h> > > #include "pipeline_handler.h" > > diff --git a/src/libcamera/include/ipa_proxy.h b/src/libcamera/include/ipa_proxy.h > index ac57699be949..72216662e373 100644 > --- a/src/libcamera/include/ipa_proxy.h > +++ b/src/libcamera/include/ipa_proxy.h > @@ -11,7 +11,7 @@ > #include <string> > #include <vector> > > -#include <libcamera/ipa/ipa_interface.h> > +#include <ipa/ipa_interface.h> > > #include "ipa_module.h" > #include "utils.h" > diff --git a/src/libcamera/ipa_interface.cpp b/src/libcamera/ipa_interface.cpp > index 9d30da29228f..d7d8ca8881ef 100644 > --- a/src/libcamera/ipa_interface.cpp > +++ b/src/libcamera/ipa_interface.cpp > @@ -5,7 +5,7 @@ > * ipa_interface.cpp - Image Processing Algorithm interface > */ > > -#include <libcamera/ipa/ipa_interface.h> > +#include <ipa/ipa_interface.h> > > /** > * \file ipa_interface.h > diff --git a/src/libcamera/meson.build b/src/libcamera/meson.build > index 0706a08b270b..0916bc411360 100644 > --- a/src/libcamera/meson.build > +++ b/src/libcamera/meson.build > @@ -120,7 +120,7 @@ libcamera = shared_library('camera', > include_directories : includes, > dependencies : libcamera_deps) > > -libcamera_dep = declare_dependency(sources : [libcamera_api, libcamera_h], > +libcamera_dep = declare_dependency(sources : [libcamera_api, libcamera_ipa_api, libcamera_h], > include_directories : libcamera_includes, > link_with : libcamera) > > diff --git a/src/libcamera/pipeline/vimc.cpp b/src/libcamera/pipeline/vimc.cpp > index f8f91d6219b1..f26a91f86ec1 100644 > --- a/src/libcamera/pipeline/vimc.cpp > +++ b/src/libcamera/pipeline/vimc.cpp > @@ -12,10 +12,10 @@ > > #include <linux/media-bus-format.h> > > +#include <ipa/ipa_interface.h> > +#include <ipa/ipa_module_info.h> > #include <libcamera/camera.h> > #include <libcamera/controls.h> > -#include <libcamera/ipa/ipa_interface.h> > -#include <libcamera/ipa/ipa_module_info.h> > #include <libcamera/request.h> > #include <libcamera/stream.h> > > diff --git a/src/libcamera/proxy/ipa_proxy_linux.cpp b/src/libcamera/proxy/ipa_proxy_linux.cpp > index f881aab5b2e1..83a7425077ea 100644 > --- a/src/libcamera/proxy/ipa_proxy_linux.cpp > +++ b/src/libcamera/proxy/ipa_proxy_linux.cpp > @@ -7,8 +7,8 @@ > > #include <vector> > > -#include <libcamera/ipa/ipa_interface.h> > -#include <libcamera/ipa/ipa_module_info.h> > +#include <ipa/ipa_interface.h> > +#include <ipa/ipa_module_info.h> > > #include "ipa_module.h" > #include "ipa_proxy.h" > diff --git a/src/libcamera/proxy/worker/ipa_proxy_linux_worker.cpp b/src/libcamera/proxy/worker/ipa_proxy_linux_worker.cpp > index ffba3ae4de80..a10761e52b32 100644 > --- a/src/libcamera/proxy/worker/ipa_proxy_linux_worker.cpp > +++ b/src/libcamera/proxy/worker/ipa_proxy_linux_worker.cpp > @@ -9,8 +9,8 @@ > #include <sys/types.h> > #include <unistd.h> > > +#include <ipa/ipa_interface.h> > #include <libcamera/event_dispatcher.h> > -#include <libcamera/ipa/ipa_interface.h> > #include <libcamera/logging.h> > > #include "ipa_module.h" > -- > Regards, > > Laurent Pinchart > > _______________________________________________ > libcamera-devel mailing list > libcamera-devel@lists.libcamera.org > https://lists.libcamera.org/listinfo/libcamera-devel
diff --git a/Documentation/Doxyfile.in b/Documentation/Doxyfile.in index db939abc8319..ecc058eec683 100644 --- a/Documentation/Doxyfile.in +++ b/Documentation/Doxyfile.in @@ -791,7 +791,9 @@ WARN_LOGFILE = # spaces. See also FILE_PATTERNS and EXTENSION_MAPPING # Note: If this tag is empty the current directory is searched. -INPUT = "@TOP_SRCDIR@/include/libcamera" "@TOP_SRCDIR@/src/libcamera" +INPUT = "@TOP_SRCDIR@/include/ipa" \ + "@TOP_SRCDIR@/include/libcamera" \ + "@TOP_SRCDIR@/src/libcamera" # This tag can be used to specify the character encoding of the source files # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses diff --git a/Documentation/meson.build b/Documentation/meson.build index a560d02abfa5..4ff3fbeb0674 100644 --- a/Documentation/meson.build +++ b/Documentation/meson.build @@ -21,6 +21,7 @@ if doxygen.found() input : [ doxyfile, libcamera_api, + libcamera_ipa_api, libcamera_headers, libcamera_sources, ], diff --git a/include/libcamera/ipa/ipa_interface.h b/include/ipa/ipa_interface.h similarity index 100% rename from include/libcamera/ipa/ipa_interface.h rename to include/ipa/ipa_interface.h diff --git a/include/libcamera/ipa/ipa_module_info.h b/include/ipa/ipa_module_info.h similarity index 100% rename from include/libcamera/ipa/ipa_module_info.h rename to include/ipa/ipa_module_info.h diff --git a/include/ipa/meson.build b/include/ipa/meson.build new file mode 100644 index 000000000000..a0ce96ba96c3 --- /dev/null +++ b/include/ipa/meson.build @@ -0,0 +1,7 @@ +libcamera_ipa_api = files([ + 'ipa_interface.h', + 'ipa_module_info.h', +]) + +install_headers(libcamera_ipa_api, + subdir: join_paths(libcamera_include_dir, 'ipa')) diff --git a/include/libcamera/meson.build b/include/libcamera/meson.build index a8a38a9b1db7..868f1a6bf1ab 100644 --- a/include/libcamera/meson.build +++ b/include/libcamera/meson.build @@ -8,8 +8,6 @@ libcamera_api = files([ 'event_dispatcher.h', 'event_notifier.h', 'geometry.h', - 'ipa/ipa_interface.h', - 'ipa/ipa_module_info.h', 'logging.h', 'object.h', 'request.h', @@ -18,6 +16,8 @@ libcamera_api = files([ 'timer.h', ]) +include_dir = join_paths(libcamera_include_dir, 'libcamera') + gen_header = files('gen-header.sh') libcamera_h = custom_target('gen-header', @@ -25,7 +25,7 @@ libcamera_h = custom_target('gen-header', output : 'libcamera.h', command : [gen_header, meson.current_source_dir(), '@OUTPUT@'], install : true, - install_dir : 'include/libcamera') + install_dir : join_paths('include', include_dir)) version = libcamera_version.split('.') libcamera_version_config = configuration_data() @@ -36,7 +36,7 @@ libcamera_version_config.set('LIBCAMERA_VERSION_PATCH', version[2]) configure_file(input : 'version.h.in', output : 'version.h', configuration : libcamera_version_config, - install_dir : 'include/libcamera') + install_dir : join_paths('include', include_dir)) install_headers(libcamera_api, - subdir : 'libcamera') + subdir : include_dir) diff --git a/include/meson.build b/include/meson.build index a89c0d7f9e40..42b2453445b5 100644 --- a/include/meson.build +++ b/include/meson.build @@ -1,2 +1,5 @@ +libcamera_include_dir = 'libcamera' + subdir('android') +subdir('ipa') subdir('libcamera') diff --git a/src/ipa/ipa_dummy.cpp b/src/ipa/ipa_dummy.cpp index 4c8b6657689d..9313aabd2db8 100644 --- a/src/ipa/ipa_dummy.cpp +++ b/src/ipa/ipa_dummy.cpp @@ -7,8 +7,8 @@ #include <iostream> -#include <libcamera/ipa/ipa_interface.h> -#include <libcamera/ipa/ipa_module_info.h> +#include <ipa/ipa_interface.h> +#include <ipa/ipa_module_info.h> namespace libcamera { diff --git a/src/ipa/ipa_dummy_isolate.cpp b/src/ipa/ipa_dummy_isolate.cpp index 24434e85d318..cd66626df2df 100644 --- a/src/ipa/ipa_dummy_isolate.cpp +++ b/src/ipa/ipa_dummy_isolate.cpp @@ -8,8 +8,8 @@ #include <iostream> -#include <libcamera/ipa/ipa_interface.h> -#include <libcamera/ipa/ipa_module_info.h> +#include <ipa/ipa_interface.h> +#include <ipa/ipa_module_info.h> namespace libcamera { diff --git a/src/libcamera/include/ipa_manager.h b/src/libcamera/include/ipa_manager.h index 310ce7c85e84..126f8babbc8f 100644 --- a/src/libcamera/include/ipa_manager.h +++ b/src/libcamera/include/ipa_manager.h @@ -9,8 +9,8 @@ #include <vector> -#include <libcamera/ipa/ipa_interface.h> -#include <libcamera/ipa/ipa_module_info.h> +#include <ipa/ipa_interface.h> +#include <ipa/ipa_module_info.h> #include "ipa_module.h" #include "pipeline_handler.h" diff --git a/src/libcamera/include/ipa_module.h b/src/libcamera/include/ipa_module.h index 18e9223f028d..97737587ab3a 100644 --- a/src/libcamera/include/ipa_module.h +++ b/src/libcamera/include/ipa_module.h @@ -10,8 +10,8 @@ #include <memory> #include <string> -#include <libcamera/ipa/ipa_interface.h> -#include <libcamera/ipa/ipa_module_info.h> +#include <ipa/ipa_interface.h> +#include <ipa/ipa_module_info.h> #include "pipeline_handler.h" diff --git a/src/libcamera/include/ipa_proxy.h b/src/libcamera/include/ipa_proxy.h index ac57699be949..72216662e373 100644 --- a/src/libcamera/include/ipa_proxy.h +++ b/src/libcamera/include/ipa_proxy.h @@ -11,7 +11,7 @@ #include <string> #include <vector> -#include <libcamera/ipa/ipa_interface.h> +#include <ipa/ipa_interface.h> #include "ipa_module.h" #include "utils.h" diff --git a/src/libcamera/ipa_interface.cpp b/src/libcamera/ipa_interface.cpp index 9d30da29228f..d7d8ca8881ef 100644 --- a/src/libcamera/ipa_interface.cpp +++ b/src/libcamera/ipa_interface.cpp @@ -5,7 +5,7 @@ * ipa_interface.cpp - Image Processing Algorithm interface */ -#include <libcamera/ipa/ipa_interface.h> +#include <ipa/ipa_interface.h> /** * \file ipa_interface.h diff --git a/src/libcamera/meson.build b/src/libcamera/meson.build index 0706a08b270b..0916bc411360 100644 --- a/src/libcamera/meson.build +++ b/src/libcamera/meson.build @@ -120,7 +120,7 @@ libcamera = shared_library('camera', include_directories : includes, dependencies : libcamera_deps) -libcamera_dep = declare_dependency(sources : [libcamera_api, libcamera_h], +libcamera_dep = declare_dependency(sources : [libcamera_api, libcamera_ipa_api, libcamera_h], include_directories : libcamera_includes, link_with : libcamera) diff --git a/src/libcamera/pipeline/vimc.cpp b/src/libcamera/pipeline/vimc.cpp index f8f91d6219b1..f26a91f86ec1 100644 --- a/src/libcamera/pipeline/vimc.cpp +++ b/src/libcamera/pipeline/vimc.cpp @@ -12,10 +12,10 @@ #include <linux/media-bus-format.h> +#include <ipa/ipa_interface.h> +#include <ipa/ipa_module_info.h> #include <libcamera/camera.h> #include <libcamera/controls.h> -#include <libcamera/ipa/ipa_interface.h> -#include <libcamera/ipa/ipa_module_info.h> #include <libcamera/request.h> #include <libcamera/stream.h> diff --git a/src/libcamera/proxy/ipa_proxy_linux.cpp b/src/libcamera/proxy/ipa_proxy_linux.cpp index f881aab5b2e1..83a7425077ea 100644 --- a/src/libcamera/proxy/ipa_proxy_linux.cpp +++ b/src/libcamera/proxy/ipa_proxy_linux.cpp @@ -7,8 +7,8 @@ #include <vector> -#include <libcamera/ipa/ipa_interface.h> -#include <libcamera/ipa/ipa_module_info.h> +#include <ipa/ipa_interface.h> +#include <ipa/ipa_module_info.h> #include "ipa_module.h" #include "ipa_proxy.h" diff --git a/src/libcamera/proxy/worker/ipa_proxy_linux_worker.cpp b/src/libcamera/proxy/worker/ipa_proxy_linux_worker.cpp index ffba3ae4de80..a10761e52b32 100644 --- a/src/libcamera/proxy/worker/ipa_proxy_linux_worker.cpp +++ b/src/libcamera/proxy/worker/ipa_proxy_linux_worker.cpp @@ -9,8 +9,8 @@ #include <sys/types.h> #include <unistd.h> +#include <ipa/ipa_interface.h> #include <libcamera/event_dispatcher.h> -#include <libcamera/ipa/ipa_interface.h> #include <libcamera/logging.h> #include "ipa_module.h"
The ipa includes are located in include/libcamera/ipa/. This gives an incorrect impression that they are a sub-part of the rest of the libcamera API, while they are the API towards the IPA the same way that include/libcamera/ contains the API towards applications. To clarify this, move them to include/ipa/. The IPA headers are however still part of libcamera, so installing them to ${prefix}/include/ipa/ would make little sense. To fix this, move the application facing API to ${prefix}/include/libcamera/libcamera/ when installed, and the IPA to ${prefix}/include/libcamera/ipa/. When major versions of libcamera will be released, they could then be installed side by side in ${prefix}/include/libcamera-${version}/. Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> --- Documentation/Doxyfile.in | 4 +++- Documentation/meson.build | 1 + include/{libcamera => }/ipa/ipa_interface.h | 0 include/{libcamera => }/ipa/ipa_module_info.h | 0 include/ipa/meson.build | 7 +++++++ include/libcamera/meson.build | 10 +++++----- include/meson.build | 3 +++ src/ipa/ipa_dummy.cpp | 4 ++-- src/ipa/ipa_dummy_isolate.cpp | 4 ++-- src/libcamera/include/ipa_manager.h | 4 ++-- src/libcamera/include/ipa_module.h | 4 ++-- src/libcamera/include/ipa_proxy.h | 2 +- src/libcamera/ipa_interface.cpp | 2 +- src/libcamera/meson.build | 2 +- src/libcamera/pipeline/vimc.cpp | 4 ++-- src/libcamera/proxy/ipa_proxy_linux.cpp | 4 ++-- src/libcamera/proxy/worker/ipa_proxy_linux_worker.cpp | 2 +- 17 files changed, 35 insertions(+), 22 deletions(-) rename include/{libcamera => }/ipa/ipa_interface.h (100%) rename include/{libcamera => }/ipa/ipa_module_info.h (100%) create mode 100644 include/ipa/meson.build