[Tensors] Add tensor dimensions string for negotiation

Add tensors dimensions string for negotiation.
The default cap form of "other/tenosrs" is

"other/tensors, " \
"rank = (int) [ 1, 4 ], " \
"num_tensors = (int) [1, 65535], "\
"type = (string) { float32, float64, int32, uint32,
int16, uint16, int8, uint8 }, " \
"framerate = (fraction) [ 0/1, 2147483647/1 ]" \
/* Dimensions of Tensors for negotiation */
/* "dimensions = (string)
    dim1:dim2:dim3:dim4, dim1:dim2:dim3:dim4" */

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>

[DIST] RPM Build: Add python build dependency

Although python is implicitly added as build-dep by other packages,
we now uses python explicitly with a few test cases.

Thus, we'd better express it explicitly.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Common/Unittest] move unittest to tests/

TODO: add runTest.sh for tests/common and remove unittest_common from rpm spec.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter/Test] Add regression test for issue #190

Test case with 640x480 --> 320x240 scaler.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter] Fix pad-cap tranform bug

Fixes #190.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Convert/Filter] Add transform size functions

This commit enables allocation-type vmethods, "transform_size" for filter
and updates corresponding comments for converter.

Note that allocation units is not requires as transform size is supplied.

Fixes #26

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Sink] update testcase

1. add test for basesink properties
2. add test for unknown property and signal
3. add signal handle (greater than 0 when successfully connected)
4. add example to get negotiated caps

**Self evaluation:**
1. Build test: [*]Passed [ ]Failed [ ]Skipped
2. Run test: [*]Passed [ ]Failed [ ]Skipped

Signed-off-by: Jaeyun Jung <jy1210.jung@samsung.com>

[Tensors] Fix gst buffer error

In order to keep buffer data to next element after create new buffer,
we have to increse reference count before push the buffer.

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>

[Example Custom Filter] Scaler Example Custom Filter

Added scaler that changes dimension and to meaningful memcpy

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Sink] testcases with base pipeline

1. test code for tensor sink
 - testcases for get/set properties, buffer, render-rate
 - uses simple pipeline
 - can receive buffer after signal connect
2. update cmake for unittest.

**Self evaluation:**
1. Build test: [*]Passed [ ]Failed [ ]Skipped
2. Run test: [ ]Passed [ ]Failed [* ]Skipped

Signed-off-by: Jaeyun Jung <jy1210.jung@samsung.com>

[Test] Add plugin dependency and cmake build check.

- testAPI.sh: using find and gst-inspect-1.0 to check dependency

Signed-off-by: Sewon Oh <sewon.oh@samsung.com>

[CI] Add TAOS-CI config files for nnstreamer

1st
- config files: copy files
- Documentation/ci-config/README.md: describe how to use these files.
- ./README.md: add link ci-config readme file.

2nd
- ./README.md: modify to change line

3rd
- merge: some files are added.
- Documentation/ci-config/README.md: command change to link ci-config folder

Signed-off-by: Sewon Oh <sewon.oh@samsung.com>

[Code Clean] tensor_fitler clean up

- Remove debugging-only code
- Code clean for repeated expressions & debug prints
- Remove unnecessary code blocks

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

Added how to use test cases in Documentation folder

This PR is to append how to use test cases in Documentation folder
because the instruction contents of test cases has been increased gradually.

**Changes proposed in this PR:**
1. Added test case document in Documentation directory

**Self assessment:**
1. mark-down test: okay

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

Added getting-started document in Documentation folder

The content of `Getting Started` section is too big in README.md file.
This PR is to create getting-started mark-down document in Documentation folder.

**Changes proposed in this PR:**
1. Added getting-started.md file
2. Updated README.md

**Self assessment:**
1. mark-down test: okay
2. gbs build: okay

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[Tests] Added check function to inspect dependent commands

This PR is to append a dependency check routine to inspect the required
packages are install before starting tests/testAPI.sh

**Changes proposed in this PR:**
1. Added dependency check function
2. Applied shell commands with checkDependency()
   - gst-launch-1.0, cmp, dirname, basename, sed, and find

**Self assessment:**
1. gbs build: okay
2. local test: okay

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[Tensors] Complete Set of Test Case for Tensors

