gstreamer 手册

GStreamer(1)                                                                                                                                 GStreamer(1)


NAME
       gst-launch - build and run a GStreamer pipeline


SYNOPSIS
       gst-launch [OPTION...] PIPELINE-DESCRIPTION


DESCRIPTION
       gst-launch is a tool that builds and runs basic GStreamer pipelines.


       In  simple  form,  a PIPELINE-DESCRIPTION is a list of elements separated by exclamation marks (!). Properties may be appended to elements, in the
       form property=value.


       For a complete description of possible PIPELINE-DESCRIPTIONS see the section pipeline description below or consult the GStreamer documentation.


       Please note that gst-launch is primarily a debugging tool for developers and users. You should not build applications on top of it.  For  applica‐
       tions, use the gst_parse_launch() function of the GStreamer API as an easy way to construct pipelines from pipeline descriptions.


OPTIONS
       gst-launch accepts the following options:


       --help  Print help synopsis and available FLAGS


       -v, --verbose
               Output status information and property notifications


       -q, --quiet
               Do not print any progress information


       -m, --messages
               Output messages posted on the pipeline's bus


       -t, --tags
               Output tags (also known as metadata)


       -e, --eos-on-shutdown
               Force  an  EOS  event on sources before shutting the pipeline down. This is useful to make sure muxers create readable files when a muxing
               pipeline is shut down forcefully via Control-C.


       -i, --index
               Gather and print index statistics. This is mostly useful for playback or recording pipelines.


       -o FILE, --output=FILE
               Save XML representation of pipeline to FILE and exit (DEPRECATED, DO NOT USE)


       -f, --no-fault
               Do not install a fault handler


       --no-sigusr-handler
               Do not install signal handlers for SIGUSR1 (play) and SIGUSR2 (stop)


       -T, --trace
               Print memory allocation traces. The feature must be enabled at compile time to work.


       GSTREAMER OPTIONS
              gst-launch also accepts the following options that are common to all GStreamer applications:


       --gst-version
               Prints the version string of the GStreamer core library.


       --gst-fatal-warnings
               Causes GStreamer to abort if a warning message occurs. This is equivalent to setting the environment variable G_DEBUG to  'fatal_warnings'
               (see the section environment variables below for further information).


       --gst-debug=STRING
               A  comma separated list of category_name:level pairs to specify debugging levels for each category. Level is in the range 0-5 where 0 will
               show no messages, and 5 will show all messages. The wildcard * can be used to match category names.


               Use --gst-debug-help to show category names


               Example: GST_CAT:5,GST_ELEMENT_*:3,oggdemux:5


       --gst-debug-level=LEVEL
               Sets the threshold