RealSystem Producer 9 Preview Command Line Reference

For product documentation see RealSystem Producer Preview Guide.

USAGE

USAGE: (For detailed help and full list of options type 'producer -m')
   producer INPUT [OUTPUT(s)] [OPTIONS]

INPUT is one of the following:
  File: -i <filename|directory|filename w/wildcard>
  Live: -ac <audioDev> -ap <audioPort> -vc <videoDev> -vp <videoPort>
        -mc <mixerDev> -mp <mixerPort>

OUTPUT is one or more of:
  Output File:   -o  <filename>
  Output Server: -sg [user:password@]server:port/streamname

OPTIONS are any of:
  --- ENCODING SETTINGS -----    --- PREFILTERS ------------------
  -ad Audience(s) <file|name>    -nf Video Noise Filter <low|high>
  -vm Video Mode <see below>     -ag Audio Gain <-12 to 12>
  -am Audio Mode <voice|music>   -cr Cropping <left,top,width,hght>
  -cs Capture Size <WxH>         -di Deinterlace <auto|d|i|di>
  -d  Duration <dd:hh:mm:ss>     -rq Resize Quality <fast|high>
  -dt Disable 2-pass Encoding    -rs Resize [width]x[height]
  -da Disable Audio              -bl Enable Black Level Filter
  -dv Disable Video              -arq Audio Resampling Qual <fast|high>
                                 -daw Disable Audio Watchdog
  --- CLIPINFO ----------------- --- LOGGING SETTINGS ---------
  -t Title     -k Keywords       -lc Logging Category <e,w,i,d>
  -a Author    -de Description   -pid Process ID File<filename>
  -c Copyright
  --- INFO OPTIONS -------------------------------------------------
  -pd Print Devices           -pa Print Audiences         -v Version

OPTIONS

The options for the command line are described in the sections below. 

INPUTS 
OUTPUTS 
ENCODING SETTINGS
PREFILTER
CLIP INFORMATION
SCREEN OUTPUT
INFORMATION

INPUTS

Options in this section define audio/video inputs.

-i    Input File
-ac   Audio Capture Device
-ap   Audio Capture Port
-mc   Audio Mixer Device
-mp   Audio Mixer Port
-vc   Video Capture Device
-vp   Video Capture Port
-d    Capture Duration
-cs   Capture Size

Each of these options are described in detail below.

Input File or Directory    -i


A filename pointing to a file to be encoded.  Filename can be a relative or absolute path on a network or local drive.  If relative paths provided, the location is relative to the current working directory.  See CROSS-PLATFORM FILE PATHS section below for valid cross platform file paths.  Input file may be one of the following:

If a directory or a filename with wildcard is specified, a batch each input file is encoded sequentially one after. All files matching the wildcard are used as input and output to the directory as defined in the Output File option (-o).  If output directory is not specified, output files are placed in the same directory as the input file.  Wildcards are supported in filename only (not in directory name). For instance, c:\movies\*.avi will read all AVI files from the directory 'movies'.  If the input is a directory or wildcard output name are automatically generated from input filenames.  See EXAMPLES section below for examples for different combinations of inputs and output. Ignored if Audio Capture Device (-ac) or Audio Capture Device (-vc) options specified.

Default:

No default

Values:

Any valid filename with path or directory.

Wildcards allowed in filename only (e.g. c:\dir1\*.avi)

Example:

-i myfile.avi
-i c:\media\movie1.mpg
-i c:\media\*.mpg

 

Audio Capture Device ID    -ac


Specifies the audio device ID for the input audio devices. The audio device ID is obtained from the command line option -pd.  Overrides the -i option.

Default:

No default

Values:

Allowable values can be any of:

See -pd for system specific values

Example:

-ac 0
-ac "VIA Audio (WAVE)"
-ac "Sound Blaster*"

 

Audio Capture Device Port    -ap


Specifies the audio port for the input audio devices. The port is obtained from the command line option -pd.  Audio port may be omitted in which case the current mixer settings are used.  Not available on Linux using the free OSS audio drivers (audio capture port is set via the mixer device instead).  Not available on Windows (set audio capture port using Recording Control Panel instead).

Default:

No default

Values:

Allowable values can be any of:

See -pd for system specific values