Test Case is:
  1. generate random png (RGB, 640x480)
  2. read x-raw from png
  3. Make Three Tensors (gsttesttensors)
     . R Tensor [1][640][480][1] : Size 307200
     . G Tensor [1][640][480][1] : Size 307200
     . B Tensor [1][640][480][1] : Size 307200
     . num_tensors : 3
     . glist dimensions : tensor_dim type([1][640][480][1]) x 3

- Add generate golden data from python code
- Add tar for the tizen rpm pacakging
- Add binary difference check
- Modify tensor_meta to work right

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>

[Filter/Main] Fully support flexible (sink->src) dimension

Fixes #153, thus fixing #71 as well.

Added a test case to prevent regression

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter/Custom] Support flexible dimension

- Allow to configure input/output dimension in run-time.
- After pad-cap negotiation, if gstremaer somehow fixes input-dimenson,
 a filter subplugin can configure output-dimension accordingly.
- An example custom filter, "passthrough_variable", supports any
 arbitrary tensor for passthrough operations.
- Filter/Main and Filter/Custom has been amended during the development
 of the example custom plugin.

FOUND BUG (mentioned as "known bug" in the code):
- If GST-BaseTransform tries to fixate pad-caps without getting
 any hints on the input dimension, fixate vmethod fixes the input
 dimension to 1:1:1:1. We need to implement non-fixed pad-cap
 declarations in fixated vmethod.
- The disabled test case #4 in tests/nnstreamer_filter_custom
 is the corresponding regression detector.
- However, this bug is to be fixed with another commit.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Git Infra] pre-commit to filter styles

If you want to know if there is coding style errors
before actually creating a commit, use this pre-commit by
copying common/pre-commit to .git/hooks/

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Sink] add properties and signals

1. emit signals when new buffer received, start/end stream event.
2. add properties for signals and render rate.
3. add caps callback from basesink.

**Self evaluation:**
1. Build test: [*]Passed [ ]Failed [ ]Skipped
2. Run test: [ ]Passed [ ]Failed [* ]Skipped

Signed-off-by: Jaeyun Jung <jy1210.jung@samsung.com>

[CI/Unit test] Integrate unit test with cmake.

Test command: ctest -V (you can do after 'make', -V means log output)
- ./CMakeLists.txt: add subdirectory and enable test
- test/CMakeLists.txt: add unit test
- testAll.sh: using `dirname $0` to solve path problem
- testAPI.sh: same as testAll.sh
- debian/control: add dependency for unit testing

Signed-off-by: Sewon Oh <sewon.oh@samsung.com>

[Convert] Memory Handling Fixed

1. Added g_free() to an allocated pointer.
2. Added transform_size() to allow gst framework to allocate
the exact amount needed for output buffer in non-in-place mode.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter/Main] Guarantee calling "open" before all other callbacks.

Added "open" virtual methods for tensor_filer subplugins.

TODO: guarantee calling "close" at the end.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Common] Code Clean for common libraries

1. Install tensor_common.a to devel packaging so that external custom plugins may use tensor-common libraries
2. Rearrange headers, straighten up the dependencies
3. Add cap-to-dim API.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter/tflite]Add skeleton code for load model file

add skeleton code for load model file of tensorflow lite subplugin
additional implement will be done after applying cpp api of tensorflow lite
could be used in tensorflow_lite_filter.c

Signed-off-by: jinhyuck <jinhyuck83.park@samsung.com>

[CI/UnittestCoverage] Exclude tests

