From 755413853394e43d809fc42672ade34f06f3e32b Mon Sep 17 00:00:00 2001 From: "Jerome Blanchi aka d.j.a.y" Date: Fri, 8 Feb 2019 22:10:20 +0100 Subject: [PATCH] Improve help (#76) : veejay-howto.html --> veejay-howto.md todo 4.5.3 network --> end --- .../veejay-server/doc/veejay-HOWTO.md | 216 ++++++++---------- 1 file changed, 101 insertions(+), 115 deletions(-) diff --git a/veejay-current/veejay-server/doc/veejay-HOWTO.md b/veejay-current/veejay-server/doc/veejay-HOWTO.md index b58a43394..09199bc04 100644 --- a/veejay-current/veejay-server/doc/veejay-HOWTO.md +++ b/veejay-current/veejay-server/doc/veejay-HOWTO.md @@ -160,15 +160,15 @@ Veejay consists out of several packages: veejay-server -This is veejay +This is veejay ! veejay-client -This is reloaded, the graphical user interface to veejay +reloaded, the graphical user interface to veejay veejay-utils -Commandline utilities to interface with veejay +Command-line interface with veejay, sayVIMS sendVIMS @@ -176,7 +176,7 @@ Veejay consists out of several packages: veejay-themes -Themepack for reloaded +Theme-pack for reloaded @@ -691,7 +691,7 @@ Also, you can send single VIMS format message. 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 -m "361:0 0 100 3;" ``` **Using files** @@ -701,7 +701,7 @@ Last but not least, sayVIMS can parse files containing VIMS messages. 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 +$ sayVIMS -f advocate.vims -h localhost -p 3490 ``` **Others examples** @@ -728,137 +728,122 @@ $ sayVIMS -h localhost -p 4000 -m "246:224.0.0.50 5000;" Here is a quick overview for the most used default keys, if applied in order you will end up with a newly created video sample looping in some way (depending on how many times you press the asterix key) - - - -#### Some keyboard bindings - -*Description* - -*SDL key* - -*In plain english* - -Set the starting position of a new sample - -SDLK\_LEFTBRACKET - -Left bracket - -Set ending position and create a new sample - -SDLK\_RIGHTBRACKET - -Right bracket - -Select and play sample **1** - -SDLK\_F1 - -F1 - -Set playback speed to 3 - -SDLK\_d - -d - -Change looptype - -SDLK\_KP\_MULTIPLY - -asterix on numeric keypad - -Play backward -SDLK\_KP\_4 -Cursor left on numeric keypad - -Play forward - -SDLK\_KP\_6 - -Cursor right on numeric keypad - -Skip 1 second - -SDLK\_KP\_8 - -Cursor up on numeric keypad - -Switch playmode to Plain - -SDLK\_KP\_DIVIDE - -Divide on numeric keypad - -Print information about sample - -SDLK\_HOME - -Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Some keyboard bindings
DescriptionSDL keyIn plain english
Set the starting position of a new sampleSDLK_LEFTBRACKETLeft bracket
Set ending position and create a new sampleSDLK_RIGHTBRACKETRight bracket
Select and play sample 1SDLK_F1F1
Set playback speed to 3SDLK_dd
Change looptypeSDLK_KP_MULTIPLYasterix on numeric keypad
Play backwardSDLK_KP_4Cursor left on numeric keypad
Play forwardSDLK_KP_6Cursor right on numeric keypad
Skip 1 secondSDLK_KP_8Cursor up on numeric keypad
Switch playmode to PlainSDLK_KP_DIVIDEDivide on numeric keypad
Print information about sampleSDLK_HOMEHome
- - The function keys **F1**...**F12** can be used to select sample **1** ... **12**, use the keys **1**...**9** to select a sample range **1-12** ... **108-120** and press one of the **F**-keys to play that sample. Use **ESC** to switch between samples and streams. Press **ESC** again -to switch back to the sample playmode -You can create new input streams by using the console interface or by -using GVeejay. -All new input streams (and samples) are auto numbered. - - +to switch back to the sample playmode. + +You can create new input streams by using the console interface **sayVIMS** or by +using the graphical user interface **reloaded**. All new input streams (and samples) are auto numbered. 4.4 Recording video ----------------------------------------- -You can record video to a new clip , by using the stream- or clip -recorder functions. -For example, to record a new clip from a playing clip in MJPG format: - - 302:mjpg; +You can record video to a new clip, in a specified codec format, by using the stream or clip recorder functions. -Record 100 frames and start playing new clip when ready: +For example, to select a MJPG codec to record a new clip from a playing clip: +``` +$ sayVIMS -m "302:mjpg;" +``` - 130:100 1; +Record 100 frames and start playing (1 = auto-play) new clip when ready: +``` +$ sayVIMS -m "130:100 1;" +``` -Record the whole clip and dont start playing new clip when ready: +Record the whole clip and don't start playing new clip when ready: +``` +$ sayVIMS -m "130:0 0;" +``` - 130:0 0; +If your Effect Chain is very CPU demanding, consider disabling audio and using the command-line parameter `-c 0` to disable synchronization correction. -If your Effect Chain is very CPU demanding , consider disabling audio -and using the commandline parameter -c 0 to disable sync correction. - It is possible to start veejay headless and have it write all video data -to a (special) file for further processing. - -Refer to chapter [5.3](veejay-HOWTO.md#5.3) for some examples. - +to a (special) file for further processing. Refer to chapter [5.1](veejay-HOWTO.md#5.1) for some examples. 4.5 Streaming video ----------------------------------------- You can create an input stream to read video coming from a video4linux -device, from a pipe or from a network socket (both unicast and -multicast). +device (USB webcam, TV tuner...), from a pipe or from a network socket (both unicast and multicast). ### 4.5.1 video4linux -To open a video4linux device use gveejay or type the command: - - - $ sayVIMS 240:0 1; +To open a video4linux device use reloaded or type the command: +``` +$ sayVIMS -m "240:0 1;" +``` -The selector '240' tells veejay to open a video4linux device, the first +The VIMS selector `240` tells veejay to open a video4linux device, the first argument '0' indicates the device number (i.e. /dev/video0) and the last argument '1' indicates the video in port of your capture card (in this case composite). -Veejay will create a new stream see [chapter 4.4](#4.4) for activating -the stream. +Veejay will create a new stream see [chapter 4.3](#4.3) for activating +the stream. ### 4.5.2 pipe @@ -866,19 +851,20 @@ Veejay supports reading video data from a pipe (FIFO) by means of an input stream. The only supported transport format is yuv4mpeg (yuv 4:2:0). When playing YUV 4:2:2 the video stream will be sampled to YUV 4:2:0 and vice -versa -You can create the input stream by typing the command +versa. - $ sayVIMS 243:/tmp/stream.yuv; +You can create the input stream by typing the command +``` +$ sayVIMS -m "243:/tmp/stream.yuv;" +``` ### 4.5.3 network -To get frames from another running veejay, use the command: - - $ sayVIMS 245: ; +To get frames from another running veejay, use the VIMS selector `245` with hostname (or IP number) and port: +``` +$ sayVIMS 245:localhost 5000; +``` -For example, sayVIMS 245:localhost 5000; - If you want to send the same video to multiple running veejays accross the network, you can save bandwith by starting the veejay you wish to use as server with the -V option.