Example:

-ap 0
-ap "mic"

 

Audio Mixer Device ID    -mc


Specifies the device ID for the input audio mixer.  The device ID is obtained from the command line option -pd.  Not required with Windows or Linux commercial OSS drivers.  On Linux with free OSS drivers, this option allows the audio mixer device to be set.  May be omitted in which case the current mixer settings are used. Overrides the -i option.

Default:

No default

Values:

Allowable values can be any of:

See -pd for system specific values

Example:

-mc "Sound Blaster*"
-mc "
-mc "/dev/mixer2"

 

Audio Mixer Device Port    -mp


Specifies the port for the input audio mixer.  The port is obtained from the command line option -pd.  Not required with Windows or Linux commercial OSS drivers.  On Linux with free OSS drivers, this option allows the audio mixer device port to be set.  May be omitted in which case the current mixer settings are used. Overrides the -i option.

Default:

No default

Values:

Allowable values can be any of:

See -pd for system specific values

Example:

-mp 1
-mp "Line*"

 

Video Capture Device ID    -vc


Specifies the device ID for the input video device. The video device ID is obtained from the command line option -pd. Overrides the -i opti.

Default:

No default

Values:

Allowable values can be any of:

See -pd for system specific values

Example:

-vc 0
-vc "Osprey Capture Card 1"
-vc "Osprey*"
-vc /dev/video3

 

Video Capture Device Port    -vp


Specifies the device port for the input video device. The port is obtained from the command line option -pd.  Not available for Video for Windows (VFW) devices (video capture port is set via the device driver dialog instead).  May be omitted in which case the current device settings are used. Overrides the -i option.

Default:

No default

Values:

Allowable values can be any of:

See -pd for system specific values

Example:

-vp 0
-vp "Composite 1"

 

Input audio/video device duration    -d


Specifies the amount of elapsed time before which encoding will stop when encoding from an input audio or video device.  The duration is specified in d:h:m:s.ms format described in the TIME FORMAT section below. If duration is not provided then it is assumed infinite.  Ignored if input is file (-i).

Default:

infinite

Values:

[d:][h:][m:][s[.ms]]

Example:

-d 90 (90 seconds)
-d 1:00:00 (1 hour)

 

Input video capture frame size    -cs


Sets the input video capture size in pixels. Ignored for audio only inputs. Default is to use the device default video frame size which occurs if this option is not present. This filter is applied to all device inputs. If the width or height are not divisible by 4, they are rounded down to the nearest integer divisible by 4.

Default:

No default

Values:

WxH

Where:

Example:

-cs 320x240

  

OUTPUTS

Options in this section define file and server outputs and other outputs generated by the command line.

-o    Output File
-sg   Output Server
-pid  Process ID File

Each of these options are described in detail below.

Output Filename or directory    -o


The output filename or directory name if multiple input (batch encoding).  Required when input is device but optional for file inputs (-i).  For batch (more than one input) each input filename is used to generate the respective output filename. If a directory name and a single input file the output file name is auto-generated from the input filename and file is written to the directory specified. If directory and multiple input files specified, then all files are written to the output directory. If output directory does not exist, it is created.  If a file exists with the requested output filename, the existing file is backed up immediately following the merge process to a filename based on the input filename with "_archNNN" inserted before the file extension where NNN is the next available integer (e.g. movie_arch001.rm).  If the output file size reaches 4 GB (limit of RealMedia file format) the output file is automatically rolled and a new file is started.  The new file is appended with a number (e.g. movie1.rm).  On Linux 2.0.x kernels the output file is rolled at 2 GB to respect default kernel limitations.  This option may be called multiple times. Each time this option is used on the command line a new active destination is added to the job. If relative paths provided, the location is relative to the current working directory. See CROSS-PLATFORM FILE PATHS section below for valid cross platform file paths.

Default:

No default for device input. Auto-generated for file input.

Values:

Any valid filename with path or directory.

Example:

-o C:\Windows\Desktop\movie.rm
-o /home/johndoe/commercialbreak.rm
-o C:\Movies

  

Output Server   -sg


Settings required for encoding to RealServer G2 through 8.01. The special delimiters (@ : /) are not allowed except as noted. May be called multiple times - each time a new active destination is added to the Job.