Do not check unittest coverage of tests/*
Limit the coverage target to gst, nnstreamer_example, include, common.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Documentation] update readme with the progress details

The "known bug" is already fixed.
Add progress updates.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter/Main] Support implicit dimension declaration

If a subplugin of tensor-filter has declared input/output dimension
with getInputDimenion/getOutputDimension, configure tensor-filter
with such values.

This prepares for configuring dimesions based on pad-cap negotiations as well.
(There are a few TODOs to fully support it)

This does about half of #144 .
Added a test case for implicit dimension declaration as well.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Readme] Fix typo

Multi model --> Multi modal
(multiple heterogeneous input sources for NNs; e.g.. cameras and mics)

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[TensorMeta] Add utility functions to manipilation of tensors (#158)

* [TensorMeta] Add utility functions to manipilation of tensors

Add Utility functions
- gst_make_tensors
- gst_get_tensor
- gst_get_tensordim
- gst_remove_tensor
- gst_get_num_tensors

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>
* [Tensors] Add Tensors Generation Testcase

Add Testcase to generate Tensors
 - gsttesttensor
    . take video/x-raw ( RGB type )
    . generate three [1][642][480][1] dimension tensor
    . generate tensors with GstTensorMeta

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>
* [Tensors] Add Tensors Check Element

In order to check tensors in downstream element, tensorscheck element
is added.
In this element, "other/tensor" type is in sink pad and check if it is
tensors and merge three tensor into one RGB original tensor.

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>
* [Tensors] Add test for the tensors in tests directory

In order to test tensors, gstreamer pipeline test is added as below.

filesrc location=testcase01_RGB_642x480.png ! pngdec ! videoscale !
imagefreeze ! videoconvert !
video/x-raw,format=RGB,width=642,height=480,framerate=0/1 !
testtensors silent=TRUE ! tensorscheck silent=TRUE ! filesink
location=\"testcase01_RGB_642x480.nonip.log\" sync=true

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>

[Documentation] Added maintainer & committers

This PR is to append the maintainer(s) and committer(s) that were proposed
at `STAR-SteeringCommitte` as follows.

* [STAR On Device] nnstreamer Repo Creation Proposal
   * https://github.sec.samsung.net/STAR/STAR-SteeringCommittee/issues/17

**Changes proposed in this PR:**
1. Added maintainer & committers
2. Updated mark-down template
3. Updated some statements for readability

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

Renamed file name to display license info at webpage

This PR is to replace `LICENSE.LGPLv2.1` with `LICENSE` in order to
display official license of this repository automatically.

**Changes proposed in this PR:**
1. Replaced LICENSE.LGPLv2.1 with LICENSE
2. Updated nnstreamer.spec

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[Doxygen] Added how to write doxygen tags

This PR is to add how to write doxygen documents in the source code.

**Changes proposed in this PR:**

Ver2:
2. Added addtional case studies for C/C++ code

Ver1:
1 Added how to write doxygen tags

**Self assessment:**
1. GBS build: okay
2. mark-down test: okay

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[Filter] Flexible input/output dimension, prep data structure

In order to allow flexible input/output dimension for subplugins,
prepare proper data structure and virtual method, "setInputDimension

Additional mod: constify Gst_Tensor_Filter for subplugins

CC: @jinhyuck83-park @hello-ahn : I need your opinion on this vmethod update.
Preparing #71

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Sink] register sink plugin

Update code to register tensor sink plugin.
1. added plugin registration
2. refactor code for interface (later work)

**Self evaluation:**
1. Build test: [*]Passed [ ]Failed [ ]Skipped
2. Run test: [ ]Passed [ ]Failed [* ]Skipped

Signed-off-by: Jaeyun Jung <jy1210.jung@samsung.com>

[Merge Error Fix] Missing Merge Conflict Resolve.

There were a few missing spots in the previous merge conflict resolve.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[TensorMeta] Change TensorMeta -> GstMetaTensor

- Change Tensor Meta from TensorMeta to GstMetaTensor for more general.
- Add GstMetaTensor in tensor_converter and tensor_decoder and tested.
  . For now, GstMetaTensor->num_tensors is set as 1 in
    tensor_converter and included in GstBuffer.
  . GstBuffer is sent through pipeline and this meta data can get in
    tensordec.

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>

[Sink] update doxygen

Add doxygen eitries and fix doxygen issue.

**Self evaluation:**
1. Build test: [*]Passed [ ]Failed [ ]Skipped
2. Run test: [ ]Passed [ ]Failed [* ]Skipped

Signed-off-by: Jaeyun Jung <jy1210.jung@samsung.com>

[Sink] Add template for buffer and QoS event

1. add function to handle buffer
(render and render_list in BaseSinkClass)
2. add template to set QoS event

Signed-off-by: Jaeyun Jung <jy1210.jung@samsung.com>

[Documentation] Added development guide of nnstreamer

This PR is to append some mark-down documents to develop
nnstreamer source code consistently.

Original documents is mirrored from TAOS-CI repository.
Thane, modified the document for nnstreamer project.

**Changes proposed in this PR:**

* Version 3:
1. Removed Python rule
2. Updated how to run gst-indent before submitting PR

* Version 2:
1. Replaced a manual indent command with ./common/gst-indent script

* Version 1:
1. Added coding convention document
2. Added how to contribute code
3. Added generation script to create TOC automatically
4. Added how to archive large data for evaluation
   (In this case, another repository has to be created for only large data.)

**Self assessment:**
1. gbs build: okay
2. markd-down generation: okay

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[Doxygen] Add doxygen entries for common headers and conveter

To comply with doxygen, a few more entires are added.
Hope this will help developers using common headers.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[TensorMeta] Add Tensor Meta Data for GstBuffer

In order to deal with other/tensors, we need GstBuffer which includes
multiple GstMemory for Tensors and GstMeta to describe offset and etc.

This is the first draft commit for the GstMeta for Tensor, say
TensorMeta.

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>

[Code Clean] Type naming & constify

1. We still had "uint32_t *", which should've been replaced by "tensor_dim"
2. Constify input tensor. Incorrect usage will generate compiler errors later :)

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

Added legacy issue template

This PR is to support compatibility of issue template between different github versions.

**Changes proposed in this PR:**
1. Added legacy issue template

**Reference:**
* Legacy issue template: ./.github/ISSUE_TEMPLATE.md
* Up-to-date issue template: ./.github/ISSUE_TEMPLATE/{Bug_report.md|Feature_request.md|Support_request.md}

* Our request for github.sec.samsung.neet:
   * https://github.sec.samsung.net/SERVICE/GitHub/issues/124

**Self assessment:**
1. GBS build: okay
2. Local test: okay

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[License] Remove apache-2.0. Unify to LGPL-2.1

Please use LGPL 2.1 for all files

Fixes #130
Fixes PROTEX mismatches

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

Updated README.md to fix pdebuild issue

Fix issue #127.
This PR is to solve unexpected build issues when users try to run
`pdebuild` command to do Debian packaging of nnstreamer source.

**Changes proposed in this PR:**
1. Replaced **```** with **```bash**
2. Added how to create a base tarball with correct apt repository
3. Updated how to use pdebuild to avoid build errors
4. Used OTHERMIRROR instead of MIRRORSITE to handle lots of cases

**Self assessment:**
1. Local test with Ubuntu 16.04 (Xenial): Okay
2. GBS Build: Okay

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[Code Clean] Use common functions / typedef.

There had been a few new common functions/typedef introduced.
Use them!

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Decode] Minor code refactoring to save mem and cpu

We do not need to allocate 1024 bytes for RGB/BGRx/Progressive keywords
We do not need to do strcpy for setting such values, either.

Later, we may commonize such keywords into include/*.h

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Documentation] Updated how to build nnstreamer

This PR is to update the existing build manual in order to help nnstreamr users.

**Changes proposed in this PR:**

* Version 2:
1. Applied the comments of @myungjoo-ham

* Version 1:
1. Removed Unnecessary statements to avoid complicated explanation
2. Added links for `gbs` and `pdebuild` command
3. Updated the expressions.

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[CI/indent] Fix indent bug

- *.c: add semi-colon to end of function GST_PLUGIN_DEFINE

[Decoder] Support the case which is not divided by 4.

If the width of tensor is not divided by 4, it should be padded
with (width % 4). In that case, we should use not use in-place
calculation.

- Add gst_t2c_transform() to add padding
- Add more test cases. (RGBx_642x480, RGBx_640x480, RGB_640x480)

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>

[Sink] initial commit for basesink template (#117)

* [Sink] initial commit for basesink template

Add base template for tensor_sink.
This PR does not include cmake changes, also does not include testcase.

Signed-off-by: Jaeyun Jung <jy1210.jung@samsung.com>
[Squahed by: MyungJoo Ham <myungjoo.ham@samsung.com>

Remove unnecessary build dependent package

Fixes issue #118.
This PR is to remove unnecessary a build dependent package such as plugins-good-dev.

**Changes proposed in this PR:**
1. Removed libgstreamer-plugins-good1.0-dev package from Build-Depends statement

**Self assessment:**
1. GBS build: okay

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

Created gst folder that maintains all modules for consistency and efficiency

This PR is to crate `gst`folder to maintain all modules in same folder.
* Reference: https://github.com/GStreamer/gst-plugins-good/tree/master/gst

**Changes proposed in this PR:**
* Version2:
1. Fxied tests folder

* Version1:
1. Created 'gst' folder
2. Moved all modules (e.g., tensor_***) to 'gst' folder
3. Modified CMakeLists.txt

**Self assessment:**
1. GBS build: okay
2. Debian build:
   - Cmake test: okay
   - mk-build-deps test: okay

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

Replaced project name from audri to nnstreamer

This commit is trivial.
This PR is to replace project name from `audri` to `nnstreamer` in nnstreamer.spec.

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[Filter/Custom] Expose filter properties to custom filters

In order to let custom filters to be flexible,
they need to be aware of filter/main's properties (e.g., pad caps).

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

Fix typo in nnstreamer.spec for gcov report

This commit is trivial.

**Changes proposed in this PR:**
1. Fixed incorrect project name in nnstreamer.spec file
* before: AuDri
* After: nnstreamer

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[Common] Provide err_print() and debug_print()

1. Add err_print() and debug_print() for all elements in nnstreamer.
2. Replace dirty logging usages in all current elements.

For later commits in nnstreamer, I'll reject the direct usage of log/print.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Readme] update how-to-build guide for self-hosting

Added more information on how to prepare to build nnstreamer in your local pc environment.

Fixes #103

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter] Refactor properties: remove "debug".

Silent = !Debug. We do not need to have the two properties.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[All Filter] "silent" is TRUE by default.

We are going to turn it off only when we are doing debugging.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[DIST] Debian packaging

Support debian packaging. Use debuild or pdebuild to generate deb packaging

Note that debian packaging does not include unit-test / golden-test and
it does not execute them in the build process either.

Please include it later.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter/Main] Add "Custom" Property

Added "Custom" property so that each sub-plugins may get properties
from users (gst apps) directly.

Partially addresses #71

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Test] Add GstFailTest API

For unit-testing, we need to execute failing cases, where graceful exit is required.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Readme] update how-to-test guide

We not have a central testing service at /tests/. Update README accordingly.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[CI] Add template for Issue & PR

This PR is to create a template to automate issue and PR process.
It is cloned from https://github.sec.samsung.net/STAR/TAOS-CI/tree/tizen/.github

**Changes proposed in this PR:**
1. Added issue template
2. Added PR template

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[SINK]Update README file of tensor_sink

Update README file if tensor_sink for first commit to nnstreamer

Signed-off-by: jinhyuck <jinhyuck83.park@samsung.com>

[CI] Add CI server web-address for nnstreamer

This PR is to append web-address of nnstreamer CI service and enable
the nnstreamer CI server.

**Changes proposed in this PR:**
1. Added webpage link for nnstreamer

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[Codeowners] Update. Add all members for reviewers

- Add all members to reviewer list
- Update the comments

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Common] Add .gitignore

Ignore the following files in the git repo:
- cmake build
- golden test generated files
- vi files
- binary (object) files
- ctag

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Decoder] Fix the Bug (#94) and Delete check for SRC direction

- Fix the missing memeory free (#94).
- Delete Check for the GST_PAD_SRC direction. The SRC is ANY, it can
  be Any format and the Sink should be TENSOR Type. Therefore it just
  return GST_TENSOR_CAP_DEFAULT GstCaps.

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>

Doxygen: Create the main page for doxygen generation

This PR is to create the introduction of Main Page  at HTML-based doxygen document.
(e.g., http://aaci.mooo.com/nnstreamer/html/)

**Changes proposed in this PR:**
1. Added Main Page tag

**Self assessment:**
1. GBS build: Okay
2. Local test: Okay

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>

[Transform] Add tesnsor_transform makrdown title for commit testing

- README.md: add title line makrdown file in tensor_transform folder

[Decoder] Remove unneeded blank line

This patch just removes a unneeded blank line.

Signed-off-by: Wook Song <wook16.song@samsung.com>

[Tensor Decoder] Add test case

Add test case for Tensor Decoder. Currently test case which width is
not divided by 4 is not supported.

- Add RGB 640x480

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>

[Converter/Filter] Migrate all testcases into the central test mechanism.

Move rest of tensor_converter/test/* to tests/nnstreamer_converter

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Style] ANSI-C89 Comment Style

https://gstreamer.freedesktop.org/documentation/frequently-asked-questions/developing.html#what-is-the-coding-style-for-gstreamer-code
states:

  Comments should be in /* ANSI C comment style */ and code should generally be compatible with ANSI C89, so please declare all variables at the beginning of the block, etc.

