[TensorMux] Code rewriting with GstCollectPads

In order to dealing wiht input stream, it is better to use
GstCollectPads. Therefore most of the codes are rewritten and
restructured.

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

[Test] move methods to generate test img

to remove duplicated methods (for generating bmp) in testcase, move all
generating functions to gen24bBMP.py.

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

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

[Tests] Fix bug, errors ignored

Bug:
- When there is no log files, a test results in "PASSED"
- When there is differences between golden and test, the result sasy "PASSED"

Fixes #275

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

[Filter/tflite]Add tensorflow lite method with core apis

add tensorflow lite sub plugin method by calling tensorflow lite core apis
in cpp file of tensor flow lite

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

[GIT] Add bmp file to .gitignore

Ignore bmp file created by tests

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

[Documentation] Update getting-started.

As we now depend on tensorflow-lite-dev, update
pdebuild configuration accordingly.

Fixes #269

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

[Filter/TF-Lite] update the methods for get in/out dimension of tensors

1. by using memcpy, improve the robustness
2. when upper layer call get in/output tensor dimension, return data type of tensor rather than length. because the length is fixed with NNS_TENSOR_RANK_LIMIT

Signed-off-by: HyoungjooAhn <hello.ahn@samsung.com>

[Mux] Fix build break during merging asynchronously.

Resolves conflicts between #300 and #283

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

[Test] Remove dependencies on PIL and .tar.gz files

To remove build dependencies on PIL,
we implement bmp-write in the test framework.

Then, the test script will convert BMP to PNG with
bmp2png implementation based on libpng.

This eliminates all fancy dependencies
not portable to embedded SW platforms.

Fixes #266

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

[CMAKE] Set timeout property in ctest.

To prevent ctest from getting too long, set timeout property value to 120seconds.

Add more hint.

Resolves: #284

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

[Code Clean] Comments Cleaned Up

This is part of #169

A few comment lines were cleaned up (Style Fixes)

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

[Code Clean] Use common function / Remove unnecessary code

- Use get_tensor_from_padcap to read tensor info from padcap.
- Expand the capability of get-tensor_from_padcap for framerate.
- Remove nnfw_support_status

This is start of #169

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

[Example Apps] Build example apps out of nnstreamer context

Build example_* apps in tizen build environment without nnstreamer
build environment as if nnstreamer is already in Tizen and
the apps are regular Tizen apps.

In order to do this:
- Add nnstreamer_testapp.spec: try gbs build --spec nnstreamer_testapp.spec to build test apps only
- Add INSTALL_EXAMPLE_APP option to install example apps optionally.
- Add tizen_app_build_example CMakeLists.txt to build example apps seperatedly.
- Added format dependencies on gstreamer-app-1.0

With this we can ensure that nnstreamer-based apps can be built completely without nnstreamer source codes and we can verify packaging of nnstreamer-devel.

Fixes #262 for Tizen.

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

[Test/Example] add python example / code clean

1. add python example to link nnstreamer plugin
2. update document to run examples
3. remove unnecessary code

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

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

[TensorMux] Append GstMemory according to the setcaps order

There was potential bugs due to saving without considering setcaps
order. Previously, the tensors meta is not consisitent with saving
GstMemory in outbut buffer. Because it was not considered the order of
save GstMemory from sink. Mostly it is because gstreamer is working by
asynchronous manner. Therefore _get_tensor_order which give right
order to save is added.

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

[Filter/TF-Lite] make model path as const

changing model path at tflite core is prevented by using const

Signed-off-by: HyoungjooAhn <hello.ahn@samsung.com>

[TensorMux] Remove lock in tensor_meta

There is no need to have lock in tensor_meta. Therefore remove them.

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

[debuild/pdebuild] Enable a parallel build by default for debuild command

* Resolves: issue #284 (sub-issue 1. -j1)

This commit is to enable a parallel build for debuild command by default.

