X-Git-Url: http://research.m1stereo.tv/gitweb?a=blobdiff_plain;f=docs%2Fmvcp.txt;h=f8285cf6edc91ee1a3e0efb52f45df3266eb5486;hb=ddd309cedb17a260c4723f4f2378fc7ea5db47d0;hp=2fe0e1726d62944451848bc5e311cb5f4152d21c;hpb=093f38066a0b1b2df494492ddb2de20cac2de689;p=melted

diff --git a/docs/mvcp.txt b/docs/mvcp.txt
index 2fe0e17..f8285cf 100644
--- a/docs/mvcp.txt
+++ b/docs/mvcp.txt
@@ -1,8 +1,9 @@
 MLT Video Control Protocol (MVCP) Reference Documentation
 
 Copyright (C) 2004-2009 Ushodaya Enterprised Limited
+Copyright (C) 2010-2011 Dan R. Dennedy
 Author: Dan Dennedy <dan@dennedy.org>
-Last Revision: 2009-05-15
+Last Revision: 2011-04-17
 
 
 General Format
@@ -125,12 +126,12 @@ RUN {file}
 	The response body contains each command sent along with its arguments,
 	followed by each command's response status code and response body.
 
-
 STATUS
 	Responds with the output of USTA for each unit and accepts no further
 	input. Each time the state of the unit changes, a new row is returned by
 	the server containing the state of the unit. 
 
+
 Unit Management
 
 	The following global commands manage the playout units within the server.
@@ -142,7 +143,6 @@ Unit Management
 NLS
 	* NOT IMPLEMENTED IN MELTED YET *
 
-
 UADD mlt-consumer[:argument]
 	Add a unit based upon the mlt-consumer id and optional constructor
 	argument.
@@ -185,7 +185,7 @@ USET {unit} {key=value}
 	
 	Property "points" determines whether the playback engine restricts the
 	playback region to the in and out points. It takes one of the following
-	values: use, ignore.
+	values: use, ignore. (not currently implemented)
 	
 UGET {unit} {key}
 	Get a unit's configuration property.
@@ -233,7 +233,7 @@ REMOVE {unit} [ [+|-]clip ]
 	currently playing clip index.
 	
 CLEAN {unit}
-	Removes all by the playing clip.
+	Removes all but the playing clip.
 	
 WIPE {unit}
 	Removes all clips before the playing clip.
@@ -262,12 +262,8 @@ REW {unit}
 	(200%).
 	If the unit is stopped, then the frame position is reset to the first
 	frame. First frame depends upon the "points" unit configuration property
-	and whether an in point has been established for the clip using the SIN
-	command.
-	Set the currently loaded clip's in point.
-	Frame is zero-based and absolute. It is not dependent upon the clip's
-	current in point.
-	A frame-number of -1, resets the in point to 0.
+	(not currently implemented)	and whether an in point has been established
+	for the clip using the SIN command.
 
 FF {unit}
 	Fast forward the unit.
@@ -275,8 +271,8 @@ FF {unit}
 	in reverse).
 	If the unit is stopped, then the frame position is reset to the first
 	frame. First frame depends upon the "points" unit configuration property
-	and whether an in point has been established for the clip using the SIN
-	command.
+	(not currently implemented) and whether an in point has been established
+	for the clip using the SIN command.
 
 STEP {unit} {number-of-frames}
 	Adjust the current frame position by the number of frames specified.
@@ -335,3 +331,11 @@ XFER {unit} {target-unit}
 	Transfer the unit's clip to the target unit.
 	The clip inherently includes the in- and out-point information.
 	The target unit's "points" configuration property is set to "use."
+
+PUSH {unit}
+{size}
+{XML}
+	Append an in-band MLT XML document to the unit.
+	Do note that the size and XML arguments are on new lines.
+	Size is the size of the XML payload in bytes.
+	Returns 404 if the XML is malformed or if the XML producer fails parsing.