Thus, we have updated commenting style.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Style] Apply gst-indent results to all *.c files

nnstreamer.git$ for x in `find -name *.c`; do common/gst-indent $x; done

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Example] Remove examples. They are useless.

The files are already published in the tutorial web site.
We do not need gst examples in nnstreamer git.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Common] Import gst-indent script from Gstreamer mainline.

Use the script to do coding style check.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Test F/W] gst-launch-based test framework v 1.0

nnstreamer_filter_custom is the example test group.

How to use:
- Add a subdirectory under /tests/ representing a test case group
- In the created subdirectory, write "runTest.sh" with given APIs in testAPI.sh

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[converter, filter] Reduce log messages

Emit debug/log messages when proper options are given only.
Do not write such messages when no options are specified.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Dist] Run unittest for filter/custom/1 with gbs

Add the new filter/custom/1 testcase as a unittest during the build

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter/Custom] Add testcase. Fix bugs found by the testcase.

1. Added "passthrough with 3x280x4 tensors" Custom Filter Example
2. Added test case with the example.
3. Fixed filter/custom bugs with the test case
4. Relocated headers and their install paths

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter/Main] First working prototype of filter::main

The full execution path of tensor_filter::main is tested with testcase-01
although it does not process anything in the model.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Decoder] Tensor Decoder Draft