According to debhelper manual:
If your package can be built in parallel,
please either use compat 10 or pass --parallel to dh. Then dpkg-buildpackage -j will work.
* https://manpages.debian.org/testing/debhelper/dh.1.en.html

**How to evaluate:**
* debuild
```bash
export DEB_BUILD_OPTIONS='parallel=8' ; time debuild -us -uc  ;  export DEB_BUILD_OPTIONS=""
```
* pdebuild
```bash
export DEB_BUILD_OPTIONS='parallel=8' ; time pdebuild  ;  export DEB_BUILD_OPTIONS=""
```

**Self assessment:**
* 1. before this PR:
```bash
make[2]: Leaving directory '/var/www/temp-archive/nnstreamer/build'
/usr/bin/cmake -E cmake_progress_start /var/www/temp-archive/nnstreamer/build/CMakeFiles 0
make[1]: Leaving directory '/var/www/temp-archive/nnstreamer/build'
   dh_auto_test -O--buildsystem=cmake -O--builddirectory=build -O--parallel
        make -j1 test ARGS\+=-j1
make[1]: Entering directory '/var/www/temp-archive/nnstreamer/build'
Running tests...
/usr/bin/ctest --force-new-ctest-process -j1
Test project /var/www/temp-archive/nnstreamer/build
    Start 1: unit_test
```

* 2. after this PR:
```bash
make[2]: Leaving directory '/var/www/temp-archive/nnstreamer/build'
/usr/bin/cmake -E cmake_progress_start /var/www/temp-archive/nnstreamer/build/CMakeFiles 0
make[1]: Leaving directory '/var/www/temp-archive/nnstreamer/build'
   dh_auto_test -O--buildsystem=cmake -O--builddirectory=build -O--parallel
        make -j8 test ARGS\+=-j8
make[1]: Entering directory '/var/www/temp-archive/nnstreamer/build'
Running tests...
/usr/bin/ctest --force-new-ctest-process -j8
Test project /var/www/temp-archive/nnstreamer/build
    Start 1: unit_test
```

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

[CI/config] Update CI-config files to the latest version.

update CI-config files to the latest version.

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

[TensorMux] Add types varible handle

There are a lot of cases which types are differ. Therefore proper
type handling is requried when the tensors is generated.
In order to do this, gst_push_tensor is added.

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

[Dist/Debian] Enable tensorflow-lite

Use tensorflow-lite in debian build (for Ubuntu)

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

[TensorMux] Add 3 Test Cases

Add three test cases.
- one tensor sink pad --> mux --> tensors
- two tensor sink pads --> mux --> tensors ( two gstmem )
- three tensor sink pads --> mux --> tensors ( three gstmem )

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

[Example] initial commit for tensor stream from cam

prepare demo app,
1. pipeline displays video frame from cam
2. add textoverlay to indicate result
3. should update tensor filter later

Related issue #197.

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

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

[Sink/Example] change sink caps / property

1. change sink pad caps (any > other/tensor)
2. change property type and name (signal-rate)
3. remove unnecessary functions and params
4. add testcase for caps nego failed

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

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

[TensorMux] Remove memcopy

No need to use memcopy to make tensors buffer. gst_buffer_get_memory
is used to extract the mem from in buffer and use it after increase
ref count.

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

[Test] Allow to execute tests of a single category.

We now can execute a single "runTest.sh" instead of
"testAll.sh"

Fixes #188

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

[Test] GenBMP python module

Write BMP files based on the string input.
Addresses #266 partially.

Tested with locally modified nnstreamer_converter cases.

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

[Transform] Add testcase for dimchg, 0:b cases.

Add unittest cases for transform/dimchg where
option is 0:b.

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

[TensorMux] Documentation of Section header in source code

Add tensromux refsec in source code

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

[TensorMux] Making Output buffer for tensors

After caps negotiations, we need to make tensors buffer and generate
meta for "other/tensors".

@TODO : Need better way to handle threads

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

[Dist] LD Path Error Fix