Default:

No default

Values:

[username:password@]address[:port]/streamname

Where:

Example:

-sg janedoe:letmein@realserver.yourcompany.com/live.rm
-sg johndoe:letmein@172.16.0.34:4040/quarterlymeeting.rm

  

Process ID File    -pid


A file where the process ID of the encoding session is written.  Filename can be a relative or absolute path. If relative paths provided, the location is relative to the working directory.  File is created at startup and deleted upon normal shutdown.  If file exists and is and is writeable, the file is overwritten.  See CROSS-PLATFORM FILE PATH section below for valid cross platform file paths.

Default:

No default

Values:

Any valid filename.

Example:

-pid "/usr/log/myfile.pid" 
-pid "C:\jobs\job34.pid"

 

ENCODING SETTINGS

Options in this section define encoding settings for compressing audio and video into RealVideo and RealAudio format.

-ad   Audience Definition
-am   Audio Mode
-vm   Video Mode
-dt   Disable 2-Pass
-da   Disable Audio
-dv   Disable Video
-rs   Resize
-rq   Resize Quality
-arq  Audio Resampling Quality

Each of these options are described in detail below.

Audience Definition or Audience File    -ad


This is a comma separated list of Audience Files or Audience Definitions defined within the RealSystem Producer. The name of the audience may be abbreviated with the first few letters if referencing Audience Definitions in which case the closest matching audience definition is used where exact matches are preferred over partial matches.  For example, "28k Dial-up" may be abbreviated with "28k" or just "28".  If a Audience File is referenced, the full filename must be included, including file extension. If more than one audience with the same name matches, then an error is logged and encoding stops.  This option may be called multiple times - each time it is called, the audiences are added to the Job.

Default:

16k,28k,56k,256k

Values:

A comma separated list of strings that matches the names of an Audience File or Audience Definitions defined within the RealSystem Producer.

Example:

-ad "28k,56k"
-ad 150k
-ad "28k Dial-up,56k Dial-up,256k DSL/Cable Modem"
-ad "C:\settings\My 28k Modem.rpad"
-ad "/files/28k.rpad,/files/56k.rpad"
-ad "28k.rpad,56k.rpad" (searches local working directory).

 

Audio Mode    -am


Describes the type of audio content. Certain codecs are tuned to encode voice frequency responses and others are turned to encode music. Audiences are defined with different choices of audio codec based on the type of input. This setting determines which audio codec to be assigned from an audience.

Default:

music

Values:

voice or music

Example:

-am voice
-am music

 

Video Mode    -vm


Setting to control the picture quality of the encoded video. sharp=Sharpest Image, normal=Normal Motion, smooth=Smoothest Motion, slideshow=Slide Show.

Default:

normal

Values:

sharp, normal, smooth, slideshow

Example:

-vm sharp
-vm slideshow

 

Disable 2-Pass Encoding    -dt


If option is present, the input file is read in single pass only.   2-pass is an encoding technique where the file is read in two passes.  The first pass analyzes the file to determine where the most bits are required in the file. The second pass encodes the file using hints provided by the first pass. By disabling this option, the resulting file will be of lower quality but the encoding time is reduced by about one half.  This option is applied to all outputs. 2-pass encoding only applies for encoding file to file so this option is ignored if input is a device (-ac, -vc) or output is a server (-sg).

Default:

This option takes no arguments.  By default, 2-pass encoding is enabled in the command line unless this option is present.

Values:

No value required for this option.

Example:

-tp

 

Disable Audio    -da


Option to disable audio streams from the output RealMedia file. Affects all output files.

Default:

NA

Values:

No value required for this option.

Example:

-da

 

Disable Video    -dv


Option to disable video streams from the output RealMedia file. Affects all output files.

Default:

NA

Values:

No value required for this option.

Example:

-dv

 

Resize Video (output size)    -rs


Sets the output video size in pixels. Ignored for audio only inputs. Default is not to resize which occurs if this option is not present. This filter is applied to all inputs. Width and height may be set as follows:

Width and height values must be divisible by 4 pixels. If width or height are not an even increment of 4 pixels, the value is rounded down to the nearest integer that is divisible by 4.

Default:

0x0

Values:

WxH

Where:

Example:

