previous

Chapter 6: Command Line Utilities

RealProducer is installed with utilities that allow you to use the command line to modify streaming media files (.rm files). You run these utilities through the MS-DOS prompt.

The following programs are available to you:

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:

  1. Open the MS-DOS prompt.

  2. Change the directory to the main RealProducer directory.

    The default main directory is c:\Program Files\Real\Producer.

  3. 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:

  1. Open the MS-DOS prompt.

  2. Change the directory to the main RealProducer directory.

    The default main directory is c:\Program Files\Real\Producer.

  3. 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 © 1999 RealNetworks
For information on RealNetworks' technical support, click here.
This file last updated on 02/05/99 at 16:28:59.
previous