doc common: Draft documentation for C++ header APIs

Write documentation for some of the APIs that have already been cleared up.

loaders svg: code refactoring

split functions as its purpose.

loader SvgLoader: Fix wrong debug log

1.
Modify that attribute information used for use type
looks like it was used for g type.

2.
Fix clippath node looking like setting "none"
(clippath's display = false is intentional)

Revert "** Temporary patch for diagnosing some hideous bugs in Tizen **"

This reverts commit 9996be4c047b5b3b9ced9fabe3c4b888ed795cff.

Change-Id: Ib5f0ee8c5d63012863d22e3ba051278be6e99982

loader SvgLoader: add locale-independent strtof function

strtof's behavior is changed by system locale.
https://linux.die.net/man/3/strtof

Because of this, strtof(10.0000) returns 0.0 in some locales.
When a given value string is locale-independent, strtof has to be
replaced to custom function.

Change-Id: I0166c434990ef8b692f0007d24112aa61c6ef679

bump up v0.1.2

Change-Id: Ia351fa777c21654308ae0d717feddbcfa24592ab

loaders svg: ++safety

prevent buffer overflow just in case.

Change-Id: I58e079d00b4840437632716c3cdd0deea144c5c6

resolve some unpexpected code involving while upstream code sync.

Change-Id: Ie818f1db73e997bf6d7eaae24cf55303c55eceba

bump up v0.1.2

Change-Id: Ia3f1dddf6c27fbe3894df637f15d8d9b55f7710c

loader svg: displaying SVG images without the specified viewBox attribute

If no viewBox attribute is given, the height and width attributes are used
to establish the viewBox size. However, this information was not available
inside the scene builder, even though it was needed.

Change-Id: Icf5a74936d26de5f10c3a3eb428c7800749c1e9d

common: code refactoring.

renamed internal function, no logical changes.

Change-Id: Iea738826315a2f02f6d4f9d56b81a55379c09738

sw_engine: adding a check before stroke fill dereference

The crash was observed for empty shapes.

Change-Id: Ie1a38ebae6a6877caaf307bddcf93dd4ee07bd8d

common initializer: counting engine init count properly.

Manage the reference count in common so that
all common resources can be initialized/terminated identically.

Change-Id: Ica05c031774d212c068bb055aa8f74123d9915dc

examples: ignoring pictures other than svgs in Stress.cpp

The picture->size() function does not work for raw/png pictures.
As a consequence enabling both, the svg and png file loaders,
resulted in the unintended behavior of the example.

** Temporary patch for diagnosing some hideous bugs in Tizen **

This patch puts some prints for analizing a crash issue,
it must be reverted after fixing it.

Change-Id: Iac2db25da27aa85dcfef19d05ced887d821584de

loader SvgLoader: Fix for coding convention

Change-Id: I0c6852eef9d19a8a58d1912ff54084a9c2b2c13d

loader SvgLoader: return null if transform attribute invalid

In transform matrix parsing, null is returned if any of the matrices are invalid.

loaders svg: fix a wrongly handles the corner case.

Stop the internel loop quick as possible, and state must be reset.

loaders svg: code refactoring.

keep it clean & neat within tvg coding convention.

wasm: fix compile errors.

sync versioning 0.1.0

Change-Id: I6b4eb3d603963d68b01bcf398f59e336ad18e46d

bump up v0.0.7

Change-Id: I3e8d10dc94f2931b2898a02c86d851a964f0acb6

loader svg: fix composition(mask/clip) issue.

composition target missed transform of its source.

That brings incorrect composition area.

This fixes it.

Change-Id: I7e1adc225af2c0177581b3505288de50d77cc411

sw_engine: fixing stroke gradient

Instead of checking the stroke's fill, the shape's fill was checked.
As a result the improper rastering function was called (or none).

loaders svg: set default color for composition paint.

not only clippath but alpha compositions might also have any valid color.
Set it default and let it override values while appending shapes if it's necessary.

loaders svg: prevent composition setting if the result shape is invalid.

Current loader could return invalid shapes -default, from _appendShape()-
by a certain interpretation result,

Though it's a wrong or exception case, we can prevent worse case by avoiding it.

loaders svg: code refactoring

clean up code and remove unnecessary internal class.

this also helps to reduce binary size by 5.5kb

no logical changes.

loaders svg: ++ log info for wrong situation.

if either log is printed, we need to improve the composition method.

loaders svg: code refactoring

++ clean code.

loaders svg: fix invalid clip path result.

tvg engine expects the valid clippath with valid colors,
loaders set any colors values to enable it.

this fixes invalid clippath behavior.

sw_engine: fix GradientStroke crash

++ strict null check.

sw_engine raster: adding antialiasing to the gradient rastering functions

The gradient rastering functions with composition did not take
antialiasing into account. The missing part has been added.

sw_engine raster: refactoring the gradient rastering functions

The gradient rastering functions have been splitted into translucent
and opaque.

sw_engine: rastering the opaque radial gradient with masking

In the radial gradient rastering functions, the part supporting
the (inverse) masking was added.

sw_engine: removed unnecessary function parameter

In the fillFetchLinear function the offset parameter was removed.
The destination address may be shifted directly in the dst parameter,
it doesn't need to be passed separately.

binary optimization

remove inlining to reduce size by 22kb.

Change-Id: I1036e28cac2de5d42f8a7a08b09897c1fb3dc5a6

common paint: fix wrong fast clippath logic.

it missed to check clippath's transform in fasttrack logic.
now it additionally check it...

Update README.md

sw_engine raster: ++ precise alpha multiplying

previously alpha multiplying operation doesn't have perfect precision,
could loss 1 pixel since it divides 255 values by 256.

This improved operation comply with both precision & performance.

Update CONTRIBUTING.md

loader png: code refactoring

Seperate behaviors open/read/close,
free/close pngimage properly,
add copyright for files.

There still left one optimization point by applying Task.

meson: revise png loader meson script.

We hate spagettie code, not even build script.
this revise it to keep the build script consistency.

sw_engine: unnecessary memory allocation and variables has been removed

loader loaderMgr: add a useful debug message.

Print info if file format is not supported.

examples: revise picture sample code.

minor fixes

Added png loading example

Added libpng based png loading

bump up version

Change-Id: I96c3b3c8d32e0d9d62fdff44a3f6329c0abcb31b

sw_engine: fixing linear gradient rastering for shapes with composition

Masking and Inverse masking are for now rastered properly only for the linear
gradients without the opacity.

Change-Id: Ie37ac7650586e199083affdf8c52b62dbb41c160

gradients: paint linerar gradients properly with mask composition method

@Issues: 243

Change-Id: Ie26a0b903af94a46683348e3fb7d8b554576997c

capi: changing function name

For uniformity of the functions naming the function name
tvg_shape_stroke_get_gradient changed to tvg_shape_get_stroke_gradient.

Change-Id: Iebceab1c01e135534c182d00f88b2bda4d5fea4a

bump up version

Change-Id: I3d781585fb50498ab660c0d38a41866dedfa20eb

doc: update sample images.

Change-Id: Idc5035f61452f2dd39115c4deb994bd587fe1569

Update README.md

common: fix wrong viewport region.

in the clip rect, viewport must be accumulated to the smaller one.
this patch improves that corner-case.

common sw_engine: optimize single rectangle ClipPath.

If ClipPath is a singular rectangle,
we don't need to apply this to all children nodes to adjust rle span regions.

Rather than its regular sequence,
we can adjust render region as merging viewport that is introduced internally,

All in all,
If a Paint has a single ClipPath that is Rectangle,
it sets viewport with Rectangle area that viewport is applied to
raster engine to cut off the rendering boundary.

In the normal case it brings trivial effects.
but when use SVGs which has a viewbox, it could increase the performance
up to 10% (profiled with 200 svgs rendering at the same time)

Note that, this won't be applied if the Paint has affine or rotation transform.

@Issues: 294

sw_engine: code refactoring

1. unified clip & bounding box in rle processing
2. unified outline boundingbox functions between shape & image.

examples: allow a desianted main thread capacity.

Maximum threads is not always peak the highest performance,
tvg examples guide user the proper threads count.

common paint: fix memory leak case.

free the previous composition target if any,
before reset with the new one.

updated copyright

common engines: code refactoring

Introduce RenderRegion structure for region data
to simplify the methods paratemers.

also depends on the NRVO for the return data.

svg_loader: ommiting xml entities in the svg file (#278)

SVG files created using 'sketch' may contain xml entities,
which are not understandable by the svg loader.
For now only '"' is ommited.

loader svg: fix coding convention

examples: revise StrokeGradient

renamed GradientStroke & repositioned visuals.

bump up version

Change-Id: I0026c758712b068949d61556ca202786627a9fe5

svg_loader: applying AlphaMask during scene building

The AlphaMask composition case was omitted in the _sceneBuilderHelper().

initializer: add reference counting for the engines initialization.

Introduced the reference counting for the backend engines so that
tvg prevents unpaired engine initialization/termination calls by user mistake.

@Issues: 296

common picture: fix crash at picture duplication.

A duplicated picture needs to access internal picture loader data
to get its properties while rasterizing.

But it missed the loader since it's not copied from origin.

Thus, we fix this by sharing the internal loader among the duplications and origin.

@Examples: Duplicate

paint: clip was substracted from the array for any composite method

Only ClipPath composite method should cause clips subtraction.

common shape: Fixed appendArc for negative values.

Description:
Fixed appendArc API for -90 angles. In that case it was drawn in wrong
direction.

@Examples

```cpp
  float x = 40.0, y = 40.0;
  auto shape1 = tvg::Shape::gen();

  //OK
  shape1->appendArc(x + 50, y, 25, 0, -91, false);
  //NOK
  shape1->appendArc(x + 100, y, 25, 0, -90, false);
  //OK
  shape1->appendArc(x + 150, y, 25, 0, -89, false);
```

Change-Id: Ic9cba89b44e170b3a1411e7d126c912a9fb135d5

loaders svg: remove unnecessary move call, move is guaranteed at the return value.

warning: moving a temporary object prevents copy elision [-Wpessimizing-move]

sw_engine: optimize rle clipping

We don't need to copy the rle data unecessarily,
we can just replace the completed clip rle.

Change-Id: I099a071bdc83937d3a942fc5d08ff2c2d72f96ac

examples: clean up mask resources.

These are not proper for our svg examples.

sw_engine rleClipPath: Modify clippath spans creation size.

When updating rle for clipped area, realloc size should be larger than spans size.
so this patch prevents the problem while realloc.

loader SvgSceneBuilder: Add root node to clipping viewBox.

If the boundary of scene created through the scenebuilder is larger than the viewbox,
scene(SVG's root) should be clipped to the size of the viewbox.
So, if scene need a clip, add a parent root and add clippath composition to that root.

bump up version.

Change-Id: I33545ca3d2e437d43471b080cc60a39e52a28bf6

common shape: revise Shape::reset() api.

reset Path is useful rather than reset all properties.

Change-Id: Ic62eaecf9e4129f2ada790ebef6745e7be85db4c

This is too untable.... Stress in example is crashed by this.

Revert "svg_loader: limiting the ploted area of svg to viewBox"

This reverts commit 2bb108b2f13432ac140d9be08daae189fe9c61c5.

Change-Id: Iec82290d6ca080d868471275bc83663adbaf4b56

common canvas: initialize member variable.

to shutdown the static code analizer report.

Change-Id: Id32127ab3caf64f1b8e34e5f3abf6780ac0d3b71

svg_loader: limiting the ploted area of svg to viewBox

The 'viewBox' element given in the svg file determines
the coordinates of the plotted area. ClipPath used in Svg loader.

Change-Id: Idddcbce7cddfe46e2049d6741379c747e76482ed

sw_engine fill: correct value loss by data conversion.

revert unintended code changes while upstream code sync.

Change-Id: I5c95954a470d5a1f330f3044e254b896d445426c

example: Duplicate.cpp modified

Duplication of the Picture with a raw image is added

Change-Id: I8d069e2e829a4f869e477a6aa5076175335a6751

updated AUTHORS

Change-Id: I43defd73b85b000aea191f017c5be30f8e195d93

Revert "sw_engine shape/image: substituting logical 'and' with 'or'"

This reverts commit 74b27c74af220e30fef274e07f8ad4f19430d217.

This patch breaks Stroke example. 1 line drawings...

There is a possibility that less 1 (i.e: 0.5) width axis-aligned line drawings...

So logically "&&" is correct.

Change-Id: Ia98622d7df464f55a255a35ccb37fc9664ed6954

sw_engine raster: functions optimization in the image block

The alpha value calculation pulled out outside the inner loop
to reduce the number of unnecessary operations.
Added local variables to reduce the number of costly
multiplications performed in a loop.

Change-Id: Ib7f68cb05d1ec8fd05df751d933ce7c2c09da484

sw_engine shape/image: substituting logical 'and' with 'or'

In the case when the height or width of the bounding box is 0
it is not necessary to calculate Rle.

Change-Id: Ib5351cf43d68530b83efd71d4c2dd71caf67c904

example: AnimateMask images change

Change-Id: Iacd407c3e186f1f91c2bcbd9099f0b83a9dba264

bump up version.

Change-Id: I664ef791eef4afac8ce5b8ecc9dec7166a6f6c52

Update README.md

Update README.md

updated svg part.

svg_loader SvgPath: Remove unnecessary optimization code

This condition(optimization) is not a step suggested by arc implementation.
https://www.w3.org/TR/SVG11/implnote.html#ArcCorrectionOutOfRangeRadii (Step2)
This code is useful if the arc is too small to represent.
However, scaling often occurs in vectors, which can create unnecessary problems.

example path
<path d="M32.41,20.49a.41.41,0,1,1-.41-.42A.41.41,0,0,1,32.41,20.49Z" transform="translate(0)" fill="#020202"/>

svg_loader SvgLoader: Fix copy conditions for stop of gradient

When getting a linked stop list, if there is no existing stop list
in current gradient, it is copied.

svgloader: fixing linear gradient transformation

Gradient stop points were incorrectly transformed when building
the scene in the SVG loader.

capi: fix incorrect composite api.

Api prototype is completely wrong, now it's corrected.

svgloader: fixing SVG image display when viewBox size is not given

When viewBox is not given its dimensions should be determined
by the height and width parameters

sw_engine fill: fixing the infinite loop condition

Fixed in the fillFetchLinear() function.

svgloader: fillRule value passed to the shape

The value was loadeed but not set to the shape.

canvas: replacement of the bitwise OR operator with the logical one

Bitwise logical operators do not perform short-circuiting.