Chapter 6: Command Line Utilities
RealProducer Plus is installed with utilities that allow you to use the command line to create and modify streaming media files (.rm files). You run these utilities through the MS-DOS prompt.
The following programs are available to you:
- RMBatch allows you to create .rm files using all RealProducer Plus features, such as SureStream, live broadcasting, and recording preferences.
- RMEditor allows you to change information about an .rm file, trim the length of the clip, combine multiple .rm files, and create a text file containing the file's information.
- RMEvents allows you to merge image map and event text files into an existing .rm file and extract events and image maps from a .rm file into a text file.
Using RMBatch
RMBatch gives you the conversion and broadcasting capability of the RealProducer Plus main interface, but also allows you to create a batch file and record multiple .rm files with a single command.
To use the command line encoder:
- Open the MS-DOS prompt.
- Change the directory to the main RealProducer Plus directory.
The default main directory is c:\Program Files\Real\Producer.
- Type
rmbatch <switches> where <switches> are the recording switches you specify to record your media. See the tables below for more details on all necessary switches.
 |
Note |
|
You must specify an input by using the /I, /D, or /L
switches.
|
- The command line RealProducer Plus converts the specified input into RealAudio or RealVideo once you press Enter.
Switches
The following tables describe each switch that you can use on the command line. These switches are divided into Input/Output switches, Encoding switches, and Preferences switches.
Input/Output Switches
| Syntax |
Description |
Default Value |
Example |
| /I <input file> |
name and directory of the input file |
no default |
/I c:\Real\foo.avi
|
| /D <input dir> |
directory of the input files; ignores the /I switch |
no default |
/D c:\Real\avifiles\
|
| /L <audio>,<video> |
specifies live audio and video input(s), where <audio> and <video> represent the values assigned to an audio card driver and a video card driver; ignores /I or /D switches |
0,0
0 - primary audio card
0 - primary video card |
/L 3,1
|
| /O <output file> |
name of the output file |
<input file>.rm |
/O c:\Real\foo.rm
|
| /S "<server[:port]>/<file>" |
name of the output server, port, and file |
port defaults to 4040; output file must be specified |
/S "myserver:6060/foo.rm"
|
| /U <user name> |
the user name to log on to the server |
no default |
/U myname
|
| /P <password> |
the password for the user name |
no default |
/P mypassword
|
| /X <hh>:<mm>:<ss> |
maximum amount of time to record |
continuous |
/X 01:20:30
|
Encoding Switches
| Syntax |
Description |
Default Value |
Example |
| /T <target1>,<target2>,... |
target audiences for the recording; use any of the following numbers:
0 - 28 Kbps Modems
1- 56 Kbps Modems
2 - single ISDN
3 - dual ISDN
4 - xDSL/cable modem
5 - corporate LAN |
0 - 28 Kbps modem |
/T 1,2,3
|
| /A 0, 1, 2, or 3 |
audio format; use one of the following numbers:
0 - voice only
1 - voice with background music
2 - music
3 - stereo music |
0 - voice only |
/A 2
|
| /V 0, 1, 2, or 3 |
video quality; use one of the following numbers:
0 - normal motion
1- smoothest motion
2 - sharpest image
3 - slide show |
0 - normal motion |
/V 2
|
| /F 0 or 1 |
file type; use one of the following numbers:
0 - Single Rate
1- SureStream |
1 - SureStream |
/F 0
|
| /M <file> |
use the specified settings configuration file; overrides /T and /A; see below for more information |
none |
/M mysettings.txt
|
| /B <title> |
the title for the recorded clip |
none |
/B The Title
|
| /H <author> |
the author for the recorded clip |
none |
/H Joe Schmoe
|
| /C <date> |
the copyright date for the recorded clip |
none |
/C 1999
|
| /Y 0 or 1 |
enable audio recording;
0 - no
1 - yes |
1- yes |
/Y 0
|
| /Z 0 or 1 |
enable video recording;
0 - no
1 - yes |
1 - yes |
/Z 0
|
Preferences Switches
| Syntax |
Description |
Default Value |
Example |
| /K 0 or 1 |
allow download;
0 - no
1 - yes |
0 - no |
/K 1
|
| /R 0 or 1 |
allow recording for RealPlayer Plus users;
0 - no
1 - yes |
0 - no |
/R 1
|
| /W 0 or 1 |
emphasize audio or video (SureStream recording only);
0 - emphasize audio
1 - emphasize video |
0 - audio |
/W 1
|
| /G 5 or 6 |
the version of RealPlayer the clip is compatible with (SureStream recording only); use one of the following numbers:
5 - RealPlayer 5.0 or later
6 - RealPlayer G2 |
6 - RealPlayer G2 |
/G 5
|
| /J <l>,<t>,<w>,<h> |
set cropping values where l=left, t=top, w=width, and h=height |
0,0,0,0 |
/J 0,0,200,150
|
| /? |
displays help information |
|
|
Examples
The following example records foo.avi into a RealMedia file for 28 and 56 Kbps audiences, audio set to voice only, video set to normal, file type set to SureStream, and "The Title" as the title of the clip. The output file defaults to foo.rm.
rmbatch /I C:\foo.avi /T 0,1 /A 0 /V 0 /F 1 /B The Title
The next example records from a live source to a RealServer with the same settings as above.
rmbatch /L 0,0 /S "myserver:4040/foo.rm" /T 0,1 /A 0 /V 0 /F 1 /B The Title
Settings Configuration File
The Settings Configuration File switch (/M) allows the user to specify a text file that contains the necessary target audience settings for the recording. Using a settings file allows you to save different settings that you use all the time, plus you can specify the exact codec used.
The parameters contained used for each target audience are as follows:
Settings File Parameters
| Parameter |
Description |
| TARGET |
the target audience; see below for a list of values |
| TOTAL_BIT_RATE |
total bit rate for the target audience |
| AUDIO_CODEC |
the audio codec used for the target audience; see below for a list of values |
| MAX_FRAME_RATE |
maximum frame rate, measured in frames per second (default = 15) |
 |