-rs 320x240
-rs 320x0 (resize width to 320 and maintain aspect ratio)
-rs 0x240 (resize to 240 high but maintain aspect ratio)
-rs 0x240 (resize to 240 high but maintain aspect ratio)

 

Resize Quality    -rq


Affects the resulting quality of an output video when resize is applied. Choosing high results in a better quality resize but uses considerably more CPU. This filter is applied to all inputs. Ignored if -rs option omitted.

Default:

high

Values:

fast or high

Example:

-rq fast
-rq high

 

Audio Resampling Quality    -arq


Affects the resulting quality of audio resampling operations.  Resampling must be done if the sample rate required by the target audio codec is different from the input file or device sample rate. The producer automatically invokes the resampler for each audio codec as needed. Choosing 'high' results in an audio-only encode using as much as 2 times as much CPU for live or taking twice as long to encode for file to file encodes.  The fast audio resampling algorithm does not incur additional CPU but results the encoded output having a slightly lower quality.  In all cases, there is no pitch shift incurred by the audio resampler.

Default:

high

Values:

fast or high

Example:

-arq fast
-arq high

 

PREFILTER

Options in this section define settings that are applied to the input before it is encoded to improve the quality of the output.

-ag   Audio Limiter
-bl   Black Level Filter
-di   Deinterlace/Inverse Telecine
-daw  Disable Audio Watchdogs
-cr   Video Cropping
-nf   Video Noise Filter

Each of these options are described in detail below.

Audio Gain filter    -ag


Prevents the audio signal from clipping by applying dynamic range compression as well as offer gain control to increase or decrease the gain of the signal. The value of gain can be set from -12 to 12 as indicated above.  This filter is applied to all inputs. If option is omitted, no audio limiting occurs.

Default:

No default

Values:

Any number from -12.0 to 12.0

Example:

-ag 0

 

Black Level filter    -bl


This filter is designed to make blacks blacker. If the source video has a washed out appearance, this filter can be used to help restore proper color. This filter automatically computes reasonable Values: for the black, white and gamma levels.  This filter is applied to all inputs. If option is omitted, no black level filtering occurs.

Default:

NA

Values:

No value required for this option.

Example:

-bl

 

Inverse Telecine and Deinterlace Filter    -di


The same filter does Deinterlace and Inverse Telecine. This filter applied to all inputs. If option is omitted, no Deinterlace or Inverse Telecine filtering occurs.

Default:

No default

Values:

auto, d, i or di

Where:

Example:

-di auto
-di i

 

Disable Audio Watchdog    -daw


The Audio Watchdog is a group of 4 different tests that are applied to an input audio stream to test for possible problems.  These are:

No watchdog barks more frequently than once every 5 seconds, so as not to flood the log system.  This filter is applied to all inputs. If option is included, the Audio Watchdog is not loaded.

Default:

Value set in user preferences file.

Values:

NA

Example:

-daw

 

Input Cropping    -cr


Prefilter to to crop the size of the input video. This filter is applied to all inputs. If option is omitted, no input cropping filtering occurs.

Default:

No default

Values:

left,top,width,height

Example:

-cr 2,2,320,240

 

Video Noise Prefilter    -nf


This filter removes small distortions or static in the video image.

This filter is applied to all inputs. If option is omitted, no video noise filtering occurs. If the value is not recognized, an error is generated and job is not started.

Default:

No default

Values:

low or high

Example:

-nf low
-nf high

 

CLIP INFORMATION

Options in this section define descriptive metadata that is inserted into the RealMedia file such as Title, Author and Copyright.

-t    Title
-a    Author
-c    Copyright
-k    Keywords
-de   Description

Each of these options are described in detail below.

Title    -t


Title to be inserted into all output media clips and live streams.  This string gets inserted into the header of all output RealMedia files and live streams. This information is exposed to the user through the player's Clip Info region.

Default:

No default

Values:

Any user supplied string up to 255 bytes.

Example:

-t "My Clip Title"

 

Author    -a


Author to be inserted into all output media clips and live streams.  This string gets inserted into the header of all output RealMedia files and live streams. This information is exposed to the user through the player's Clip Info region

Default:

No default

Values:

Any user supplied string up to 255 bytes characters.

Example:

-a "William Shakespeare"

 