- Run unittest after install and set LD_LIBRARY_PATH to the install path
- Run ldconfig at install/uninstall

Fixes #246

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

[Filter/TF-Lite] add the invoke function

the scratch invoke function is updated.
the index array has the name ~_list and the length variable has ~_len
use filling input parameter rather than return the pointer
move the real definitions code to .cc

Signed-off-by: HyoungjooAhn <hello.ahn@samsung.com>

[CMake] Fix cmake bugs

1. Use C++11 (moving to 14 is ok if you really want it)
2. Fix link direction reversal issue

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

[Example] update document for example

1. add videoscale example (example_cam)
2. remove unnecessary header-include (example_cam)
3. update document to build and run examples

Related issue #255.

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

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

[Transform] Initial draft implementation of DIMCHG.

DIMCHG mode of tensor_tranform implemented.

Testcases will be added later.

Partially addresses #248 (need test cases to close it!)

(This code is only minimally tested with gst-launch-1.0 and vbindiff.)

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

[Decoder] Add stream test case

Add the basic small 10-frame PNG stream test case.
Please refer to this scheme when you expand the test cases.

Fixes #160

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

[License] Clean up bolierplates

- Remove alternative license (MIT) from boilerplate; apply LPGL 2.0+ for all
- Shorten the license statement.

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

[Transform] Skeleton with dimchg mode.

other/tensor result of tensor_converter from video/x-raw is
not compatible with most neural network image input dimensions.

Thus, we need tensor-transform ASAP to test with real
NN models.

This prepares such cases.
Cap negotiation codes will follow soon as another commits.

Partially addresses #248

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

[License] Clean up license statements

LGPL-2.1 is the default license for gst plugins.

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

[Example] application for webcam

1. add test pipeline for webcam.
2. use video-mixer to mix two video frames.

add tensor_filter and change pipeline later.

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

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

[Sink] update example code

1. change to video live stream test.
2. remove unnecessary element in test pipeline.
3. fix doxygen error.

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

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

[CI/Doxygen] Apply advanced rule

- Remove unused file: config-cibot.json
- Update config files for applying advanced doxygen rule

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

[TensorMux] Set Capability & using private date for sink pad

Added vmthods
- gst_tesnor_mux_request_new_pad : set new sink pad & call setup
- gst_tensor_mux_release_pad : release pad
- gst_tensor_mux_setup_sinkpad : initialize pad
- gst_tensor_mux_chain : actual calculation of buffers
- gst_tensor_mux_setcaps : set capability
- gst_tensor_mux_sink_event : event handling ( cap, segment, start )
- gst_tensor_mux_dispose : dispose tensor mux
- gst_tensor_mux_change_state : state handler

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

[Filter] Support fixed framerate

Do not declare framerate in filter. Use whatever the input source uses.
Added 30fps stream test case for tensor_filter custom filters

Fixes #159
Fixes #240
Prepares #160

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

[DIST/Build] Fix bugs of tensorflow-lite on/off control

- Fixed typo
- Added compiler preprocessor definition control
- Code clean

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

[Filter] Allow to allocate outbuf in invoke().

Because tensorflow allocated output buffer in the tensorflow context,
allocating output buffer in gstreamer side incurs additional memcpy.

Thus, allow to generate GstBuf of Sink-Pad from the memory allocated
by filter's "invoke" method.

Fixes #161

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

[Test Framework] Do not printout clutters.

When everything is alright, you don't need to log such.

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

[CI/Doxygen] Change capital letter to small letter

Capital letter doxygen tag change to small letter
Doxygen can't use /* */ and capital letter tags.

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

[Testcase] Increase # frame to 10 from 6.

The stream test case is required to have at least 10 frames.
Increase the number of frames.

This prepares #160

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

[Filter/TF-Lite] upload the tensorflow lite core

some of main functions are uploaded

Signed-off-by: HyoungjooAhn <hello.ahn@samsung.com>

[Filter/Main] Allow to define dimension methods freely