Warning |
|
Parameters must be in upper case.
|
The settings file contains a line for each target audience that the user wishes to record for. A sample configuration settings file for a SureStream recording would be as follows:
TARGET=0,TOTAL_BIT_RATE=20,AUDIO_CODEC=sipr0,MAX_FRAME_RATE=7.5
TARGET=2,TOTAL_BIT_RATE=45,AUDIO_CODEC=sipr1
The RealEncoder then takes these values and creates a RealMedia stream for the target audience specified in each line.
|
|
Warning |
|
Using a settings configuration file will override the
Audio Format switch (/A) and the Target Audience
switch (/T).
|
Target Audience Values
| 0 |
28 Kbps Modems |
| 1 |
56 Kbps Modems |
| 2 |
Single ISDN |
| 3 |
Dual ISDN |
| 4 |
xDSL/Cable Modem |
| 5 |
Corporate LAN |
Audio Codec IDs
| sipr0 |
6.5 Kbps Voice |
| sipr1 |
8.5 Kbps Voice |
| sipr2 |
5 Kbps Voice |
| sipr3 |
16 Kbps Voice |
| cook7 |
32 Kbps Voice |
| cook14 |
64 Kbps Voice |
| cook8 |
6 Kbps Music |
| cook0 |
8 Kbps Music |
| cook1 |
11 Kbps Music |
| cook2 |
16 Kbps Music |
| cook3 |
20 Kbps Music |
| cook4 |
32 Kbps Music |
| cook5 |
44 Kbps Music |
| cook6 |
64 Kbps Music |
| cook9 |
20 Kbps Stereo Music |
| cook10 |
32 Kbps Stereo Music |
| cook11 |
44 Kbps Stereo Music |
| cook12 |
64 Kbps Stereo Music |
| cook13 |
96 Kbps Stereo Music |
Using RMEditor
RMEditor allows you to modify a previously created .rm file by changing clip information, recording and downloading options, and clip length.
To use the command line editor:
- Open the MS-DOS prompt.
- Change the directory to the main RealProducer Plus directory.
The default main directory is c:\Program Files\Real\Producer.
- Type rmeditor -i input.rm -o output.rm <switches> where
input.rm is the name of the input file, output.rm is the name of the output file, and <switches> are the editing switches you specify. See the table below for more details on all necessary switches.
Switches
The following table describes each switch that you can use on the command line.
RMEditor Switches
| Syntax |
Description |
Example |
| -a <author> |
name of the author of the clip |
-a "New Name"
|
| -t <title> |
title of the clip |
-t "New Title"
|
| -c <copyright> |
copyright information |
-c "1999 by My Company"
|
| -C <comments> |
any comments about the clip |
-C "blah blah"
|
| -k 0 or 1 |
allow download |
-k 1
|
| -r 0 or 1 |
allow recording for RealPlayer Plus users |
-r 1
|
| -s <dd:hh:mm:ss> |
start time of the edited clip in days:hours:minutes:seconds |
-s 00:00:30:45.20
|
| -e <dd:hh:mm:ss> |
end time of the edited clip in days:hours:minutes:seconds; use 0 to specify the end of the input file |
-e 00:02:15:00.00
|
| -l <file> |
the path and name of the log file; edit results are written to this file |
-l c:\Real\Producer\logs\logfile.txt
|
| -d <file> |
the path and name of the dump file; the contents of the input file are written to this file |
-l c:\Real\Producer\dumps\dumpfile.txt
|
Examples
The following example allows you to view the current title, author, copyright, comments, mobile playback and selective record settings:
rmeditor -i input.rm
The following example changes the title of input.rm to "New Title" and saves the file as output.rm:
rmeditor -i input.rm -t "New Title" -o output.rm
The following example disables the selective record option and saves the file as output.rm:
rmeditor -i input.rm -r 0 output.rm
The following example trims both the beginning and end of input.rm and saves the result as output.rm:
rmeditor -i input.rm -s 0:0:3:2.20 -e 0:0:4:2.20 -o output.rm
|
|
Note |
|
The start and end times will be adjusted in video clips so
that the clip starts and ends on keyframes.
|
The following example pastes several .rm files together into one output file:
rmeditor -i input1.rm -i input2.rm -i input3.rm -o output.rm
|
|
Note |
|
If more than one input file is specified, any start and
end time arguments will be ignored.
|
Using RMEvents
RMEvents allows you to merge events and image map text files to an .rm file. Events and image map text files are created using a text editor. Refer to the RealSystem G2 Production Guide for more information. RMEvents also allows the user to extract events and image maps from a .rm file into a text file, so they may be edited using any text editor.
To use the command line events utility:
- Open the MS-DOS prompt.
- Change the directory to the main RealProducer Plus directory.
The default main directory is c:\Program Files\Real\Producer.
- Type rmevents -i input.rm -o output.rm <switches> where
input.rm is the name of the input file, output.rm is the name of the output file, and <switches> are the events switches you specify. See the table below for more details on all necessary switches.
Switches
The following table describes each switch that you can use on the command line.
RMEvents Switches
| Syntax |
Description |
Example |
| -e <file> |
path and name of the event text file |
-e c:\Real\event.txt
|
| -m <file> |
path and name of the image map text file |
-m c:\Real\image.txt
|
| -d <dump> |
the path and name of the dump files that hold the image maps and events dumped from the input file; events will be dumped into <dump>_evt.txt and image maps to <dump>_imap.txt |
-d c:\Real\events\input
|
Examples
The following example merges an event text file with a .rm file:
rmevents -i input.rm -e events.txt -o output.rm
The following example merges an image map text file with a .rm file:
rmevents -i input.rm -m image.txt -o output.rm
The following example dumps image maps and events from the input file into files named input_imap.txt and input_evt.txt, respectively:
rmevents -i input.rm -d input
Copyright © 1998
RealNetworks
For information on RealNetworks' technical support, click here.
This file last updated on 11/20/98 at 14:44:43.