Copyright    -c


Copyright to be inserted into all output media clips and live streams.  This string gets inserted into the header of all output RealMedia files and live streams. This information is exposed to the user through the player's Clip Info region.

Default:

No default

Values:

Any user supplied string up to 255 bytes characters.

Example:

-c "RealNetworks©2001"

 

Keywords    -k


Keywords to be inserted into all output media clips and live streams.  This string gets inserted into the header of all output RealMedia files and live streams.

Default:

No default

Values:

Any user supplied string up to 1023 bytes.

Example:

-k "Keyword1 keyword2 keyword3"

 

Description    -de


Description to be inserted into all output media clips and live streams.  This string gets inserted into the header of all output RealMedia files and live streams. Any text beyond the 64k character limit is truncated.

Default:

No default

Values:

Any user supplied string up to 64 kb in size.

Example:

-de "A story about a galaxy far far away, in a time long long ago..."

 

SCREEN OUTPUT

Options in this section control what information is printed to the screen during encoding.

-lc   Logging Category
-dlf  Disable Logging to File
-dls  Disable Logging to Screen
-q    Quiet Mode

Each of these options are described in detail below.

Logging Category    -lc


Overrides the logging category setting in the user preferences file.  Logging category defines the type of log messages that are printed to the log file and written to the screen.  There are four categories of log messages:

See DIAGNOSTICS below for more details on configuration for logging.

Default:

Value set in command line preferences file.

Values:

Comma separated list of error, warning, info or diagnostic.  May be abbreviated as "e,w,i,d".

Example:

-lc "error,warning,diagnostic"
-lc "err,warn,info"
-lc "e,w,i,d" 

 

Disable logging to file    -dlf


Suppresses logging to file.  Logging to file settings are read from the user preferences file.  Overrides the enable/disable logging setting in the user preferences file.   See DIAGNOSTICS below for more details on configuration for logging.

Default:

NA

Values:

No value required for this option.

Example:

-dlf

 

Disable logging to screen    -dls


Suppresses logging to screen.  Logging to screen settings are read from the user preferences file.  Overrides the enable/disable logging setting in the user preferences file.   See DIAGNOSTICS below for more details on configuration for logging.

Default:

NA

Values:

No value required for this option.

Example:

-dls

 

Quite Mode    -q


Prevents any output from being printed to the screen ever. Useful if you are running the producer from within another application that fails if data output to standard output or standard error. Overrides -dls option.

Default:

NA

Values:

No value required for this option.

Example:

-q

 

INFORMATION

Options in this section provide information about the system configuration.  This information is useful in settings up an encoding session. 

-h    Print Help
-m    Help Manual
-pd   Print Devices
-pa   Print Audiences
-v    Print Version

Each of these options are described in detail below.

Display Short Help    -h


Prints usage to the screen. Intended to only be used by itself on the command line.  Also accepts -help | --help | ?

Default:

NA

Values:

No value required for this option.

Example:

-h

 

Display Detailed Help (this file)    -m


This option displays full detailed help for the RealSystem Producer in a system-dependent manor.

Default:

NA

Values:

No value required for this option.

Example:

-m

 

Print Device Information    -pd


This is an informational option that extracts audio and video device information from the system for use in the -d option. See the -d option for information on how to use the information printed with this command. This option may only be used by itself on the command line. See USAGE section above.

Default:

NA

Values:

No value required for this option.

Example:

-pd

 

Print Audience Definitions    -pa


This is an informational option that extracts Audience Definition information from the the application for use in the -ad option. See the -ad option for information on how to use the information printed with this command. This option may only be used by itself on the command line. See USAGE section above.

Default:

NA

Values:

No value required for this option.

Example:

-pa

 

Print Version Information    -v


This option prints version information for the RealSystem Producer.

Default:

NA

Values:

No value required for this option.

Example:

-v

 

EDITING AUDIENCES

To specify an audience on the command line the -ad option is specified.  An audience is a XML based file that specifies video codec, audio codec, bit rate and other settings.  To customize audience settings the audience can be edited.  Default audiences are located in a directory called 'audiences' located in the application root directory.  These files are text formatted with XML.  The files can be edited using any regular text editor or any GUI-based XML editor.  See the RealSystem Producer Preview Guide for information on customizing audiences.

