impossiblefxv1 1.13.2

package/proto/Movie.proto

@@ -0,0 +1,4081 @@
+//
+// Copyright 2010-2015 Impossible Software GmbH.  All rights reserved.
+//
+// The contents and use of this file are subject to our Terms Of Use.
+// You may not use this file except in compliance with the Terms of Use.
+//
+// You can obtain a copy of the terms at http://www.impossiblesoftware.com/meta/tos.html
+// See the Terms Of Use for the specific language governing permissions
+// and limitations under the terms.
+
+syntax = "proto2";
+
+package JetSDL.Proto;
+
+option java_outer_classname = "FXProto";
+
+
+
+/** A fraction defined by numerator divided by denumerator */
+message Fractional {
+	/** numerator */
+	optional uint64 num = 1
+	[default=30];
+	
+	/** denumerator */
+	optional uint64 den = 2
+	[default=1];	
+}
+
+
+/** 
+	StreamParams define settings for the rendered video. There are separate settings for the
+	audio and video parts of the stream. Additional parameters define the behvior for 
+	streaming delivery.
+*/
+message StreamParams{
+	/** Parameters for the video stream  */
+	required VideoParams vparams = 1;
+
+	/** Parameters for the video stream  */
+	optional AudioParams aparams = 2;
+
+	/** deprecated. Streaming behaviour */
+	optional bool nosleep = 3
+		[default = true];
+
+	/** Number of passes for multi-pass encoding */
+	optional int32 pass = 5;
+
+	/** Filename for statistics during multi-pass encoding */
+	optional string statfile = 4;
+
+	/** duration in seconds the client is expected to buffer before playback starts (Streaming only) 
+	    only needed for realtime streams */
+	optional double client_prebuffer = 7
+		[default = -1];
+		
+	/** duration beeing processed 'at once' by the server 
+		only needed for realtime streams */
+	optional double encoding_quantum = 8
+		[default = -1];
+	
+	/** Minimum number of seconds in client buffer (Streaming only) */
+	optional double min_client_buffer = 6
+		[default = 2.0];
+		
+	// Does this work?
+	optional Color default_image_color = 9;
+}
+
+/**
+* Settings for the video stream
+*/
+message VideoParams {
+
+	/** Method of rate control */
+	enum VideoRateControl {
+		/** Control bitrate: video stream should not exceed given bitrate */
+		VRC_BITRATE = 0;
+
+		/** Control quantization */
+		VRC_QUANTIZER = 1;
+
+		/** Control quality: Keep constant quality regardless of bitrate */
+		VRC_RATEFACTOR = 2;
+	}
+
+	/** 
+		Allow encoder to withhold frames for smaller files, better quality.
+	   	<br>Only relevant for streaming render modes 
+	*/
+	enum EncoderDelayReq {
+		/** Do not keep reference frames, emit frames as fast as possible */
+		DELAY_REALTIME = 1;
+
+		/** Keeo reference frames, even if it slows down streaming */
+		DELAY_SMALL = 2;
+	}
+  
+  	enum ColorSpace{
+		COLORSPACE_UNSPECIFIED = 0;
+		COLORSPACE_AUTO = 1;
+		COLORSPACE_BT709 = 2;
+		COLORSPACE_BT470BG = 3;
+		COLORSPACE_SMTPE170M= 4; 
+	}
+  
+  /** Width of the rendered video */
+  required uint32 width = 1;
+
+  /** Height of the rendered video */
+  required uint32 height = 2;
+  
+  /** Video codec type */
+  optional Codec videocodec = 5 
+  		[default = VIDEO_X264];
+
+  /** Frame rate of video (as fraction, e.g. 25/1, 30000/1001) */
+  optional Fractional videoframerate = 6;
+  
+  /** Video bitrate in kilobits per second */
+  optional uint32 videobitrate = 7 
+  		[default =2000];
+
+  // Number of bframes (H.264 + X.264 only)
+  optional int32 videobframes =8
+  		[default = 0];
+
+  /** Number of frames in a picture group */	
+  optional int32 videogopsize = 9
+  		[default = 30];
+
+  /** Quantization parameter (15..50) */
+  optional int32 videoqp = 10
+  		[default = 16];
+
+  /** Method of rate control */	
+  optional VideoRateControl videorc = 11
+  		[default = VRC_BITRATE];	
+  	
+  
+  /** Controls for encoder speed / quality tradeoff - range 0.0 - 100.0
+  * guidelines to start with:<dl>
+  * <dt> 0.0</dt><dd>pointlessly bad quality, extremely fast</dd>
+  * <dt>10.0</dt><dd>dont care about quality, make it fast</dd>
+  * <dt>20.0</dt><dd>general purpose 'fast' preset</dd>
+  * <dt>50.0</dt><dd>'medium' speed/quality tradeoff, recommended encoder default</dd>
+  * <dt>80.0</dt><dd>sensible 'high quality preset'</dd>
+  * <dt>90.0</dt><dd>don't care about speed</dd>
+  * </dl>
+  * don't expect changes with every small adjustment - encoder might have a coarse granularity interpreting this
+  */
+  optional double videocpueffort = 12
+  		[default = 10.0];
+  
+  /** @internal */
+  optional EncoderDelayReq videodelayrequirement = 13
+  		[default = DELAY_SMALL];
+
+  /** Transparency (GIF only) */
+  optional bool videotransparency = 15
+  	[default = false];
+
+  /** Minimum number of video frames after which forced keyframes will be inserted - forced keyframes split scenes into sub segments used in HLS and MPEG DASH streaming and parallel rendering*/
+  optional int32 videominimumforcedkeyframeinterval = 16
+  	[default = 45];
+  	
+  optional ColorSpace videocolorspace = 17
+  	[default = COLORSPACE_UNSPECIFIED];	
+  	
+  /** @internal */
+  repeated KeyValuePair videocodecextraparams = 14;
+
+
+}
+
+/**
+* Audio Settings for rendered video
+*/
+message AudioParams{
+	/** Audio codec */
+	optional Codec audiocodec= 10
+			[default = AUDIO_NONE];
+
+	/** Audio bitrate in kilobits per second */
+	optional uint32 audioabr = 11
+			[default =80000];
+
+	/** Number of audio samples per second */
+	optional uint32 audiosamplerate =12
+			[default =44100];
+
+	/** Number of channels (1=mono, 2=stereo) */
+	optional uint32 audiochannels = 14
+			[default = 2];
+
+	/** Number of samples per audio frame */
+	optional uint32 audioframe_size = 13
+			[default = 1024];
+}
+
+/**
+  * Determines, what happens when requesting frames past the end of a given source.
+  * Not all values can be used in all situations.
+  */
+enum EndBehaviour{
+	/** Repeat last frame */
+	repeatlast = 0;
+
+	/** Start again */
+	loop = 1; 
+
+	/** An empty frame */
+	emptyframe = -2;
+
+	/** not used */
+	fullframe = -3;
+
+	/** Throw an error and stop rendering */
+	fail = -4;
+}
+
+
+/**
+    Movie is the main message of the SDL.
+    It consists of Scenes and an Audio object for the whole movie. 
+    It also specifies Video and Audio parameters.
+*/
+message Movie {
+  
+    /** Audio and Video parameters */
+	required StreamParams params = 15;
+
+	/** An array of Scenes that describes the movie content */
+	repeated Scene scenes =3;
+
+	/** An Audio object that handles Audio during the whole movie. Additional audio tracks are mixed on top of this Audio track */
+	optional Audio audio=4;
+
+	/** Parameter for an endless looping stream (will be ignored for RenderMovie/RenderImagesequence) */
+	optional bool loop=14
+			[default = false];
+
+	/** Initialise all variables in the movie at startup (sacrificing "time to first byte") */
+	optional bool initatstart = 16
+			[default = false];		
+
+	/** Metadata for accounting/logging/etc. */
+	repeated Metadata metadata = 17;
+	
+	/** Variable information for movie audio tracks */
+	optional VariableInformation audiovarinfo = 18;
+	
+	enum UnexpectedFrameSizeSolution{
+		UFS_SCALE = 0;
+		UFS_LETTERBOX = 1;
+		UFS_COPY = 2;
+		UFS_NONE = 3;
+	}
+	optional UnexpectedFrameSizeSolution ufssolution = 19
+		[default=UFS_SCALE];
+		
+	optional int32 posterframe = 20
+		[default=0];
+		
+	repeated Scene compositions = 21;
+	
+	/** Flag to change video error behavior, if set to true errors in the video part of a movie will lead to renderfailure instead of gracefull skip/handle */
+	optional bool videofailfast = 22
+		[default=false];
+	/** Flag to enable/disable packet caching, default is true */
+	optional bool usepacketcache = 23
+		[default=true];
+	
+
+	/** scene definitions that can be referenced by their referenceid */
+	repeated Scene scenedefinitions = 24;
+
+	optional string comment = 2047;
+
+    extensions 1000 to 1999;
+}
+
+/**
+    A Scene message describes one part (i.e. a sequence of frames) of a movie
+    A scene consist of a number of VisualTracks layered on top of each other and a scene specific Audio object
+    If a Scene has no dynamic content it is static and can be preencoded
+*/
+message Scene{
+
+	enum Type{
+		/** A scene providing visual content through VisualTracks in <code>tracks</code> and audio content through Audio and AudioTracks from <code>audio</code>*/
+		normal = 0;
+		/** A scene defering to the SceneView <code>sceneview</code> for visual and audio content*/
+		scenebased = 1;
+		/** A scene referencing another scene contained in the movies scene reference section */
+		reference = 2;
+	}
+	/** The type of scene*/
+	optional Type type = 1
+		[ default = normal];
+
+	/** 
+        Number of frames this scene has, the length of the whole movie is determined by adding up all frames of all scenes
+	    If left out or <0 the scene tries to determine it's length by checking the content of it's tracks for videos
+    */
+	optional int32 numframes=2;
+	
+	/** Number of frames overlapping in edit situations e.g. crossfade transitions.
+	   Adjusts numframes, usually should be negative e.g. -25
+    */
+	optional int32 editoverlap=16;
+
+	/** Turns off the preencoding of this scene, when set to false; mainly used for testing purposes */
+	optional bool static=3
+		[default = true];
+		
+	/**
+        deprecated: the base content should now be introduced through the first Visualtrack for more flexibility 
+    */
+	optional ImageProvider content=4;
+	
+	/** The visual content of this scene as a sequence of layers*/
+	repeated VisualTrack tracks=5;
+	
+	/** The scene specific Audio */
+	optional Audio audio=6;
+	
+	/** @deprecated A subtitle object to allow optimization through preencoding for subtitle overlay frames */
+	optional Subtitles subtitles=7;
+	
+	/** keys and possible values to allow semi static preencoding */
+	optional VariableInformation varinfo = 8;
+	
+	/** Do not throw error if this scene has no content */
+	optional bool canbeempty = 9
+		[default=false];
+		
+	/** Name or names for this scene */
+	repeated string name = 10;
+	
+	/** Poster frame */
+	optional int32 posterframe = 11
+		[default=0];
+		
+	/** @deprecated Use the audio to determine length of scene. Deprecated use <var>numframesfrommode</var>, instead */
+	optional bool useaudioforlength = 12
+		[default=false];
+
+	enum NumframesFromMode{
+		numframesfrommode_video = 0;
+		numframesfrommode_audio = 1;
+		numframesfrommode_max = 2;
+		numframesfrommode_min = 3;
+	}
+	/** When numframes is not set, how to determine the length of scene. Supercedes <var>useaudioforlength</var>, if both are set */
+	optional NumframesFromMode numframesfrommode = 17
+		[default = numframesfrommode_video];
+
+	/** An optional ID */
+	optional string id = 13;
+	
+	/** The variable that dynamically enables or disables this scene */
+	optional StringVariable enablevariable = 14;
+
+	/** Reverse enablesvariables logic */
+	optional bool invertenable = 15
+		[default=false];
+	
+	/** @comment [scenebased] The sceneview to use for this scenes content */
+	optional SceneView sceneview = 18;
+
+	/** @comment [reference] The id by which to identify the scene referenced from the scenedefinitions */
+	optional string referenceid = 19;
+
+	message VarMapping{
+		enum Type{
+			string = 1;
+			points = 2;
+		}
+		optional Type type = 1
+			[default=string];
+		optional string key = 4;
+
+		optional StringVariable stringvariable = 2;
+		optional PointsVariable pointsvariable = 3;
+	}
+	/** @comment [reference] Mapping that changes the variables accessible in the refernenced scene, a variable with key <var>key</var> and the same value as either <var>stringvariable</var> or <var>pointsvariable</var> is added to the variable dictionary for the referenced scene. If <var>key</var> was already in that dictionary the value is replaced. **/
+	repeated VarMapping variablemapping = 20;
+
+	/** Comment */
+	optional string comment = 2047;
+
+    extensions 1000 to 1999;
+}
+
+/**
+    A SceneViewVariant message is a lookup map that assigns scenes to key values. When requesting movies that contain SceneViews the query parameter determines which scene to select.
+*/
+message SceneViewVariant{
+	/** SceneView's name (used to select this variant via query parameter */
+	required string key = 2;
+
+	/** Array of scenes to play when this variant is active */
+	repeated Scene scenes = 3;
+
+    extensions 1000 to 1999;
+}
+
+/**
+    A SceneView is a container for either SceneViewVariants or EmbeddedScenes
+*/
+message SceneView{
+
+	/** Type */
+	enum Type{
+		/** Scenes are define inline in the scenes array */
+		embedded = 0;
+
+		/** @deprecated file based scene definitions */
+		file = 1;
+
+		/** 
+            This scene consists of multiple variants defined in the <code>variants</code> field. Which variant to play is determined through the value of the <code>variable</code>
+        */
+		variant = 2;
+	}
+
+	/** Type of SceneView */
+	optional Type type = 1
+		[default = embedded];
+
+	/** The embedded scenes */
+	repeated Scene scenes = 2;
+
+	/** What to do if SceneView has fewer frames than required by container */
+	optional EndBehaviour endbehaviour = 3
+		[default = repeatlast];
+
+	/** */
+	optional FileLocation source = 4;
+
+	/** All possible variants for this scene */
+	repeated SceneViewVariant variants = 19;
+
+	/** Variable to use to select active variant */
+	optional StringVariable variable = 20;
+
+	/** */
+	optional int32 width = 21;
+
+	/** */
+	optional int32 height = 22;
+	
+	// for file type sceneviews this has to hold the keys used for variables in the scenes to not interfere with preencoding
+	repeated string keys = 18;
+
+	//This is used to hold the filelocationprefix to use it to complete loaded SDL files
+	//you don't need to touch this
+	optional string filelocationprefixholder = 17
+		[default = ""];
+
+	/** experimental, used to convert framerate of inner scenes, use on own risk */
+	optional Fractional videoframerate = 23;
+
+    extensions 1000 to 1999;
+}
+
+/**
+* An ImageProvider object provides an image given a particular frame number
+* There are basically two types:
+* a SingleImage provides the same image every time and 
+* an Imagesequence that provides different images for different frame numbers (e.g. a video, other SDLs)
+*
+*/
+message ImageProvider{
+	
+	/** Type of ImageProvider */
+	enum Type{
+		// SingleImage types
+
+		/** One single frame image */
+		stillimage=0;
+
+		/**
+		    An single-frame image generated from an array of VisualTracks. 
+		    Use to create multi-layered images, transformed or filtered images
+		*/
+		manipulatedimage=2;
+
+		/** An empty single-frame image with specified size and color */
+	 	emptyimage=4;
+
+	 	/** An image loaded from a URL over http */
+	 	http=9;
+
+	 	/** An image loaded from a URL using the jetcom protocol */
+	 	jetcom=10;
+
+	 	/** A rendered text */
+		textsimple=7;
+		 
+		/** A rendered gradient */
+		gradient=25;
+	 	
+	//  Imagesequence types  
+
+		/** A sequence of images loaded from disk */
+	 	imagesequence=1;
+
+	 	/** A sequence of 32bit floating point images loaded from disk */
+	 	image32fsequence=3;
+
+	 	/** A sequence generated by rendering Text between to (moving) lines */
+	 	textcurved=5;
+
+	 	/** A sequence generated by rendering Text into a moving Quad */
+	 	textquad=6;
+
+	 	/** A sequence generated by rendering Text (inserting linebreaks) into a moving Quad  */
+	 	textmultiline=8;
+         
+	 	/** @deprecated A sequence decoded form a video */
+	 	decoder=11;
+
+	 	/** A video as zipped image sequence or video file, with scale aware disk cache */
+		video = 12;
+
+		/** http live video stream */
+		livevideo = 22;
+		
+		/** Image sequences created by rendering a Scene or SceneVariant object */
+		scenebased = 13;
+
+		/** Internal. Will be moved to a SDL extension module in the future		 */
+		comicbook = 14;
+
+		/** Internal. */
+		custom = 15;
+		
+		/** An image provider that can act as a matte for a compose operation */
+		masksource = 17;
+
+		/** Draw (and animate) a pie chart. */
+		piechart = 16; 
+
+		/** Draw (and animate) a bar chart */
+		barchart = 18;
+
+		/** Draw (and animate) a bar chart made from images */
+		imagebarchart = 19;
+
+		/** Draw (and animate) a line chart */
+		linechart = 21;
+
+		/** Draw (and animate) a bezier line */
+		bezier = 20;
+		
+		/** Draw and fill (and animate) a bezier-based shape  */
+		path = 24;
+
+		/** Image data as data url or SVG+XML from a variable*/
+		string = 26;
+		
+		/** Arrange multiple child ImageProviders according to a layout */
+		layout = 27;
+
+		/** @undocumented draw on canvas using javascript (obsolet) */
+		jscanvas = 23;
+	}
+	
+
+	/** The type of this ImageProvieder */
+	required Type type=1;
+	
+	/**
+	* @comment [video, decoder, imagesequence, image32fsequence] The number of frames that are rendered
+		Only needed if you want to return less frames than scene length (Masking only)
+	*/
+	optional int32 numframes = 21 [default = -1];
+	
+	/**
+	* @comment [stillImage, url, imagesequence, image32fsequence] Image source
+	* @comment [decoder, video] Video source
+	* @comment [textsimple, textagg, textquad, textmultiline] Font source
+	*/
+	optional FileLocation source=2;
+	
+	/** @comment [manipulatedimage] An array of VisualTracks for compositing the image */
+	repeated VisualTrack tracks=3;
+	
+	/**
+	* @comment [emptyimage, textsimple, textagg, textquad, textmultiline] Width of the provided image, 
+		used if it can not be inferred from other parameters
+	*/
+	optional int32 width=4;
+
+	/**
+	* @comment [emptyimage, textsimple, textagg, textquad, textmultiline] Height of the provided image, 
+		used if it can not be inferred from other parameters
+	*/
+	optional int32 height=5;
+	
+	/**
+	* @comment [textsimple, textagg, textquad, textmultiline] Text Color
+	* @comment [emptyimage] Background Color
+	*/
+	optional Color color=6;
+	
+	/**
+	* @comment [textquad, textmultiline] Tracking data for text path
+	*/
+	optional TrackData trackdata= 7;
+	
+	/**
+	* @comment [textcurved] Description of the tracking data for the two curves
+	*/
+	optional TrackData trackdatatop= 8;
+
+	/**
+	* @comment [textcurved] Description of the tracking data for the two curves
+	*/
+	optional TrackData trackdatabottom= 9;
+	
+	/** @comment [textsimple, textagg, textquad, textmultiline] Font size (deprecated) */
+	optional int32 fontsize = 12 [default = 40]; //deprecated use fontsize_d instead
+
+	/** @comment [textsimple, textagg, textquad, textmultiline] Font size */
+	optional double fontsize_d = 35 [default = 40];
+
+	/** @comment [textsimple, textagg, textquad, textmultiline] Animation function for font size */
+	optional Function fontsize_function = 76;
+
+	/** @comment [textagg, textquad, textquad, textmultiline] Base length of text */
+	optional int32 baselength = 13 [default = 80];
+
+	/** @comment [textagg, textquad, textquad, textmultiline] Base height of text */
+	optional int32 baseheight = 14 [default = 12];
+
+	/** @comment [textagg, textquad, textquad, textmultiline] Number of step for font smoothing */
+	optional int32 numinterpoints = 15 [default = 50];	
+	
+	/** @comment [textmultiline] Average number of characters per line */
+	optional int32 linechars = 17 [default = 50];
+	
+	/** @comment [textsimple, textagg, textquad, textmultiline] Enable horizotal text centering */
+	optional bool center = 16 [default = false];
+	
+	/** @comment [textsimple, textagg, textquad, textmultiline] The text to render */
+	optional StringVariable text = 18;
+	
+	/** @comment [textagg, textquad, textmultiline] Scale factor for tracking data */
+	repeated double scale = 19;
+	
+	/** @deprecated renamed to 'contentoffset' to be consistent with equivalent members in AudioTrack*/
+	optional int32 videooffset = 80 [default = 0];
+
+	/** @deprecated renamed to 'contentoffsetvariable' to be consistent with equivalent members in AudioTrack*/
+	optional StringVariable videooffsetvariable = 81;
+	
+	/** offset for the content of this to adjust the start frame */
+	optional int32 contentoffset = 22 [default = 0];
+
+	/** additional offset for the content of this to adjust the start frame */
+	optional StringVariable contentoffsetvariable = 71;
+
+	/** Number of frames overlapping in edit situations e.g. crossfade transitions.
+	 *  Adjusts contentoffset, usually should be negative e.g. -25
+	 */
+	optional int32 editoverlap=82;
+
+    /** @undocumented */
+	optional bool usecachedir =23 [default = true];
+
+    /** @undocumented */
+	optional string cachedir = 24 [default = "cache"];
+
+    /** @undocumented */
+	optional string writeextension=30 [default = ".tif"];
+
+    /** Allow upscaling of images and videos to make them fit the container */
+	optional bool upscale =28 [default = false];
+
+    /** Allow downscaling of images and videos to make them fit the container */
+	optional bool downscale =29 [default = true];
+
+    /** @undocumented */
+	optional string scale_ar_hint = 36[default = "w"];
+	
+	/** Horizontal Alignment options for textsimple */
+	enum TextAlignment{
+		flushleft = 0;
+		centered = 1;
+		flushright = 2;
+	}
+	
+    /** @comment [textsimple] Horizontal text alignment */
+    optional TextAlignment xalignment = 25 [default = flushleft];
+
+	/** Vertical lignment options for textsimple */
+	enum TextPosition{
+		top = 0;
+		middle = 1;
+		bottom = 2;
+	}
+
+    /** @comment [textsimple] Vertical text alignment */
+	optional TextPosition yalignment = 27 [default = bottom];
+
+	/** @comment [http, video] Hint for the extension of http images if no extension can be found in the URL */
+	optional string http_extension_hint = 26;
+
+	/** Switch to skip alpha premultiplication on load (e.g. for masks)  */
+	optional bool loadpremulalpha = 31
+		[default=true];
+	
+	/** @comment [video, http] Specifies if http images are downloaded only once per movie rendering(false) or every time(true) (only enable when http content changes frequently)	*/
+	optional bool httpalwaysload = 32
+		[default=false];
+		
+	/** @comment [scenebased] Sceneview for <code>scenebased</code> ImageProvider */	
+	optional SceneView sceneview = 33;
+	
+	/** @deprecated */
+	optional int32 fontspacing_deprecated = 34
+		[default = 0];
+
+    /** @comment [textsimple] Extra horizintal spacing between glyphs */
+	optional double fontspacing = 45
+		[default = 0];
+
+    /** @comment [textsimple] Extra line spacing between lines of text */
+	optional double linespacing = 55
+		[default = 0];
+	
+    /** @undocumented */
+	optional double comicbookframetime = 37
+		[default = 1.0];
+
+    /** @undocumented */
+	optional ImageProvider comicsource = 38;
+	
+    /** @comment [textsimple] Right text border */
+	optional int32 textborder_right = 39
+		[default=0];
+
+    /** @comment [textsimple] Left text border */
+	optional int32 textborder_left = 40
+		[default=0];
+
+    /** @comment [textsimple] Top text border */
+	optional int32 textborder_top= 41
+		[default=0];
+
+    /** @comment [textsimple] Bottom text border */
+	optional int32 textborder_bottom = 42
+		[default=0];
+		
+    /** @deprecated @comment [textsimple] Allow text to be resized if it doesn't fit the container */
+	optional bool overflowresize = 43
+		[default=true];
+		
+	/** @comment [textsimple] Avoid rendering small fontsizes by rendering with higher font size and scaling down the image afterwards */
+	optional bool textsmallfontsizeavoidance = 106
+		[default=false];
+
+    /** @undocumented */
+	optional string custom_identifier = 44;
+	
+    /** @comment [piechart] */
+	optional PieChartDescription piechartdescription = 46;
+
+    /** @comment [barchart] */
+	optional BarChartDescription barchartdescription = 50;
+
+    /** @comment [imagebarchart] */
+	optional ImageBarChartDescription imagebarchartdescription = 51;
+
+    /** @comment [linechart] */
+	optional LineChartDescription linechartdescription = 54;
+
+    /** @comment [bezier] */
+	optional BezierDescription bezierdescription = 53;
+	
+    /** @undocumented */
+    optional bool treatasstaticforcaching = 47
+		[default=false];
+		
+    /** Secondary ImageProvider for certain types (mask, augments) */
+	optional ImageProvider innerprovider = 48;
+
+    /** color channel for masking */
+	optional int32 maskchannel = 49
+		[default =0];
+
+    /** Image texture fill styles */
+	enum TextureStyle{
+		texturestyle_line=0;
+		texturestyle_full=1;
+		texturestyle_tiled=2;
+		texturestyle_tiledline=3;
+		texturestyle_segments=4;
+		texturestyle_tiledsegments=5;
+	}
+
+	enum TextGlyphColorMode{
+		/** default mode, use color or texture configured */
+		textglyphcolormode_default=0;
+		/** sue font embedded color information, used for bitmap fonts or embedded SVG, etc. */
+		textglyphcolormode_fontembedded=1;
+	}
+
+    /** Text outlines are extra borders drawn aroun/along the glyphs of text */
+	message TextOutline{
+		enum Type{
+			simple = 0;
+			rounded = 1;
+		}
+
+        /** Text outline type */
+		optional Type type = 1
+			[default = simple];
+
+        /** Thickness of outline */
+		optional double size = 2
+			[default = 1];
+
+        /** Color to draw outline with */
+		optional Color color = 3;
+
+        /** Image to use for texture filling */
+		optional ImageProvider texture = 4;
+
+        /** Fill style for image texture */
+        optional TextureStyle texturestyle = 5
+			[default=texturestyle_line];
+	}
+
+    /** Text augments are extra (usually small) images rendered at, above, above glyphs of text strings. */
+	message TextAugment{
+
+        /** Image to render */
+		optional ImageProvider content = 2;
+
+        /** Start position given in percent of string length */
+		optional double anchor_character = 3 //in percent of string (rounded)
+			[default=0];
+
+        /** Horizontal offset */
+		optional double x = 4 //in pixels (rounded)
+			[default=0];
+
+        /** Vertical offset */
+		optional double y = 5 //in pixels (rounded)
+			[default=0];
+
+        /** Scaling factor for image */
+		optional double size = 6 // in percent of line height
+			[default=1.0]; 
+	}
+
+    /** @comment [textsimple]  Array of TextOutline objects */
+	repeated TextOutline textoutlines = 56;
+
+    /** @comment [textsimple] Image provider for texture inside of rendered text*/
+	optional ImageProvider texttexture = 57;
+
+    /** @comment [textsimple] Texture style */
+	optional TextureStyle texttexturestyle = 68
+		[default=texturestyle_line];
+
+	/** @comment [textsimple] Color mode for text, used to switch between specified color/texture or font embedded */
+	optional TextGlyphColorMode textglyphcolormode = 98
+		[default=textglyphcolormode_default];
+
+    /** @comment [textsimple] Animate text like written on a typewriter */
+	optional Function texttypewritereffect = 58;
+
+    /** @comment [textsimple] typewriter animation start */
+	optional Function texttypewriterfadestart = 61;
+
+    /** @comment [textsimple] typewriter animation end */
+	optional Function texttypewriterfadeend = 62;
+
+    /** @comment [textsimple] Animation function for character spacing */
+	optional Function fontspacing_function = 63;
+
+    /** @comment [textsimple] Animation function for line spacing */
+	optional Function linespacing_function = 64;
+
+	/** @comment [textsimple] Character stretching in x-axis */
+	optional double textstretchx = 99
+		[default=1.0];
+	/** @comment [textsimple] Animation function for character stretching in x-axis */
+	optional Function textstretchx_function = 100;
+	/** @comment [textsimple] Character stretching in y-axis */
+	optional double textstretchy = 101
+		[default=1.0];
+	/** @comment [textsimple] Animation function for character stretching in y-axis */
+	optional Function textstretchy_function = 102;
+
+    /** @comment [textsimple] Fineness of text outlines */
+	optional double textoutlinesubpixellevel = 59
+		[default = 1];
+
+    /** @comment [textsimple] Array of TextAugment objects */
+	repeated TextAugment textaugmentations = 60;
+	
+    /* When text overflows a given container, the OverflowBehaviour defines what to do (also see TextImageSizeBehaviour*/
+	enum TextOverflowBehaviour{
+        /** Do nothing, let text overflow the box */
+		textoverflowbehaviour_none=0;
+
+        /* Condense text horzontally */
+		textoverflowbehaviour_scale_x=1;
+
+        /* Condense text horizontally, scale font size if necessary */
+		textoverflowbehaviour_fs_y_scale_x=2;
+
+        /* Scale font size if necessary */
+		textoverflowbehaviour_fs=3;
+		
+		/* Use one or more other 'text'-ImageProvider as reference for resizing */
+		textoverflowbehaviour_ref=4;
+
+		/* Insert linebreaks horizontally if necessary */
+		textoverflowbehaviour_wordwrap_x=5;
+		
+		/* Insert linebreaks horizontally, scale font size on vertical overflow */
+		textoverflowbehaviour_wordwrap_x_fs_y=6;
+	}
+
+    /** @comment [textsimple] What to do if text does not fit into given container */
+	optional TextOverflowBehaviour textoverflowbehaviour = 70
+		[default=textoverflowbehaviour_fs];
+
+	/** @comment [textsimple] References to look to for fontsize and scale, when using 'textoverflowbehaviour_ref'*/
+	repeated ImageProvider textoverflowreferences = 92;
+
+	/* how the size for the text image is determined*/
+	enum TextImageSizeBehaviour{
+		/* use the specified size from width/height parameter or an implicit size from the movie context*/
+		textimagesizebehaviour_specified = 0;
+		/* determine the width of the image from the text, and the height implicitely from the movie context or the height parameter*/
+		textimagesizebehaviour_auto_width = 1;
+		/* determine the height of the image from the text, and the width implicitely from the movie context or the height parameter*/
+		textimagesizebehaviour_auto_height = 2;
+		/* determine both width and height of the image from the text*/
+		textimagesizebehaviour_auto = 3;
+	}
+
+	/** @comment [textsimple] How to determine the size of the text image, default is a fixed specified size */
+	optional TextImageSizeBehaviour textimagesizebehaviour = 108
+		[default=textimagesizebehaviour_specified];
+
+
+	/** User comment */
+	optional string comment = 2047;
+	
+    //used for backwards compatibility in old iv tool projects, leave alone
+    /** @undocumented */
+	optional bool usevideodecodernormalisation = 52
+		[default = true];
+		
+    /** @undocumented */
+	optional bool uselocalhttpproxy = 65
+		[default = false];
+
+    /** Behaviour when more images are requested from this image provider than available */
+	optional EndBehaviour endbehaviour = 66
+		[default = repeatlast];
+
+    /** @undocumented */
+	message JSCanvasDescription{
+		enum Mode{
+			jscanvas_script = 0;
+			jscanvas_location = 1;
+		}
+		optional Mode mode = 2
+			[default=jscanvas_script];
+		optional StringVariable script = 3;
+		optional FileLocation location = 4;
+		repeated KeyValuePair defaultparams = 5;
+		//keys for user provided parameters sent to the canvas
+		repeated string keys = 6;
+		//Function to adjust the completion given to the javascript code, don't use unless you know what you are doing
+		optional Function completionfunction =7; 
+		
+		message FontDescription{
+			required string alias = 2;
+			required FileLocation source = 3;
+		}
+		repeated FontDescription fonts = 8;
+	}	
+
+    /** @undocumented */
+	optional JSCanvasDescription jscanvasdescription = 67;
+
+    /** Reduce image to 8 bit per channel */
+	optional bool ensure8bit = 69
+		[default = false];
+
+    /* Styles for text background, underline and strike-through */
+	message TextDecoration{
+		optional Color color = 2;
+		optional ImageProvider texture = 3;
+		optional TextureStyle texturestyle = 4;
+		optional double paddingleft = 5;
+		optional double paddingright = 6;
+		optional double paddingtop = 7;
+		optional double paddingbottom = 8;
+	}
+
+	/** Definition of a text context overriding one or more of the settings for the whole text or contexts up in the context tree.*/
+	message TextContext{
+		/** identifier for the text context, should contain alphanumeric characters only*/
+		optional string name = 2;
+		/** Font file, overrides source*/
+		optional FileLocation font = 3;
+		/** Advanced configuration options for making http requests to retrieve the font */
+		optional HTTPDownloadRequestInformation fonthttpconfig = 14;
+		/** Font size */
+		optional double fontsize = 4;
+		/** Animation function for font size */
+		optional Function fontsize_function = 9;
+
+		optional Color color = 5;
+		optional ImageProvider texture = 6;
+		optional TextureStyle texturestyle = 7
+			[default=texturestyle_line];
+		/** Color mode for text, used to switch between specified color/texture or font embedded */
+		optional TextGlyphColorMode glyphcolormode = 15
+			[default=textglyphcolormode_default];
+		optional double fontspacing =8;
+		
+		/** Character streching in x-axis*/
+		optional double stretchx = 16 
+			[default=1.0];
+		/** Animation function for character streching in x-axis*/
+		optional Function stretchx_function = 17;
+		/** Character streching in y-axis*/
+		optional double stretchy = 18
+			[default=1.0];
+		/** Animation function for character streching in y-axis*/
+		optional Function stretchy_function = 19;
+		
+		optional TextDecoration strikethrough = 10;
+		optional TextDecoration underline = 11;
+		optional TextDecoration background = 12;
+		optional string script = 13;
+		repeated TextAnimator textanimators = 20;
+	}
+
+    /* @comment [textsimple] Array of TextContext */
+	repeated TextContext textcontexts = 72;
+
+    /* @comment [textsimple] Flag to indicate text contains markup referencing textcontexts */
+	optional bool usetextcontextmarkup = 73
+		[default = false];
+		
+    /* @comment [textsimple] Styles for strike-through */
+	optional TextDecoration strikethrough = 77;
+
+    /* @comment [textsimple] Styles for underline */
+	optional TextDecoration underline = 78;
+
+    /* @comment [textsimple] Styles for background */
+	optional TextDecoration background = 79;
+
+    /** @comment [video] Detect and apply device orientation/rortation meta data */
+	optional bool rotatevideobymetadata = 74
+		[default = true];
+	/* @undocumented enables prefetching and caching on disk of large video resources to avoid large range request seek times*/
+	optional bool allowhttpprefetch = 83
+		[default = true];
+
+	/** @comment [video, http, textsimple] Advanced configuration options for making http requests */
+	optional HTTPDownloadRequestInformation httpconfig = 97;
+
+    /* An animated cubic bezier path */
+	message PathDescription{
+	
+		enum PathType{
+			type_straight = 1;
+			type_bezier = 2;
+		}
+		enum DrawMethod{
+			draw_fill = 1;
+			draw_stroke = 2;
+			draw_stroke_fill = 3;
+		}
+		optional PathType pathtype =1
+			[default=type_straight];		
+		optional TrackData points = 2;
+		optional Color color = 3;
+		optional Color fillcolor = 8;
+		optional double linewidth = 4
+			[default=1.0];
+		
+		optional LineCapStyle capstyle =5
+			[default=cap_butt];
+		optional bool closepath = 6
+			[default=true];
+		optional DrawMethod drawmethod = 7
+			[default=draw_fill];
+	}
+
+    /** @comment [path] Definition for an animated path of cubic bezier curves */
+	optional PathDescription pathdescription = 75;
+	
+	/** @comment [textsimple] Modifier for the height of new lines in percent*/
+	optional double textnewlineheightmodifier = 84
+		[default = 0.0];
+
+	/** @comment [textsimple] Script of the text to be rendered. Default (unset) autodetects on a per character basis.
+		Valid values are ISO 15924 abbreviations and long script names from the Unicode Character Database. 
+		E.g. the usual western alphabet characters would be 'Latn' or 'Latin', Arabic would be 'Arab' or 'Arabic'*/
+	optional string textscript = 86;
+	
+	enum TextWritingMode{
+		textwritingmode_lrtb = 0;
+		textwritingmode_lrbt = 1;
+		textwritingmode_tblr = 2;
+		textwritingmode_tbrl = 3;
+	}
+	/** @comment [textsimple] Text writing mode option for horizontal/vertical text. Modes like rl* and bt* are expected to be handled through BiDi instead*/
+	optional TextWritingMode textwritingmode = 87
+		[default = textwritingmode_lrtb];
+	
+	/** Definition of special ruby context. Used to define the three components of a ruby definition 'container', 'base', 'text' and 'reserve' markup for lines that should reserve space for rubies*/
+	message TextRuby{
+		enum Type{
+			/** Container type, needs 0 or 1 base and 0..n text components and nothing else inside*/
+			type_container = 0;
+			/** Base type, needs to be the first component in its container*/
+			type_base = 1;
+			/** Text type*/
+			type_text = 2;
+			/** Reserve type*/
+			type_reserve = 3;
+		}
+		/** Type of ruby*/
+		required Type ruby = 1;
+		/** Name of the special ruby context */
+		required string name = 2;
+		
+		enum Align{
+			/** Align at the start of the ruby container (left justified/top justified) */
+			align_start = 0;
+			/** Align at the center of the ruby container */
+			align_center = 1;
+			/** Align at the end of the ruby container (right justified/bottom justified) */
+			align_end = 2;
+		}
+		enum Position{
+			/** Position before the base */
+			position_before = 0;
+			/** Position after the base */
+			position_after = 1;
+			/** Position before the first line and after every other line */
+			position_outside = 2;
+		}
+		enum Reserve{
+			/** Reserve space before and after the line(s)*/
+			reserve_both = 0;
+			/** Reserve space before the line(s)*/
+			reserve_before = 1;
+			/** Reserve space after the line(s)*/
+			reserve_after = 2;
+			/** For multiple lines reserve space before the first line, and after every other line, for one line reserve space before and after the line*/
+			reserve_outside = 3;
+		}
+		
+		/** @comment [type_container] Alignment mode of the ruby base and ruby text (whichever is longer) */
+		optional Align rubyalign = 3
+			[default = align_center];
+		
+		/** @comment [type_text] Position of the ruby text */
+		optional Position rubyposition = 4
+			[default = position_outside];
+	
+		/** @comment [type_reserve] Position of the ruby reserved space */
+		optional Reserve rubyreserve = 5
+			[default = reserve_outside];
+	
+		/** @comment [type_text, type_reserve] Size modifier of the ruby text (or potential ruby text for reserve) in relation to base*/
+		optional double relativesize = 6
+			[default = 0.5];
+	
+		/** @comment Additional context definition for the ruby component*/
+		optional TextContext context = 7;
+	}
+	/** @comment [textsimple] List of specialized text contexts used for ruby support, ruby specific options are based on the TTML2 standard. Needs 'usetextcontextmarkup' to be true to have an effect. */
+	repeated TextRuby textrubies = 88;
+	
+	/** Definition of a special text combine context. Used to group characters that should be rendered horizontally together in vertical text runs. Has no special effect in horizontal text.*/
+	message TextCombine{
+		/** Name of the special ruby context */
+		required string name = 2;
+		/** @comment Outer fontspacing*/
+		optional double fontspacing = 3;
+		/** @comment Additional context definition for the text combine component*/				
+		optional TextContext context = 4;
+	}
+	/** @comment [textsimple] List of specialized text contexts used for ruby support, ruby specific options are based on the TTML2 standard. Needs 'usetextcontextmarkup' to be true to have an effect. */
+	repeated TextCombine textcombines = 89;
+	
+	enum TextCharacterPositionMode{
+		/** Use the bounding box of the individual character*/
+		charposition_charbased = 1;
+		/** Use the extent of the individual character in writing direction, but use font based maxima in non-writing direction. I.e. this makes the height consistent for horizontal text even when the text changes*/
+		charposition_fontbased = 2;
+	}
+	
+	/** @comment [textsimple] Changes how character positions (i.a. used tor 'textposition'-TrackData) are computed */
+	optional TextCharacterPositionMode textcharpositionmode = 91
+		[default = charposition_charbased];
+	
+	/** @comment set a limit to the number of frames determined dynamically from content */
+	optional int32 maxcontentframes = 90;
+
+	message GradientDescription{
+		enum Type{
+			/** A linear gradient */
+			gradient_linear = 1;
+			/** A radial gradient */
+			gradient_radial = 2;
+			/** A conic gradient */
+			gradient_conic = 3;
+		}
+		/** The type of gradient*/
+		optional Type type = 1
+			[default = gradient_linear];
+		/** Specifies if the gradient should repeat */
+		optional bool repeating = 2
+			[default = false];
+
+		/** @comment [gradient_linear, gradient_conic] Angle in degrees, for the linear gradient it specifies rotation of the gradient, for the conic gradient it specifies the start of the gradient */
+		optional double angle = 3
+			[default = 0.0];
+
+		enum Shape{
+
+			shape_ellipse = 1;
+			shape_circle = 2;
+		}
+		enum RadialSize{
+			/** Circle/ellipse goes through the farthest corner from the middle*/
+			radialsize_farthest_corner = 1;
+			/** Circle/ellipse touches the farthest side(s) from the middle*/
+			radialsize_farthest_side = 2;
+			/** Circle/ellipse goes through the closest corner from the middle*/
+			radialsize_closest_corner = 3;
+			/** Circle/ellipse touches the closest side(s) from the middle*/
+			radialsize_closest_side = 4;
+			/** Circle/ellipse sizes is specified by radiusx (and radiusy)*/
+			radialsize_absolute = 5; 
+		}
+		/** @comment [gradient_radial] shape of the radial gradient*/
+		optional Shape shape = 4 
+			[default = shape_ellipse];
+		/** @comment [gradient_radial] specifies how to determine the size of the radial gradient */
+		optional RadialSize radialsize = 5
+			[default = radialsize_farthest_corner];
+		/** @comment [gradient_radial] specifies an absolute radius when radialsize is radialsize_absolute */
+		optional double radiusx = 6;
+		/** @comment [gradient_radial] specifie a second absolute radius for ellipse when radialsize is radialsize_absolute */
+		optional double radiusy = 7;
+		
+		/** @comment [gradient_radial, gradient_conic] the middle point of the gradient */
+		optional Point middle = 8;
+
+		message ColorStop{
+			enum Type{
+				/** A color stop, needs color set */
+				stop = 1;
+				/** A transition hint, needs positionset, ignores its color, needs to be followed and preceded by a normal color stop */ 
+				hint = 2;
+			}
+			/** Type of the color stop, if it is a real stop or only a transition hint */
+			optional Type type = 1
+				[default = stop];
+			enum PositionType{
+				/** Position is relative, usually in [0.0 - 1.0] */
+				position_relative = 1;
+				/** Position is in pixel, pixel based color stops are not allowed for gradient_conic */
+				position_pixel = 2;
+			}
+			/** Position type of the color stop, pixel position color stops are not allowed for gradient_conic */
+			optional PositionType positiontype = 2
+				[default = position_relative];
+			/** The position of the color stop */
+			optional double position = 3;
+			/** The color of the color stop */
+			optional Color color = 4;
+		}
+		/** The color stops of the gradient, need at least one color stop */
+		repeated ColorStop colorstops = 9;
+
+	}
+	/** @comment [gradient] Description for the gradient to render*/
+	optional GradientDescription gradientdescription = 93;
+	/** @comment [gradient] Defines the interpolation color space between gradient color stops*/
+	optional Color.ColorInterpolationMode gradientinterpolationmode = 94
+		[default = color_interpolation_rgb];
+	enum GradientDescriptionType{
+		/** Use the gradient description specified via 'gradientdescription' parameter*/
+		gradientdesctype_embedded = 1;
+		/** Parse the string specified via 'gradientdescriptionvariable' parameter*/
+		gradientdesctype_string = 2;
+	}
+	/** @comment [gradient] Where to get the gradient description*/
+	optional GradientDescriptionType gradientdescriptiontype = 95
+		[default = gradientdesctype_embedded];
+	/** @comment [gradient] Variable that can be used to specify the gradient as a string (in css)*/
+	optional StringVariable gradientdescriptionvariable = 96;
+
+	/** @comment [string] Variable that holds image data either as RFC2397 data URL or SVG XML document */
+	optional StringVariable imagedata = 103;
+
+	message TextAnimator{
+		message Selector{
+			enum BasedOnType{
+				BASEDON_CHARS = 1;
+				BASEDON_CHARSNOSPACES = 2;
+				BASEDON_WORDS = 3;
+				BASEDON_LINES = 4;
+			}
+			/** Based on which unit the animation values are computed. Can be used to animate all characters individually or all in the same word or line at the same time.*/
+			optional BasedOnType basedon = 3
+				[default=BASEDON_CHARS];
+
+			enum ShapeType{
+				/** Transform from start to end with the edges being partially affected based on smoothness*/
+				SHAPE_SQUARE = 1;
+				/** Transform from start to end with the end being fully transformed, the start being not transformed and units inbetween being interpolated linearly*/
+				SHAPE_RAMPUP = 2;
+				/** Transform from start to end with the start being fully transformed, the end being not transformed and units inbetween being interpolated linearly*/
+				SHAPE_RAMPDOWN = 3;
+				/** Transform from start to end with the start being not transformed, the end being not transformed, the halfway point being fully transformed and units inbetween being interpolated linearly*/
+				SHAPE_RAMPBOTH = 4;
+				/** Transform from start to end with the start being not transformed, the end being not transformed, the halfway point being fully transformed and units inbetween being interpolated on a scaled half circle*/
+				SHAPE_ROUND = 5;
+				/** Transform from start to end with the start being not transformed, the end being not transformed, the halfway point being fully transformed and units inbetween being interpolated eased*/
+				SHAPE_SMOOTH = 6;
+			}
+			/** Shape of the Selector, determines which characters are fully/partially animated*/
+			optional ShapeType shape = 4;
+
+			/** Smoothness of the edge of SHAPE_SQUARE, should be between 0.0 and 1.0 */
+			optional double squaresmoothness = 13
+				[default=1.0];
+			/** The amount the animated property is affected by the animation*/
+			optional double amount = 5
+				[default=1.0];
+			/** Function to modify the amount the animated property is animated by over time*/
+			optional Function amountfunction = 6;
+
+			/** Start of the selected range (in percent)*/
+			optional double start=7
+				[default=0.0];
+			/** End of the selected range (in percent)*/
+			optional double end=8
+				[default=1.0];
+			/** Offset to start and end of the selected range (in percent)*/
+			optional double offset=9
+				[default=0.0];
+
+			/** Function to animate start of the selected range */
+			optional Function startfunction=10;
+			/** Function to animate end of the selected range */
+			optional Function endfunction=11;
+			/** Function to animate offset of the selected range */
+			optional Function offsetfunction=12;
+
+			enum RangeValueType{
+				RANGEVALUE_PERCENT = 1;
+				RANGEVALUE_UNITINDEX = 2;
+			}
+			/** How the start, end and offset values will be interpreted */
+			optional RangeValueType rangevaluetype = 14
+				[default=RANGEVALUE_PERCENT];
+
+			optional double easehigh = 15
+				[default=0.0];
+			optional double easelow = 16
+				[default=0.0];
+
+		}
+		repeated Selector selectors = 2;
+		
+		enum AnchorPointType {
+			ANCHORPOINT_CHARS = 1;
+			ANCHORPOINT_WORDS = 2;
+			ANCHORPOINT_LINES = 3;
+			ANCHORPOINT_ALL = 4;
+		}
+		/** on what type of grouping the anchor point is based on */
+		optional AnchorPointType anchorpointtype = 18
+			[default=ANCHORPOINT_CHARS];
+		/** offset to the anchor point relative to the anchor point grouping (1.0 is 100% of the size of the group)*/
+		optional Point anchorpointalignment = 19;
+
+		enum PropertyType{
+			PROPERTY_SIMPLE = 1;
+			PROPERTY_MULTIVALUE = 2;
+			PROPERTY_3DVALUE = 3;
+		}
+		/** Mode of animating properties (rotate, scale, translate, etc.) PROPERTY_MULTIVALUE can have differing values over time (anchortrackdata, etc.)*/
+		optional PropertyType propertytype = 7
+			[default=PROPERTY_SIMPLE];
+
+		/**Properties used with propertytype PROPERTY_SIMPLE*/
+
+		optional Point anchor = 3;
+		optional Point scale = 4;
+		optional float rotate = 5;
+		optional Point translate = 6;
+		optional Point skew = 14;
+		optional double opacity = 8
+			[default=1.0];
+
+		/**Properties used with propertytype PROPERTY_MULTIVALUE*/
+
+		optional TrackData anchortrackdata = 9;
+		optional TrackData scaletrackdata = 10;
+		optional TrackData rotatetrackdata = 11;
+		optional TrackData translatetrackdata = 12;
+		optional TrackData skewtrackdata = 15;
+		optional Function opacityfunction = 13;
+
+		optional Pos3d anchor3d = 20;
+		optional Pos3d scale3d = 21;
+		optional Pos3d rotate3d = 22;
+		optional Pos3d translate3d = 23;
+		optional Pos3d skew3d = 24;
+		optional double focus3d = 25;
+
+		
+		/** Color to which the color of the text is interpolated to*/
+		optional Color color = 16;
+		optional Color.ColorInterpolationMode colorinterpolation = 17
+			[default=color_interpolation_rgb];
+
+
+
+
+	}
+
+	repeated TextAnimator textanimators = 104;
+
+	/** @comment [textsimple] change the region where the text is constrained to for purposes of overflowresize considerations from the default (size of image - borders)*/
+	optional ROI textroi = 105;
+
+	/* A description for a grid layout */
+	message LayoutDescription{
+
+		/* Specification for a track (column or row) of the grid */
+		message Track{
+			enum Type{
+				/* determine size from content of grid items */
+				auto = 1;
+				/* size is value in pixels */
+				pixel = 2;
+				/* size as a fraction of total size of the grid (100% is 1.0)*/
+				percent = 3;
+				/* size is value in flex units, flex units (fr) represent size normalized to the sum of all flex units of columns/rows, if sum is greater than 1.0, or 1.0 if smaller than 1.0. */
+				flex = 4;
+			}
+			/** type of the tracks size */
+			optional Type type = 1
+				[default = pixel];
+			/** @comment [pixel, percent, flex] the size in a unit specified by type */
+			optional double value = 2;
+		}
+		/** A list of Tracks defining the explicit rows of the grid */
+		repeated Track rows = 2;
+		/** A list of Tracks defining the explicit columns of the grid */
+		repeated Track columns = 3;
+		/** A default Track specification for implicit rows of the grid */
+		optional Track rowdefault = 5;
+		/** A default Track specification for implicit columns of the grid */
+		optional Track columndefault = 6;
+
+		/** Specification for a grid item */
+		message Item{
+
+			/** The content of the grid */
+			optional ImageProvider content = 2;
+			
+			/** Left border inside the grid item, contributes to size of the grid item if a Track containing the item is auto sized*/
+			optional int32 borderleft = 3
+				[default = 0];
+			/** Right border inside the grid item, contributes to size of the grid item if a Track containing the item is auto sized */
+			optional int32 borderright = 4
+				[default = 0];
+			/** Top border inside the grid item, contributes to size of the grid item if a Track containing the item is auto sized */
+			optional int32 bordertop = 5
+				[default = 0];
+			/** Bottom border inside the grid item, contributes to size of the grid item if a Track containing the item is auto sized*/
+			optional int32 borderbottom = 6
+				[default = 0];
+
+			/** The first row containing the grid item, can be omitted so that the grid item is placed implicitely either based on a specified rowend (spanning one row) or the explicit grid and surrounding grid items.
+				The explicit grid starts at row 0.
+			 */
+			optional int32 rowstart = 7;
+			/** The row at which the grid item ends (the item is not contained in this row), can be omitted so that the grid item is placed implicitely either based on a specified rowstart (spanning one row) or the explicit grid and surrounding grid items */
+			optional int32 rowend = 8;
+			/** The first column containing the grid item, can be omitted so that the grid item is placed implicitely either based on a specified columnend (spanning one column) or the explicit grid and surrounding grid items.
+				The explicit grid starts at column 0.
+				 */
+			optional int32 columnstart = 9;
+			/** The column at which the grid item ends (the item is not contained in this column), can be omitted so that the grid item is placed implicitely either based on a specified columnstart (spanning one column) or the explicit grid and surrounding grid items */
+			optional int32 columnend = 10;
+
+			enum Position{
+				/** position at the start (top or left) */
+				position_start = 0;
+				/** position in the center */
+				position_center = 1;
+				/** Position at the end */
+				position_end = 2;
+			}
+			/** Position of the content of the item in the grid cell X axis (left, center, right)*/
+			optional Position justify = 11
+				[default=position_center];
+			/** Position of the content of the item in the grid cell Y axis (top, center, bottom)*/
+			optional Position align = 12
+				[default=position_center];
+
+		};
+
+		/** The grid items. Items positioned not in the explicit grid (rows, columns) create new implicit Tracks using the rowdefault, columndefault */
+		repeated Item items = 4;
+
+	}
+
+
+	/** @comment [layout] parameters for layout */
+	optional LayoutDescription layoutdescription = 107;
+
+	repeated string name = 85;
+
+    extensions 1000 to 1999;
+	
+}
+
+
+/** A FileLocation specifies the location of a file (on disk or on the internet).
+The path specifies the qualified filename or URL of the file.
+
+Variable substitution will be performed on the following special tokens:
+<table>
+<tr><th>Token</th></tr>
+<tr><td>$variable</td><td>The token $variable will be replaced with the result of a StringVariable</td></tr>
+<tr><td>$session</td><td>The token $session will be replaced with the current session or token ID</td></tr>
+<tr><td>$frame</td><td>The token $frame will be replaced with the current frame number<td></td></tr>
+</table>
+*/
+message FileLocation{
+	enum Type{
+		/** Default FileLocation type */
+		simple=0;
+
+		/** @undocumented */
+		session=1;
+		/** @undocumented */
+		frame=2;
+		/** @undocumented */
+		sessionandframe=3;
+		/** @undocumented */
+		var=4;
+		/** @undocumented */
+		varframe=5;
+		/** @undocumented */
+		varsession=6;
+		/** @undocumented */
+		varframesession=7;
+	}
+
+	/** @deprecated: Used to indicate subsitution type. 
+		Now: all necessary substitutions are determined automatically from the path */
+	optional Type type=1;
+	
+	/**The file location with optional tokens to replace */
+	required string path=2;
+	
+	/** Offset that is added to the framenumber before substitution */
+	optional int32 offset=3 [default=0];
+	
+	/** Frame numbers are padded with zeroes, till they are at least padding long */
+	optional int32 padding=4 [default=5];
+	
+	/** the token <code>$variable</code> will be replaced with the value of this */
+	optional StringVariable variable=5;
+
+	enum FileSystemType{
+		filesystem_project = 1;
+		filesystem_userfs = 2;
+	}
+	optional FileSystemType filesystemtype = 6
+		[default = filesystem_project];
+}
+
+
+/**
+* Container for AudioTracks. All tracks are mixed (composed) according to their 
+* Mix and volume settings
+*/
+message Audio {
+	/** Array of AudioTracks to compose */	
+	repeated AudioTrack audiotracks=2;
+
+    extensions 1000 to 1999;
+}
+
+
+/**
+* The AudioTrack object encapsulate an audio source. Like VisualTracks, audio tracks 
+* can be composed (mixed) on top of each other according to their volume and clipping functions.
+* <br><br>
+* Note: When operating on sections of audio objects (numframes, offset), a frame is defined
+* by the number of audio samples per frame. To work width audio frames taht are roughly equal
+* to the visual frames set the audioframesize in the AudioParams to samplerate/(frames per second)
+* e.g. 44100 / 25 = 1764.
+*/
+message AudioTrack{
+	/** Mix Mode */
+	enum LevelMode{
+	 /** hard-clip audio track when applying gain, mixing tracks will never overdrive, intermodulation artifacts may occur */
+	 legacy=0;
+	 /** soft-clip audio track when applying gain, mixing tracks will never overdrive, intermodulation artifacts may occur */
+	 legacy_softgain=1;
+	 /** generally hard clip sample amplitude at overflows */
+	 hardclip=2;
+	 /** soft clip sample amplitude at overflows - less audible distortion */
+	 softclip=3;
+	 /** soft clip with 4x oversampling (avoids aliasing, more cpu-intensive) */
+	 softclip4x=4;
+	}
+
+	/** Source type */
+	enum Type{
+	 /** audio source is preencoded aac*/
+	 preencoded=0;
+
+	 /** audio source is wav, mixed with underlying AudioTracks, deprecated use video_mix*/
+	 mix=1;
+
+	 /** audio source is wav, replacing underlying AudioTracks, deprecated use video_replace*/
+	 replace=2;
+	 
+	 /** audio source is a video, mixed with underlying AudioTracks , deprecated use video_mix*/
+	 decoder=3;
+
+	 /** audio source is a video, replacing underlying AudioTracks, deprecated use videoreplace*/
+	 decoder_replace = 4;
+
+	 /** audio source is a video, but the audio is cached in a .wav-file, mixed with underlying AudioTracks*/
+	 video_mix = 5;
+
+	 /** audio source is a video, but the audio is cached in a .wav-file, replacing underlying AudioTracks*/
+	 video_replace = 6;
+	 
+	 /** based on a sceneview*/
+	 scenebased = 7;     
+	           
+	 /** create silent track*/
+	 empty = 8;
+
+	 /** change volume of tracks rendered up to this point */
+	 changevolume = 20;
+
+	 /** Live (Remote) audio source */
+	 live = 9;
+
+	 /** Live (Remote) audio source, no mixing */
+	 live_replace = 19;
+
+	 /** dynamically synthesized audio track, no mixing*/
+	 synthetic = 10;
+
+	 /** dynamically synthesized audio track*/
+	 synthetic_mix = 11;
+	 
+	 /** combining track that plays inner audiotracks backtoback even on variable lengths*/
+	 backtoback = 12;
+
+	 /** @undocumented used internally for transition to seperated AudioTrack/AudioProvider system*/
+	 media_mix = 21;
+	 media_replace = 22;
+
+	 /** Audio from 'audioprovider' is mixed with underlying audio tracks */
+	 provided_mix = 23;
+	 /** Audio from 'audioprovider' replaces underlying audio tracks */
+	 provided_replace = 24;
+
+	}
+
+	/** Type of this AudioTrack */
+	optional Type type=1 [default = preencoded];
+
+	/** Globally applied gain, specified in dB */
+	optional double gain = 15 [default = 0];
+	
+	/** Volume for audio mixing used in mix */
+	optional double volume = 3 [default = 1.0];
+
+	/** Volume function for fade in and fade out */
+	optional Function volumefunction = 6;
+	
+	/** The default location of the audio file, used to give a fallback for multi language audio */
+	optional FileLocation defaultsource=4;
+
+	/** The location for the audio source, either a sound file, or a video( .mov, .mp4, .avi) */
+	optional FileLocation source=5;
+	
+	
+	/** Offset from the beginning of the scene/movie, audio starts playing after offset frames  */
+	optional int32 offset=2[default = 0];
+
+	/** Optional number of frames (use when fewer frames needed than source provides) */
+	optional int32 numframes = 9;
+	
+	/** Audio content offset, when audio starts playing it begins with the equivalent of the contentoffset of the AudioSource */
+	optional int32 contentoffset = 11;
+
+	/** Variable for contentoffset */
+	optional StringVariable contentoffsetvariable = 21;
+	
+	/** Variable for dynamic offset of the AudioTrack */
+	optional StringVariable offsetvariable = 27;
+
+	/** Number of frames overlapping in edit situations e.g. crossfade transitions.
+	 *  Adjusts contentoffset/numframes, usually should be negative e.g. -25
+	 */
+	optional int32 editoverlap=24;
+
+	/** Do not throw error if source provides no audio */
+	optional bool optional_audio = 10[default = false];
+
+	/** @comment [scenebased] SceneView for scene-based audio */
+	optional SceneView sv = 12;
+
+	/** Names for this a´AudioTrack */
+	repeated string name = 13;
+
+	/** Mix mode */
+	optional LevelMode levelmode = 16 [default = legacy];
+
+	/** @undocumented */
+	optional Synthesizer synthesizer = 17;
+	
+	/** @deprecated */
+	repeated AudioTrack inneraudiotracks = 18; // deprecated use audiotracks in inneraudio instead
+
+	/** @comment [backtoback] List of tracks */
+	optional Audio inneraudio = 20;
+	
+    /** ignore any provided length information. Instead use computed length */
+	optional bool ignorelength = 19
+		[default=false];
+
+	/** Variable to enabled or disable this track dynmically */		
+	optional StringVariable enablevariable = 22;
+
+	/** Invert logic for enabledvariable */
+	optional bool invertenable = 23
+		[default=false];
+	
+    /** @internal name (used by editors for indentification purposes) */
+	optional string comment = 2047;
+
+    /** @internal cache computed data */
+	optional bool usecachedir = 7[default = true];
+
+	/* @undocumented enables prefetching and caching on disk of large video resources to avoid large range request seek times*/
+	optional bool allowhttpprefetch = 25
+		[default = true];
+
+	/** Advanced configuration options for making http requests */
+	optional HTTPDownloadRequestInformation httpconfig = 32;
+
+    /** @internal name of cache directory */
+	optional string cachedir = 8[default = "cache"];
+
+	/** @comment [video_mix, video_replace, mix, replace] Endbehaviour of audio source */
+	optional EndBehaviour endbehaviour =  26
+		[default = emptyframe];
+
+	/** @comment [video_mix, video_replace] Enables audio decoding using multiple streams of the source video/audio file (to support apple itunes spec) or allows to specify one used audio stream instead of defaulting to the first one */
+	repeated int32 multistreamindices = 28;
+
+	/** @comment [scenebased, backtoback] mix the audio returned from the sceneview/inneraudio according to volume/volumefunction and apply gain instead of only passing it through. Note: This changes the order audio is mixed. */
+	optional bool mixvolume = 29
+		[default = false];
+
+	/** @comment set a limit to the number of frames determined dynamically from content */
+	optional int32 maxcontentframes = 30;
+
+	optional AudioProvider audioprovider = 31;
+
+    extensions 1000 to 1999;
+}
+
+message AudioProvider{
+	enum Type{
+		media = 1;
+	}
+
+	optional Type type = 1 
+		[default = media];
+
+	/** @comment [media] The location for the audio source, either a sound file, or a video( .mov, .mp4, .avi) */
+	optional FileLocation source=2;
+
+	/** @comment [media] A default location for the media file used if source can not be loaded, e.g. can be fallback for multi language audio */
+	optional FileLocation defaultsource=3;
+
+
+	/** Audio content offset, when audio starts playing it begins with the equivalent of the contentoffset of the AudioSource */
+	optional int32 contentoffset = 4;
+
+	/** Variable for contentoffset */
+	optional StringVariable contentoffsetvariable = 5;
+	
+	/** Number of frames overlapping in edit situations e.g. crossfade transitions.
+	 *  Adjusts contentoffset/numframes, usually should be negative e.g. -25
+	 */
+	optional int32 editoverlap=6;
+
+	/** Do not throw error if source provides no audio */
+	optional bool optional_audio = 7[default = false];
+
+	/* @undocumented enables prefetching and caching on disk of large http audio sources to avoid large range request seek times*/
+	optional bool allowhttpprefetch = 8
+		[default = true];
+
+	/** Advanced configuration options for making http requests */
+	optional HTTPDownloadRequestInformation httpconfig = 11;
+
+	/** @comment set a limit to the number of frames determined dynamically from content */
+	optional int32 maxcontentframes = 9;
+
+	/** @comment Endbehaviour of audio provider */
+	optional EndBehaviour endbehaviour =  10
+		[default = emptyframe];
+
+}
+
+/** @undocumented */
+message Synthesizer
+{
+	/** @undocumented */
+	enum Type{
+		//play fixed number of random audio samples with jitter
+		randomsamples=0;
+	}
+
+	optional Type type = 1 [default = randomsamples];
+
+	// seed for random numbers
+	optional uint32 randomseed=2 [default = 0];
+	
+	// base sound samples - currently only wav supported
+	repeated FileLocation samples=3;
+
+	// for randomsamples this is the number of samples to be played (StringVariable containing int)
+	optional StringVariable iterations=4;
+
+	// for randomsamples this is the maximum of periodicity jitter in seconds
+	optional double jitter=5 [default = 0 ];
+
+	// should be set to the same as numframes of enclosing AudioTrack
+	optional int32 numframes=6 [default = 500];
+
+    extensions 1000 to 1999;
+}
+
+
+
+/** BlendMode determines how two VisualTracks (Layers) are blended into each other.  */
+enum BlendMode{
+    /** This is the standard blend mode which uses the top layer alone */
+	normal=0;
+
+    /** With Screen blend mode the values of the pixels in the two layers are inverted, multiplied, and then inverted again. */
+	screen=1;
+
+    /** This is a softer version of Hard Light. Applying pure black or white does not result in pure black or white.*/
+	softlight=2;
+
+    /** Hard Light combines Multiply and Screen blend modes. Equivalent to Overlay, but with the bottom and top images swapped.*/
+	hardlight=3;
+
+    /** Overlay combines Multiply and Screen blend modes. The parts of the top layer where the base layer is light become lighter, the parts where the base layer is dark become darker. Areas where the top layer are mid grey are unaffected. An overlay with the same picture looks like an S-curve*/
+	overlay=4;
+
+    /** Multiply blend mode multiplies the numbers for each pixel of the top layer with the corresponding pixel for the bottom layer. */
+	multiply=5;
+
+    /** Mean-Value Cloning */
+	mvcclone=6;
+
+	/** Linear Dodge performs a saturating addition of the two layers*/
+	lineardodge = 7;
+
+	/** Linear burn performs a saturating addition of the two layers and then inverts the result*/
+	linearburn = 8;
+
+	/** Subtract does a saturating subtraction of of the two layers*/
+	subtract = 9;
+
+	/** Difference takes the absolute difference of the two layers*/
+	difference = 10;
+
+	/** Negation takes the absolute difference of the two layers with one layer inverted and inverts the result*/
+	negation = 11;
+
+	/** Lighten only blends the regions of the top layer where it is lighter than the bottom layer*/
+	lighten = 12;
+
+	/** Darken only blends the regions of the top layer where it is darker than the bottom layer*/
+	darken = 13;
+}
+
+
+//A VisualTrack generally composes its transformed base content on a background buffer provided by VisualTracks before it
+//If there is no input background buffer (first VisualTrack) only the transformed base content is given back
+//If there is no base content in the VisualTrack, the background buffer is transformed instead
+
+/**
+	<p>As part of the image processing pipeline, VisualTracks create, transform and composite
+	visual contents onto a background buffer. The background buffer for each VisualTrack
+	is the composite of all previous VisualTracks (or the frame buffer in case of the 
+	first VisualTrack) in the layer stack.</p>
+
+	<p>When a content is defined, the VisualTrack will transform this content by executing all
+	transformations defined in the <code>transformations</code> array. When no content is defined
+	transformations will be executed upon the background buffer ("Adjustment tracks").</p>
+
+	<p>In and out point of a VisualTrack (<code>offset</code> and <code>numframes</code>) define
+	the timing of this track within its scene. The length can also be dyamically provided through
+	the <code>numframesvariable</code> property.</p>
+
+	<p>VisualTracks can be dynamically enabled or disabled by providing a <code>enablevariable</code>.
+	If the variable evaluates to false (or not set) the entire track is disabled (as if it does not exist).
+	To disable individual transformations, see the <code>enablevariable</code> in Transformation type.</p>
+
+*/
+message VisualTrack{
+	//base content of this VisualTrack
+	optional ImageProvider content=2;
+	
+	//number of frames of this VisualTrack, if not specified it will provide content until the end of the scene
+	optional int32 numframes =3 [default =-1];
+	
+	/** Number of frames overlapping in edit situations e.g. crossfade transitions.
+	 *  Adjusts numframes, usually should be negative e.g. -25
+	 */
+	optional int32 editoverlap = 26;
+
+	//offset to change the starting point of this VisualTrack relative to the start of the scene (negative values give undefined behaviour)
+	optional int32 offset =4 [default =0];
+	
+	//options for compositing offsets of layer content
+	//offset for the compositing of background and layer content
+	optional int32 x =5 [default =0];
+	optional int32 y =6 [default =0];
+	//automatic centering for the compositing of background and layer content (center is deprecated, use centerx centery instead)
+	optional bool center = 16[default = false]; //deprecated
+	optional bool centerx = 17[default = false];
+	optional bool centery = 18[default = false]; 
+	
+	/** @deprecated Image channel to use for masking */
+	optional int32 maskchannel =7 [default =0];
+
+	/** @deprecated Invert mask */
+	optional bool invertmask =13 [default =false]; 
+
+	/** @deprecated Mask content using this mask */
+	optional ImageProvider mask = 9;
+	
+	/** Array of Transformations, that are applied to either the content or the background buffer*/
+	repeated Transformation transformations = 10;
+	
+	/** Blendmode for the compositing operation */
+	optional BlendMode blendmode= 11 [default = normal];
+
+	/** Alpha (opacity) for the compositing operation */
+	optional double opacity =12 [default = 1.0];
+
+	/** Animate opacity over time using this function */
+	optional Function opacityfunction = 15;
+	
+	/** Compute destination alpha after compositing */
+	optional bool adjustalpha =8 [default = false];	
+	
+	/** @internal */
+	optional bool lazyevaluate = 19
+		[default = true]; 
+		
+	/** Dynamically enable this VisualTrack through this variable */
+	optional StringVariable enablevariable = 20;
+
+	/** Invert the logic of the <code>enablevariable</code> */
+	optional bool invertenable = 23
+		[default=false];
+	
+	/** Name(s) for this track */
+	repeated string name = 21;
+	
+	/** Track data */
+	optional TrackData positions = 22;
+	
+	/** Ignore any provided <code>numframes*</code> properties. Length will be computed through other tracks */
+	optional bool ignorelength = 24
+		[default=false];
+	
+	/** Variable for dynamic length of the VisualTrack */
+	optional StringVariable numframesvariable = 25;
+
+	/** Variable for dynamic offset of the VisualTrack */
+	optional StringVariable offsetvariable = 27;
+
+	/** User comment */
+	optional string comment = 2047;
+
+    extensions 1000 to 1999;
+
+}
+
+/**
+    A Transformation takes an input image and return a transformed version.
+*/
+message Transformation{
+    //There are three distinctions as to the size of the returned image
+    //NeutralSize: the size does not change
+    //SpecifiedSize: the size is determined by parameters of the Transformation
+    //ContextSize: the size is determined by the context, in which the Transformation is called (usually the size of the Movie) 
+    
+    enum Type{
+    	option allow_alias = true;
+//NeutralSize
+
+        /** Gaussian blur */
+        blur=4;
+
+        /** Motion blur */
+        motionblur=5;
+
+        /** Motion blur, with parameters derived from average motion of tracking data */
+        trackedmotionblur=6;
+
+        /** inpainting of points */
+        inpaint=12;
+
+        /** masking by alpha mask */
+        mask=13;
+
+        /** Moving Least Squares image morphing (deprecated, use morph with morph_mls morphtype instead */
+        mls=7;
+
+        /** morphing image through MLS or TPS */
+        morph=34;
+
+        /** viewpoint transformation zoom in */
+        linearzoomin=10;
+
+        /** viewpoint transformation zoom out */
+        linearzoomout=11;
+
+        /** change saturation of the image */
+        intensity = 16;
+
+        /** rotate the image */
+        rotate = 36;
+
+        /** invert the image */
+        invert = 40;
+
+        /** make the image premultiplied/unpremultiplied */
+        premultiplyalpha = 41;
+
+        /** Minimax effect from After Effects, uses image morphology operations (dilate/erode), sets pixels to the minimum/maximum value of their neighbourhood */
+        minimax = 45;
+        
+        /** Circular blur */
+        circularblur = 46;
+        
+        /** Radial blur */
+        radialblur = 47;
+
+//SpecifiedSize:
+
+        /** scaling of input image */
+        scaling=8;
+
+        /** scaling of input image preserving aspect ratio */
+        scalingletter=9;
+
+        /** scaling to a specified width or height with aspect ratio */
+        scalingaspect=14;
+
+        /** scaling to a specified width or height with aspect ratio */
+        scalingcrop=30;
+
+        /** cropping of the image with x/y offset and specified size */
+        crop = 31;
+
+        /** scale down to an(implicitly) specified size (mipmap) for further use in ContextSize transformations/to avoid interpolation artifacts */
+        mipmap = 38;
+
+		/** detect a face and crop the input around it */
+		facedetect = 42;
+
+//ContextSize
+
+        /** warping to quad track data */
+        quadtracking=0;
+		/** warping to quad track data */
+        warp=0;
+
+		/** warping from quad track data */
+        warpback=43;
+
+		/** warping from quad track data to quad track data*/
+        warpquads=44;
+
+        /** warping to grid track data */
+        gridtracking=1;
+        /** warping to grid track data */
+        gridwarp=1;
+
+        /** warping to image map */
+        texturemapping32f=3;
+
+        /** animate the input */
+        animate=15;
+
+        /** affine transformation (2D) similar to animate */
+        affine=37;
+
+        /** affine transformation (2D) similar to animate */
+        affinemotionblur=39;
+
+        /** translate to a tracking point */
+        pointpaste=17;
+
+        /** custom */
+        custom=28;
+
+        /** Crop, rotate & warp in one step. Data supplied dynamically */
+        croprotatewarp=29;
+
+        /** Flip image around given FlipAxis */
+        flip=32;
+
+        /** Perform 3D color transformation */
+        colortwist=33;
+
+        /** Boost saturation of colors */
+        colorboost = 18;
+
+        /** Instagramm like Nashville filter*/
+        nashville = 19;
+
+        /** Instagramm like Lord Kelvin filter*/
+        lordkelvin = 20;
+
+        /** Colorize specific color range, grayscale the rest */
+        splittoning = 21; 
+
+        /** Depth of field simulation */
+        tiltshift = 22;
+
+        /** Instagramm like Sin City filter*/
+        sincity = 23;
+
+        /** Glow Effect */
+        glow = 24;
+
+        /** Vignette (darken edges with circular center) */
+        vignette= 25;
+
+        /** Cartoonize image (optionally perform Roy Lichtenstein color dithering)*/
+        comic= 26;
+
+        /** Drop shadow */
+        textshadow = 27;
+
+        /** 3-D color lookup table */
+        cubelut = 35;
+
+		/** Distort image based on distortionmap **/
+		distortionmap = 48;
+	}
+
+	/** Type of this Transformation */
+	required Type type =1;
+	
+	//TrackData message for the trackdata used by tracking based Transformations: 
+	//  trackedmotionblur, quadtracking, gridtracking, linearzoomin, linearzoomout, inpaint
+    /** @comment [trackedmotionblur, quadtracking, quadtrackingback, gridtracking, croprotatewarp, linearzoomin, linearzoomout, inpaint] Motion data */
+	optional TrackData trackdata=2;
+
+	/** @comment [quadtoquadwarp] Motion data */
+	optional TrackData sourcetrackdata=104;
+
+    /**
+        @comment [texturemapping32f] image sequence to use as UV map
+        @comment [mask] mask to use on image
+		@comment [distortionmap] distortion map to use on image
+    */
+	optional ImageProvider image=3;
+	
+    /**
+        @comment [blur] kernelsize of the Gaussian blur in Pixels
+        @comment [motionblur] length of the motion
+        @comment [trackedmotionblur] factor for the determined motion
+    */
+	optional double blurlength = 4
+		[default =1.0];
+
+    /**
+        @comment [blur] sigma of the Gaussian blur
+        @comment [motionblur] direction of the motion in degrees
+    */
+	optional double blurfactor = 5;
+	
+	/** @comment [blur, motionblur] increment by frame for blurlength and blurfactor */
+	optional double blurlength_inc = 6;
+
+	/** @comment [blur, motionblur] increment by frame for blurlength and blurfactor */
+	optional double blurfactor_inc = 7;
+	
+    /* @comment [blur, motionblur] Animation function for gaussian blur */
+	optional Function blurfunction = 71;
+
+	/** @comment [quadtracking] Scale the input image to an appropriate size before warping to avoid interpolation artifacts. Especially useful when large zooming is taking place. Used in quadtracking, corresponds to sharpness */
+	optional bool zoomscale = 8;
+
+	/** @comment [quadtracking] Workaround to image warping bug. Slower but avoids aliasing artifacts on warped images */
+	optional int32 smoothedge =16
+			[default =0];
+	
+    /**
+        @comment [mls] scale factor for points
+        @comment [scaling, scalingletter] Size of the scaled output
+        @comment [trackedmotionblur, quadtracking, gridtracking, linearzoomin, linearzoomout, inpaint] Scale factor for the tracking data
+    */
+	repeated double scale =9;
+	
+	/** @comment [scaling, scalingletter] If this is true scaling and scalingLetterbox Transformations are done with the scale factor relative to the imageSize */
+	optional bool scalerelative=23 
+		[default=false];
+	
+	/** @comment [scaleaspect] Aspect ratio */
+	optional double aspectratio=24;
+
+	/** @comment [scaleaspect] the length in pixels of the side specified in <var>specifiedside</var> */
+	optional int32 fixedsidesize=25;
+
+	/** @comment [scaleaspect] w | h */
+	optional string specifiedside=26;
+	
+	/** 
+        @comment [scalingletter] background color of image 
+	    @comment [sincity] Reference color. This color which will be preserved - only Hue component is relevant
+        @comment [vignette] Color the border will be faded into.
+    */
+	optional Color color =10;
+	
+	
+    /** @comment [mls] Number of points in <var>sourcepoints</var> and <var>destinationpoints</var> */
+	optional int32 numpoints =11;
+
+    /** @comment [mls] Source coordinates */
+	optional PointsVariable sourcepoints=12;
+
+    /** @comment [mls] Destination coordinates */
+	optional PointsVariable destinationpoints=13;
+
+
+	//offset and length parameters for Viewport transformations
+    /** @comment [quadtracking] number of frames to apply transformation */
+	optional int32 numframes = 14;
+
+    /** @comment [quadtracking] offset in frames for transformation */
+	optional int32 offset = 15;
+	
+	/** @comment [quadtracking, croprotatewarp] Tracking data adjustion for quadtracking */
+	/** @comment [facedetect]  Adjustion for detected face area cutout */
+	optional PosAdjust posadjust=17;
+	
+
+	/** @comment [inpaint] Radius to clean */
+	repeated int32 erasesize=18;
+
+	/** @comment [inpaint] Radius to search */
+	optional double searchradius=19
+		[default =4]; 
+		
+
+	/** @comment [mask] which channel of image contains the alpha mask*/
+	optional int32 maskchannel =20 [default =0];
+	/** @comment [mask] invert the mask before use */
+	optional bool invertmask =22 [default =false]; 
+	
+	//Animation for animation type
+    /** @undocumented */
+	repeated Animation animations = 28;
+
+    /** @undocumented */
+	optional AnimationPosition position = 29;
+
+    /** @undocumented */
+	optional double focus = 30
+		[default=0.0];
+
+
+    /** @comment [intensity] Desaturate image. Values 0..1 */
+	optional double saturation = 31;
+	
+	//used internally
+	//optional bool cacheimages=27 [default = false];
+	
+    /** 
+        @comment [vignette, colorboost, tiltshift] Factor to boost color 
+        @comment [tiltshift] Factor to boost color. 1.7 should be a good default 
+        @comment [splittone, glow] Factor to apply effect 0..1
+    */
+	optional double colorintensity = 32
+		[default = 1.0];
+
+    /** 
+        @comment [vignette, splittone] Number of standard deviations for blur. 4-32 is useful range.
+        @comment [tiltshift] Max blur sigma for gaussian blur. 8-32 should be appropriate.
+        @comment [glow] Number of standard deviations for blur. 4-32 should be useful.
+        @comment [circularblur, radialblur] Number of standard deviations for blur.
+    */
+	optional double sigma = 33
+		[default = 1.0];
+
+    /** @comment [splittone] Color for dark areas */
+	optional Color dark = 34;
+
+    /** @comment [splittone] Color for light areas */
+	optional Color light = 35;
+
+    /** @comment [sincity] Tolerance for color matching. Range 8-32 should be useful */
+	optional double tolerance = 36
+		[default = 0.2];
+
+    /** @comment [splittone] when set to true, image will me converted to monochrome first to remove original color toning. false should be a good default */
+	optional bool monochromize = 37
+		[default = false];
+
+    /** @comment [tiltshift] size of focus area. 0.1 should be a good default*/
+	optional double focussize = 38
+		[default = 0.2];
+    
+    /** @comment [tiltshift] position of focus center - 0.0 means top of image, 1.0 means bottom. 0.7 should be a good default*/
+	optional double focusheight= 39
+		[default = 0.5];
+
+    /** 
+        @comment [tiltshift] If true: use an elliptical ('spot') focus area. If false: horizontally invariant focus
+        @comment [vignette] True means emphasized area is circular, false means area is elliptical with the same AR as image
+    */
+	optional bool spotfocus = 40
+		[default = false];
+
+    /** @comment [splittone] brightness value where toning is switched from dark to light 128 is the most sensible default value */
+	optional double threshold = 41
+		[default = 0.08];
+
+    /** @comment [splittone] number of brightness levels used for dark toning - light toning transition. 8-64 should be reasonable */
+	optional double transitionwidth = 42
+		[default = 0.3];
+	
+    /** @comment [colorboost] Brightness enhance */
+    optional double brightness = 43
+		[default = 1.0];
+	
+    /** @comment [vignette] Size of preserved center area, 1.0 means full image size. Nice default: 0.7 */
+	optional double aperture= 44
+		[default = 0.7];
+
+    /** @comment [vignette] Blur faded border areas */
+	optional bool blurborder= 46
+		[default = false];
+
+    /** @comment [comic] Number of iterations for bilateral filtering. Bilateral filtering is the key processing step removing fine details to obtain plain, unicolor areas typical for comic images. 4 iterations produce good results but need a lot of cpu time.*/
+	optional int32 bilatfilter_iterations = 49
+		[default = 4];
+
+    /** @comment [comic] Scale factor for contour layer - use bigger values to drop small details and smaller for fine contours*/
+	optional double edge_detail_scale= 47
+		[default = 1.0];
+
+    /** @comment [comic] Sigma for color layer blur. This blurring step is performed after color reduction and smoothes transitions between unicolored areas - should normally be disabled with lichtenstein dithering*/
+	optional double colorblur= 48
+		[default = 0.8];
+
+    /** @comment [comic] Tonal sigma for bilat. filtering*/
+	optional double bilatfilter_tonalsigma = 50
+		[default = 8.0];
+
+    /** @comment [comic] Spatial sigma for bilat. filtering*/
+	optional double bilatfilter_spatialsigma = 51
+		[default = 3.0];
+
+    /** @comment [comic] Preprocessing Blur Sigma. Useful for reduction of fine-grained image structures or noise which may distract the edge detection process most images will look fine with this option being disabled. -1 disables option.*/
+	optional double preproc_sigma = 52
+		[default = -1.0];
+
+    /** @comment [comic] Number colors for color reduction. Depending on color_reduct_method, this parameter is used differently: <ul>
+    <li><b>ComicColorReductMethod.fixed</b><br>
+        colorreduct_levels sets the number of brightness levels for each color channel. Raise this to the power of 3 to get the number of possible colors. (The actual number of resulting colors will be smaller, except for extremely colorful images)<br>
+        
+        Points to be considered:<br>
+        Do not use too high values, real number of colors is the third power of this value Do not use too small values, reduction to fixed colors may look ugly otherwise A good default for color_reduct_levels would be 8, resulting in 8x8x8=512 possible colors.
+    </li> 
+
+    <li><b>ComicColorReductMethod.adaptive</b><br>
+        colorreduct_levels sets the actual number of colors used for reduction. Just think about how many colors should be used for this image and set this value. A good default for color_reduct_levels would be 18
+    </li> 
+
+    <li>
+        <b>ComicColorReductMethod.rlichtenstein</b><br>
+        colorreduct_levels sets the number of base colors used for reduction. White is always used as additional color. Each base color may occur in plain and in dithered style, as colored dots on white background.<br>
+        
+        Points to be considered:<br>
+        After converting the image to HSV space, the 'value' (V) component is discarded. Therefore a fewer number of colors is needed nice reduction results. A good default for color_reduct_levels would be 5
+    </li> 
+    */
+	optional int32 colorreduct_levels = 53
+		[default = 8];
+
+    /** @comment [comic] color quantization: minimum saturation which will not be quantized to grey*/
+	optional int32 colorreduct_minsaturation= 54
+		[default = 16];
+
+    /** Method used for color reduction, after bilateral filtering. */
+	enum ComicColorReductMethod{
+        /** Color reduction suitable for video. Reduction is very simple: Colors will be matched to a fixed palette, independent from image content. This avoids fluctuation and flickering effects over time.*/
+		fixed = 1;
+
+        /** Correct adaptive color reduction. Based on image content, the colors for best perceptional image representation will be determined. Should not be used with video content*/
+		adaptive = 2;
+
+        /** Special dithering style: use each color in full and half half saturation. Areas with half saturation will be dithered with dots in “Roy Lichtenstein” style.*/
+		rlichtenstein = 3;
+	}
+
+    /** @comment [comic] Color reeduction method to use*/
+	optional ComicColorReductMethod colorreduct_method= 55
+		[default = fixed];
+
+    /** @comment [comic] Ratio of area being dithered with half saturation*/
+	optional double lstein_dither_ratio = 56
+		[default = 0.5];
+
+	/** @comment [comic] Radius of dots used in dithering*/
+	optional double lstein_dot_radius = 101
+		[default = 1.6];
+	/** @comment [comic] Distance between dots used in dithering*/
+	optional int32 lstein_dot_distance = 102
+		[default = 6];
+	/** @comment [comic] Skew of dots used in dithering*/
+	optional int32 lstein_dot_skew = 103
+		[default = 1];
+
+    /** @comment [comic] Tile size during interpolation. Avoid too small values.*/
+	optional int32 interpoltilesize = 57
+		[default = 8];
+		
+	// Text shadow options - inner and outer shadows possible
+	// size and softness of shadow (blur) 
+
+    /** @comment [textshadow] */
+	optional double inner_size = 58
+		[default=3.0];
+
+    /** @comment [textshadow] */
+	optional double outer_size = 59
+		[default=0.0];
+
+	//color of shadow
+    /** @comment [textshadow] */
+	optional Color inner_color = 60;
+
+    /** @comment [textshadow] */
+	optional Color outer_color = 61;
+
+	//offset of shadow in x/y direction
+    /** @comment [textshadow] */
+	optional int32 inner_offsetx = 62
+		[default=1];
+
+    /** @comment [textshadow] */
+	optional int32 inner_offsety = 63
+		[default=1];
+
+    /** @comment [textshadow] */
+	optional int32 outer_offsetx = 64
+		[default=1];
+
+    /** @comment [textshadow] */
+	optional int32 outer_offsety = 65
+		[default=1];
+
+	//intensity of shadow - alpha composition parameter
+    /** @comment [textshadow] */
+	optional double inner_intensity = 66
+		[default=0.75];
+
+    /** @comment [textshadow] */
+	optional double outer_intensity = 67
+		[default=0.27];
+
+    /** @undocumented */
+	optional string custom_identifier = 68;
+	
+	
+    /** @comment [croprotatewarp] Rotation angle in degrees. Rotates the crop rectangle specified in <var>cropvariable</var>. Rotation center defaults to center of crop rectangle, but can be adjusted via <var>rotatecenterxoffset</var> and <var>rotatecenteryoffset</var>.*/
+	optional StringVariable rotatevariable = 69;
+
+    /** @comment [croprotatewarp] List of 4 comma separated values, specifying the top left and bottom right corners of a crop rectangle, e.g. 20, 20, 220, 320. Can be absolute or relative coordinates, depending on <var>relativecroppositions</var>.*/
+	optional StringVariable cropvariable = 70;
+
+    /** @comment [croprotatewarp] Orientation value, one of "0", "1", "2", "3". Specifies the number of 90 degree turns the cropped source image is turned to correct missing orientation metadata.*/
+	optional StringVariable orientationvariable = 97;
+
+    /** @comment [croprotatewarp] X offset for rotation center. Relative to size of crop rectangle. Default (0) is center*/
+	optional double rotatecenterxoffset = 80
+		[default = 0];
+
+    /** @comment [croprotatewarp] Y offset for rotation center. Relative to size of crop rectangle. Default (0) is center.*/
+	optional double rotatecenteryoffset = 81
+		[default = 0];
+
+    /** @comment [croprotatewarp] Use crop positions in coordinates relative to source image size.*/
+	optional bool relativecroppositions = 100
+		[default = false];
+		
+	// crop parameter - new image will be width x height pixel taken from old image with top left corner x,y
+    /** @comment [crop] Width of the cropped image */
+	optional int32 width = 72;
+
+    /** @comment [crop] Height of the cropped image*/
+	optional int32 height = 73;
+
+    /** @comment [crop] X coordinate of the top left corner*/
+	optional double x = 74;
+
+    /** @comment [crop] Y coordinate of the top left corner */
+	optional double y = 75;
+
+    /** @comment [crop] Crop from horizontal center */
+	optional bool centerx = 76;
+
+    /** @comment [crop] Crop from vertical center*/
+	optional bool centery = 77; 
+	
+	/** Axis for <var>flip</var> transformation */
+	enum FlipAxis{
+		flipx=0;
+		flipy=1;
+	}
+
+    /** @comment [flip] Flip around this axis */
+	optional FlipAxis flipaxis = 78;
+	
+    /** @comment [colortwist] */
+	optional StringVariable colormatrix = 79;
+	
+    /** Image morphing mode */
+	enum Morph{
+		morph_mls=0;
+		morph_tps=1;
+		morph_mls_legacy=2;
+	}
+
+    /** @comment [mls, morph] Image morphing mode */
+	optional Morph morphtype = 82
+		[default=morph_mls];
+
+    /** @comment [mls, morph] Source positions */
+	optional TrackData morphsourcepoints = 83;
+
+    /** @comment [mls, morph] Destination positions */
+	optional TrackData morphdestinationpoints = 84; 
+
+    /** @comment [mls, morph] Processing size */
+	optional int32 morphtilesize = 85
+		[default=10];
+	
+    /** @comment [cubelut] File in IRIDAS .cube format or Photoshop .acv curve format */
+	optional FileLocation paramfile = 86;	
+
+    /* Rotation mode for rotate transformation */
+	enum RotationMode{
+		clockwise90 = 1;
+		counterclockwise90 =2;
+		autolandscapecw = 3;
+		autolandscapeccw = 4;
+		autoportraitcw = 5;
+		autoportraitccw = 6;
+	}
+
+    /** @comment [rotate] Use video metadata to detect device rotation and re-orint image correctly */
+	optional RotationMode rotationmode = 87;
+	
+    /** @comment [affine, affinemotionblur] Scaling (Size) motion data for affine transformations */
+	optional TrackData scaledata=88;
+
+    /** @comment [affine, affinemotionblur] Rotation motion data for affine transformations*/
+	optional TrackData rotatedata=89;
+
+    /** @comment [affine, affinemotionblur] Position motion data for affine transformations */
+	optional TrackData translatedata=90;
+
+    /** @comment [affine, affinemotionblur] Anchor offset motion data for affine transformations*/
+	optional TrackData anchordata=91;
+	
+    /** Mip mapping (Resolution/Size dependant scaling) */
+	enum MipMapType{
+		mipmap_trackdatabased =1;
+		mipmap_maskbased_alpha =2;
+		mipmap_maskbased_grayscale =3;
+	}
+
+    /** @comment [mipmap] */
+	optional MipMapType mipmap_type = 92
+		[default=mipmap_trackdatabased];
+
+    /** @comment [mipmap] */
+	optional int32 mipmap_initialsize = 93
+		[default = 5];
+
+    /** @comment [mipmap] */
+	optional double mipmap_basefactor = 94
+		[default = 2];
+	
+    /** Enable this transformation depending on the value of this variable */
+	optional StringVariable enablevariable = 95;
+
+    /** Invert logic for <var>enablevariable</var> */
+	optional bool invertenable = 96
+		[default=false];
+
+    /** Invert color and/or alpha channel of an image */
+	enum InvertBehaviour{
+		invertbehaviour_color_channels = 0;
+		invertbehaviour_alpha = 1;
+		invertbehaviour_color_channels_and_alpha = 2;
+	}
+
+    /** @comment [invert] Image channels to invert */
+	optional InvertBehaviour invertbehaviour = 98
+		[default = invertbehaviour_color_channels];
+
+     /** @comment [premultiplyalpha] Premultiply image with alpha */
+	optional bool premultipliedalphastate = 99
+		[default = true];
+
+	enum MiniMaxMode{
+		minimax_minimum = 1;
+		minimax_maximum = 2;
+		minimax_minimumthenmaximum=3;
+		minimax_maximumthenminimum=4;
+	}
+	/** @comment [minimax] */
+	optional MiniMaxMode minimaxmode = 105
+		[default = minimax_minimum];
+	/** @comment [minimax] The radius determining the kernel size of the minimax morphology operation*/
+	optional int32 minimaxradius = 106
+		[default = 1];
+
+	enum AffinePositionMode{
+		affineposition_topleft = 1;
+		affineposition_topright = 2;
+		affineposition_bottomleft = 3;
+		affineposition_bottomright = 4;
+		affineposition_center = 5;
+		affineposition_centertop = 6;
+		affineposition_centerbottom = 7;
+		affineposition_centerleft = 8;
+		affineposition_centerright = 9;
+	}
+	/** @comment [affine] Determines the positioning of the image in the coordinate system (which part lies at (0, 0))*/
+	optional AffinePositionMode affinepositionmode = 108
+		[default=affineposition_topleft];
+
+
+	enum ColorSpace{
+		COLORSPACE_HSV = 1;
+		COLORSPACE_HLS = 2;
+	}
+	/** @comment [intensity] Determines the colorspace for the saturation adjustments, defaults to HSV for legacy reasons, HLS should probably be preferred */
+	optional ColorSpace intensitycolorspace = 109
+		[default=COLORSPACE_HSV];
+	/** @comment [intensity] Function to do a multiplicative animation of the "saturation" parameter */
+	optional Function saturationfunction = 110;
+
+	/**@comment [distortionmap] distortion factor in x-axis **/
+	optional double distortionxfactor = 111
+		[default = 1.0]; 
+	/**@comment [distortionmap] distortion factor in y-axis **/
+	optional double distortionyfactor = 112
+		[default = 1.0]; 
+	/**@comment [distortionmap] channel of map to use for x-axis **/
+	optional int32 distortionxchannel = 113
+		[default = 0]; 
+	/**@comment [distortionmap] channel of map to use for y-axis **/
+	optional int32 distortionychannel = 114
+		[default = 1]; 
+
+	enum ScalingAlignment{
+		scalingalign_left = 1;
+		scalingalign_center = 2;
+		scalingalign_right = 3;
+	}
+	enum ScalingPosition{
+		scalingpos_top = 1;
+		scalingpos_middle = 2;
+		scalingpos_bottom = 3;
+	}
+
+	/**@comment [scalingaspect, scalingcrop] X-axis alignemnt for scaled image, when cropped or letterboxed, default is centered **/
+	optional ScalingAlignment scalingalign = 115
+		[default = scalingalign_center];
+	/**@comment [scalingaspect, scalingcrop] Y-axis position for scaled image, when cropped or letterboxed, default is centered in middle **/
+	optional ScalingPosition scalingposition = 116
+		[default = scalingpos_middle];
+
+	repeated string name = 107;
+
+    /** user comment */
+	optional string comment = 2047;
+
+	extensions 1000 to 1999;
+}
+
+/** Structure for additional position and scale adjustment transformations */
+message PosAdjust{
+	optional double scalex=1 [default =1.0];
+	optional double scaley=2 [default =1.0];
+	optional double offsetx=3 [default =0.0];
+	optional double offsety=4 [default =0.0];
+}
+
+
+message ROI{
+	optional int32 x=2;
+	optional int32 y=3;
+	optional int32 width=4;
+	optional int32 height=5;
+}
+
+/** The color type provides properties for creating and animating colors. Colors
+in certain ImageProviders can be variable or can be animated to generate smooth
+transitions from one color to another */ 
+message Color {
+
+	enum Type{
+		/** Fixed value */
+		constant=1;
+
+		/** Color value is provided by a variable in the form #rrggbb[aa] where rr,gg, bb and aa are
+		hexadecimal values in the range [0..255]. Alpha (aa) defaults to 255 */
+		stringvariable=2;
+
+		/** Color value will be animated via throught the <code>keyframes</code> and <code>keyframefunction</code>. */
+		keyframe=3;
+	}
+
+    /** Color type */
+	optional Type type = 5 [default=constant];
+
+	/** @comment [constant] The red component of the color */
+	optional int32 red =1 [default =0];
+
+	/** @comment [constant] The green component of the color */
+	optional int32 green =2 [default =0];
+
+	/** @comment [constant] The blue component of the color */
+	optional int32 blue =3 [default =0];
+
+	/** @comment [constant] The alpha component of the color */
+	optional int32 alpha =4 [default =0];
+
+	/** @comment [stringvariable] Variable for dynamic color in the form #rrggbb[aa] where rr,gg, bb and aa are
+		hexadecimal values in the range [0..255]. Alpha (aa) defaults to 255 */
+	optional StringVariable string = 6;
+	
+	/** Type for keyframes in an animated Color definition */
+	message ColorKeyframe{
+		/** Time for this keyframe in the range [0..1]. Relative to track in which the color is used */
+		optional double time = 2;
+
+		/** Color for this keyframe.*/
+		optional Color color = 3;
+	}
+
+	/** @comment [keyframe] Array of keyframes for color animations */
+	repeated ColorKeyframe keyframes = 7;
+
+	/** @comment [keyframe] Temporal animation function. Used for easing */
+	optional Function keyframefunction = 8;
+
+    /* Interpolation modes for animated, keyframe-based Color objects */
+	enum ColorInterpolationMode {
+		color_interpolation_rgb=1;
+		color_interpolation_lab=2;
+		color_interpolation_hsv=3;
+	}
+
+	/** @comment [keyframe] Color model to use for color animations */
+	optional ColorInterpolationMode colorinterpolation = 9
+		[default=color_interpolation_rgb];
+}
+
+
+
+message TrackData{
+	enum Type{
+		/** Load data from file (json format) */
+		file=1;
+		/** Tracking data supplied in the TrackData message */
+		embedded=2;
+		/** Load data for one single frame from a PointsVariable */
+		variable = 3;
+		/** Load data via HTTP (JSON encoded)  */
+		http = 4;
+		/** Load data via a StringVariable (JSON encoded) */
+		stringvariable = 5;
+		/** Data from an array of KeyFrameTrackData objects */
+		keyframe = 6;
+		/** Data from an inner TrackData object transformed by affine transformations */
+		affine = 7;
+		/** Data from positions of a rendered text of a 'text'-ImageProvider */
+		textposition = 8;
+		/** Data computed from inner data*/
+		computed = 9;
+	 }
+
+	optional Type type=1
+		[default =file];
+
+
+	/** Frame offset */
+	optional int32 offset=3
+		[default=0];
+
+	/** Number of frames to use */
+	optional int32 numframes=13
+		[default = 1];
+
+	/** Scale all values by scale[0] (x values), scale[1] (y values) */
+	repeated double scale=5;
+
+	/** Abort rendering on any error in the motion tracking data */
+	optional bool failfast = 6
+		[default = false];
+
+	/** What to do if there are fewer motion data frames than the track's visual frames */
+	optional EndBehaviour endbehavior = 7
+		[default = repeatlast];
+
+
+
+	/** @comment [embedded] Motion data for TrackData type <code>embedded</code>.*/
+	optional EmbeddedTrackData embeddeddata=4;
+		
+	/** @comment [file, http] A FileLocation indicating the file to use */
+	optional FileLocation source=2;
+
+	/** @comment [variable] A PointVariable pointing to the motion data */
+	optional PointsVariable points = 8;
+
+	/** @comment [stringvariable] A StringVariable pointing to the motion data */
+	optional StringVariable string = 9;
+
+	/** @comment [http] Do not cache the loaded motion data (Slow) */
+	optional bool httpalwaysload = 10;
+
+	/** @comment [http] Use a caching HTTP proxy to load data */
+	optional bool uselocalhttpproxy = 11
+		[default = false];
+		
+	/** @comment [http] Advanced configuration options for making the http requests */
+	optional HTTPDownloadRequestInformation httpconfig = 25;
+
+	/** @comment [keyframe] Motion data as an array of keyframes. Values in between keyframes will be interpolated */
+	repeated KeyFrameTrackData keyframes = 12;
+
+	enum Interpolation{
+		/** Linear interpolation */
+		INTERPOL_LINEAR = 1;
+
+		/** Bezier interpolation */
+		INTERPOL_BEZIER = 2;
+	}
+
+	optional Interpolation keyframeinterpolation = 21
+		[default=INTERPOL_LINEAR];
+
+	 /** @comment [affine] Scaling (Size) motion data for affine transformations */
+	optional TrackData scaledata=14;
+
+    /** @comment [affine] Rotation motion data for affine transformations*/
+	optional TrackData rotatedata=15;
+
+    /** @comment [affine] Position motion data for affine transformations */
+	optional TrackData translatedata=16;
+
+    /** @comment [affine] Anchor offset motion data for affine transformations*/
+	optional TrackData anchordata=17;
+
+	/** @comment [affine] Trackdata transformed by affine transformation*/
+	optional TrackData innertrackdata=18;
+
+	/** @comment [textposition] Trackdata derived from positions of a 'textsimple' ImageProvider*/
+	optional ImageProvider text=19;
+
+	message TextPositionDescription{
+
+		enum Mode{
+			/** Provide a point*/
+			MODE_POINT = 4;
+			/** Use width of the character(s) and a height according to 'aspectratio' to form a quad */
+			MODE_WIDTH = 1;
+			/** Use height of the character(s) and a width according to 'aspectratio' to form a quad */
+			MODE_HEIGHT = 2;
+			/** Use width and height of the character(s) to form a quad*/
+			MODE_BOTH = 3;
+			/** Use 'fixedwidth' and 'fixedheight' to form a quad*/
+			MODE_FIXED = 5;
+			/** Provide a point, but only use the x axis component and set y axis component to 0*/
+			MODE_POINT_X = 7;
+			/** Provide a point, but only use the y axis component and set x axis component to 0*/
+			MODE_POINT_Y = 8;
+		}
+		enum PositionX{
+			/** Position the quad/point before the character(s), e.g. right side of quad coincides witth left side of character area */
+			POSX_BEFORE = 1;
+			/** Position the quad/point on the left of the character(s), e.g. left side of quad coincides with left side of character area */
+			POSX_LEFT = 2;
+			/** Position the quad/point in the center of the character(s), e.g. center point of quad coincides with center point of character area */
+			POSX_CENTER= 3;
+			/** Position the quad/point on the rigth side of the character(s), e.g. right side of quad coincides with right side of character area */
+			POSX_RIGHT = 4;
+			/** Position the quad/point after the character(s), e.g. left side of quad coincides with right side of character area */
+			POSX_AFTER = 5;
+		}
+		enum PositionY{
+			/** Position the quad/point above the character(s), e.g. bottom side of quad coincides with top side of character area */
+			POSY_ABOVE= 1;
+			/** Position the quad/point on the top of the character(s), e.g. top side of quad coincides with top side of character area */
+			POSY_TOP = 2;
+			/** Position the quad/point in the middle of the character(s), e.g. middle point of quad coincides with middle point of character area */
+			POSY_MIDDLE = 3;
+    		/** Position the quad/point on the bottom of the character(s), e.g. bottom side of quad coincides with bottom side of character area */
+			POSY_BOTTOM = 4;
+			/** Position the quad/point below the character(s), e.g. top side of quad coincides with bottom side of character area */
+			POSY_BELOW = 5;
+			/** Position the quad/point above the baseline of the character(s), e.g. bottom side of quad coincides with baseline */
+			POSY_BASELINE_ABOVE = 6;
+			/** Position the quad/point below the baseline of the character(s), e.g. top side of quad coincides with baseline */
+			POSY_BASELINE_BELOW = 7;
+		}
+
+		enum CharEnd{
+			/** Count the end of the characters from total character count*/
+			CHAREND_TOTAL = 1;
+			/** Count the end of the characters from the end of the character displayed by the typewriter effect*/
+			CHAREND_TYPEWRITER = 2;
+		}
+
+		enum RangeNewLineMode{
+			/** Include positions of all newlines in character ranges*/
+			NL_ALL = 1;
+			/** Include positions of single newlines (those that lead to an empty line) in character ranges*/
+			NL_SINGLE = 2;
+			/** Skip newlines in character ranges*/
+			NL_NONE = 3;
+		}
+
+		/** Mode to determine if single point or quad should be provided and has several options for quad dimensions*/
+		optional Mode mode = 2
+			[default = MODE_WIDTH];
+		/** Positioning in X axis*/
+		optional PositionX positionx = 3
+			[default = POSX_CENTER];
+		/** Positioning in Y axis*/
+		optional PositionY positiony = 4
+			[default = POSY_MIDDLE];
+		/** Character index to base positions on or start of character range, if 'charindexend' is set; negative indices count from end*/
+		optional int32 charindex = 5
+			[default = 0];
+		/** End of character range (inclusive) to base positions on; negative indices count from end*/
+		optional int32 charindexend = 6;
+		/** Which character to use as end for negative indexing*/
+		optional CharEnd charendmode = 7
+			[default = CHAREND_TOTAL];
+		/** Aspect ratio used for mode MODE_WIDTH and MODE_HEIGHT */
+		optional double aspectratio = 8
+			[default = 1];
+		/** Width used for mode MODE_FIXED */
+		optional double fixedwidth = 9;
+		/** Height used for mode MODE_FIXED */
+		optional double fixedheight = 10;
+		/** Option, which newlines to include in character ranges*/
+		optional RangeNewLineMode rangeusenewlines = 11
+			[default = NL_SINGLE];
+		/** Additional relative adjustment of quad points after positioning */
+		optional PosAdjust posadjust = 12;
+	}
+	/** @comment [textposition] Options used for the text dependend position data */
+	optional TextPositionDescription textpositiondesc = 20;
+
+	enum Operator{
+		OPERATOR_ADD = 1;
+		OPERATOR_SUB = 2;
+		OPERATOR_MUL = 3;
+		OPERATOR_DIV = 4;
+	}
+	/** @comment [computed] which operator to use to compute data from to inner trackdata objects */
+	optional Operator computedoperator = 22
+		[default = OPERATOR_ADD];
+	/** @comment [computed] Trackdata used as first operand in computation*/
+	optional TrackData computedoperand1=23;
+	/** @comment [computed] Trackdata used as second operand in computation*/
+	optional TrackData computedoperand2=24;
+}
+/**
+    Structure for a keyframe used in transformation onvolving tracking, motion tracking, or gemotric transformations. These keyframe support easing via Bezier functions.
+*/
+message KeyFrameTrackData{
+
+
+	enum Type{
+		/** Use 'points' directly */
+		embedded = 1;
+
+		/** Use the points provided by 'trackdata' */
+		reference = 2;
+	}
+
+	optional Type type=1
+		[default=embedded];
+
+	/** frame number */
+	optional int32 offset=2
+		[default=0];
+
+    /** @comment [embedded] keyframe values */
+	optional PointsVector points=3;
+
+	/** @comment [embedded] grid width */
+	optional int32 gridwidth = 11;
+	/** @comment [embedded] grid height */
+	optional int32 gridheight = 12;
+
+    /** Y value of the first temporal control point */
+	optional double incoming_velocity = 5
+		[default = 0.0];
+
+    /** X value of the first temporal control point */
+	optional double incoming_influence = 6
+		[default = 0.0];
+
+    /** Y value of the second temporal control point */
+	optional double outgoing_velocity = 7
+		[default = 0.0];
+    /** X value of the second temporal control point */
+	optional double outgoing_influence = 8
+		[default = 0.0];
+
+	/** @comment [reference] TrackData object queried for points */
+	optional TrackData trackdata = 9;
+	/** @comment [reference] offset into the tracking data specified in 'trackdata' */
+	optional int32 contentoffset = 10;
+
+	/** @comment [embedded] Bezier control point keyframe values */
+	optional PointsVector incomingcontrol = 14;
+	/** @comment [embedded] Bezier control point keyframe values */
+	optional PointsVector outgoingcontrol = 15;
+	
+	/** @comment [reference] Bezier control points keyframe values provided by TrackData object */
+	optional TrackData incomingcontroltrackdata = 16;
+	/** @comment [reference] Bezier control points keyframe values provided by TrackData object */
+	optional TrackData outgoingcontroltrackdata = 17;
+}
+
+/** Structure to hold motion data. To be used when data is embedded directly in the SDL and not loaded from a file. */
+message EmbeddedTrackData{
+    /** Motion data */
+	repeated PointsVector frames=2;
+
+    /** Number of points per frame (horizonally, usually 2) */
+	optional int32 width=3
+		[default =0];
+
+    /** Number of points per frame (vertically, usually 2) */
+	optional int32 height=4
+		[default =0];
+    
+    /** @internal */
+	optional Point motionstart = 5;
+
+    /** @internal */
+	optional Point motionend = 6;
+}
+
+/*
+ * @deprecated
+ */
+message TrackDataFrame{
+	optional PointsVector points=2;
+}
+
+
+/**
+	@undocumented
+
+	Subtitles are half dynamic content and can be preencoded, when all languages(possible variations) are specified at Movie creation time 
+*/
+message Subtitles{
+	/** ImageProvider that provides subtitles overlays, expected to have a map variable with key SubtitleFunctor::language_identifier */
+	required ImageProvider content =2;
+
+	/** all languages for which subtitles will be preencoded */
+	repeated string languages =3;
+
+}
+
+/**
+	Variable messages can fetch data like user names or coordinates dynamically at rendering time
+	At the moment there are string and PointVector variables.
+	StringVariables are used in TextRendering and in FileLocations.
+	PointVectorVariables provide user supplied morph points for the MLS transformation.
+	As soon as a dynamic variable (not const, add, condition or boolean) is used somewhere in a Scene the whole Scene becomes dynamic
+*/
+message StringVariable{
+	enum Type{
+		/** constant variable, use value*/
+		constant=0;
+
+		/** fetch value from file, discontinued*/
+		file=1;
+
+		/** fetch value over http*/
+		http=2;
+
+		/** fetch value from map of GET-parameters*/
+		map=3;
+
+		/** randomly select a value from randomvalues*/
+		random=4;
+
+		/** meta variable, that adds the values of two variables together*/
+		add=5;
+
+		/** iv tool support for selector/target based filename retrieval*/
+		target = 6;
+
+		/** variable getting values from an iv tool datasource*/
+		datasource = 7;
+
+		/** tests if file exists*/
+		fileexists = 8;
+
+		/** uses path-syntax to retrieve data from structured input (only JSON and JSONPath implemented) */
+		structureddata = 9;
+		
+		/** evaluates condition using variable1 comparing with operator to specified values, intended for enablevars */
+		condition = 65;
+
+		/** was boolean*/
+		logical = 66; 
+
+		/** changes value from counterstart to counterend based on function, expects parsable input */
+		counter = 67;
+		
+		/** escapes value of inner variable for use in URLS*/
+		urlescape = 69;
+
+		/** transform string value of inner variable */
+		transform = 70;
+		
+		/** template variable, taking template substitution values directly from a context build from the map parameters */
+		format = 68;
+		
+		/** time providing variable, that gives either current date/time or user specified date/time as floating point number (e.g. for use in counter) */
+		datetime = 71;
+	}
+	
+	/** Type of this variable */
+	required Type type=1;
+	
+	/** @comment [file, http, map] Location/key where the value can be retrieved */
+	optional FileLocation source=2;
+
+	/** @comment [map, datasource]  (Query-) Parameter name */
+	optional string key=7;
+	
+	/** @comment [random]  values from which one is randomly picked*/
+	repeated string randomvalues=3;
+	
+	/** @comment [constant, template] Value*/
+	optional string value =4;
+	
+	/** @comment [add] Variable for first parameter*/
+	optional StringVariable variable1=5;
+
+	/** @comment [add] Variable for second parameter*/
+	optional StringVariable variable2=6;
+	
+	/** @comment [map] Default value */
+	optional string defaultvalue = 8;
+	
+	/** @comment [datasource] Column name*/
+	optional string column =9;  
+
+	/** @comment [datasource] Default row*/
+	optional string defaultrow =10;
+	
+    /* Data encoding for Structured Data StringVariables */
+	enum StructuredDataType{
+		structured_json = 1;
+	}
+
+	/** @comment [structureddata] Type*/
+	optional StructuredDataType structureddatatype =11
+		[default=structured_json];
+
+	/** @comment [structureddata] Input data*/
+	optional StringVariable structureddatainput=12;
+
+	/** @comment [structureddata] Data source*/
+	optional StringVariable path=13;
+
+	/** @comment [structureddata] Variable for dynamic formatting of integers*/
+	optional StringVariable integerformat=14;
+
+	/** @comment [structureddata]  Variable for dynamic formatting of floating point values*/
+	optional StringVariable floatingpointformat=15;
+	
+    /* Conditions for StringVariables of type "condition" */
+	enum ConditionOperator{
+		IN=1;
+		NOT_IN=2;
+		BEGINS_WITH=3;
+		ENDS_WITH=4;
+	}
+
+	/** @comment [condition] Operator to use when evaluation condition expressions*/
+	optional ConditionOperator conditionoperator = 16
+		[default=IN];
+
+	/** @comment [condition] -´Array of values to test for <pre>IN</pre>, <pre>BEGINS_WITH</pre> and <pre>ENDS_WITH</pre> operations*/
+	repeated string conditionvalues = 17;
+
+	/** @comment [condition] Value to return for trueness */
+	optional string conditiontruevalue = 27
+		[default = "t"];
+
+	/** @comment [condition] Value to return for falseness*/
+	optional string conditionfalsevalue = 28
+		[default = ""];
+	
+    /* Operations for StringVariables of type "logical" */
+	enum BooleanOperator{
+		AND=1;
+		OR=2;
+		NAND=3;
+		NOR=4;
+		NOT=5;
+	}
+
+	/** @comment [logical] Operator to use when avaluating logical expressions */
+	optional BooleanOperator booleanoperator = 18
+		[default=AND];
+	
+	/** @comment [counter] Start value for counter */
+	optional StringVariable counterstart = 19;
+
+	/** @comment [counter] End value for counter */
+	optional StringVariable counterend = 20;
+
+	enum CounterValueType{
+		CVT_START_END = 1;
+		CVT_OFFSET_TO_START = 2;
+		CVT_OFFSET_TO_END = 3;
+	}
+
+	/** @comment [counter] -*/
+	optional CounterValueType countervaluetype = 26
+		[default = CVT_START_END];
+
+	/** @comment [counter] Animation function to advance the counter with each frame. */
+	optional Function counterfunction = 21;
+
+    /** Counter value interpretation mode */
+	enum CounterFormat{
+		FORMAT_INT = 1;
+		FORMAT_FLOAT = 2;
+		FORMAT_TIME = 3;
+	}
+
+	/** @comment [counter] How to interpret counter value before formatting the output string */
+	optional CounterFormat counterformattype = 22
+		[default = FORMAT_INT];
+
+	/** @comment [counter] A variable to supply the format to <var>formatstring</var>*/
+	optional StringVariable counterformat = 23;
+
+    /** Rounding mode for counter type StringVariables */
+	enum RoundingMode{
+		RND_ROUND = 1;
+		RND_CEIL = 2;
+		RND_FLOOR = 3;
+	}
+
+	/** @comment [counter] Round fractional counter values up or down */
+	optional RoundingMode roundingmode = 24
+		[default = RND_FLOOR];
+
+    /** Time units for Counter type StringVariables */
+	enum TimeUnit{
+		TU_MILLISECOND = 1;
+		TU_SECOND = 2;
+		TU_MINUTE = 3;
+		TU_HOUR = 4;
+		TU_DAY = 5;
+	}
+
+	/** @comment [counter] Counter value is interpreted as this time unit */
+	optional TimeUnit countertimeunit = 25
+		[default = TU_SECOND];
+	
+	/** @comment [counter] C printf like format string or a time format string ( %D for days, %H for hours, %M for minutes, %S for seconds, %L for milliseconds; execept for days, use lower case characters instead to get a value bounded to the next greater unit (e.g "%H:%02m:%02s" for a clock)) 
+		@comment [format] A variable substitution string (e.g. "Hello ${name}, how are you?") */
+	optional string formatstring = 29;
+
+	/** @comment [counter, format] Do not throw errors if value cannot be converted with given format string */
+	optional bool ignoreformaterrors = 30
+		[default = false];
+	
+	/** @comment [format] Urlescape all variable values before substitution*/
+	optional bool urlescapeall = 38
+		[default = false];
+
+	message KVEntry{
+		required string key = 1;
+		optional StringVariable value = 2;
+	}
+	/** @comment [foramt] Addditional variable substitutions, that get added to the substitution context. If there already was an entry with the same key in the substitution context the old value is shadowed by the newly added value*/
+	repeated KVEntry formatadditionalsubstitutions = 39;
+
+    /** String transformations for StringVariable */
+	enum TransformMode{
+		TRANS_LOWER = 1;
+		TRANS_UPPER = 2;
+		TRANS_TITLE = 3;
+		TRANS_ARABIC = 4;
+		TRANS_WORDWRAP = 5;
+		TRANS_SUBSTR = 6;
+	}
+
+	/** @comment [transform] Type of text transform to perform */
+	optional TransformMode transformmode = 31
+		[default=TRANS_UPPER];
+	
+	/** @comment [transform] number of characters per line used as hint for wordwrapping */
+	optional int32 wordwraphint = 32;
+	
+	/** @comment [transform] start index for the substring */
+	optional int32 substringstart = 35;
+	/** @comment [transform] length of the substring, default (-1) means till endof input*/
+	optional int32 substringlength = 36
+		[default=-1];
+	
+	
+	/** @comment [datetime] Unit for the time returned from datetime variable, defaults to second*/
+	optional TimeUnit datetimeunit = 33
+		[default = TU_SECOND];
+	
+	/** @comment [datetime] User provided date/time in ISO 8601 format, leave unset for current date/time*/
+	optional StringVariable datetimestring = 34; 
+	
+	/** @comment [http] Advanced configuration options for making the http requests */
+	optional HTTPDownloadRequestInformation httpconfig = 37;
+
+
+    extensions 1000 to 1999;
+
+}
+
+/**
+* A vector of 2D points
+*/
+message PointsVector{
+	/** Array of Points */
+	repeated Point points=1;
+}
+
+/**
+* A 2D Point
+*/
+message Point{
+	/** x value */
+	optional double x=1;
+
+	/** y value */
+	optional double y=2;
+}
+
+message PointsVariable{
+	enum Type{
+		/** constant variable, use value*/
+		constant=0;
+		/** fetch value from file*/
+		file=1;
+		/** fetch value over http*/
+		http=2;
+		/** fetch value from map of GET-parameters*/
+		map=3;
+		/** randomly select a value from randomvalues*/
+		random=4;
+		/** meta variable, that adds the values of two variables together*/
+		add=5;
+		/** iv tool support for selector/target based filename retrieval*/
+		target = 6;
+		/** variable getting values from an iv tool datasource*/
+		datasource = 7;
+		/** tests if file exists*/
+		fileexists = 8;
+		/** uses path-syntax to retrieve data from structured input (only JSON and JSONPath implemented)*/
+		structureddata = 9;
+		
+		/** unused */
+		condition = 65;
+
+		/** unused */
+		/** boolean = 66;*/
+		logical = 66;
+	}
+	
+	/** Type of this variable */
+	required Type type=1;
+
+	/** Default value */
+	optional PointsVector defaultvalue = 8;  
+
+	/** @comment [file, http, map] Location/key where the value can be retrieved */
+	optional FileLocation source=2;
+
+	/** @comment [map]  (Query-) Parameter name */
+	optional string key=7;
+
+	
+	/** @comment [random]  Array of <var>PointsVector</var> objects. One value is choosen by random. */
+	repeated PointsVector randomvalues=3;
+	optional PointsVector value =4;
+	
+	/** @comment [add]  <var>PointsVector</var> in <var>variable1</var> will be concatinated with values from <var>variable2</var> */
+	optional PointsVariable variable1=5;
+
+	/** @comment [add]  <var>PointsVector</var> in <var>variable1</var> will be concatinated with values from <var>variable2</var> */
+	optional PointsVariable variable2=6;  
+	
+	
+    /** @comment [datasource]  Column name */
+	optional string column =9;
+
+    /** @comment [datasource]  Row to supply data values when no key is provided*/
+	optional string defaultrow =10;
+	
+    /** Type of data for structured data in a PointsVariable */
+	enum StructuredDataType{
+		structured_json = 1;
+	}
+
+	optional StructuredDataType structureddatatype =11
+		[default=structured_json];
+	optional StringVariable structureddatainput=12;
+	optional StringVariable path=13;
+	optional StringVariable integerformat=14;
+	optional StringVariable floatingpointformat=15;
+	
+	enum ConditionOperator{
+		IN=1;
+		NOT_IN=2;
+	}
+	optional ConditionOperator conditionoperator = 16
+		[default=IN];
+	repeated string deprecated_conditionvalues = 17;
+	optional string conditiontruevalue = 27
+		[default = "t"];
+	optional string conditionfalsevalue = 28
+		[default = ""];
+
+	enum BooleanOperator{
+		AND=1;
+		OR=2;
+		NAND=3;
+		NOR=4;
+	}
+	optional BooleanOperator booleanoperator = 18
+		[default=AND];	
+
+	/** @comment [http] Advanced configuration options for making the http requests */
+	optional HTTPDownloadRequestInformation httpconfig = 37;
+
+    extensions 1000 to 1999;
+
+}
+
+/***
+* Container for the information needed for making downloads of resources, that have more requirements than a simple HTTP GET request.
+* i.e.: additional HTTP headers, user authentication, different HTTP methods than GET (POST, PUT), request body etc.
+* all the default values are for making simple unauthenticated HTTP GET
+*/
+message HTTPDownloadRequestInformation{
+
+	enum HttpMethod{
+		HTTP_GET = 1;
+		HTTP_POST = 2;
+		HTTP_PUT = 3;
+	}
+
+	/** HTTP Method to use */
+	optional HttpMethod method = 2
+		[default=HTTP_GET];
+
+
+	/** Content-type of the request body, will get overriden by also setting a "content-type" as part of the <var>headers<var> */
+	optional string contenttype = 3;
+
+
+	message KVEntry{
+		required string key = 1;
+		optional StringVariable value = 2;
+	}
+
+	/** A list of headers added to the request */
+	repeated KVEntry headers = 4;
+
+	enum BodyType{
+		BODYTYPE_NONE = 1;
+		BODYTYPE_FORM = 2;
+		BODYTYPE_RAW = 3;
+	}
+
+	/** If and what kind of body to send */
+	optional BodyType bodytype = 5
+		[default=BODYTYPE_NONE];
+	
+	optional StringVariable rawbody = 6;
+
+	repeated KVEntry formentries = 7;
+
+	optional StringVariable username = 8;
+	optional StringVariable password = 9;
+
+	message ExponentialBackoff{
+		optional int32 retries = 2
+			[default = 5];
+		optional double factor = 3
+			[default = 1.5];
+		optional double waitsec = 4
+			[default = 0.5];
+	}
+	optional ExponentialBackoff exponentialbackoff = 10;
+
+}
+
+
+
+/**
+* @undocumented
+*/
+message Animation{
+	optional Function function = 2;
+	repeated AnimTransformation transformations = 3;
+	optional int32 start = 4;
+	optional int32 end = 5;
+	optional bool invert = 6
+		[default =false];
+		
+	optional Pos3d position = 7;
+}
+
+
+/**
+* @undocumented
+*/
+message AnimTransformation{
+	/**
+	* @undocumented
+	*/
+	enum Type{
+		translate = 1;
+		shear = 2;
+		scale = 3;
+		rotatex = 4;
+		rotatey = 5;
+		rotatez = 6;
+	}
+	
+	required Type type = 1;
+	optional double x = 2;
+	optional double y = 3;
+	optional double z = 4; 
+	optional double angle = 5;
+	
+}
+
+/**
+* @undocumented
+*/
+message AnimationPosition{
+	required Pos3d tl = 1;
+	required Pos3d tr = 2;
+	required Pos3d br = 3;
+	required Pos3d bl = 4;
+}
+
+/**
+* @undocumented
+*/
+message Pos3d{
+	optional double x = 1
+		[default =0.0];
+	optional double y = 2
+		[default =0.0];
+	optional double z = 3
+		[default =0.0];
+}
+
+/**
+    Function are used to animate values over time. The functions use normalized
+    values in the range [0...1] for input (x value). The computed value (y value)
+    is usually, but not necessarily, between [0..1].
+
+    Functions can be composed with other functions via addition or multiplication, or other operators.
+*/
+message Function{
+	enum Type{
+		//all functions use innerfunction for function composition
+		
+		//no parameter		
+        /** f(t)=if(1-t) */
+		inverted = 1;
+
+        /** f(t)=|t| */
+		abs =15; 
+
+        /** f(t)=t */
+		linear = 3;
+
+		//uses param1
+
+        /** f(t)=p1 */
+		constant = 4; 
+
+        /** f(t)=t^p1 */
+		power= 5; 
+
+        /** f(t)=sin(2pi * p1 * t) */
+		sin = 6; 
+
+        /** f(t)=p1*t*if(t) */
+		factor = 7; 
+
+        /** f(t)=1-(p1*(1-t)^2-(1-t))/(p1-1); */
+		overshoot =8; 
+
+        /** f(t)=(p1*t^2-t)/(p1-1);*/
+		undershoot = 9; 
+		
+        /** f(t) = sigmoid(param1, param2) */
+		sigmoid = 10;
+
+        /** f(t)= 1 if p1<=t<=p2, 0 else */
+		switched = 11;
+
+        /** 
+            f(t) = if(0) if t<p1
+		 	       if(1) if t>p1
+		 	       if((t-p1)/(p2 -p1)) else	
+        */
+		timed = 2;
+		
+		//metafunction
+		//higher order function using innerfunction and metafunctionparam
+
+        /** f(t)=mf(t)+if(t) */
+		add = 12; 
+
+        /** f(t)=mf(t)-if(t) */
+		subtract = 13;
+
+        /** f(t)=mf(t)*if(t) */
+		multiply = 14;
+		
+		//keyframe function
+        /** f(t) = lerp(LUT(t)) */
+		keyframe = 16;
+	}
+	
+	
+	/** Type of function, see Function.Type */
+	optional Type type = 1
+		[default=linear];
+
+    /** Parameter 1 for functions (p1) */
+	optional double param1 = 2;
+
+    /** Parameter 2 for functions (p2) */
+	optional double param2 = 3;	
+	
+    /** parameter "if" for for function composition */ 
+	optional Function innerfunction = 4;
+
+    /** parameter "mf" for for function composition */ 
+	optional Function metafunctionparam = 5;
+	
+    /** @comment [keyframe] Array of Points to be used as simple (not Advanced) keyframes. Point.x is interpreted as time , Point.x is interpreted as value */
+	repeated Point keyframes = 6;
+
+    /** @comment [keyframe] Continue to interpolate values outside of ranges given by keyframes. If false last keyframe value will be used */
+	optional bool extrapolate = 7
+		[default=true];
+
+    /** Advanced keyframes can have relative times referencing either the beginning or the end of a container, expressed either as percentage in the range [0..1] or in absolute frame numbers. They also support easing via Bezier interpolation. */
+	message KeyFrame{
+
+        /** Time reference type: var>relative</var> means to interpret the time as a percentage, <var>frame</var> means to take the value absolutely. */
+		enum Type{
+			relative = 1;
+			frame = 2;
+		}
+
+
+        /** Type of time reference for a <var>Keyframe</var> in a <var>Function</var>. */
+		optional Type type = 1
+			[default=relative];
+
+        /** The time for this keyframe */
+		optional double time=2;
+
+        /** The value for this keyframe */
+		optional double value=3;
+
+        /** Constants for the <var>origin</var> parameter of a <var>Keyframe</var> in a <var>Function</var>*/
+		enum OriginType{
+			origin_start=1;
+			origin_end=2;
+		}
+
+        /** Time is relative to start or end of container */
+		optional OriginType origin = 4
+			[default=origin_start];
+
+        /** Y value of the first temporal control point */
+		optional double incoming_velocity = 5
+			[default = 0.0];
+
+        /** X value of the first temporal control point */
+		optional double incoming_influence = 6
+			[default = 0.0];
+
+        /** Y value of the second temporal control point */
+		optional double outgoing_velocity = 7
+			[default = 0.0];
+
+        /** X value of the second temporal control point */
+		optional double outgoing_influence = 8
+			[default = 0.0];
+			
+		/** Incoming control value for spatial bezier interpolation */
+		optional double incomingcontrol = 9;
+		/** Outgoing control value for spatial bezier interpolation */
+		optional double outgoingcontrol = 10;
+	}
+
+    /** @comment [keyframe] Array of advanced <var>Keyframes</var> */
+	repeated KeyFrame advancedkeyframes = 8;
+
+	enum Interpolation{
+		/** Linear interpolation */
+		INTERPOL_LINEAR = 1;
+
+		/** Cubic Bezier interpolation */
+		INTERPOL_BEZIER = 2;
+	}
+
+	optional Interpolation advancedkeyframeinterpolation = 21
+		[default=INTERPOL_LINEAR];
+
+    extensions 1000 to 1999;
+	
+}
+
+///////////////////////
+//Variable Information
+///////////////////////
+
+message VariableInformation{
+	repeated VariableInformationEntry entries = 2;
+	optional int32 maxcombinations = 3
+		[default=1];
+	repeated DataSourceInformation datasources = 4;
+}
+
+message VariableInformationEntry{
+	required string key = 2;
+	repeated string values = 3;
+	optional bool undefinable = 4
+		[default = false];
+}
+
+message DataSourceInformation{
+	enum Type{
+		file=1;
+		string=2;
+		embedded=3;
+	}
+	optional Type type = 1
+		[default=file];
+	required string key = 2;
+	optional FileLocation source = 3;
+	optional string defaultrow = 4;
+	optional StringVariable variable = 5;
+	optional EmbeddedDataSourceInformation embeddeddatasource = 6;
+}
+
+message EmbeddedDataSourceInformation{
+	repeated string columnnames = 2;
+	repeated EmbeddedDataSourceInformationRow rows = 3;
+}
+
+message EmbeddedDataSourceInformationRow{
+	required string rowid = 2;
+	repeated string columns = 3;
+}
+
+
+////////////////////////
+//Metadata
+////////////////////////
+/** A key value pair */
+message Metadata{
+	required string key = 2;
+	optional string value = 3;
+}
+
+/** A key value pair */
+message KeyValuePair{
+	required string key = 2;
+	optional string value = 3;
+}
+
+
+///////////////////////////
+// Pie Chart
+//////////////////////////
+
+message PieChartArcDescription{
+	optional StringVariable percent =2;
+	optional Color color=3;
+}
+
+message PieChartDescription{
+	repeated PieChartArcDescription finished_arcs = 2;
+	optional PieChartArcDescription current_arc = 3;
+	optional double current_arc_completion = 4
+		[default = 1.0];
+	optional Function current_arc_completion_function = 5;
+	enum Direction{
+		clockwise = 0;
+		counterclockwise = 1;
+	}
+	optional Direction direction = 6
+		[default = clockwise];
+	optional double radius = 7
+		[default = 50];
+	optional double offset = 8;
+}
+
+
+///////////////////////////
+// Bar Chart
+//////////////////////////
+
+message BarChartBarDescription{
+	optional StringVariable value =2;
+	optional Color color=3;
+}
+
+message BarChartDescription{
+	repeated BarChartBarDescription finished_bars = 2;
+	optional BarChartBarDescription current_bar = 3;
+	optional double current_bar_completion = 4
+		[default = 1.0];
+	optional Function current_bar_completion_function = 5;
+
+	optional int32 num_bars = 6
+		[default = 3];
+	
+	optional double max_val = 9
+		[default = 100];
+}
+
+
+///////////////////////////
+// Image Bar Chart
+//////////////////////////
+
+message ImageBarChartBarDescription{
+	optional StringVariable value =2;
+	optional ImageProvider image=3;
+	optional double image_equivalent=4
+		[default = 1.0];
+}
+
+message ImageBarChartDescription{
+	repeated ImageBarChartBarDescription finished_bars = 2;
+	optional ImageBarChartBarDescription current_bar = 3;
+	optional double current_bar_completion = 4
+		[default = 1.0];
+	optional Function current_bar_completion_function = 5;
+
+	optional int32 num_bars = 6
+		[default = 3];
+}
+
+
+
+///////////////////////////
+// Line Chart
+//////////////////////////
+
+enum LineCapStyle{
+	cap_square=0; // CAIRO_LINE_CAP_SQUARE - flat endings, thickness also influences length of lines
+	cap_round=1; // CAIRO_LINE_CAP_ROUND - round endings, thickness also influences length of lines
+	cap_butt=2;  // CAIRO_LINE_CAP_BUTT - flat endings, thick lines are exactly as long as thin lines
+}
+
+
+message LineChartDescription{
+	optional TrackData points = 2;
+	
+	optional int32 num_finished_lines = 3
+		[default = 0];
+	optional int32 current_line = 4
+		[default = 0];
+	optional double current_line_completion = 5
+		[default = 1.0];
+	optional Function current_line_completion_function = 6;
+
+	optional Color color = 7;
+	optional double line_width = 8
+		[default = 1.0];
+
+	optional LineCapStyle cap_style = 9
+		[default = cap_round];
+		
+	optional double min_x = 10
+		[default = 0];
+
+	optional double min_y = 11
+		[default = 0];
+
+	optional double max_x = 12
+		[default = 1];
+
+	optional double max_y = 13
+		[default = 1];
+}
+
+
+
+
+///////////////////////////
+// Bezier
+//////////////////////////
+
+	
+message BezierDescription{
+	optional TrackData points = 2;
+	optional Color color = 5;
+	optional double line_width = 6
+		[default = 1.0];
+	optional LineCapStyle cap_style = 7
+		[default = cap_round];
+	optional double completion = 8
+		[default = 1.0];
+	optional Function completion_function = 9;
+}
+
+
+/**
+* Audio and video codecs available
+*/
+enum Codec  { 
+    option allow_alias = true;
+
+	/** No video */
+	VIDEO_NONE = 0;
+
+	/** VP6 Flash video */
+	VIDEO_FLV =1; 
+
+	/** H.263 (Ole Flash Players) */
+	VIDEO_H263 =2;
+
+	/** @internal */
+	VIDEO_E264=3; 
+
+	/** Multi-purpose H.264 (MP4, FLV, HLS, MPEG-DASH) */
+	VIDEO_H264=4;
+
+	/** Low-efficiency (mobile) H.264 (MP4, FLV, HLS, MPEG-DASH) */
+	VIDEO_X264_BASELINE=5; 
+
+	/** Multi-purpose (Main Profile) H.264 (MP4, FLV, HLS, MPEG-DASH) */
+	VIDEO_X264=6;
+
+	/** Multi-purpose (High Profile) H.264 (MP4, FLV, HLS, MPEG-DASH) */
+	VIDEO_X264_HIGH=16;
+
+	/** Multi-purpose VP8 Codec for WebM video */
+	VIDEO_VP8=14;
+
+	/** MPEG2 Codec for MPEG (.mpg) video */
+	VIDEO_MPEG2=17;
+
+	/** Window Media (WMV) */
+	VIDEO_WMV=18;
+
+	/** Animated GIF (small/short videos only) */
+	VIDEO_GIF=19;
+
+	/** Multi-pupose high-quality professional Codec (.mov)*/
+	VIDEO_PRORES=20;
+
+	/** No Audio */
+	AUDIO_NONE = 0;
+
+	/** High quality ACC audio codec */
+	AUDIO_AAC=7;
+
+	/** MPEG-2 (obsolete)*/
+	AUDIO_MP2=8;
+
+	/** MPEG-3 (MP3)*/
+	AUDIO_MP3=9;
+
+	/** @internal */
+	AUDIO_EAAC=11;
+
+	/** Obsolete mobile phone audio codec */
+	AUDIO_AMR_NB=12;
+
+	/** Obsolete mobile phone audio codec */
+	AUDIO_AMR_WB=13;
+
+	/** High quality audio codec for use with VP8 video (WebM)*/
+	AUDIO_VORBIS=15;
+
+	AUDIO_PCM=21;
+}
+