The Tensor Decoder revert tensor to media type.
It takes tensor as input and produce media data type. Currently only
video/x-raw supports.

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>

[Filter/Main] Caps Negotiations Implemented

It appears that the simple test case of "videosrctest --> t_converter --> t_filter --> fakesink" works up to caps-negotiations & fixating caps.

Test Case:

gst-launch-1.0 -v --gst-debug=GST_CAPS:4 --gst-plugin-path=${PATH_TO_PLUGIN} videotestsrc num-buffers=1 ! video/x-raw,format=RGB,width=280,height=40,framerate=0/1 ! videoconvert ! video/x-raw, format=BGRx ! tensor_converter silent=FALSE ! tensor_filter debug=TRUE framework='tensorflow-lite' model='./nothing' input='4:280:40' inputtype='uint8' output='1' outputtype='uint8' ! filesink location="test.bgrx.log" sync=true

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter/Main] Restrict pad-caps when set-property gives enough information.

With dimension/type information is available via set-property,
restrict pad-caps accordingly before calling set-caps callbacks.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Documentation] How to write test cases

1. How to write gst-launch based test cases
2. How to write gtest based test cases

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Converter] Fix non-in-place (memcpy mode) and add test case for it.

Non inplace mode (memcpy mode) is fixed and tested.

