opencv/modules/gapi/src/api
Dmitry Budnikov 7566921364
Merge pull request #17020 from dbudniko:dbudniko/serialization_backend
G-API Serialization routines

* Serialization backend in tests, initial version

* S11N/00: A Great Rename

- "Serialization" is too long and too error-prone to type,
  so now it is renamed to "s11n" everywhere;
- Same applies to "SRLZ";
- Tests also renamed to start with 'S11N.*' (easier to run);
- Also updated copyright years in new files to 2020.

* S11N/01: Some basic interface segregation

- Moved some details (low-level functions) out of serialization.hpp;
- Introduced I::IStream and I::OStream interfaces;
- Implemented those via the existing [De]SerializationStream classes;
- Moved all operators to use interfaces instead of classes;
- Moved the htonl/ntohl handling out of operators (to the classes).

The implementation didn't change much, it is a subject to the further
refactoring

* S11N/02: Basic operator reorg, basic tests, vector support

- Reorganized operators on atomic types to follow >>/<< model
  (put them closer in the code for the respective types);
- Introduce more operators for basic (scalar) types;
- Drop all vector s11n overloads -- replace with a generic
  (template-based) one;
- Introduced a new test suite where low-level s11n functionality
  is tested (for the basic types).

* S11N/03: Operators reorganization

- Sorted the Opaque types enum by complexity;
- Reorganized the existing operators for basic types, also ordered by
  complexity;
- Organized operators in three groups (Basics, OpenCV, G-API);
- Added a generic serialization for variant<>;
- Reimplemented some of the existing operators (for OpenCV and G-API
  data structures);
- Introduced new operators for cv::gimpl data types. These operators
  (and so, the data structures) are not yet used in the graph
  dump/reconstruction routine, it will be done as a next step.

* S11N/04: The Great Clean-up

- Drop the duplicates of GModel data structures from the
  serialization, serialize the GModel data structures themselve
  instead (hand-written code replaced with operators).
- Also removed usuned code for printing, etc.

* S11N/05: Internal API Clean-up

- Minimize the serialization API to just Streams and Operators;
- Refactor and fix the graph serialization (deconstruction and
  reconstruction) routines, fix data addressing problems there;
- Move the serialization.[ch]pp files to the core G-API library

* S11N/06: Top-level API introduction

- !!!This is likely the most invasive commit in the series!!!
- Introduced a top-level API to serialize and deserialize a GComputation
- Extended the compiler to support both forms of a GComputation:
  an expession based and a deserialized one. This has led to changes in
  the cv::GComputation::Priv and in its dependent components (even the
  transformation tests);
- Had to extend the kernel API (GKernel) with extra information on
  operations (mainly `outMeta`) which was only available for expression
  based graphs. Now the `outMeta` can be taken from kernels too (and for
  the deserialized graphs it is the only way);
- Revisited the internal serialization API, had to expose previously
  hidden entities (like `GSerialized`);
- Extended the serialized graph info with new details (object counter,
  protocol). Added unordered_map generic serialization for that;
- Reworked the very first pipeline test to be "proper"; GREEN now, the rest
  is to be reworked in the next iteration.

* S11N/07: Tests reworked

- Moved the sample pipeline tests w/serialization to
  test the public API (`cv::gapi::serialize`, then
  followed by `cv::gapi::deserialize<>`). All GREEN.
- As a consequence, dropped the "Serialization" test
  backend as no longer necessary.

* S11N/08: Final touches

- Exposed the C++ native data types at Streams level;
- Switched the ByteMemoryIn/OutStreams to store data in `char`
  internally (2x less memory for sample pipelines);
- Fixed and refactored Mat dumping to the stream;
- Renamed S11N pipeline tests to their new meaning.

* linux build fix

* fix RcDesc and int uint warnings

* more Linux build fix

* white space and virtual android error fix (attempt)

* more warnings to be fixed

* android warnings fix attempt

* one more attempt for android build fix

* android warnings one more fix

* return back override

* avoid size_t

* static deserialize

* and how do you like this, elon? anonymous namespace  to fix android warning.

* static inline

* trying to fix standalone build

* mat dims fix

* fix mat r/w for standalone