Loosen dimension declaration methods conditions.
A subplugin may now define all three methods and behave
differently in runtime.

Fixes #231

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

[Sink] add examples for sink element

1. add simple example for data callback from sink
2. add video play example using gst app
3. update cmake (does not install sample app)

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

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

[Filter] Change vmethod prototype to return outptr.

To prepare subplugin output pointer allocation (#231),
change the vmethod (invoke_NN) prototype.

This prepares #231.

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

[CI/Build] Add armv7l build test

This commit for adding arm build test.
Add pr_comment_notice option if you want notice that value change to 1

** change logs **

Version 2:
- Change pr_commnet_notice value to 1 for notice

Version 1:
- config-environment.sh: add build and notice option

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

[Filter/Main] Add detailed doxygen entries for internal APIs

Added detailed doxygen entries for internal API users.
CC: @jinhyuck83-park @hello-ahn
Fixes #227

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

[Filter/tflite]Add skeleton for tflite sub-plugin

add skelton code for tflite sub-plugin
"open", "close" and "setinputdimension"

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

[Convert/Test] Add stream test case

Adds 6-frame 16x16 png stream test case for tensor_converter.
This shows how to create a deterministic video stream test case
for nnstreamer.

Partially addresses #160

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

[PkgConfig] Fix pkgconfig information

- Fix incorrect include path.
- Updated comments for better readability (for custom plugin writers)

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

[Sink] update sink query

1. remove format query
2. block seek query

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

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

[CI/FIX] Change ci option to fix bug

This commit is to fix wrong build message and result.

- config-plugins-audit.sh: fix duplicate build running
- config-plugins-format.sh: remove unnecessary test

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

[TensorMux] Skeleton for the Tensor Muxer

In oder to muxing tensors, we need tensor muxer. It takes as many as
"other/tensor" (currently 16 is max) and make it "other/tensors".
Therefore there are multiple sink pad of tensor and one source pad for
tensors.

Also we may need to enable how we concate the tensor. Maybe direction
property is needed.

- Add CMakeList.txt
- Add gsttensormux.c
- Add gsttensormux.h
- Modify nnstreamer/CMakeList.txt

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

[Filter/Custom/Example] Add unittest case for "Average"

Added unittest case for "Average" filter.
Fixed bug found by the unittest.

Fixes #58

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

[Filter/Main] Call close() when a stream stops.

Call close() when stop() vmethod is invoked.
Ensure open() when start() vmethod is invoked.

This resolves a few Valgrind memcheck errors.

Fixes #214

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

[Build Break Fix] C89 Compatibility issue in example

The two then-pending PRs had been conflicting with each other.
This commit fixes the build break from them (C89 vs strtok_r)

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

[Convert] Fix memory error

Unref gst object when it is no more needed.

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

[Filter/Custom/Example] Add new example: do average

Added a new test case to satisfy #58.

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

[Code Clean] Enforce C89 for all .C files

Gstreamer requires compatibility with C89 for good plugins.
This commit fixes all non-C89 compliant code of C and
enforces C89 for all C code in Cflag.

Fixes #206

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

[github] Updated pull request template

This PR is to update the existing pull request (PR) template
in order that developers can write a good Git commit messages.

**Changed proposed in this PR:**
1. Updated PR template

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

[Filter/Custom/Example] Thread Safety.

Let's not use strtok, which is not thread-safe.
Gstreamer may use multithreading depending on the stream setup.

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

[Tensors] Use GString to parse string of dimensions/types

It's better to use GString to parse the string of dimensions/types
rather than strdup/strtok.

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

[Sink] move unittest file

move unittest_sink to tests/nnstreamer_sink/

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

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

[Sink] Support 32bit systems.

Use %zd for size_t

Fixes #200

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

[Tensors] Support heterogeneous types for other/tensors

By taking the input string for types in capability, we can supprot the
heterogeneous types for other/tensors.

- Added parse string for types
- Added string for types of tensors in capability.
- Added test for type string

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

[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>