Testcase 03 for converter tests memcpy mode.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Common] Commonize default pad-caps for other/tensor

We may be changing the default pad-caps for other/tensor later.
Make it refer to the same code.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Bug Fix] Using memmove for in-place calculation

Sometimes there is undefined behavior when the source and destination overlaped.
In this case, we have to use memmove to handle overlapping regions.

Signed-off-by: jijoong.moon <jijoong.moon@samsung.com>

[Filter/Custom] Custom tensor postprocessing support

NN developers may define their own custom tensor operations
in the format given byu tensor_common to let NNStreamer
do any custom operations on the tensor stream.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter/Main] Parse all properties.

1. Complete property parsing code
2. Did a little bit of refactoring & doxygen entry filling

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Unittest] Enable unittest coverage anaysis

Use TAOS-CI to generate unittest coverage analysis html pages.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Common] Add dimension property parsing API

Let's use dimension parsing API in tensor_filter

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Common] Add get_tensor_type, find_key_strv internal API.

1. Added get_tensor_type API for plugins to parse properties
2. Added unittest cases.

get_tensor_type may be implemented with find_key_strv, but, let's
use this "faster" for type property finder.

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Filter] Add more property processing

1. Filter/Main: add property handling for more properites
2. Filter/TF-Lite: updated callback definitions

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>

[Convert] Support RSTRIDE = RU4 Cases (RGB && width%4>0)

Most (if not all) video/x-raw formats align data with 4-bytes for each
image row.

E.g., if image width = 642 and colorspace = RGB, video/x-raw adds
two zero-bytes for each row's end.

The tensor array should not have such zero-padding; thus
this commit supports zero-padding removal.

However, such operation costs one additional full memcpy; thus,
having such stream input must be discouraged.

This commit includes:
1. Support zero-padding removal
2. Added warnings when zero-paddings exists in the source streams.

Fixes #7

Signed-off-by: MyungJoo Ham <myungjoo.ham@samsung.com>