Improve Help ( game-stop#76 wip) : review veejay-HOWTO.md - progress

* todo from 4.3 to end
d-j-a-y · Feb 10, 2019 · 40b1d53 · 40b1d53
1 parent 2f46604
commit 40b1d53
Showing 1 changed file with 65 additions and 58 deletions.
diff --git a/veejay-current/veejay-server/doc/veejay-HOWTO.md b/veejay-current/veejay-server/doc/veejay-HOWTO.md
@@ -645,76 +645,83 @@ Some reserved numbers:
 ------------------------------
 
 sayVIMS is a commandline utility distributed with the veejay package, it
-allows you to give short commands in interactive mode  
-
-*$ sayVIMS -i -h localhost -p 3490*  
-
-Typing '?' followed by pressing ENTER gives the list of command below:
-
-      vi [file]           Open video4linux device 
-      fi [file]           Open Y4M stream for input 
-      fo [file]           Open Y4M stream for output 
-      av [file]           Open (almost any) video file using FFmpeg 
-      mc [address] [port] Open a multicast UDP video stream 
-      pr [hostname][port] Open a unicast TCP video stream
-      cl [file]           Load cliplist from file 
-      cn [n1] [n2]        New clip from frames n1 to n2 
-      cd [n]              Delete clip n1 
-      sd [n]              Delete Stream n1 
-      cs [file]           Save cliplist to file 
-      es [file]           Save editlist to file 
-      ec [n1] [n2]        Cut frames n1 - n2 to buffer 
-      ed [n1] [n2]        Del franes n1 - n2  
-      ep [n]              Paste from buffer at frame n1 
-      ex [n1] [n2]        Copy frames n1 - n2 to buffer 
-      er [n1] [n2]        Crop frames n1 - n2 
-      al [file]           Action file Load 
-      as [file]           Action file save 
-      de                  Toggle debug level (default off) 
-      be                  Toggle bezerk mode (default on) 
-
-Also, you can send messages in VIMS format (or files, containing VIMS
-messages )  
-
-For example, add the Pixelate effect on the Effect Chain of the current
-playing stream or clip:
-
-    sayVIMS -h localhost -p 3490 "361:0 0 150 3;"
-
-
-Last but not least, sayVIMS can parse files containing VIMS messages.  
-See the test/examples directory of the package for a list of perl
-scripts that output a VIMS script.  
+allows you to send to a veejay server short commands in interactive mode,
+single VIMS message or files containing VIMS messages.
 
-    sayVIMS -f advocate.vims -h localhost -p 3490
+In the following examples, lets say a veejay instance is running on host
+`localhost` using port `3490` (its default values).
 
-  
-Alternativly, you can start a secundary veejay and stream from peer to
-peer in uncompressed video:  
-
-    $ veejay -d -p 5000
-
-    $ sayVIMS -h localhost -p 5000 "245:localhost 3490;"
+**Interactive Mode**
+```
+$ sayVIMS -i -h localhost -p 3490
+```
+In interactive mode, after a connection is establish with a veejay server,
+a prompt wait you to enter VIMS commands. Press `ENTER` to send it.  
+The connection remain open until you exit by typing `quit`.
 
-    (press 'F7' in veejay to display the stream, prob. stream 7)
+Typing '?' followed by pressing `ENTER` gives the list of command below:
+```
+vi [file]           Open video4linux device
+fi [file]           Open Y4M stream for input
+fo [file]           Open Y4M stream for output
+av [file]           Open (almost any) video file using FFmpeg
+mc [address] [port] Open a multicast UDP video stream
+pr [hostname][port] Open a unicast TCP video stream
+cl [file]           Load cliplist from file
+cn [n1] [n2]        New clip from frames n1 to n2
+cd [n]              Delete clip n1
+sd [n]              Delete Stream n1
+cs [file]           Save cliplist to file
+es [file]           Save editlist to file
+ec [n1] [n2]        Cut frames n1 - n2 to buffer
+ed [n1] [n2]        Del franes n1 - n2
+ep [n]              Paste from buffer at frame n1
+ex [n1] [n2]        Copy frames n1 - n2 to buffer
+er [n1] [n2]        Crop frames n1 - n2
+al [file]           Action file Load
+as [file]           Action file save
+de                  Toggle debug level (default off)
+be                  Toggle bezerk mode (default on)
+```
 
-Or for multicast:
+**Single VIMS message**
 
-    $ veejay -V 224.0.0.50 -p 5000 -n -L movie1.avi
+Also, you can send single VIMS format message.
 
-    $ veejay -d 
+For example, add the Pixelate effect on the Effect Chain of the current
+playing stream or clip :
+```
+sayVIMS -h localhost -p 3490 -m "361:0 0 100 3;"
+```
 
-    $ sayVIMS -h localhost -p 3490 "246:224.0.0.50 5000;"
+**Using files**
 
-    $ veejay -d -p 4000
+Last but not least, sayVIMS can parse files containing VIMS messages.
 
-    $ sayVIMS -h localhost -p 4000 "246:224.0.0.50 5000;"
+See the `veejay-server/test/examples` directory of the package for a list of perl
+scripts that output a VIMS script.
+```
+sayVIMS -f advocate.vims -h localhost -p 3490
+```
 
-Or, if you want to play a XVID movie (or any other compressed format
-that is not I frame only):
+**Others examples**
 
-    $ sayVIMS -h localhost -p 3490 "244:/tmp/my-XVID-movie.avi;"
+Alternativly, you can start a secundary veejay and stream from peer to
+peer in uncompressed video :
+```
+$ veejay -d -p 5000
+$ sayVIMS -h localhost -p 5000 -m "245:localhost 3490;"
 
+(press 'F7' in veejay to display the stream, prob. stream 7)
+```
+Or for multicast:
+```
+$ veejay -V 224.0.0.50 -p 5000 -n -L movie1.avi
+$ veejay -d
+$ sayVIMS -h localhost -p 3490 -m "246:224.0.0.50 5000;"
+$ veejay -d -p 4000
+$ sayVIMS -h localhost -p 4000 -m "246:224.0.0.50 5000;"
+```
 <span id="4.3">4.3 The keyboard interface</span>
 ------------------------------------------------