ENVIRONMENT

The temporary directory is defined by the tempDir setting in the user preferences file.  If tempDir is set to %TEMP% in the preferences file, the Producer will search first for an environment variable called TEMP on Windows or TEMPDIR on Linux.  If TEMPDIR does not exist on Linux, then the Producer will also attempt to use /tmp to write temporary files.

Note: Due to performance penalties of moving files between file systems, it is advisable to locate the temporary directory on the same drive as the location where media files are being written.

DIAGNOSTICS

Logging preferences are defined in the user preferences file called 'producer.pref' located in the application root directory. The -lc, -dls and -dlf options described above allow logging preferences to be overridden.

SHUTTING DOWN

The application may be stopped by using the Control-C command ('Ctrl' and 'c' keys pressed at the same time). A Ctrl-c signal will stop all the current job and begin the merge process if SureStream files are being created or simply update headers generate an index if Single Rate encoding.  

The current encoding session may be canceled by pressing Ctrl-\ on UNIX or Ctrl-Break on Windows.  These keyboard commands will issue cancel the current job and delete all temp files.  Canceling a job results in no output!

UNIX

On UNIX the following signals are trapped by the command line application with the respective actions. The Signal Name or Signal Number can be used as an argument the kill command on UNIX to remotely sends a signal to a running producer instance (Use the -pid option to get the process ID).  By default the SIGTERM signal is sent by kill.

Action Description Signal Name Keyboard Shortcut
Stop Stop encoding and merge files. SIGINT (2) Control+C
Cancel Stop encoding, do not merge files and delete any temporary files. SIGQUIT (3) Control+\

Windows

On Windows the following events are trapped by the command line application with the respective actions.  The pkill command included with the NT Resource Kit can be used to remotely send a signal to a running producer instance (Use the -pid option to get the process ID).

Action Description Event Name Keyboard Shortcut
Stop Stop encoding and merge files. CTRL_C_EVENT Control+C
Cancel Stop encoding, do not merge files and delete any temporary files. CTRL_BREAK_EVENT Control+Break

Signals can also be sent to the producer Process ID (PID) by the operating system specific means. 

