Sif Format - Revision history

Rsg167: sfg grammar & rephrase

2016-02-10T22:14:01Z

sfg grammar & rephrase

D.j.a.y: add sfg file info + some style and syntax + intra/extern links

2016-02-01T20:06:21Z

add sfg file info + some style and syntax + intra/extern links

D.j.a.y: Page info

2016-02-01T19:58:13Z

Page info

Rsg167: /* Overview */ layer "group" attribute

2016-02-01T17:22:44Z

‎Overview: layer "group" attribute

Rsg167: Explain version

2016-02-01T17:00:48Z

Explain <layer> version

Rsg167: Fix layer heading

2016-01-13T17:10:26Z

Fix layer heading

Rsg167: add <layer> and reorganize

2016-01-13T17:08:31Z

add <layer> and reorganize

Rsg167: /* <meta> */ listed <meta> names

2016-01-07T18:33:32Z

‎<meta>: listed <meta> names

Rsg167: /* Overview */ canvas "focus" attribute

2016-01-07T18:04:59Z

‎Overview: canvas "focus" attribute

Rsg167: /* The format as of January 2016 */ headings under Concepts

2016-01-07T17:50:02Z

‎The format as of January 2016: headings under Concepts

@@ Line 38: / Line 38: @@
 New and alternate implementations of .sif are urged to support this compression, although it is not required.
-Synfig also recognize {{literal|.sfg}} file format has archive file format. The purpose of the .sfg files is to embed in one file the synfig project and the associated resources : images and sound files (when using {{l|Import_Image_Layer}} or {{l|Sound Layer}}).
+Synfig recognizes the {{literal|.sfg}} file format as an archival file format. A .sfg is a ZIP archive that bundles a .sif and its resources together. In Synfig Studio, images and sounds can be packed using {{l|Import_Image_Layer}} or {{l|Sound Layer}}.
 == &lt;canvas&gt; ==

@@ Line 4: / Line 4: @@
 {{TOCright}}
 <!-- Page info end -->
