Difference between revisions of "Sif Format"

From Synfig Studio :: Documentation
Jump to: navigation, search
m (→‎<meta>: listed <meta> names)
(add <layer> and reorganize)
Line 13: Line 13:
 
https://github.com/synfig/synfig/blob/master/synfig-core/src/synfig/loadcanvas.cpp
 
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.
 
.sif files aren't always self-contained.
Line 27: Line 25:
 
Recursion of .sif files is prohibited.
 
Recursion of .sif files is prohibited.
  
−
==== .sifz ====
+
=== .sifz ===
  
 
Synfig recognizes .sifz as the extension of gzip-compressed .sif files.
 
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.
 
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;.
 
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
 
|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
 
|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:
 
Inside a &lt;canvas&gt; you can find the following elements:
  
−
* &lt;defs&gt;
 
−
* &lt;meta&gt;
 
 
* &lt;name&gt;
 
* &lt;name&gt;
−
* &lt;desc&gt;
+
* &lt;meta&gt;
 
* &lt;author&gt;
 
* &lt;author&gt;
 +
* &lt;desc&gt;
 
* &lt;layer&gt;
 
* &lt;layer&gt;
 +
* &lt;defs&gt;
 
* &lt;bones&gt;
 
* &lt;bones&gt;
 
* &lt;keyframe&gt;
 
* &lt;keyframe&gt;
  
−
==== &lt;name&gt; ====
+
=== &lt;name&gt; ===
  
 
The short name of the canvas.
 
The short name of the canvas.
Line 99: Line 97:
 
</pre>
 
</pre>
  
−
==== &lt;meta&gt; ====
+
=== &lt;meta&gt; ===
  
 
Metadata for the Synfig Studio editor.
 
Metadata for the Synfig Studio editor.
Line 132: Line 130:
 
* background_second_color
 
* background_second_color
  
−
==== &lt;author&gt; ====
+
=== &lt;author&gt; ===
  
 
The name of the canvas's author.
 
The name of the canvas's author.
Line 144: Line 142:
 
</pre>
 
</pre>
  
−
==== &lt;desc&gt; ====
+
=== &lt;desc&gt; ===
  
 
A human-readable description of the canvas.
 
A human-readable description of the canvas.
Line 155: Line 153:
 
</canvas>
 
</canvas>
 
</pre>
 
</pre>
 +
 +
== &lt;layer&gt; ==
 +
 +
=== Overview ===
 +
 +
Layers describe the shapes and effects on a canvas.
 +
 +
<pre>
 +
<canvas version="0.1">
 +
    ...
 +
    <layer type="solid_color" version="0.1"
 +
    ...
 +
</canvas>
 +
</pre>
 +
 +
{|border="1" cellpadding="5" cellspacing="0"
 +
|'''Attribute'''||'''Default'''||'''What it is'''
 +
|-
 +
|type||'''no default''', this attribute is required||see the list of types
 +
|-
 +
|version||||unknown
 +
|-
 +
|desc||||a human-readable description
 +
|-
 +
|active||true||whether the layer is selected (?)
 +
|-
 +
|exclude_from_rendering||false||whether it should be rendered
 +
|}

Revision as of 20:08, 13 January 2016

Languages Language: 

English


A .sif file is the XML representation of a canvas. It holds the canvas's metadata, such as width and height, as well as information about its layers. Typically, a Synfig production comprises many .sif files joined in a sequence or nested within each other.

The .sif format is formidably complex and evolving. It is implementation-defined rather than spec-defined. Therefore, you should take everything on this page with a grain of salt. Indeed, the implementation can change at any point.

There are no plans to freeze the format.

Source code

The .sif format is implemented by the following file:

https://github.com/synfig/synfig/blob/master/synfig-core/src/synfig/loadcanvas.cpp

Concepts

Importing

.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. This may seem strange to animators who use Flash because, in Flash, importing something causes it to be embedded in the current animation. One drawback of Synfig's approach is that .sif dependencies can be hard to track. A tool called RenderChan solves this problem.

Recursion of .sif files is prohibited.

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

<canvas>

Overview

The top element of a .sif file is always a <canvas>. 

<?xml version="1.0"?>

<canvas version="0.1" width="300" height="350" xres="2952.7559"
        yres="2952.7559" view-box="-1.5 2.5 1.5 -1" antialias="2"
        fps="12" begin-time="0f" end-time="0f" bgcolor="0.5 0.5 0.5 1">
    ...
</canvas>
Attribute Default What it is
version no default, this attribute is required 0.1, always
width 480 the width of the canvas in pixels
height 270 the height of the canvas in pixels
xres 2835 the width of the canvas in pixels per meter
yres 2835 the height of the canvas in pixels per meter
view-box -4 2.25 4 -2.25 the bounding coordinates of the canvas (left top right bottom)
antialias 2 how hard Synfig should try to antialias the image
fps 24 frames per second
begin-time 0 where on the timetrack should rendering start
end-time 0 what on the timetrack should rendering end
bgcolor 0.5 0.5 0.5 1.0 the color of the background in RGBA
focus 0 0 the anchor point for changing the view-box

Inside a <canvas> you can find the following elements:

  • <name>
  • <meta>
  • <author>
  • <desc>
  • <layer>
  • <defs>
  • <bones>
  • <keyframe>

<name>

The short name of the canvas. 

<canvas version="0.1">
    ...
    <name>Aqua Sphere</name>
    ...
</canvas>

<meta>

Metadata for the Synfig Studio editor. These can be safely ignored by other implementations. 

<canvas version="0.1">
    ...
    <meta name="grid_show" content="1" />
    ...
</canvas>

Synfig Studio recognizes these <meta> names (source):

  • grid_size
  • grid_color
  • grid_snap
  • grid_show
  • onion_skin
  • onion_skin_past
  • onion_skin_future
  • guide_color
  • guide_snap
  • guide_show
  • guide_x
  • guide_y
  • sketch
  • solid_lines
  • background_size
  • background_first_color
  • background_second_color

<author>

The name of the canvas's author. 

<canvas version="0.1">
    ...
    <author>King Arthur</author>
    ...
</canvas>

<desc>

A human-readable description of the canvas. 

<canvas version="0.1">
    ...
    <desc>This aqua-colored sphere reminds me of something from Mac OS X.</desc>
    ...
</canvas>

<layer>

Overview

Layers describe the shapes and effects on a canvas. 

<canvas version="0.1">
    ...
    <layer type="solid_color" version="0.1"
    ...
</canvas>
Attribute Default What it is
type no default, this attribute is required see the list of types
version unknown
desc a human-readable description
active true whether the layer is selected (?)
exclude_from_rendering false whether it should be rendered


Languages Language: 

English

Retrieved from "https://wiki.synfig.org/index.php?title=Sif_Format&oldid=21145"