Co-authored-by: Dmitry Matveev <dmitry.matveev@intel.com>
2020-06-26 19:41:29 +00:00
..
ft_render_priv.hpp Implement cv::gapi::wip::draw::FText 2019-12-03 13:13:06 +03:00
ft_render.cpp Fix spelling typos 2019-12-26 06:45:03 -05:00
ft_render.hpp Implement cv::gapi::wip::draw::FText 2019-12-03 13:13:06 +03:00
garray.cpp Merge pull request #14741 from rgarnov:gapi_fix_includes 2019-06-14 19:27:19 +03:00
gbackend_priv.hpp Merge pull request #16031 from aDanPin:dm/streaming_auto_meta 2019-12-03 19:14:13 +03:00
gbackend.cpp Merge pull request #16995 from mpashchenkov:mp/ocv-gapi-standalone-mat 2020-04-21 20:22:01 +00:00
gcall_priv.hpp Merge pull request #13640 from andrey-golubev:gapi_gcallpriv_doc 2019-01-17 20:59:47 +03:00
gcall.cpp Merge pull request #16118 from smirnov-alexey:as/gopaque 2020-01-30 21:08:11 +03:00
gcomputation_priv.hpp Merge pull request #17020 from dbudniko:dbudniko/serialization_backend 2020-06-26 19:41:29 +00:00
gcomputation.cpp Merge pull request #17020 from dbudniko:dbudniko/serialization_backend 2020-06-26 19:41:29 +00:00
ginfer.cpp Merge pull request #15090 from dmatveev:dm/ng-0001-g-api-inference-api 2019-08-05 17:56:34 +03:00
gkernel.cpp Merge pull request #14648 from smirnov-alexey:as/gapi_transform 2019-06-17 16:26:28 +03:00
gmat.cpp G-API: "deownification" corrections 2020-05-12 14:28:32 +03:00
gnode_priv.hpp
gnode.cpp Merge pull request #12674 from dmatveev:gapi_upd270918 2018-09-28 18:42:09 +03:00
gnode.hpp
gopaque.cpp Merge pull request #16118 from smirnov-alexey:as/gopaque 2020-01-30 21:08:11 +03:00
gorigin.cpp Merge pull request #13943 from rgarnov:export_headers_for_backend_development 2019-04-17 21:54:47 +03:00
gorigin.hpp Merge pull request #14741 from rgarnov:gapi_fix_includes 2019-06-14 19:27:19 +03:00
gproto_priv.hpp Fixed standalone build, added cv::gapi::proto::ptr test 2020-04-09 17:19:11 +03:00
gproto.cpp Merge pull request #16995 from mpashchenkov:mp/ocv-gapi-standalone-mat 2020-04-21 20:22:01 +00:00
gscalar.cpp G-API: "deownification" corrections 2020-05-12 14:28:32 +03:00
kernels_core.cpp Merge pull request #16841 from TolyaTalamanov:at/warp-perspective 2020-03-25 11:23:32 +00:00
kernels_imgproc.cpp Merge pull request #17088 from mpashchenkov:mp/ocv-gapi-kernel-laplacian 2020-04-23 17:47:55 +00:00
kernels_video.cpp gapi: buildOpticalFlowPyramid() interface, CPUkernel and CPUtests implementation 2020-04-21 14:36:42 +03:00
ocv_mask_creator.hpp Implement cv::gapi::wip::draw::FText 2019-12-03 13:13:06 +03:00
operators.cpp Merge pull request #14741 from rgarnov:gapi_fix_includes 2019-06-14 19:27:19 +03:00
README.md
render_ocv.cpp Fix render opencv backend text slowdown 2020-02-06 15:12:38 +03:00
render_ocv.hpp Implement cv::gapi::wip::draw::FText 2019-12-03 13:13:06 +03:00
render_priv.hpp Merge pull request #15751 from TolyaTalamanov:at/refactor-render-tests 2019-10-30 13:33:39 +03:00
render.cpp Rm imgproc from render.cpp 2020-03-05 11:41:36 +03:00
s11n.cpp Merge pull request #17020 from dbudniko:dbudniko/serialization_backend 2020-06-26 19:41:29 +00:00

This directory contains implementation of G-API frontend (public API classes).