encode.txt

基于嵌入式linux的程序

NAME
       encode - encode video and/or speech files

SYNOPSIS
       encode [options...]

DESCRIPTION
       This demo uses the Codec Engine to encode data from peripheral device
       drivers to files. Video and speech files are supported. The files
       created will be encoded elementary streams of video or speech.

       You must supply at least one file for the demo to run.

       The DSP Link and CMEM kernel modules need to be inserted for this demo
       to run. Worst case CMEM pools needed by this demo are 2x829440, 1x160
       and 1x80. Use the script 'loadmodules.sh' to make sure both kernel
       modules are loaded with adequate parameters.

OPTIONS
       -v <video file>, --videofile <video file>
             Encodes video data to the given file. The file will be created if
             it doesn't exist, and truncated if it does exist. The demo
             detects which type of video file is supplied using the file
             extension. Supported video algorithms are MPEG4 (.mpeg4 extension)
             and H.264 (.264 extension).

       -s <speech file>, --speechfile <speech file>
             Encodes speech data to the given file. The file will be created
             if it doesn't exist, and truncated if it does exist. The demo
             detects which type of speech file is supplied using the file
             extension. The only supported speech algorithm as of now is
             G.711 (.g711 extension).

       -r <resolution>, --resolution <resolution>
             The resolution of video to encode in the format 'width'x'height'.
             Default is 720x480.

       -b <bit rate>, --bitrate <bit rate>
             This option sets the bit rate with which the video will be
             encoded. Use a negative value for variable bit rate. Default is
             variable bit rate.

       -l, --linein
             This option makes the input device for sound recording be the
             'line in' as opposed to the 'mic in' default.

       -x, --svideo
             Use s-video video input instead of the composite default.

       -k, --keyboard
             Enables the keyboard input mode which lets the user input
             commands using the keyboard in addition to the IR remote control
             interface. At the prompt type 'help' for a list of available
             commands.

       -t <seconds>, --time <seconds>
             The number of seconds to run the demo. Defaults to infinite time.

       -h, --help
             This will print the usage of the demo.

EXAMPLE USAGE
       First execute this script to load kernel modules required:
             ./loadmodules.sh

       General usage:
             ./encode -h

       MPEG4 video encode only in CIF NTSC resolution:
             ./encode -v test.mpeg4 -r 352x240

       H.264 video encode at 1Mbps with keyboard interface
             ./encode -v test.264 -b 1000000 -k

       H.264 video encode from s-video and G.711 speech encode:
             ./encode -v test.264 -s test.g711 -x

COPYRIGHT
       Copyright (c) Texas Instruments Inc 2005

       Use of this software is controlled by the terms and conditions found in
       the license agreement under which this software has been supplied or
       provided.

KNOWN ISSUES

VERSION
       1.1

CHANGELOG
       1.0:
             A 'display' thread has been added to show the raw captured
             video being currently encoded on the display while it is being
             encoded. This requires an extra memory copy on the ARM which
             increases the ARM CPU load slightly.

             A 'writer' thread has been added to parallelize the filesystem
             I/O with the DSP algorithm processing.

             The demo now supports encoding arbitrary resolutions using the
             '-r' switch.

             A bit rate parameter was added (-b) to allow the user to change
             bit rate of the video being encoded.

             The demo now has a keyboard interface (-k) which lets
             you input the same commands as you would have input using the
             remote control in the past.

             Added support for s-video video input using the '-x' flag.

SEE ALSO
       For documentation and release notes on the individual components see
       the html files in the host installation directory.