On Windows one can write a C program or use the pkill command that is provided with the NT Resource Kit.  The HandlerRoutine (http://msdn.microsoft.com/library/en-us/dllproc/conchar_5zz9.asp) in Microsoft Windows allows events to be generated by a C program and sent to a running producer instance by process ID.   This and other signal handling routines are documented on the MSDN website (http://msdn.microsoft.com/).  

On UNIX the kill command can be used to send a signal to an application or a C program may be written.  The kill function in UNIX allows events to be generated by a C program and sent to a running producer instance by process ID.  The Introduction To Unix Signals Programming (http://users.actcom.co.il/~choo/lupg/tutorials/signals/signals-programming.html) covers this in more detail.

RETURN VALUE

The producer returns a 0 if no errors occurred.  Otherwise, the producer returns a  value of 1.  This is useful when running the producer from within a script.

UNIX

On UNIX the return code can be accessed by assigning the function call to a variable and then testing that variable's value.  For example:

For example:

res=`producer -i myfile.avi`
if [ $res -ge 1 ]; then echo "Huston, we have a problem."

Will pass the results of the producer call to the variable 'res' and then print the corresponding string if 'res' has a value of 1 or more.  Note the back quotes used around the producer command.  These are special quotes that cause the contents to be executed in place.

Windows

On Windows the return code can be accessed by using the ERRORLEVEL option to the IF command.  From the DOS command line help on the IF command:

IF [NOT] ERRORLEVEL number command

Where:

For example:

producer -i myfile.avi
IF NOT ERRORLEVEL 1 echo "Huston, we have a problem."

Will print the corresponding string is an error occurred with the previous command line execution of the producer.

CROSS-PLATFORM FILE PATHS

In order to enable platform independent command line scripts, paths names are translated to be compliant to the platform the script is being run on.  The following defines the translations that are done.

STREAM NAMES

The stream name is the name given to a live RealMedia stream.  This is the name that will be used when linking to RealMedia live stream.  The following defines valid characters for RealMedia stream names:

TIME FORMAT

Duration format is [D:][h:][m:]s[.xyz] 
Where:

Limits for testing

EXAMPLES

Following are several examples demonstrating different applications of the RealSystem Producer command line interface.

Simple Example


producer -i input.avi

Encodes single input file 'input.avi' located in the current working directory to output file 'output.avi' in the same directory.  All defaults are used which include 28k Dial-up and 56k Dial-up audience definitions, Audio Mode 'music' and Video Mode 'smoothest'. 

 

Single input file to single output file


producer -i myFile.avi -o myRealMediaFile.rm

Generate an output file called 'myRealMediaFile.rm' from input file.  Use default audiences, audioMode and videoMode.

 

Batch -  Input filename with wildcard


producer -i *.avi

Generate one output file per input and output all files to the same directory.  If input directory has 2 files; myfile1.avi and myfile2.avi, 2 output files are generated in the same directory as the input files called myfile1.rm and myfile2.rm.  Each file is processed sequentially, one after another.

 

Batch -  Input filename with wildcard and output directory


producer -i C:\capture\*.avi -o C:\movies\

Generate one output file per input and output all files in output directory.  If input directory has 3 files, myfile1.avi, myfile2.avi and myfile3.avi, 3 output files are written to the C:\movies directory called myfile1.rm, myfile2.rm and myfile3.rm.  Each file is processed sequentially, one after another.

 

Batch -  Input directory


producer -i C:\capture\

Generate one output file per input and output all files in same directory.  If input directory has 2 files; myfile1.mov and myfile2.mov, 2 output files are generated in the same directory as the input files called myfile1.rm and myfile2.rm.  Each file is processed sequentially, one after another.

 

Batch -  Input directory and output directory


producer -i /capture/ -o /home/janedoe/movies/

Generate one output file per input.  If input directory has 3 files, myfile1.avi, myfile2.avi and myfile3.avi, 3 output files are written to the /home/janedoe/movies directory called myfile1.rm, myfile2.rm and myfile3.rm.  If input directory does not exist, create it.  Each file is processed sequentially, one after another.

 

Live to File


producer -vc 0 -ac 0:3 -o c:\capturefile.rm

Capture input from video capture card and audio sound card and write to output file capturefile.rm

 

Live to File - Audio Only


producer -ac 0:3 -o c:\audiocapturefile.rm

Capture input from audio sound card and write to output file audiocapturefile.rm

 

Live to Server


producer -vc 0:2 -ac 0:3 -sg janedoe:letmein@realserver.mycompany.com:4040/live.rm

Capture audio and video and stream to RealSystem 9 Server using Advanced Push broadcast type and streamname 'live.rm'.

 

Live to Server and File


producer -vc 0:2 -ac 0:3 -o archive.rm -ad "56k,150k" -sg janedoe:letmein@realserver.mycompany.com:4040/live.rm

Capture audio and video and capture to file and stream using Advanced Push broadcast type using streamname 'live.rm'.

 

File to Server


producer -i game3.mp3 -sg janedoe:letmein@realserver.mycompany.com/live.rm

Capture audio and video and stream to server using streamname 'live.rm'.

 

Setting Clipinfo


producer -i myfile.mov -o output.rm -t "Summer Vacation " -a "John Doe" -k "Cape Cod Summer Vacation 2002" -de "Video from summer vacation in Cape Cod."

Capture input from audio sound card and write to output file output.rm

 

Using Prefilters


producer -i vacation.mov -ag 4 -rs 240x0 -rq high -bl -di auto

Encode from file to file using audio limiter (-ag) with a value of 4, resize to 240 high by maintaining aspect ratio, use high quality resize, apply a black level filter and perform auto-detection of De-interlace and Inverse Telecine.

 

Using Audience Definition Files


producer -i vacation.mov -o vacation.rm -ad "C:\audiences\audience12.rpad"

Capture input from audio sound card and write to output file vacation.rm

 

BUGS

See readme.txt in the application root directory for a list of known bugs and resolutions.

AUTHOR

Copyright (c) 1995-2002 RealNetworks, Inc.

RealAudio, RealNetworks, RealSystem, RealVideo, and SureStream are trademarks or registered trademarks of RealNetworks, Inc. All other companies or products listed herein are trademarks or registered trademarks of their respective owners. All rights reserved.