Synfig Studio :: Documentation - User contributions [en]

Doc:Overview/cs

2019-01-02T11:46:06Z

Want:

{{Title|Přehled}}
{{Navigation|Category:Manual/cs|Doc:Getting Started}}
[[Category:Manual/cs]]
{{NewTerminology}}

Pravděpodobně víte, že při animaci vzniká iluze pohybu tím, že se rychle po sobě zobrazuje série na sebe navazujících obrázků. Tradiční 2D animace se dělá tak, že se kreslí každý obrázek zvlášť. Toto je tzv. '''fázová animace''' (angl. "Stop motion"). Ale také se jí říká '''pookénková animace''' (angl. "frame-by-frame animation"), protože jednotlivé obrázky (angl. "frames") se nazývají okénka. Aby se pohyb zdál dostatečně plynulý, je třeba nakreslit hodně obrázků, což je hodně náročné jak na čas, tak lidské zdroje.
[[File:Traditional-animation.gif|x150px|frame|center|Tradiční fázová animace, převzato z : http://flipily.com|link=http://flipily.com]]
{{literal|Synfig Studio}} je [https://en.wikipedia.org/wiki/Free_software open-source] software pro vektorovou 2D animaci. Umožňuje tvorbu kvalitních animací s minimálními nároky na zdroje.

Synfig Studio je navrženo tak, aby nebylo nutné kreslit každé okénko zvlášť, a k tomu využívá dvě techniky:
* Animaci s využitím morfingu
* Ploškovou animaci

== Morfing ==
[[File:Rose4b.gif|thumb|100px|right|Animace růže pomoí morfingu, od Rore]] '''Morfing''' (angl. '''Morphing''') je operace při které se vytvoří mezi dvěma různými obrázky plynulý přechod, takže se jeden tvar plynule změní na jiný. A to jakým způsobem má transformace proběhnout je určeno pomocí kontrolních bodů. Synfig Studio pracuje s vektory, takže morfing dělá zcela automaticky. Pro vytvoření animace tudíž stačí přesunout klíčové body a zvolit vhodný časový interval. Stačí tedy nakreslit výchozí snímek, a přesunem bodů na klíčovém snímku vymezujícím časový interval určit co, odkud a jam se má na scéně přesunout. Synfig Studio pak pozice bodů pro ostatní snímky dopočítá.
 

== Plošková animace ==
[[Image:Cutoutsample.gif|thumb|100px|left|Plošková animace z tutoriálu pro Synfig]]
U '''ploškové animace''' (angl. '''cut-out animation''') je objekt rozdělen na menší části, na které se pak aplikují jednoduché operace jako např. posun, rotace, změna velikosti, aj. Synfig Studio umí z pozice objektů na klíčových snímcích dopočítat jejich pozice pro ostatní snímky. Ploškovou animaci tak lze udělat jak z bitmapových, tak vektorových obrázků.
 

== Přechody a další funkcionality ==
V obou případech je úkolem vyplnit mezery mezi klíčovými snímky (keyframes) tak aby vznkla hladká a plynulá animace. Tento proces dopočítávání chybějících snímků se nazývá anglickým výrazem "tweening" .

I když Synfig Studio není primárně určeno ke tvorbě fázové animace, lze v jeho prostředí dělat i animace z ručně malovaných obrázků, pokud se snímek převede z bitmapového formátu na vektorový. Tento proces se nazývá trasování ("tracing") a obvykle se dělá tak, že se nad bitmapovým obrázkem ručně nakreslí tvaru definované vektory. Při tom můžete využít řadu fascinujících efektů, takže Synfig Studio vám umožní udělat vskutku profesionální animace.


Ať už budete dělat fázovou animaci, nebo ne, Synfig Studio vám výrazně usnadní kontrolu nad často se střídajícími operacemi, jako kupř. když se má něco opakovat, změnit barva, textura co obrázek, upravit charakteristika okrajové linky, a nabízí řadu dalších věcí - animační trajektorie a vytvoření akcí. Opakované využití dat jejich prolinkováním. V tom je síla Synfig Studia, kterou lze využít i pro velké animační projekty.

Také si můžete předem nadefinovat vztahy, jaké mají být mezi vzájemě se pohybujícími obrázky ty pak využívat jako funkce. To vám umožní dělat automatické animace, založené na těchto předem definovaných zákonitostech a což posouvá proces animae na zcela novou úroveň.
[[Image:Parabolic-shot.gif|frame|center|Animace parabolické dráhy střely z tutoriálu pro Synfig]]



Všechny z uvedených funkcionalit Synfig Studia jsou podrobně popsány v kapitolách tohoto manuálu.


{{Navigation|Category:Manual|Doc:Getting Started}}

Doc:Overview/cs

2019-01-02T11:44:33Z

Want:

{{Title|Přehled}}
{{Navigation|Category:Manual/cs|Doc:Getting Started}}
{{NewTerminology}}

Pravděpodobně víte, že při animaci vzniká iluze pohybu tím, že se rychle po sobě zobrazuje série na sebe navazujících obrázků. Tradiční 2D animace se dělá tak, že se kreslí každý obrázek zvlášť. Toto je tzv. '''fázová animace''' (angl. "Stop motion"). Ale také se jí říká '''pookénková animace''' (angl. "frame-by-frame animation"), protože jednotlivé obrázky (angl. "frames") se nazývají okénka. Aby se pohyb zdál dostatečně plynulý, je třeba nakreslit hodně obrázků, což je hodně náročné jak na čas, tak lidské zdroje.
[[File:Traditional-animation.gif|x150px|frame|center|Tradiční fázová animace, převzato z : http://flipily.com|link=http://flipily.com]]
{{literal|Synfig Studio}} je [https://en.wikipedia.org/wiki/Free_software open-source] software pro vektorovou 2D animaci. Umožňuje tvorbu kvalitních animací s minimálními nároky na zdroje.

Synfig Studio je navrženo tak, aby nebylo nutné kreslit každé okénko zvlášť, a k tomu využívá dvě techniky:
* Animaci s využitím morfingu
* Ploškovou animaci

== Morfing ==
[[File:Rose4b.gif|thumb|100px|right|Animace růže pomoí morfingu, od Rore]] '''Morfing''' (angl. '''Morphing''') je operace při které se vytvoří mezi dvěma různými obrázky plynulý přechod, takže se jeden tvar plynule změní na jiný. A to jakým způsobem má transformace proběhnout je určeno pomocí kontrolních bodů. Synfig Studio pracuje s vektory, takže morfing dělá zcela automaticky. Pro vytvoření animace tudíž stačí přesunout klíčové body a zvolit vhodný časový interval. Stačí tedy nakreslit výchozí snímek, a přesunem bodů na klíčovém snímku vymezujícím časový interval určit co, odkud a jam se má na scéně přesunout. Synfig Studio pak pozice bodů pro ostatní snímky dopočítá.
 

== Plošková animace ==
[[Image:Cutoutsample.gif|thumb|100px|left|Plošková animace z tutoriálu pro Synfig]]
U '''ploškové animace''' (angl. '''cut-out animation''') je objekt rozdělen na menší části, na které se pak aplikují jednoduché operace jako např. posun, rotace, změna velikosti, aj. Synfig Studio umí z pozice objektů na klíčových snímcích dopočítat jejich pozice pro ostatní snímky. Ploškovou animaci tak lze udělat jak z bitmapových, tak vektorových obrázků.
 

== Přechody a další funkcionality ==
V obou případech je úkolem vyplnit mezery mezi klíčovými snímky (keyframes) tak aby vznkla hladká a plynulá animace. Tento proces dopočítávání chybějících snímků se nazývá anglickým výrazem "tweening" .

I když Synfig Studio není primárně určeno ke tvorbě fázové animace, lze v jeho prostředí dělat i animace z ručně malovaných obrázků, pokud se snímek převede z bitmapového formátu na vektorový. Tento proces se nazývá trasování ("tracing") a obvykle se dělá tak, že se nad bitmapovým obrázkem ručně nakreslí tvaru definované vektory. Při tom můžete využít řadu fascinujících efektů, takže Synfig Studio vám umožní udělat vskutku profesionální animace.


Ať už budete dělat fázovou animaci, nebo ne, Synfig Studio vám výrazně usnadní kontrolu nad často se střídajícími operacemi, jako kupř. když se má něco opakovat, změnit barva, textura co obrázek, upravit charakteristika okrajové linky, a nabízí řadu dalších věcí - animační trajektorie a vytvoření akcí. Opakované využití dat jejich prolinkováním. V tom je síla Synfig Studia, kterou lze využít i pro velké animační projekty.

Také si můžete předem nadefinovat vztahy, jaké mají být mezi vzájemě se pohybujícími obrázky ty pak využívat jako funkce. To vám umožní dělat automatické animace, založené na těchto předem definovaných zákonitostech a což posouvá proces animae na zcela novou úroveň.
[[Image:Parabolic-shot.gif|frame|center|Animace parabolické dráhy střely z tutoriálu pro Synfig]]



Všechny z uvedených funkcionalit Synfig Studia jsou podrobně popsány v kapitolách tohoto manuálu.


{{Navigation|Category:Manual|Doc:Getting Started}}

Doc:Overview/cs

2019-01-02T11:41:40Z

Want:

{{Title|Přehled}}
{{Navigation|Category:Manual|Doc:Getting Started}}
{{Category:Manual}}
{{NewTerminology}}

Pravděpodobně víte, že při animaci vzniká iluze pohybu tím, že se rychle po sobě zobrazuje série na sebe navazujících obrázků. Tradiční 2D animace se dělá tak, že se kreslí každý obrázek zvlášť. Toto je tzv. '''fázová animace''' (angl. "Stop motion"). Ale také se jí říká '''pookénková animace''' (angl. "frame-by-frame animation"), protože jednotlivé obrázky (angl. "frames") se nazývají okénka. Aby se pohyb zdál dostatečně plynulý, je třeba nakreslit hodně obrázků, což je hodně náročné jak na čas, tak lidské zdroje.
[[File:Traditional-animation.gif|x150px|frame|center|Tradiční fázová animace, převzato z : http://flipily.com|link=http://flipily.com]]
{{literal|Synfig Studio}} je [https://en.wikipedia.org/wiki/Free_software open-source] software pro vektorovou 2D animaci. Umožňuje tvorbu kvalitních animací s minimálními nároky na zdroje.

Synfig Studio je navrženo tak, aby nebylo nutné kreslit každé okénko zvlášť, a k tomu využívá dvě techniky:
* Animaci s využitím morfingu
* Ploškovou animaci

== Morfing ==
[[File:Rose4b.gif|thumb|100px|right|Animace růže pomoí morfingu, od Rore]] '''Morfing''' (angl. '''Morphing''') je operace při které se vytvoří mezi dvěma různými obrázky plynulý přechod, takže se jeden tvar plynule změní na jiný. A to jakým způsobem má transformace proběhnout je určeno pomocí kontrolních bodů. Synfig Studio pracuje s vektory, takže morfing dělá zcela automaticky. Pro vytvoření animace tudíž stačí přesunout klíčové body a zvolit vhodný časový interval. Stačí tedy nakreslit výchozí snímek, a přesunem bodů na klíčovém snímku vymezujícím časový interval určit co, odkud a jam se má na scéně přesunout. Synfig Studio pak pozice bodů pro ostatní snímky dopočítá.
 

== Plošková animace ==
[[Image:Cutoutsample.gif|thumb|100px|left|Plošková animace z tutoriálu pro Synfig]]
U '''ploškové animace''' (angl. '''cut-out animation''') je objekt rozdělen na menší části, na které se pak aplikují jednoduché operace jako např. posun, rotace, změna velikosti, aj. Synfig Studio umí z pozice objektů na klíčových snímcích dopočítat jejich pozice pro ostatní snímky. Ploškovou animaci tak lze udělat jak z bitmapových, tak vektorových obrázků.
 

== Přechody a další funkcionality ==
V obou případech je úkolem vyplnit mezery mezi klíčovými snímky (keyframes) tak aby vznkla hladká a plynulá animace. Tento proces dopočítávání chybějících snímků se nazývá anglickým výrazem "tweening" .

I když Synfig Studio není primárně určeno ke tvorbě fázové animace, lze v jeho prostředí dělat i animace z ručně malovaných obrázků, pokud se snímek převede z bitmapového formátu na vektorový. Tento proces se nazývá trasování ("tracing") a obvykle se dělá tak, že se nad bitmapovým obrázkem ručně nakreslí tvaru definované vektory. Při tom můžete využít řadu fascinujících efektů, takže Synfig Studio vám umožní udělat vskutku profesionální animace.


Ať už budete dělat fázovou animaci, nebo ne, Synfig Studio vám výrazně usnadní kontrolu nad často se střídajícími operacemi, jako kupř. když se má něco opakovat, změnit barva, textura co obrázek, upravit charakteristika okrajové linky, a nabízí řadu dalších věcí - animační trajektorie a vytvoření akcí. Opakované využití dat jejich prolinkováním. V tom je síla Synfig Studia, kterou lze využít i pro velké animační projekty.

Také si můžete předem nadefinovat vztahy, jaké mají být mezi vzájemě se pohybujícími obrázky ty pak využívat jako funkce. To vám umožní dělat automatické animace, založené na těchto předem definovaných zákonitostech a což posouvá proces animae na zcela novou úroveň.
[[Image:Parabolic-shot.gif|frame|center|Animace parabolické dráhy střely z tutoriálu pro Synfig]]



Všechny z uvedených funkcionalit Synfig Studia jsou podrobně popsány v kapitolách tohoto manuálu.


{{Navigation|Category:Manual|Doc:Getting Started}}

Doc:Overview/cs

2019-01-02T11:40:17Z

Want:

{{Title|Přehled}}
{{Navigation|Category:Manual|Doc:Getting Started}}
[[Category:Manual]]
[[Category:Manual/cs]]
{{NewTerminology}}

Pravděpodobně víte, že při animaci vzniká iluze pohybu tím, že se rychle po sobě zobrazuje série na sebe navazujících obrázků. Tradiční 2D animace se dělá tak, že se kreslí každý obrázek zvlášť. Toto je tzv. '''fázová animace''' (angl. "Stop motion"). Ale také se jí říká '''pookénková animace''' (angl. "frame-by-frame animation"), protože jednotlivé obrázky (angl. "frames") se nazývají okénka. Aby se pohyb zdál dostatečně plynulý, je třeba nakreslit hodně obrázků, což je hodně náročné jak na čas, tak lidské zdroje.
[[File:Traditional-animation.gif|x150px|frame|center|Tradiční fázová animace, převzato z : http://flipily.com|link=http://flipily.com]]
{{literal|Synfig Studio}} je [https://en.wikipedia.org/wiki/Free_software open-source] software pro vektorovou 2D animaci. Umožňuje tvorbu kvalitních animací s minimálními nároky na zdroje.

Synfig Studio je navrženo tak, aby nebylo nutné kreslit každé okénko zvlášť, a k tomu využívá dvě techniky:
* Animaci s využitím morfingu
* Ploškovou animaci

== Morfing ==
[[File:Rose4b.gif|thumb|100px|right|Animace růže pomoí morfingu, od Rore]] '''Morfing''' (angl. '''Morphing''') je operace při které se vytvoří mezi dvěma různými obrázky plynulý přechod, takže se jeden tvar plynule změní na jiný. A to jakým způsobem má transformace proběhnout je určeno pomocí kontrolních bodů. Synfig Studio pracuje s vektory, takže morfing dělá zcela automaticky. Pro vytvoření animace tudíž stačí přesunout klíčové body a zvolit vhodný časový interval. Stačí tedy nakreslit výchozí snímek, a přesunem bodů na klíčovém snímku vymezujícím časový interval určit co, odkud a jam se má na scéně přesunout. Synfig Studio pak pozice bodů pro ostatní snímky dopočítá.
 

== Plošková animace ==
[[Image:Cutoutsample.gif|thumb|100px|left|Plošková animace z tutoriálu pro Synfig]]
U '''ploškové animace''' (angl. '''cut-out animation''') je objekt rozdělen na menší části, na které se pak aplikují jednoduché operace jako např. posun, rotace, změna velikosti, aj. Synfig Studio umí z pozice objektů na klíčových snímcích dopočítat jejich pozice pro ostatní snímky. Ploškovou animaci tak lze udělat jak z bitmapových, tak vektorových obrázků.
 

== Přechody a další funkcionality ==
V obou případech je úkolem vyplnit mezery mezi klíčovými snímky (keyframes) tak aby vznkla hladká a plynulá animace. Tento proces dopočítávání chybějících snímků se nazývá anglickým výrazem "tweening" .

I když Synfig Studio není primárně určeno ke tvorbě fázové animace, lze v jeho prostředí dělat i animace z ručně malovaných obrázků, pokud se snímek převede z bitmapového formátu na vektorový. Tento proces se nazývá trasování ("tracing") a obvykle se dělá tak, že se nad bitmapovým obrázkem ručně nakreslí tvaru definované vektory. Při tom můžete využít řadu fascinujících efektů, takže Synfig Studio vám umožní udělat vskutku profesionální animace.


Ať už budete dělat fázovou animaci, nebo ne, Synfig Studio vám výrazně usnadní kontrolu nad často se střídajícími operacemi, jako kupř. když se má něco opakovat, změnit barva, textura co obrázek, upravit charakteristika okrajové linky, a nabízí řadu dalších věcí - animační trajektorie a vytvoření akcí. Opakované využití dat jejich prolinkováním. V tom je síla Synfig Studia, kterou lze využít i pro velké animační projekty.

Také si můžete předem nadefinovat vztahy, jaké mají být mezi vzájemě se pohybujícími obrázky ty pak využívat jako funkce. To vám umožní dělat automatické animace, založené na těchto předem definovaných zákonitostech a což posouvá proces animae na zcela novou úroveň.
[[Image:Parabolic-shot.gif|frame|center|Animace parabolické dráhy střely z tutoriálu pro Synfig]]



Všechny z uvedených funkcionalit Synfig Studia jsou podrobně popsány v kapitolách tohoto manuálu.


{{Navigation|Category:Manual|Doc:Getting Started}}

Doc:Overview/cs

2019-01-02T11:38:48Z

Want:

{{Title|Přehled}}
{{Navigation|Category:Manual|Doc:Getting Started}}
[[Category:Manual]]
{{NewTerminology}}

Pravděpodobně víte, že při animaci vzniká iluze pohybu tím, že se rychle po sobě zobrazuje série na sebe navazujících obrázků. Tradiční 2D animace se dělá tak, že se kreslí každý obrázek zvlášť. Toto je tzv. '''fázová animace''' (angl. "Stop motion"). Ale také se jí říká '''pookénková animace''' (angl. "frame-by-frame animation"), protože jednotlivé obrázky (angl. "frames") se nazývají okénka. Aby se pohyb zdál dostatečně plynulý, je třeba nakreslit hodně obrázků, což je hodně náročné jak na čas, tak lidské zdroje.
[[File:Traditional-animation.gif|x150px|frame|center|Tradiční fázová animace, převzato z : http://flipily.com|link=http://flipily.com]]
{{literal|Synfig Studio}} je [https://en.wikipedia.org/wiki/Free_software open-source] software pro vektorovou 2D animaci. Umožňuje tvorbu kvalitních animací s minimálními nároky na zdroje.

Synfig Studio je navrženo tak, aby nebylo nutné kreslit každé okénko zvlášť, a k tomu využívá dvě techniky:
* Animaci s využitím morfingu
* Ploškovou animaci

== Morfing ==
[[File:Rose4b.gif|thumb|100px|right|Animace růže pomoí morfingu, od Rore]] '''Morfing''' (angl. '''Morphing''') je operace při které se vytvoří mezi dvěma různými obrázky plynulý přechod, takže se jeden tvar plynule změní na jiný. A to jakým způsobem má transformace proběhnout je určeno pomocí kontrolních bodů. Synfig Studio pracuje s vektory, takže morfing dělá zcela automaticky. Pro vytvoření animace tudíž stačí přesunout klíčové body a zvolit vhodný časový interval. Stačí tedy nakreslit výchozí snímek, a přesunem bodů na klíčovém snímku vymezujícím časový interval určit co, odkud a jam se má na scéně přesunout. Synfig Studio pak pozice bodů pro ostatní snímky dopočítá.
 

== Plošková animace ==
[[Image:Cutoutsample.gif|thumb|100px|left|Plošková animace z tutoriálu pro Synfig]]
U '''ploškové animace''' (angl. '''cut-out animation''') je objekt rozdělen na menší části, na které se pak aplikují jednoduché operace jako např. posun, rotace, změna velikosti, aj. Synfig Studio umí z pozice objektů na klíčových snímcích dopočítat jejich pozice pro ostatní snímky. Ploškovou animaci tak lze udělat jak z bitmapových, tak vektorových obrázků.
 

== Přechody a další funkcionality ==
V obou případech je úkolem vyplnit mezery mezi klíčovými snímky (keyframes) tak aby vznkla hladká a plynulá animace. Tento proces dopočítávání chybějících snímků se nazývá anglickým výrazem "tweening" .

I když Synfig Studio není primárně určeno ke tvorbě fázové animace, lze v jeho prostředí dělat i animace z ručně malovaných obrázků, pokud se snímek převede z bitmapového formátu na vektorový. Tento proces se nazývá trasování ("tracing") a obvykle se dělá tak, že se nad bitmapovým obrázkem ručně nakreslí tvaru definované vektory. Při tom můžete využít řadu fascinujících efektů, takže Synfig Studio vám umožní udělat vskutku profesionální animace.


Ať už budete dělat fázovou animaci, nebo ne, Synfig Studio vám výrazně usnadní kontrolu nad často se střídajícími operacemi, jako kupř. když se má něco opakovat, změnit barva, textura co obrázek, upravit charakteristika okrajové linky, a nabízí řadu dalších věcí - animační trajektorie a vytvoření akcí. Opakované využití dat jejich prolinkováním. V tom je síla Synfig Studia, kterou lze využít i pro velké animační projekty.

Také si můžete předem nadefinovat vztahy, jaké mají být mezi vzájemě se pohybujícími obrázky ty pak využívat jako funkce. To vám umožní dělat automatické animace, založené na těchto předem definovaných zákonitostech a což posouvá proces animae na zcela novou úroveň.
[[Image:Parabolic-shot.gif|frame|center|Animace parabolické dráhy střely z tutoriálu pro Synfig]]



Všechny z uvedených funkcionalit Synfig Studia jsou podrobně popsány v kapitolách tohoto manuálu.


{{Navigation|Category:Manual|Doc:Getting Started}}

Spherize Layer

2017-03-16T22:52:28Z

Want:

{{Title|Spherize Layer}}
{{Category|Layers}}
{{Category|Distortions}}
{{NewTerminology}}


{{l|Image:Layer_distortion_spherize_icon.png|64px}}

== About Spherize Layers==

FIXMM!!!

==Parameters of Spherize Layers==

The parameters of the spherize layers are:

{|{{Parameters}}

|-style="background:#"
||{{l|Image:Type_vector_icon.png|16px}} {{l|Position Parameter}}
||0.000000u,0.000000u
||vector

|-style="background:#eeeeee"
||{{l|Image:Type_real_icon.png|16px}} {{l|Radius Parameter}}
||1.000000u
||real

|-style="background:#"
||{{l|Image:Type_real_icon.png|16px}} {{l|Amount Parameter}}
||1.000000u
||real

|-style="background:#eeeeee"
||{{l|Image:Type_bool_icon.png|16px}} {{l|Clip Parameter}}
|| {{Bool|}}
||bool

|-style="background:#"
||{{l|Image:type_integer_icon.png|16px}} {{l|Distort Type Parameter}}
||Spherize
||integer

|-
|}

History.fr

2017-03-16T22:46:28Z

Want: Redirected page to History/fr

#REDIRECT [[History/fr]]

Developer Documentation/cs

2017-03-16T17:27:10Z

Want: Created page with " {{Title|Dokumentace pro vývojáře}} {{TOCright}}  Dokumentace pro vývojáře je primárně určena pro: * aktuální vývojáře..."

{{Title|Dokumentace pro vývojáře}}
{{TOCright}}


Dokumentace pro vývojáře je primárně určena pro:

* aktuální vývojáře aplikačního kódu
* případné budoucí vývojáře
* ty co mají další nápady, a chtějí odhalit případné chyby a nedostatky

= Hlavní stránky =

* {{l|Dev:Build Instructions|Instrukce pro sestavení}}
* {{l|Dev:Building Documentation|Dokumentace procesu sestavení}}
* {{l|Dev:Source code|Zdrojové kódy}} jak je získat a jakým způsobem se zapojit do vývoje
* {{l|Dev:Action System|Akce a jejich systém}} : popis a dokumentace akcí s nimiž systém pracuje – ideální místo, kde začít s pronikáním do kódu Synfigu.
* Nastavení vývojového IDE {{l|Dev:IDE_Linux|v Linuxu}} | {{l|Dev:IDE_Windows| ve Windows}}
* {{l|Dev:Roadmap|Plán dalšího vývoje}}
* {{l|Dev:Contribute to Code|Jak přispět ke zkvalitnění kódu}}
* {{l|Dev:Translation|Jak překládat GUI}}
* {{l|Dev:Wish list}}
* {{l|Dev:Coding_Conventions|Konvence pro psaní kódu}}
* {{l|Dev:UI/UX Redesign|Úpravy UI dle UX}} – aneb jak využívat zkušeností uživatelů (UX) při úpravách rozhraní aplikace (UI)
* {{l|Dev:ETL_replacement|Nahrazení ETL}} za knihovny z Boost C++ (které jsou postupně integrovány do standardního C++)

= Co patří k Synfigu =
Synfig tvoří tři hlavní součásti: etl, synfig-core and synfig-studio.
* '''[http://download.tuxfamily.org/synfig/api/ETL/annotated.html ETL]''' je sada knihoven, která rozšiřuje možnosti standardních knihoven. Jednou z nejdůležitějších funkcionalit, kterou poskytuje, jsou sdílené třídy, které tvoří základ pro tvorbu objektů u dalších částí aplikace. Využití "handles" u sdílených objektů místo c++ ukazatelů umožňuje automatický úklid paměti na základě počítání referencí.
* '''[http://download.tuxfamily.org/synfig/api/synfig-core/annotated.html Synfig-core]''' tvoří jádro aplikace/renderovací aplikace ("synfig") obsluhovaná z příkazové řádky (cli) zpracovává do výsledného zobrazení datovou strukturu dokumentu, který mu předává aplikace: body (valuenodes), vrstvy (layers) a plošky (canvases).
* '''[http://download.tuxfamily.org/synfig/api/synfig-studio/annotated.html Synfig Studio]''' ("synfig-studio") je grafické rozhraní aplikace (GUI).
* Viz též: {{l|Dev:How Synfig Works}}

= Externí knihovny =
== Synfig využívá několika externích knihoven ==
* [https://developer.gnome.org/gtkmm-tutorial/2.24/ Gtkmm 2], je postupně nahrazováno [https://developer.gnome.org/gtk3/ Gtkmm 3] ( viz [https://developer.gnome.org/gtk3/3.4/gtk-migrating-2-to-3.html GTK migrace z verze 2 na 3])
* [https://developer.gnome.org/gtkmm/2.24/namespaceGdk_1_1Cairo.html Cairo] (grafická knihovna, která umí při renderování obrazu využívat hardwarovou akceleraci grafické karty, pokud je k dispozici)
* [http://freetype.org/ Freetype2] – knihovna pro renderování vrstvy {{l|Text Layer}} u softwarově renderovaného obrazu
* [http://libxmlplusplus.sourceforge.net/ libxmlplusplus] (k parsování projektových souborů)
* [http://www.boost.org/doc/libs/1_54_0/doc/html/program_options.html Boost Program Options] (synfig cli)
* [http://www.mltframework.org/ MLT Framework - Media Loving Toolkit] (využívá {{l|Sound Layer}})
* [http://www.libpng.org/pub/png/libpng.html libpng] (načítá a zapisuje soubory {{Literal|.png}} formátu)

== Také může využívat tyto knihovny, pokud jsou k dispozici ==
* [http://www.imagemagick.org/Magick++/ Magick++] – API aplikace ImageMagick umí využívat synfig-core prostřednictvím modulu mod_magickpp
* libavcodec – využívá synfig-core prostřednictvím modulu mod_libavcodec
* libmng – využívá synfig-core prostřednictvím modulu mod_mng
…pro další informace vizte stránku {{l|Dev:Build Instructions}}.

= Postup při psaní kódu =
* {{l|Dev:Adding a Layer}}
* Přidání Panelu, {{l|Dev:Adding a Panel - Part I|Část I}} a {{l|Dev:Adding a Panel - Part II|Část II}}. '''Poznámka:''' Vezměte v potaz, že tento tutoriál už je hodně "out of date". Takže adresář "gtkmm" byl přejmenován na "gui" a panelu se nyní říká dok. Také byly přesunuty některé soubory do podadresářů (viz např. obsah podadresáře "gui/docks").

= Další odkazy =
* [http://download.tuxfamily.org/synfig/api/index.html Dokumentace pro ETL, Synfig a pro API SynfigStudia]
* [http://synfig.org/wiki/index.php?title=Special:PrefixIndex&from=&namespace=102 Seznam všech stránek ve jmenném prostoru Dev]
* {{l|Dev:Translation|Informace k překladům}}
* {{l|Dev:Release|Procedury pro vydání další verze}}
* {{l|Dev:GoogleSoC|Google Summer of Code}}
* [http://sourceforge.net/p/synfig/mailman/synfig-devl/ Mailová konference vývojářů Synfigu]
* [https://github.com/synfig/synfig/issues Systém hlášení chyb pro Synfig]
* [http://www.synfig.org/forums/viewtopic.php?f=2&t=6097 Genete free stuff…]
* {{l|Dev:C%2B%2B11_Migration|Migrace na C++11}}

Developer Documentation

2017-03-16T16:10:37Z

Want:

{{Title|Developer Documentation}}
{{TOCright}}

The Developer Documentation part of this wiki is primarily for the following groups of people:

*Current developers of the code
*Future and potential developers
*Those interested in bug filing and generating ideas

= Main pages =

* {{l|Dev:Build Instructions}}
* {{l|Dev:Building Documentation}}
* {{l|Dev:Source code}} description and workflow
* {{l|Dev:Action System}} : structure of the action system, good entry-point into Synfig.
* IDE Setup {{l|Dev:IDE_Linux|under Linux}} | {{l|Dev:IDE_Windows| under Windows}}
* {{l|Dev:Roadmap}}
* {{l|Dev:Contribute to Code}}
* {{l|Dev:Translation}}
* {{l|Dev:Wish list}}
* {{l|Dev:Coding_Conventions}}
* {{l|Dev:UI/UX Redesign}}
* {{l|Dev:ETL_replacement}}

=Synfig components=
Synfig is divided into three main components: etl, synfig-core and synfig-studio.
* '''[http://download.tuxfamily.org/synfig/api/ETL/annotated.html ETL]''' is the extended template library. One of its most important components is the shared object class, which is the base class for most other parts of the application. Using "handles" to shared objects instead of c++ pointers provides garbage collection via reference counting.
* '''[http://download.tuxfamily.org/synfig/api/synfig-core/annotated.html Synfig-core]''' is the core/command-line (cli) renderer ("synfig") contains the document data structure for the application: valuenodes, layers, and canvases.
* '''[http://download.tuxfamily.org/synfig/api/synfig-studio/annotated.html Synfig Studio]''' ("synfig-studio") provides the gui for the application.
* See also: {{l|Dev:How Synfig Works}}

= External libs =
== Synfig use several external libs==
* [https://developer.gnome.org/gtkmm-tutorial/2.24/ Gtkmm 2], some work on branchs has been started to reach [https://developer.gnome.org/gtk3/ Gtkmm 3] ([https://developer.gnome.org/gtk3/3.4/gtk-migrating-2-to-3.html Migrating 2to3])
* [https://developer.gnome.org/gtkmm/2.24/namespaceGdk_1_1Cairo.html Cairo] (Cairo render mode)
* [http://freetype.org/ Freetype2] library (Text layer rendering in software render mode)
* [http://libxmlplusplus.sourceforge.net/ libxmlplusplus] (to parse the project files)
* [http://www.boost.org/doc/libs/1_54_0/doc/html/program_options.html Boost Program Options] (synfig cli)
* [http://www.mltframework.org/ MLT Framework - Media Loving Toolkit] (Sound Layer)
* [http://www.libpng.org/pub/png/libpng.html libpng] (load and write .png files)

==Optionally you will also need==
* [http://www.imagemagick.org/Magick++/ Magick++] the ImageMagick API (to build mod_magickpp, the magick++ module from synfig-core)
* libavcodec (to build mod_libavcodec, from synfig-core)
* libmng (to build mod_mng, from synfig-core)
... check the {{l|Dev:Build Instructions}} page for more detailed informations.

=Complete coding tutorials=
* {{l|Dev:Adding a Layer}}
* Adding a Panel, {{l|Dev:Adding a Panel - Part I|Part I}} and {{l|Dev:Adding a Panel - Part II|Part II}}. '''Note: these are highly out of date''' please note that the directory "gtkmm" has been renamed to "gui", Panel is now know has Dock. Also, some files were moved into subfolders (take a look inside the "gui/docks" folder for example).

=Other links=
* [http://download.tuxfamily.org/synfig/api/index.html ETL, Synfig, SynfigStudio Api documentation]
* [http://synfig.org/wiki/index.php?title=Special:PrefixIndex&from=&namespace=102 All Dev namespace pages]
* {{l|Dev:Translation|Translate the application}}
* {{l|Dev:Release|Release procedure}}
* {{l|Dev:GoogleSoC|Google Summer of Code}}
* [http://sourceforge.net/p/synfig/mailman/synfig-devl/ Synfig Developer Mailing List]
* [https://github.com/synfig/synfig/issues Synfig Issue Tracker]
* [http://www.synfig.org/forums/viewtopic.php?f=2&t=6097 Genete free stuff...]
* {{l|Dev:C%2B%2B11_Migration|C++11 Migration}}

Dev:Adding a Panel - Part II

2017-03-16T16:10:12Z

Want:

{{Title|Adding a Panel - Part II}}
{{Category|Code}}

'''These are highly out of date''' please note that the directory "gtkmm" has been renamed to "gui",
Panel is now know has Dock. Also, some files were moved into subfolders, take a look
inside the "gui/docks" folder is a good start to understand how Docks and Dockable Class work.

== Adding Widgets ==

This example will show how to add widgets to the boring panel that was made in {{l|Dev:Adding a Panel - Part I|Part I}}.

Defined in <gtkmm dir>dockable.h file, The only widgets defined are the "toolbar" and "toolbarbutton" so I will show these first. Then use some of the other widgets in the "canvasarea" and show how the toolbutton(s) can work together with the widgets in the "canvasarea" to modify, change or create items or parameters in Synfig Studio.

===ADDING A TOOL BAR BUTTON===
To use a toolbar button in your panel add this section of code to the class and function.
==== FILE: <mod dir>boringedit.h====
==== CLASS: class Dock_BoringEdit : public Dockable====

void on_add_pressed();

==== FILE: <mod dir>boringedit.cpp====
====FUNCTION: dock_BoringEdit::Dock_BoringEdit()====
The button icon can be changed to any of the stock id icons. Here we have it set to "gtk-add".
The link shows the GTK name, just use "gtk-about", "gtk-bold", "gtk-apply" in that fashion etc..
http://www.gtkmm.org/docs/gtkmm-2.4/docs/reference/html/namespaceGtk_1_1Stock.html#bf965c1d305e2880ac77f830477bb282

This function can be added as many times as you want. The widget will create a drop down box if widget(s) are larger than GUI allows.

add_button(
Gtk::StockID("gtk-add"),
_("ADD")
)->signal_clicked().connect(
sigc::mem_fun(
*this,
&Dock_BoringEdit::on_add_pressed
)
);

Then add this stub function "on_add_pressed" which will do noting except be a place holder for the signal of button(s).

void Dock_BoringEdit::on_add_pressed()
{
}

==NOT FINISHED YET..==

Dev:Adding a Panel - Part II

2017-03-16T16:09:52Z

Want:

{{Title:Adding a Panel - Part II}}
{{Category|Code}}

'''These are highly out of date''' please note that the directory "gtkmm" has been renamed to "gui",
Panel is now know has Dock. Also, some files were moved into subfolders, take a look
inside the "gui/docks" folder is a good start to understand how Docks and Dockable Class work.

== Adding Widgets ==

This example will show how to add widgets to the boring panel that was made in {{l|Dev:Adding a Panel - Part I|Part I}}.

Defined in <gtkmm dir>dockable.h file, The only widgets defined are the "toolbar" and "toolbarbutton" so I will show these first. Then use some of the other widgets in the "canvasarea" and show how the toolbutton(s) can work together with the widgets in the "canvasarea" to modify, change or create items or parameters in Synfig Studio.

===ADDING A TOOL BAR BUTTON===
To use a toolbar button in your panel add this section of code to the class and function.
==== FILE: <mod dir>boringedit.h====
==== CLASS: class Dock_BoringEdit : public Dockable====

void on_add_pressed();

==== FILE: <mod dir>boringedit.cpp====
====FUNCTION: dock_BoringEdit::Dock_BoringEdit()====
The button icon can be changed to any of the stock id icons. Here we have it set to "gtk-add".
The link shows the GTK name, just use "gtk-about", "gtk-bold", "gtk-apply" in that fashion etc..
http://www.gtkmm.org/docs/gtkmm-2.4/docs/reference/html/namespaceGtk_1_1Stock.html#bf965c1d305e2880ac77f830477bb282

This function can be added as many times as you want. The widget will create a drop down box if widget(s) are larger than GUI allows.

add_button(
Gtk::StockID("gtk-add"),
_("ADD")
)->signal_clicked().connect(
sigc::mem_fun(
*this,
&Dock_BoringEdit::on_add_pressed
)
);

Then add this stub function "on_add_pressed" which will do noting except be a place holder for the signal of button(s).

void Dock_BoringEdit::on_add_pressed()
{
}

==NOT FINISHED YET..==

Dev:Adding a Panel - Part I

2017-03-16T16:09:07Z

Want:

{{Title|Adding a Panel - Part I}}
{{Category|Code}}

'''These are highly out of date''' please note that the directory "gtkmm" has been renamed to "gui",
Panel is now know has Dock. Also, some files were moved into subfolders, take a look
inside the "gui/docks" folder is a good start to understand how Docks and Dockable Class work.

Here's an example of how to build a module and add a basic panel option to the file menu in Synfig Studio. For this example I will make a empty panel option and have subsequent parts adding to it.

Section 1, "The Code" will present the entire source, uninterrupted

== The Code ==

We need to create four new files (two header (.h) files. One for the module and one for the dock, and two implementations (.cpp) files. Also one for the module and one for the dock), and edit one existing files (outside of the newly created module directory app.cpp, and the Makefile.am), all in the synfigstudio/src/gtkmm/ folder:

=== <gtkmm dir>/mod_boring/mod_boring.h ===

/* === S Y N F I G ========================================================= */
/*! \file mod_boring.h
** \brief Template Header
**
** $Id$
**
** \legal
** Copyright (c) 2002-2005 Robert B. Quattlebaum Jr., Adrian Bentley
**
** This package is free software; you can redistribute it and/or
** modify it under the terms of the GNU General Public License as
** published by the Free Software Foundation; either version 2 of
** the License, or (at your option) any later version.
**
** This package is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
** General Public License for more details.
** \endlegal
*/
/* ========================================================================= */
/* === S T A R T =========================================================== */
#ifndef __SYNFIG_MOD_BORING_H
#define __SYNFIG_MOD_BORING_H
/* === H E A D E R S ======================================================= */
#include <ETL/handle>
#include "../module.h"
/* === C L A S S E S & S T R U C T S ======================================= */
namespace studio {
class Dock_BoringEdit;
class ModBoring : public Module
{
friend class Dock_BoringEdit;
Dock_BoringEdit* dock_boring_edit;

protected:
virtual bool start_vfunc();
virtual bool stop_vfunc();

public:
virtual ~ModBoring() { stop(); }
};

}; // END of namespace studio
/* === E N D =============================================================== */
#endif

=== <gtkmm dir>/mod_boring/mod_boring.cpp ===

/* === S Y N F I G ========================================================= */
/*! \file mod_boring.cpp
** \brief Template File
**
** $Id$
**
** \legal
** Copyright (c) 2002-2005 Robert B. Quattlebaum Jr., Adrian Bentley
**
** This package is free software; you can redistribute it and/or
** modify it under the terms of the GNU General Public License as
** published by the Free Software Foundation; either version 2 of
** the License, or (at your option) any later version.
**
** This package is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
** General Public License for more details.
** \endlegal
*/
/* ========================================================================= */
/* === H E A D E R S ======================================================= */
#ifdef USING_PCH
# include "pch.h"
#else
#ifdef HAVE_CONFIG_H
# include <config.h>
#endif
#include "mod_boring.h"
#include "dock_boringedit.h"
#include "../app.h"
#include "../dockmanager.h"
#include "../general.h"
#endif
/* === U S I N G =========================================================== */
using namespace std;
using namespace etl;
using namespace synfig;
using namespace studio;
/* === M E T H O D S ======================================================= */
bool
studio::ModBoring::start_vfunc()
{
dock_boring_edit=new Dock_BoringEdit();
App::get_dock_manager()->register_dockable(*dock_boring_edit);
return true;
}
bool
studio::ModBoring::stop_vfunc()
{
App::get_dock_manager()->unregister_dockable(*dock_boring_edit);
delete dock_boring_edit;
return true;
}

=== <gtkmm dir>/mod_boring/dock_boring.h ===

/* === S Y N F I G ========================================================= */
/*! \file dock_boringedit.h
** \brief Template Header
**
** $Id$
**
** \legal
** Copyright (c) 2002-2005 Robert B. Quattlebaum Jr., Adrian Bentley
**
** This package is free software; you can redistribute it and/or
** modify it under the terms of the GNU General Public License as
** published by the Free Software Foundation; either version 2 of
** the License, or (at your option) any later version.
**
** This package is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
** General Public License for more details.
** \endlegal
*/
/* ========================================================================= */
/* === S T A R T =========================================================== */
#ifndef __SYNFIG_STUDIO_DOCK_BORING_EDIT_H
#define __SYNFIG_STUDIO_DOCK_BORING_EDIT_H
/* === H E A D E R S ======================================================= */
#include <gtk/gtk.h>
#include <gtkmm/adjustment.h>
#include <gtkmm/table.h>
#include <gtkmm/dialog.h>
#include <synfig/time.h>
#include <synfigapp/value_desc.h>
#include <synfig/time.h>
#include "../dockable.h"
#include <vector>
#include <gtkmm/actiongroup.h>
/* === C L A S S E S & S T R U C T S ======================================= */
namespace synfigapp {
class CanvasInterface;
};
namespace studio {

class Dock_BoringEdit : public Dockable
{
Glib::RefPtr<Gtk::ActionGroup> action_group;
Gtk::Table table;
sigc::signal<void> signal_changed_;
public:
Dock_BoringEdit();
~Dock_BoringEdit();
}; // END of Dock_BoringEdit
}; // END of namespace studio
/* === E N D =============================================================== */
#endif

=== <gtkmm dir>/mod_boring/dock_boring.cpp ===

/* === S Y N F I G ========================================================= */
/*! \file dock_boringedit.cpp
** \brief Template File
**
** Takes two lists of ducks coords and matches one to another blines ducks coords
** creating a shapeshift not a tween of the two blines instead of working with one
** bline.
**
** $Id$
**
** \legal
** Copyright (c) 2002-2005 Robert B. Quattlebaum Jr., Adrian Bentley
** Copyright (c) 2007 Chris Moore
**
** This package is free software; you can redistribute it and/or
** modify it under the terms of the GNU General Public License as
** published by the Free Software Foundation; either version 2 of
** the License, or (at your option) any later version.
**
** This package is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
** General Public License for more details.
** \endlegal
*/
/* ========================================================================= */
/* === H E A D E R S ======================================================= */
#ifdef USING_PCH
# include "pch.h"
#else
#ifdef HAVE_CONFIG_H
# include <config.h>
#endif
#include "dock_boringedit.h"
#include <gtkmm/frame.h>
#include <gtkmm/table.h>
#include <gtkmm/label.h>
#include <synfig/general.h>
#include <synfigapp/canvasinterface.h>
#include <synfigapp/value_desc.h>
#include <synfigapp/main.h>
#include "../app.h"
#include "../general.h"
#endif
/* === U S I N G =========================================================== */
using namespace std;
using namespace etl;
using namespace synfig;
using namespace studio;
/* === M E T H O D S ======================================================= */
Dock_BoringEdit::Dock_BoringEdit():
Dockable("boring_edit",_("Boring"), Gtk::StockID("gtk-execute")),
table(2,2,false)
{
Glib::ustring ui_info =
"<ui>"
" <toolbar action='toolbar-boring'>"
" </toolbar>"
"</ui>" ;
App::ui_manager()->add_ui_from_string(ui_info);
set_toolbar(*dynamic_cast<Gtk::Toolbar*>(App::ui_manager()->get_widget("/toolbar-boring")));
add(table);
table.set_homogeneous(true);
show_all_children();
}
Dock_BoringEdit::~Dock_BoringEdit()
{
}

=== <gtkmm dir/app.cpp ===
Now we edit <gtkmm dir>mod_boring/app.cpp. Add this with the other #include lines:

#include "mod_boring/mod_boring.h"

We add this with the others in the G L O B A L section lines:

etl::handle< studio::ModBoring > mod_boring_;

(edited by Mesco64)
I just couldn't see the new entry under the Panels menu. In order to make it work I had to add these couple of lines to <gtkmm dir>mod_boring/app.cpp (line 1272 aprox.):

studio_init_cb.task(_("Init ModBoring..."));
module_list_.push_back(new ModBoring()); module_list_.back()->start();

After this change not only the newly created panel is available under Panels menu, but this way you'll find it already open on startup (the second line creates an instance of the panel)
Moreover, Synfig remembers about open panels and where they're placed... very nice
(end addition)

=== <gtkmm dir>/Makefile.am ===

Then I need to edit <gtkmm dir>Makefile.am and add these two files to the list of source files (maintain alphabetical order please):

This will be added above the PALETTE_HH section.

BORING_HH = \
mod_boring/dock_boringedit.h mod_boring/mod_boring.h
BORING_CC = \
mod_boring/dock_boringedit.cpp mod_boring/mod_boring.cpp

This will be added to the list of items in the "synfigstudio_SOURCES =" line.
$(BORING_CC) $(BORING_HH)

== Compiling ==

Note: This directory structures is based on the *NIX environment.

First you will need to follow the http://www.synfig.org/Build_Instructions.
Then you will need to create a directory in synfigstudio/src/gtkmm/ called mod_boring.
Next you will copy the above four files into that directory.
After That you will need to modify the two files app.cpp and Makefile.am as stated above.
You will have to run "autoreconf --install --force" and "./configure" once again to sync the makefiles up with your changes. This is only done if you modify the Makefile.am

== The Location ==

{{l|Image:adding_a_panel_I_1.jpg|300px}}

After you install the newly compiled Synfigstudio, run the binary. From the main Synfigstudio interface choose the "File" option and select "panels".

{{l|Image:adding_a_panel_I_2.jpg|150px}}

From here your new panel should be located in this list of items. Select it. An empty tab window, based on the default synfigstudio layout should show up with the default exec icon. The only thing you can do at this time is drag and drop it into another one of the panels. To try this choose one or more and drag it onto the boring panel. They should become one. This gives you a basic dock widget to work with.

{{l|Image:adding_a_panel_I_3.jpg|150px}}

== Adding Widgets ==

This will be described in the next part of adding a panel.

{{l|Dev:Adding a Panel - Part II | Adding a Panel Part II}}

Dev:Adding a Layer

2017-03-16T16:07:05Z

Want:

{{Title|Adding a Layer}}
{{Category|Code}}
Here's an example of how to add a simple layer to an existing module. For this example I picked something very easy: a layer which removes all colour from the layers beneath it. I will call this creation "Desaturate", and add it to the mod_filter module.

Section 1, [[Dev:Adding_a_Layer#The Code|"The Code"]] will present the entire source, uninterrupted, and section 2, [[Dev:Adding_a_Layer#The Description|"The Description"]] will break it up into small chunks and discuss it.

== The Code ==

We need to create two new files (one header (.h) file, and one implementation (.cpp) file), and edit two existing files (the module's main.cpp, and the Makefile.am), all in the synfig-core/src/modules/mod_filter/ folder:

=== <module>/desaturate.h ===

/* === S Y N F I G ========================================================= */
/*! \file desaturate.h
** \brief Header file for implementation of the "Desaturate" layer
**
** \legal
** Copyright (c) 2008 Chris Moore
**
** This package is free software; you can redistribute it and/or
** modify it under the terms of the GNU General Public License as
** published by the Free Software Foundation; either version 2 of
** the License, or (at your option) any later version.
**
** This package is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
** General Public License for more details.
** \endlegal
** ========================================================================= */

/* === S T A R T =========================================================== */

#ifndef __SYNFIG_DESATURATE_H
#define __SYNFIG_DESATURATE_H

/* === H E A D E R S ======================================================= */

#include <synfig/layer.h>

/* === C L A S S E S & S T R U C T S ======================================= */

class Desaturate : public synfig::Layer
{
SYNFIG_LAYER_MODULE_EXT
public:
virtual synfig::ValueBase get_param(const synfig::String&)const;
virtual Vocab get_param_vocab()const;
virtual synfig::Color get_color(synfig::Context, const synfig::Point&)const;
virtual bool accelerated_render(synfig::Context,synfig::Surface*,int,
const synfig::RendDesc &, synfig::ProgressCallback *)const;
}; // END of class Desaturate

#endif

=== <module>/desaturate.cpp ===

/* === S Y N F I G ========================================================= */
/*! \file desaturate.cpp
** \brief Implementation of the "Desaturate" layer
**
** \legal
** Copyright (c) 2008 Chris Moore
**
** This package is free software; you can redistribute it and/or
** modify it under the terms of the GNU General Public License as
** published by the Free Software Foundation; either version 2 of
** the License, or (at your option) any later version.
**
** This package is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
** General Public License for more details.
** \endlegal
** ========================================================================= */

/* === H E A D E R S ======================================================= */

#ifdef USING_PCH
# include "pch.h"
#else
#ifdef HAVE_CONFIG_H
# include <config.h>
#endif

#include "desaturate.h"

#include <synfig/context.h>
#include <synfig/paramdesc.h>
#include <synfig/renddesc.h>
#include <synfig/surface.h>
#include <synfig/value.h>

#endif

using namespace synfig;

/* === G L O B A L S ======================================================= */

SYNFIG_LAYER_INIT(Desaturate);
SYNFIG_LAYER_SET_NAME(Desaturate,"desaturate");
SYNFIG_LAYER_SET_LOCAL_NAME(Desaturate,N_("Desaturate"));
SYNFIG_LAYER_SET_CATEGORY(Desaturate,N_("Filters"));
SYNFIG_LAYER_SET_VERSION(Desaturate,"0.1");
SYNFIG_LAYER_SET_CVS_ID(Desaturate,"$Id$");

/* === M E T H O D S ======================================================= */

ValueBase
Desaturate::get_param(const String &param)const
{
EXPORT_NAME();
EXPORT_VERSION();

return ValueBase();
}

Layer::Vocab
Desaturate::get_param_vocab()const
{
return Layer::Vocab();
}

Color
Desaturate::get_color(Context context, const Point &getpos)const
{
Color tmp(context.get_color(getpos));
return tmp.set_s(0);
}

bool
Desaturate::accelerated_render(Context context,
Surface* surface,
int quality,
const RendDesc& renddesc,
ProgressCallback* cb
)const
{
SuperCallback supercb(cb,0,9500,10000);

// render the context onto the given surface
if(!context.accelerated_render(surface,quality,renddesc,&supercb))
return false;

// set the saturation of each pixel to zero
int x,y;
Surface::pen pen(surface->begin());
for(y=0;y<renddesc.get_h();y++,pen.inc_y(),pen.dec_x(x))
for(x=0;x<renddesc.get_w();x++,pen.inc_x())
{
Color tmp(pen.get_value());
pen.put_value(tmp.set_s(0));
}

// mark our progress as finished
if(cb && !cb->amount_complete(10000,10000)) return false;
return true;
}

=== <module>/Makefile.am ===

Then I need to edit modules/mod_filter/Makefile.am and add these two files to the list of source files (maintain alphabetical order please):

libmod_filter_la_SOURCES = blur.cpp blur.h colorcorrect.cpp colorcorrect.h desaturate.cpp desaturate.h halftone2.cpp halftone2.h lumakey.cpp lumakey.h radialblur.cpp radialblur.h main.cpp halftone.cpp halftone.h halftone3.cpp halftone3.h

=== <module>/main.cpp ===

And finally we edit modules/mod_filter/main.cpp. Add this with the other #include lines:

#include "desaturate.h"

and add this with the other LAYER(...) lines:

LAYER(Desaturate)

then rebuild (including the autoreconf, ./configure, etc., to get the new files added to the Makefile) and we're done.

== The Description ==

I'll break the header up into sections, describing each part:

=== The initial comment ===

This contains basic documentation and legal stuff. Just copy, paste, and edit from another file.

/* === S Y N F I G ========================================================= */
/*! \file desaturate.h
** \brief Header file for implementation of the "Desaturate" layer
**
** \legal
** Copyright (c) 2008 Chris Moore
**
** This package is free software; you can redistribute it and/or
** modify it under the terms of the GNU General Public License as
** published by the Free Software Foundation; either version 2 of
** the License, or (at your option) any later version.
**
** This package is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
** General Public License for more details.
** \endlegal
** ========================================================================= */

/* === S T A R T =========================================================== */

=== Protection against Multiple Inclusion ===

This #ifndef is a standard way to make sure the header is only compiled once, even if it happens to be included multiple times. Use a unique symbol, based on the file name.

#ifndef __SYNFIG_DESATURATE_H
#define __SYNFIG_DESATURATE_H

=== Headers ===

Include files which are needed. We're not doing anything much, so all we need to include is layer.h, which defines the Layer class that all layers inherit from.

/* === H E A D E R S ======================================================= */

#include <synfig/layer.h>

=== The Class ===

Define the class which implements our layer. We inherit from the Layer class. For this simple example we only define four methods. The rest will be inherited from the Layer class.

/* === C L A S S E S & S T R U C T S ======================================= */

class Desaturate : public synfig::Layer
{

=== SYNFIG_LAYER_MODULE_EXT ===

This is standard. Just use it for every layer. It declares members to hold the layer's name, version, category, etc., and also declares a method to create() the layer. See synfig-core/src/synfig/layer.h for its definition.

SYNFIG_LAYER_MODULE_EXT

=== The Methods ===

Then we declare the four methods we're going to implement.

==== get_param ====
First "get_param()". Since our layer isn't going to have any parameters, all it needs to do is make the layer's name and
version available.

public:
virtual synfig::ValueBase get_param(const synfig::String&)const;

==== get_param_vocab ====

This one returns a list of the layer's parameters. We have no parameters, so we return an empty list.

virtual Vocab get_param_vocab()const;

==== get_color ====

This one is used to find the color of a single given pixel. It's used by the "Info" panel to display the R,G,B values as you mouse over the canvas. It's also used if our layer has any transformation layers over the top of it. The absence of a working implementation of this method in the "Text" layer is why distorting text currently causes render artifacts.

virtual synfig::Color get_color(synfig::Context, const synfig::Point&)const;

==== accelerated_render ====

This one is used to render a large rectangular piece of our layer in one go. It typically calls the accelerated_render() method for the layers under our layer (the 'context') and then modifies the results of that call in some way:

virtual bool accelerated_render(synfig::Context,synfig::Surface*,int,
const synfig::RendDesc &, synfig::ProgressCallback *)const;
}; // END of class Desaturate

#endif

== Implementation ==

I won't reproduce the whole of the .cpp file here and go through it. The only two methods which are really interesting here are get_color() and accelerated_render():

Note the "G L O B A L S" section of the code defines the layer's name (lower case, used in .sif files), its "local" name (this is the string which is translated, and is capitalized), which category the layer belongs in (this determines where it appears in the 'new layer' menu), the layer's version (0.1 for new layers), etc.

=== get_color() ===

Given the context, and a point, get_color() should return the color of the pixel at the given point. The context has a get_color() method, so we use that to look up the color of the pixel before our layer has had a chance to affect it, and store that in 'tmp'. Then we set its saturation to zero using [http://synfig.org/api/synfig/classsynfig_1_1Color.html#b62c2069fc43baa97fba17b33ff4d32d color.set_s()] and return it. That's all:

Color
Desaturate::get_color(Context context, const Point &getpos)const
{
Color tmp(context.get_color(getpos));
return tmp.set_s(0);
}

=== accelerated_render() ===

We accept five arguments:

The context (ie. the layers under us):

bool
Desaturate::accelerated_render(Context context,

The surface we are supposed to write our results onto:

Surface* surface,

The quality at which we are to render:

int quality,

A description of the area to render - width, height, top left corner, resolution, etc, etc:

const RendDesc& renddesc,

An object which is used to monitor our progress. It's used for calculating the expected remaining time while rendering:

ProgressCallback* cb
)const
{

I didn't get around to looking at the way the 'cb' ProgressCallback is used. But this code is in pretty much all layers:

SuperCallback supercb(cb,0,9500,10000);

We call accelerated_render() on the context, to render the layers under us. We just pass on the arguments we received for surface, quality and renddesc, along with the new callback we just made. If that render fails, then we fail too:

// render the context onto the given surface
if(!context.accelerated_render(surface,quality,renddesc,&supercb))
return false;

Now we do the real work of this layer. We define integers to do the looping, and a 'pen' which we can walk over the rectangle we're working on:

// set the saturation of each pixel to zero
int x,y;
Surface::pen pen(surface->begin());

We loop through every pixel on every row of the rectangle we're working on. The 'renddesc' gives us the width and height of the rectangle. The pen has methods inc_x(), dec_x(), inc_y(), dec_y() which move it a given amount:

for(y=0;y<renddesc.get_h();y++,pen.inc_y(),pen.dec_x(x))
for(x=0;x<renddesc.get_w();x++,pen.inc_x())

At each pixel, we get the color as rendered from the context, set its saturation to zero, and write it back to the same surface:

{
Color tmp(pen.get_value());
pen.put_value(tmp.set_s(0));
}

And that's about it.

// mark our progress as finished
if(cb && !cb->amount_complete(10000,10000)) return false;
return true;
}

== Adding Parameters ==

Suppose now we want to add a parameter to the layer. Let's add a Real valued parameter called "scale". It will let the user set a value to scale the saturation by. It will default to zero, meaning to scale the saturation down to zero. When adding parameters, it's a good idea to set the default value to its effective previous value, so that old .sif files will continue to be rendered the same as before.

To add this parameter, we need to do the following:

=== desaturate.h ===

In the desaturate.h header file, include real.h (the parameter is Real valued, so we need the typedef for Real):

#include <synfig/real.h>

Add a private member to the class, type Real:

private:
synfig::Real scale;

Declare a default constructor. This is where we will set the default value of the new parameter:

Desaturate();

Declare set_param(). This will allow our layer to accept new values for the parameter:

virtual bool set_param(const synfig::String&, const synfig::ValueBase&);

=== desaturate.cpp ===

In the implementation file, we need to:

write a simple default constructor, which initializes the value of 'scale' to zero:

Desaturate::Desaturate():
scale(0)
{}

Add a line to supply the value of 'scale' in get_param():

ValueBase
Desaturate::get_param(const String &param)const
{
EXPORT_NAME();
EXPORT_VERSION();

EXPORT(scale);

return ValueBase();
}

Add new method set_param():

bool
Desaturate::set_param(const String &param, const ValueBase &value)
{
IMPORT(scale);

return false;
}

Replace the definition of get_param_vocab():

Layer::Vocab
Desaturate::get_param_vocab()const
{
Layer::Vocab ret;

ret.push_back(ParamDesc("scale")
.set_local_name(_("Scale"))
.set_description(_("Factor to scale the saturation by"))
);

return ret;
}

And change the two places where the saturation is set. In get_color():

return tmp.set_s(scale * tmp.get_s());

And in accelerated_render():

pen.put_value(tmp.set_s(scale * tmp.get_s()));

Dev:How Synfig Works

2017-03-16T16:05:25Z

Want:

{{Title|How Synfig Works}}
{{l|Image:Synfig-engine.png}}

The diagram shows more or less how Synfig is currently organized. "V" stands for valuenodes, "L" for layers, "BL" for blank layer (completely transparent layer default background), "BM" for blend method.

When Synfig needs to render a frame it starts by evaluating the valuenodes parameters of layers. If a valuenode is a Convert type then it evaluates its parameters. This process works recursively, going all the way down to the leaf nodes, calculating their value, then calculating the value of their parent, and so on until reaching the root of the node tree.

Note that valuenodes can be animated, meaning that they change value as animation time progresses. Since any leaf valuenode may have changed, the entire tree needs to be evaluated on each frame.

Once a layer has the values for it's parameters, it renders the intended shape or effect onto a raster. A raster is an array of pixels, each pixel with its color/opacity. It doesn't carry any information about the vector shapes that it's representing, only their pixel data.

Then comes blending. The raster result of the previous layers is combined with the current one according to the set blending method. Some layers (transforms, distortions, etc) just modify the raster result of the previous layers and pass that on to the next layer, instead of blending.

Note that a layer sees all the layers underneath as a single combined raster. That layer cannot distinguish the pixel data that comes from the next layer that's underneath, from pixel data from any other layer that's underneath.

The distinction between vector and raster "worlds" is important (green background for vector, red for raster in the diagram). In vector world the objects are represented symbolically, with numbers and equations that describe their caracteristics. In raster world everything is represented in a concrete way, as pixel data.

There needs to be a way to go from vector to raster world. This is called rasterization or rendering. The layers (some of them that is) sit in between the two worlds, providing the rendering.

More infos : [[Dev:Introduction_to_Layers|Introduction to Layers]]

Dev:ETL replacement

2017-03-16T16:04:22Z

Want:

{{Title|ETL replacement}}
At least the majority of the functionality implemented in the ETL is already implemented in the boost libraries, which have a very high quality, are broadly used, peer-reviewed and well tested. This effort is to replace the ETL with boost libraries, achieving simplified code with a more robust base.

The replacement will be done in the following order:
# command-line interface (ONGOING)
# synfig modules
# synfig library
# synfig studio library
# synfig studio
Along the way I can most probably simplify/improve some stuff and make synfig's code cleaner.

Follow the progress in [https://github.com/eldruin/synfig/tree/eldruin_etl_replacement this branch]

[http://www.synfig.org/issues/thebuggenie/synfig/issues/723 Bug tracker issue]

Here is a list of functions of the ETL and their replacement:

{| class="wikitable"
|-
! ETL
! Boost equivalent
|-
| etl::filename_extension
| boost::filesystem::path::extension()
|-
| etl::filename_sans_extension
| boost::filesystem::path: combination of parent_path(), stem() and extension()
|-
| etl::basename
| boost::filesystem::path: combination of stem() and extension()
|-
| etl::dirname
| boost::filesystem::path::parent_path()
|-
| etl::clock
| boost::chrono::system_clock or high_resolution_clock
|-
| etl::strprintf
| boost::format()
|}

Dev:UI/UX Redesign

2017-03-16T16:03:28Z

Want:

{{Title|UI/UX Redesign}}
[[File:Synfig_Studio_UI_n_UX.png]]

== Bran New Synfig Studio ==
It is very important that the UI of Synfig Studio should be user friendly.So,that it provided rich user experience to it's users.
User experience has been referred to as the overall experience the end user has with the company,it's products and services and how they feel about using the system.User experience(UX)not only emphasizes on important,effective and meaningful aspects of human computer interaction and ownership of product but also involves a persons point of view on the aspects such as efficiency of the system and ease of use.UX is subjective to change as it is based on individuals thoughts and feelings about the interface he is interacting with and the overall system.

Resource:
*[http://www.techved.com/uae/ux/defined-firm The concept of UX explained by Techved]

Dev:Coding Conventions

2017-03-16T16:02:49Z

Want:

{{Title|Coding Convetions}}
==Introduction==
Here are described the rules or conventions to make the Synfig code better from the point of view of style. The goal is to improve readability and make easier the understanding of the code in any editor and for new potential coders.

The coding rules established by [http://google-styleguide.googlecode.com/svn/trunk/cppguide.xml this link] are good references to follow in case of doubt.

Those rulers are not absolutely mandatory but the Synfig Team reserves the right of reject patches that doesn't follow some minimums.

== Templates ==
In each section (etl, synfig-core, synfig-studio) there is a template file. Use it to create a new file. We use .cpp for implementation and .h for header files.
We usually keep the copyrights of Robert and Adrian when the new file is one version of a similar existing one and should add the copyright of the contributor.

== Names ==

* File names: Filenames should be all lowercase and can include underscores (_). Some further rules may be defined for specific file types (icons, helper files, etc.).
* Type names: Type names start with a capital letter and have a capital letter for each new word, with no underscores.
* Variable names: Variable names are all lowercase, with underscores between words. Class member variables have trailing underscores.
* Function names: --define me--
* Enumerators names: Use capital letters and always use a prefix to identify them all.

== Comments and Documentation ==

* You can use either the // or the /* */ syntax; however, // is much more common. Be consistent with how you comment and what style you use where.
* Please try to document in this order: header file (.h) top description, class descriptions, member descriptions, procedures description. If something else is needed to document, then do it in the implementation file (.cpp)
* When possible document ''before'' the line involved. Documenting in the same line is not recommended.

== Formatting ==

* Use tabs or spaces on the indentation but once selected keep it consistent in all the document. Use only spaces on alignment.
* Try to avoid longer lines than 80 characters. If needed break the line using back slash character (\)
* Function implementation:
** Place the returned value in the previous line.
** Place the two curly brackets in the first column and the implementation one indentation right.
* Conditionals, loops, and any thing that needs two curly brackets: Place the curly brackets in the same column and the inside code one indentation right.

Dev:Wish list/cs

2017-03-16T16:01:53Z

Want: Created page with "{{Title|Seznam přání uživatelů}} Všechny položky byly přesunuty do systému pro hlášení chyb - http://www.synfig.org/issues/thebuggenie/synfig"

{{Title|Seznam přání uživatelů}}
Všechny položky byly přesunuty do systému pro hlášení chyb - http://www.synfig.org/issues/thebuggenie/synfig

Dev:Wish list

2017-03-16T15:57:50Z

Want:

{{Title|Wish list}}
All items are transfered to the bugtracker - http://www.synfig.org/issues/thebuggenie/synfig

Dev:Roadmap

2017-03-16T15:56:45Z

Want:

{{Title|Roadmap}}
== New rendering engine (opengl based) ==

[[File:Roadmap-NewEngine.png]]

== The list of features to be polished for 1.0 ==
* Single-WIndow and Gtk3 UI
* Group transformations widget
* Bones / Cutout tools
* Bone distortion
* Sound layer

=== Current Status of polishing ===
* {{L|Dev:Roadmap/Bones|Bones}} (''18/26 done'')
* {{L|Dev:Roadmap/Frame-by-frame animation (bitmap)|Frame-by-frame animation (bitmap)}} (''10/26 done'')
* {{L|Dev:Roadmap/UI|UI improvement}} (''4/7 done'')
* {{L|Dev:Roadmap/Speed|Rendering speed optimization}} (''3/11 done'')
* {{L|Dev:Roadmap/SFG Format|SFG Format}}
* {{L|Dev:Roadmap/Sound|Sound support}} (''6/10 done'')
* Video import
* Vector drawing tools
* Scripting (python) (''minimal support ready : scripts can be called from an entry menu'')
* SWF export

Take also a look to our [http://www.synfig.org/issues/thebuggenie/synfig/roadmap issue tracker roadmap]

Nota : The following list of features will NOT be subject for polishing for 1.0, but will be available as "experimental features":
* SFG container
* MyPaint integration
* Frame-by-frame animation tools
(we will focus on them after 1.0 release)

Dev:Action System

2017-03-16T15:55:46Z

Want:

{{Title|Action System}}
The action system provides a good entry-point into Synfig because it functions as a stand-alone component that only interacts with Synfig's core data structure. This page is intended to provide a quick overview of the structure of the action system.

==Data Structures==

The action system interacts with the underlying data structure of a Synfig document. An action is most likely to affect the parameters of a given layer or object, which are described by the following classes.

===Value (ValueBase)===
The ValueBase class can store values of any of the {{l|Dev:Types|13 Value Types}}, such as numbers, points, and colors. Before reading or setting any values, it is important to check the type of value being used (by calling value.get_type()). Getting the contents of the value as a C++ type also requires knowing what type is expected (e.g. value.get(Real())).

===ValueNode===
A {{l|ValueNode}} is a value can change with time. A "converted" or "animated" parameter is always a ValueNode.

Calling "value_node(time)" retrieves the value at that given time.

===ValueDesc===
Instances of this class describe a ''location'' where a ValueNode may be rather than that ValueNode itself. For example, they can refer to "the 'amount' parameter of layer x" or "the 5th point in the spline (bline)". That way, the ValueDesc continues to function even if the underlying value has been changed, exported, converted, etc.

Actions typically receive ValueDescs to operate on, only retrieving their values when they are necessary for computations.

==Properties of an Action==

The majority of actions are accessible by right-clicking on certain handle (ducks), parameters, or layers. At that point, Synfig Studio automatically determines which actions can be called based on the data that is currently selected.

The first step is for the action to provide a "Parameter Vocabulary" object that describes what types of parameters it needs in order to function.

===get_param_vocab()===

Typical implementation:
* Get the param vocab from the parent action. In most cases, it will be "ParamVocab ret(Action::CanvasSpecific::get_param_vocab());"
* Create a parameter description for each of the parameters your action needs(see [http://download.tuxfamily.org/synfig/api/synfig-studio/classsynfigapp_1_1Action_1_1ParamDesc.html ParamDesc])
** ParamDesc("new_value",Param::TYPE_VALUE)
** Set the parameter options e.g. "ParamDesc(...).set_local_name(_("ValueBase"))"
** The set actions all return the object, so you should chain them: ParamDesc(...).set_local_name(...).set_supports_multiple(...)
* Once the parameters are set, add them to the Parameter Vocabulary e.g. "ret.push_back(ParamDesc("new_value",Param::TYPE_VALUE).set_local_name(_("ValueBase")));"

However, the parameter types alone are not always sufficient to determine whether the action should be called. As such, checking a given parameter set is done by the action:

===is_candidate(const ParamList &x)===

Typical implementation:
* The first step of any candidate check is to test whether the requirements of the ParamDesc are met. "if (!candidate_check(get_param_vocab(), x)) return false;"
* At this point, you know that all of your parameters are present and can begin testing for specific cases. (For example, the "activepointsetoff" action is only applicable when the activepoint is currently on)
* If there are no tests to perform, return "true".

Once the parameter list is checked, Synfig Studio will pass the actual parameters to the action. The action must then retrieve their values and store them internally. This internal storage allows for the action to be un-done and re-done multiple times.

===set_param(const synfig::String& name, const Action::Param &param)===

Typical implementation:
* Retrieve value of the parameter and store it in an internal variable

The action needs to be able to check whether all of its parameters are set. While the parameter list is checked when the action is called as a result of a right-click menu, any actions called from other places (e.g. by other actions) manually set parameters and must check that the proper parameters are present.

===is_ready()===

Typical implementation:
* Return false if your custom parameters are unset
* Check that the required parameters for CanvasSpecific actions are met "return Action::CanvasSpecific::is_ready();"

===get_param(const synfig::String& name, Action::Param &param)===

Typical implementation:
* Set the value of the parameter from the action point of vue

The action is used in action like renameValueNode / renameLayer ... all case when a previous value was present.
To use get_param you will need Action::set_value_provided() property during the parameter description in {{l|Dev:Action_System#get_param_vocab()|get_param_vocab()}} implemenation.

==Types of actions==

There are two major types of actions.

===Undoable actions===
The first are standard undoable actions
*These inherit from [http://download.tuxfamily.org/synfig/api/synfig-studio/classsynfigapp_1_1Action_1_1Undoable.html Undoable] and [http://download.tuxfamily.org/synfig/api/synfig-studio/classsynfigapp_1_1Action_1_1CanvasSpecific.html CanvasSpecific]
*It is necessary to implement perform() and undo()

===Super-actions===
The second are Super-actions which can only call other actions. Since undoing a Super-action is simply undoing all of its sub-actions, these do not require an undo method.
*Inherit from [http://download.tuxfamily.org/synfig/api/synfig-studio/classsynfigapp_1_1Action_1_1Super.html Super]
*perform() and undo() are inherited from Super and should not be overridden.
*Instead, one should implement the prepare() method, which creates sub-actions

To add sub-actions:

* First create the action of the needed type e.g. "Action::Handle action(Action::create("ValueDescSet"));" or "ValueDescConnect::create()" (TODO: Style review here)
* Set its parameters:
**The canvas, canvas interface, and current time of the current action are usually passed on to children
***action->set_param("canvas",get_canvas());
***action->set_param("canvas_interface",get_canvas_interface());
***action->set_param("time",time);
**Other parameters will vary from action to action. For ValueDescSet they might be:
***action->set_param("value_desc",reference_value_desc);
***action->set_param("new_value",value);
* Add it to the action stack
** "add_action(action)"

Dev:Source code

2017-03-16T15:55:04Z

Want:

{{Title|Source code}}
{{Category|Code}}
{{Category|Permalink}}

Hey you! Do you want access to bleeding-edge Synfig? Well, I have good news. We provide a way to get the code:

*Using git (one repository)

Once you grab the code, you will need to follow the {{l|Dev:Build Instructions|build instructions}}.

Commit notifications to master branch are <strike>sent to [http://cia.vc/stats/project/synfig CIA] and</strike> shown up in the {{l|Contact|IRC channel}}.

== GIT repository at Github==

Anonymous access:

git clone git://github.com/synfig/synfig.git
People with commit access should use this command instead:

git clone git@github.com:synfig/synfig.git

Or this one if you prefer https protocol:

git clone https://github.com/synfig/synfig.git

You can also check out the [https://github.com/synfig/synfig web interface] to that repository.

Check out [https://help.github.com Github help page] for further references.

=Proposed git workflow=

* Consider the '''master''' branch the stable one.
* Each coder should have a '''username_master''' branch where all the small changes are done.
* Once the '''username_master''' branch is considered stable it can be rebased/merged to '''master'''.
* Work on new non-trivial features/fixes on '''username_feature''' branches.
* Once the '''username_feature''' branch is considered stable it can be rebased/merged to '''master'''.
* Obviously commit trivial fixes straight to the '''master'''.
* If it is possible, rebase & rework branches to keep history more sane, linear and atomic.
* Releases are tagged according to following criteria:
** If the release consist on a few trivial set of features or bug fixes then increase the third numeration level: 0.64.0 -> 0.64.1
** If the release consist on a set of important features and/or includes non backward compatible file format, then increase the second level numeration: 0.64.1 -> 0.65.0

=See Also=
While you are browsing the code, you may wish to refer to these links:

* [http://www.synfig.org/issues/thebuggenie/synfig Bug tracker]
* [http://sourceforge.net/p/synfig/mailman/synfig-devl/ Synfig Dev mailing list]
==Code overview==
* [http://download.tuxfamily.org/synfig/api/index.html API documentation]
* {{l|Dev:Source Outline|source code outline}}
* {{l|Dev:Source Glossary|source code glossary}}
* {{l|Dev:Layers|Mapping between layer types, classes and .cpp files}}
* {{l|Dev:class_ValueNode|ValueNode types}}
* {{l|Dev:BlendMethods|Blend Method enumeration values}}
==Others==
* {{l|Dev:ETL_make_check|ETL make check failures}}
* {{l|Interesting Readings}}

Dev:Building Documentation

2017-03-16T15:53:43Z

Want:

{{Title|Building Documentation}}
== Purpose ==
The purpose of this web page is to gather information about the current build system in order to migrate cmake setup.

DISCLAIMER: THIS IS NOT A HOW DO YOU BUILD ON X PLATFORM.

Template:1

2017-03-16T15:51:30Z

Want: Redirected page to Dev:Building Documentation

#REDIRECT [[Dev:Building Documentation]]

Category:File Menu/ro

2017-03-16T14:08:18Z

Want: Created page with "{{Title|File}} {{Category|Main Menu}} {{CategoryContents|File Menu}}"

Category:File Menu (Toolbox)/fr

2017-03-16T14:07:41Z

Want: Redirected page to Category:File Menu/fr

#REDIRECT [[Category:File Menu/fr]]

Category:File Menu/fr

2017-03-16T14:07:08Z

Want:

{{Title|Fichier}}
{{Category|Main Menu}}

Boite à outils

{{CategoryContents|File Menu}}

Category:File Menu (Toolbox)

2017-03-16T14:04:33Z

Want: Redirected page to Category:File Menu

#REDIRECT [[Category:File Menu]]

Command:Panels

2017-03-16T14:03:44Z

Want:

{{Title|Panels}}
{{Category|Window Menu}}

This submenu allows you to display and hide {{L|Category:Panels|Synfig panels}}. Among the complete list of panels there are few additional commands available here:
*'''Vertical Dock: Canvases, History''' - opens a vertical dock window with the {{l|Canvas Browser Panel|Canvas Browser Panel}}, the {{l|Canvas Drop Down List}} and the {{l|History Panel}}
*'''Horizontal Dock: Layers, Children, Parameters''' - opens an horizontal dock window with the {{l|Layers Panel}}, the {{l|Children Panel}} and the {{l|Parameters Panel}}
* '''Reset Windows to Original Layout'''

Command:Panels/ro

2017-03-16T14:03:22Z

Want:

{{Title|Panels}}
{{Category|Window Menu}}

Acest submeniu permite afisarea sau ascunderea {{L|Category:Panels|casetelor Synfig}}. In lista completa a casetelor, exista si cateva comenzi aditionale aici:
*'''Vertical Dock: Canvases, History''' - deschide o fereastra verticala care contine casetele {{l|Canvas Browser Panel|Canvas Browser Panel}}, the {{l|Canvas Drop Down List}} si {{l|History Dialog}}
*'''Horizontal Dock: Layers, Children, Params''' - deschide o fereastra orizontala care contine casetele {{l|Layers Panel}}, the {{l|Children Panel}} si {{l|Params Panel}}
* '''Reset Windows to Original Layout''' - readuce casetele in sablonul implicit al aplicatiei

Category:File Menu (Toolbox)/ro

2017-03-16T14:00:45Z

Want: Redirected page to Category:File Menu/ro

#REDIRECT [[Category:File Menu/ro]]

Command:New/cs

2017-03-16T13:57:29Z

Want:

{{Title|Nový (New)}}
{{Category|File Menu}}
{{Category|Canvas Window}}

{{Shortcut|Control|n}}: Otevře náhledové okno pro nový projekt. Jeho výchozí jméno je {{Literal|Synfig Animation #}} kde '''#''' zastupuje číslo od '''1''' výše. Pro každý další nový soubor v rámci otevřeného sezení Synfig Studia je toto číslo navýšeno o '''+ 1'''.

Tím, že se otevře nová {{l|Canvas}} začíná proces editace projektu.

Command:New/ro

2017-03-16T13:54:55Z

Want:

{{Title|New}}
{{Category|File Menu}}
{{Category|Canvas Window}}

{{Shortcut|Control|n}}: Creeaza un fisier nou. Numele implicit al fisierului este Synfig Animation #, unde # incepe de la 1 si este incrementat cu 1 pentru fiecare fisier nou creat cu o sesiune Synfig studio. Deschide un nou spatiu de lucru - "Root".

Command:New/fr

2017-03-16T13:54:38Z

Want:

{{Title|Nouveau}}
{{Category|File Menu}}
{{Category|Canvas Window}}

{{Shortcut|Control|n}}: Créé un nouveau fichier. Par défaut, son nom est Synfig Animation # ou # commence à 1 et augmente de 1 pour chaque nouveau fichier que vous créez lors d'une session de Synfig Studio. Cela commence en éditant le canevas "Racine".

Command:Open/cs

2017-03-16T13:53:39Z

Want:

{{Title|Otevřít (Open) }}
{{Category|File Menu}}
{{Category|Canvas Window}}
{{Shortcut|Control|o}}: Otevře dialogové okno pro výběr souboru {{l|FAQ#What_is_Synfig_Studio_native_file_format.3F|sifz}} s již uloženým projektem, který budete chtít otevřít.

V levém dolním rohu dialogového okna je tlačítko {{Shortcut|Otevřít historii}}. Pokud bude vybraný soubor typu {{Literal|.sfg}} a kliknete na ně, tak se vám zobrazí historie revizí tohoto projektu.

Command:Open/ro

2017-03-16T13:52:12Z

Want:

{{Title|Open}}
{{Category|File Menu}}
{{Category|Canvas Window}}

{{Shortcut|Control|o}}: Deschide o fereastra de dialog din care puteti alege fisierul {{l|FAQ#What_is_Synfig_Studio_native_file_format.3F|sifz}} pe care doriti sa il deschideti.

Command:Open/fr

2017-03-16T13:51:31Z

Want:

{{Title|Ouvrir}}
{{Category|File Menu}}
{{Category|Canvas Window}}

{{Shortcut|Control|o}}: Affiche une boite de dialogue de sélection de fichier afin de choisir le fichier {{l|FAQ#What_is_Synfig_Studio_native_file_format.3F|sifz}} que vous voulez ouvrir.

Le bouton {{Shortcut|Ouvrir l'historique}} propose, pour un fichier de type {{literal|.sfg}}, l'historique de révision du projet.

Command:Restore Defaults/ro

2017-03-16T13:50:25Z

Want:

{{Title|Restore Defaults}}
{{Category|Preferences}}

'''(NO SHORTCUT)''':Aceasta comanda va readuce setarile pentru preferinta la valorile implicite, permitand utilizatorului sa aiba o colectie sigura de setari si preferinte. Mai jos sunt preferintele implicite si valorile acestora:
* Unit System: Points
* Visual Linear Color Selection: True
* Restrict Real value ducks to Top Right Quadrant: True
* Scale New Imported Images to fit Canvas: False
* Use Single Thread: True (Windows only)
* New Document Filename Prefix: Synfig Animation # (where # is 1, 2, and so on)
* New Document X size: 480
* New Document Y size: 270
* New Document FPS: 24
* Predefined Default FPS: 24
* Predefied Default SIze: 480x270

Command:Restore Defaults/ro

2017-03-16T13:49:32Z

Want: Want moved page Command:Reset to Default Setup Values/ro to Command:Restore Defaults/ro

{{Title|Reset to Default Setup Values}}
{{Category|Dialogs}}
{{Category|File Menu (Toolbox)}}

'''(NO SHORTCUT)''':Aceasta comanda va readuce setarile pentru preferinta la valorile implicite, permitand utilizatorului sa aiba o colectie sigura de setari si preferinte. Mai jos sunt preferintele implicite si valorile acestora:
* Unit System: Points
* Visual Linear Color Selection: True
* Restrict Real value ducks to Top Right Quadrant: True
* Scale New Imported Images to fit Canvas: False
* Use Single Thread: True (Windows only)
* New Document Filename Prefix: Synfig Animation # (where # is 1, 2, and so on)
* New Document X size: 480
* New Document Y size: 270
* New Document FPS: 24
* Predefined Default FPS: 24
* Predefied Default SIze: 480x270

Command:Reset to Default Setup Values/ro

2017-03-16T13:49:32Z

Want: Want moved page Command:Reset to Default Setup Values/ro to Command:Restore Defaults/ro

#REDIRECT [[Command:Restore Defaults/ro]]

Input Devices/fr

2017-03-16T13:44:32Z

Want:

{{Title|Dialogue Périphériques d'entrée}}
{{Category|Dialogs}}
{{Category|Edit Menu}}
{{NewTerminology}}


Ce menu ouvre une boite de dialogue de paramétrage de périphérique afin de permettre à l'utilisateur de choisir des valeurs personnalisées. Il est recommandé d'avoir un seul périphérique Activé et de désactiver les autres. Choississez le mode Écran pour le périphérique actif.
Généralement il n'y a pas besoin de modifier autre chose.

N'oubliez pas d'enregistrer les paramètres avant de fermer.

Chaque outil peut avoir ses propres paramètres pour chaque périphérique. Donc si vous combinez le pointeur principal -Core pointer- (qui est toujours disponible) et un stylet vous devrez enregistrer un ensemble de préférences (couleur de contour et de remplissage, taille de brosse, outil sélectionné, etc...) pour chaque périphérique.

[[File:InputDevices.png]]

Input Devices/ro

2017-03-16T13:42:24Z

Want:

{{Title|Input Devices Dialog}}
{{Category|Dialogs}}
{{Category|Edit Menu)}}

Atunci cand este vizibil, acest meniu deschide fereastra de dialog Device Settings (Setari pentru Dispozitive de desenare - ex. tableta) si permite utilizatorului sa seteze valorile dorite. Se recomanda ca sa fie activ doar un dispozitiv, restul fiind dezactivate. Se seteaza modul dispozitivului activ la "Screen". In mod normal nu sunt necesare alte setari. Inainte de inchiderea ferestrei cu setari, se salveaza modificarile.

Fiecare instrument are valori proprii pentru fiecare dispozitiv, astfel incat atunci cand se combina lucrul cu Core pointer (valabil mereu) si cu stylus, se pot salva un set de preferinte (de obicei umplere culoare si linii de contur, marime pensula, instrument de selectie etc. pentru fiecare dispozitiv.

[[File:InputDevices.png]]

Command:Close

2017-03-16T13:37:04Z

Want:

{{Title|Close}}
{{Category|File Menu}}

{{Shortcut|Control|w}}: Closes the current document in edition. If it is "dirty" (modifications not saved to file) it would ask for save the file.

Command:Close/cs

2017-03-16T13:36:42Z

Want:

{{Title|Zavřít (Close)}}
{{Category|File Menu}}

{{Shortcut|Control|w}}: Zavře aktuálně editovaný dokument. Nejprve ale zkontroluje, zda-li neobsahuje neuložené změny. Pokud ano, tak se objeví dialog s dotazem, jestli se mají zahodit, nebo uložit. Po uložení projektu do souboru jeho náhledové okno zavře.

Command:Close/ro

2017-03-16T13:36:12Z

Want:

{{Title|Close}}
{{Category|File Menu}}

{{Shortcut|Control|w}}: Inchide documentul curent (cel in care lucrati). Daca ultimele modificari nu au fost inca salvate, apare o fereastra de dialog care cere salvarea documentului.

Command:Close/fr

2017-03-16T13:35:57Z

Want:

{{Title|Fermer}}
{{Category|File Menu}}

{{Shortcut|Control|w}}: Ferme le document en cours d'édition. Si celui-ci est "sale" (il contient des modifications non enregistrées) il vous sera demandé si vous voulez l'enregistrer.

Command:Close/ro

2017-03-16T13:35:12Z

Want:

{{Title|Close}}
{{Category|File Menu}}

'''(CTRL+W)''': Inchide documentul curent (cel in care lucrati). Daca ultimele modificari nu au fost inca salvate, apare o fereastra de dialog care cere salvarea documentului.

Command:Open Recent/cs

2017-03-16T13:28:18Z

Want: Created page with "{{Title|Otevřít nedávný (Open Recent)}} {{Category|File Menu}} {{Literal|Otevřít nedávný}} (Open Recent) rozbalí dynamicky generované submenu s přehledem poslední..."

{{Title|Otevřít nedávný (Open Recent)}}
{{Category|File Menu}}

{{Literal|Otevřít nedávný}} (Open Recent) rozbalí dynamicky generované submenu s přehledem posledních 25 (maximum) projektů na kterých se v poslední době pracovalo.

Command:Open Recent

2017-03-16T13:24:27Z

Want:

{{Title|Open Recent}}
{{Category|File Menu}}

'''Open Recent:''' It gives a dynamic menu list with the last 25 (maximum) recent opened (or created) files.

Command:Open Recent/fr

2017-03-16T13:24:06Z

Want:

{{Title|Récemment ouverts}}
{{Category|File Menu}}

'''Récemment ouverts:''' Cela ouvre un menu dynamique qui liste les derniers 25 (maximum) fichiers ouverts ou créés récemment.