[Kdenlive-devel] edit file format draft1

[Christian Berger]

Servus

Well this is the first draft for the editing file:

Syntax:


real:
  normal real number with "." as a decimal point and no points or commas
at the 1000 position

param:
  -<paramname> <param>  
  example: -startvalue 5

params:
   <param> <param...>
  example: -startvalue 1 -stopvalue 4 -wrtlpfmpf "HAllo"

commands: (can only appear outside of scenes)
  <commandname> <params  >
  example: open_input -name somefile -filename "file.avi" -speed 1.42

connection:
  <connectionname> <effect> <params>
  examples: 3 mosaik -input 2
	    2 read somefile

scene_start <params>
  <connections>
scene_stop


Commands:
 open_input			: Opens a file for input
   Params:
    	-file			: Internal name (no string)
    	-filename 		: Filename of file on disk
	-speed			: factor of speed 1=normal >1 faster <1 slower
	-start			: start of file in milliseconds

 open_output			: sets the file for output
   Params:
	-filename		: filename
	-sizex			: width of image in pixels
	-sizey			: height of image in pixels
	-nativesize		: yes=keep frames in size of possible 
				  no=scale all frames
	-type			: type of file (avi, mov, mpg, etc)
	-fps			: framerate
	-nativefps		: yes=keep original framerate
				  no=don't keep framerate
	-videocodec		: type of codec
	-nativevideocodec	: yes=keep native codec
				  no=recompress all contents
	-soundrate		: samplerate of sound
	-nativesoundrate	: yes/no	
	-soundformat		: format of sound (8bit, 16bit, uLaw, etc)
	-nativesoundformat	: yes/no

 seek				: seek to a certain position
	-file			: identifier of file opened
	-absolute		: seek to absolute position in ms
	-relative		: seek to relative position in ms


Scene definition:
 scene_start			: command to start a scene
  Params:
	-duration		: duration of sceene
	-name			: name of scene
	-based_on		: name of scenes which this scene
				  is based on (usefull for clusters)
				  may apear multible times
 
 Several lines with connections. The output reads from connection 0. All
connections (which may contain effects) are only called once per frame
in an order which makes sense. Scenes also are usually executed in
order, but might be executed in parallel.
 
 scene_stop  (no params) 

Colors:
  #rrggbb (like in HTML) or
  #aarrggbb (like in HTML, but with added transparency)

Connections:
 in 				: simply pipes the input
  Params:
	-file			: identifier of file
 
 mosaik				: simple mosaic effect
  Params:
	-input			: number of connection to read from

 fade				: simple crossfade
  Params:
	-input1			: connection from which to fade
	-input2			: connection to which to fade
	-start			: start value of fading (0-1)
	-stop 			: stop value of fading (0-1)
 
 flatcolour			: simple colour
  Params:
	-colour			: colour value

 overlay			: overlays 2 signals
  Params:
	-background		: background connection
	-foreground		: foreground connection

 title				: generates title
  Params:
	-text			: text to display
	-x			: position x
	-y 			: position y
	-colour			: colour
	-font			: font
	-height			: height


Well that's it for a start