-A .sif file is the XML representation of a {{L|Canvas|canvas}}.
+A {{literal|.sif}} file is the [https://en.wikipedia.org/wiki/XML XML] representation of a {{L|Canvas|canvas}}.
-It holds the canvas's metadata, such as width and height, as well as information about its {{L|Layer|layers}}.
+It holds the canvas's {{l|Canvas_MetaData_Panel|metadata}}, such as width and height, as well as information about its {{L|Layer|layers}}.
 Typically, a Synfig production comprises many .sif files joined in a sequence or nested within each other.
@@ Line 35: / Line 35: @@
 === Compression ===
-Synfig recognizes .sifz as the extension of gzip-compressed .sif files.
+Synfig recognizes {{literal|.sifz}} as the extension of gzip-compressed .sif files.
 New and alternate implementations of .sif are urged to support this compression, although it is not required.
 == &lt;canvas&gt; ==

← Older revision		Revision as of 19:58, 1 February 2016
Line 1:		Line 1:
		+	<!-- Page info -->
		+	{{Title\|Synfig File format}}
		+	{{NewTerminology}}
		+	{{TOCright}}
		+	<!-- Page info end -->
	A .sif file is the XML representation of a {{L\|Canvas\|canvas}}.		A .sif file is the XML representation of a {{L\|Canvas\|canvas}}.
	It holds the canvas's metadata, such as width and height, as well as information about its {{L\|Layer\|layers}}.		It holds the canvas's metadata, such as width and height, as well as information about its {{L\|Layer\|layers}}.

@@ Line 177: / Line 177: @@
 |-
 |version||'''no default'''||depends on the layer type
 |-
 |desc||||a human-readable description

@@ Line 15: / Line 15: @@
 == Concepts ==
-=== Importing ===
+=== Linking / Exporting ===
 .sif files aren't always self-contained.
-They can '''import''' (read: link to) other .sif files, which creates a dependency of one on the other.
+They can link to parts of other .sif files, which creates a dependency of one on the other.
-This may seem strange to animators who use Flash because, in Flash, importing something causes it to be embedded in the current animation.
+This may seem strange to animators who use Flash because, in Flash, animation files are usually self-contained.
-One drawback of Synfig's approach is that .sif dependencies can be hard to track.
 A tool called [https://github.com/morevnaproject/RenderChan RenderChan] solves this problem.
 Recursion of .sif files is prohibited.
-=== .sifz ===
+=== Compression ===
 Synfig recognizes .sifz as the extension of gzip-compressed .sif files.
@@ Line 171: / Line 174: @@
 |'''Attribute'''||'''Default'''||'''What it is'''
 |-
-|type||'''no default''', this attribute is required||see the list of types
+|type||'''no default'''||see the list of types
 |-
-|version||||unknown
+|version||'''no default'''||depends on the layer type
 |-
 |desc||||a human-readable description

@@ Line 154: / Line 154: @@
 </pre>
-== &lt;layer&gt; ==
+=== &lt;layer&gt; ===
-=== Overview ===
+==== Overview ====
 Layers describe the shapes and effects on a canvas.

@@ Line 13: / Line 13: @@
 https://github.com/synfig/synfig/blob/master/synfig-core/src/synfig/loadcanvas.cpp
-== The format as of January 2016 ==
+== Concepts ==
-=== Concepts ===
+=== Importing ===
-−
-==== Importing ====
 .sif files aren't always self-contained.
@@ Line 27: / Line 25: @@
 Recursion of .sif files is prohibited.
-==== .sifz ====
+=== .sifz ===
 Synfig recognizes .sifz as the extension of gzip-compressed .sif files.
 New and alternate implementations of .sif are urged to support this compression, although it is not required.
-=== &lt;canvas&gt; ===
+== &lt;canvas&gt; ==
-==== Overview ====
+=== Overview ===
 The top element of a .sif file is always a &lt;canvas&gt;.
@@ Line 53: / Line 51: @@
 |version||'''no default''', this attribute is required||0.1, always
 |-
-|width||[https://github.com/synfig/synfig/blob/master/synfig-core/src/synfig/renddesc.h#L130 720]||the width of the canvas in pixels
+|width||[https://github.com/synfig/synfig/blob/master/synfig-core/src/synfig/renddesc.h#L130 480]||the width of the canvas in pixels
 |-
-|height||[https://github.com/synfig/synfig/blob/master/synfig-core/src/synfig/renddesc.h#L131 480]||the height of the canvas in pixels
+|height||[https://github.com/synfig/synfig/blob/master/synfig-core/src/synfig/renddesc.h#L131 270]||the height of the canvas in pixels
 |-
 |xres||[https://github.com/synfig/synfig/blob/master/synfig-core/src/synfig/renddesc.h#L132 2835]||the width of the canvas in pixels per meter
@@ Line 78: / Line 76: @@
 Inside a &lt;canvas&gt; you can find the following elements:
 * &lt;name&gt;
-* &lt;desc&gt;
+* &lt;meta&gt;
 * &lt;author&gt;
 * &lt;layer&gt;
 * &lt;bones&gt;
 * &lt;keyframe&gt;
-==== &lt;name&gt; ====
+=== &lt;name&gt; ===
 The short name of the canvas.
@@ Line 99: / Line 97: @@
 </pre>
-==== &lt;meta&gt; ====
+=== &lt;meta&gt; ===
 Metadata for the Synfig Studio editor.
@@ Line 132: / Line 130: @@
 * background_second_color
-==== &lt;author&gt; ====
+=== &lt;author&gt; ===
 The name of the canvas's author.
@@ Line 144: / Line 142: @@
 </pre>
-==== &lt;desc&gt; ====
+=== &lt;desc&gt; ===
 A human-readable description of the canvas.
@@ Line 155: / Line 153: @@
 </canvas>
 </pre>

@@ Line 72: / Line 72: @@
 |-
 |bgcolor||[https://github.com/synfig/synfig/blob/master/synfig-core/src/synfig/renddesc.h#L138 0.5 0.5 0.5 1.0]||the color of the background in RGBA
 |}