gst-launch-1.0: en línea en la nube

PROGRAMA:

NOMBRE

gst-launch: compila y ejecuta una canalización de GStreamer

SINOPSIS

lanzamiento de gst [OPCIÓN...] DESCRIPCIÓN DE LA TUBERÍA

DESCRIPCIÓN

lanzamiento de gst es una herramienta que crea y ejecuta básicos GStreamer oleoductos.

En forma simple, un PIPELINE-DESCRIPTION es una lista de elementos separados por exclamación
marcas (!). Las propiedades se pueden agregar a los elementos, en la forma propiedad = valor.

Para obtener una descripción completa de las posibles DESCRIPCIONES DE TUBERÍAS, consulte la sección industrial
descripción a continuación o consulte la documentación de GStreamer.

Tenga en cuenta que lanzamiento de gst es principalmente una herramienta de depuración para desarrolladores y usuarios. usted
no debería crear aplicaciones sobre él. Para aplicaciones, use gst_parse_launch ()
función de la API de GStreamer como una forma fácil de construir pipelines a partir de pipeline
descripciones

OPCIONES

lanzamiento de gst acepta las siguientes opciones:

--ayuda Imprimir la sinopsis de la ayuda y las BANDERAS disponibles

-v, --verboso
Información de estado de salida y notificaciones de propiedad

-q, --tranquilo
No imprima ninguna información de progreso

-metro, --mensajes
Mensajes de salida publicados en el bus de la tubería

-t, --etiquetas
Etiquetas de salida (también conocidas como metadatos)

-mi, --eos al apagar
Fuerza un evento de EOS en las fuentes antes de cerrar la canalización. Esto es útil para
asegúrese de que los muxers creen archivos legibles cuando se cierra una tubería de muxing
con fuerza a través de Control-C.

-I, --índice
Recopile e imprima estadísticas de índices. Esto es principalmente útil para reproducir o grabar.
oleoductos.

-F, --sin culpa
No instale un manejador de fallas

-T, --rastro
Imprime trazas de asignación de memoria. La función debe estar habilitada en el momento de la compilación para
extra.

GSTREAMER OPCIONES
lanzamiento de gst también acepta las siguientes opciones que son comunes a todos los GStreamer
aplicaciones:

--gst-versión
Imprime la cadena de versión del GStreamer biblioteca central.

--gst-fatal-advertencias
Causas GStreamer para cancelar si aparece un mensaje de advertencia. Esto es equivalente a
establecer la variable de entorno G_DEBUG en 'fatal_warnings' (ver la sección
entorno las variables a continuación para obtener más información).

--gst-debug = CADENA
Una lista separada por comas de pares de categoría_nombre: nivel para especificar niveles de depuración
para cada categoría. El nivel está en el rango 0-9 donde 0 no mostrará mensajes y 9
mostrará todos los mensajes. El comodín * se puede utilizar para hacer coincidir los nombres de las categorías. Nota
que el orden de categorías y niveles es importante, los comodines al final pueden
anular los niveles establecidos anteriormente. Los niveles de registro son: 1 = ERROR, 2 = ADVERTENCIA, 3 = FIXME,
4 = INFORMACIÓN, 5 = DEPURACIÓN, 6 = REGISTRO, 7 = RASTREO, 9 = MEMDUMP. Desde GStreamer 1.2 también se puede utilizar
los nombres del nivel de depuración, por ejemplo, --gst-debug = * sink: LOG. Una descripción completa de la
Se pueden encontrar varios niveles de depuración en la documentación de la API de la biblioteca principal de GStreamer,
en la sección "Ejecución de aplicaciones de GStreamer".

Utilice --gst-debug-help para mostrar los nombres de las categorías

Ejemplo: GST_CAT: 5, GST_ELEMENT _ *: 3, oggdemux: 5

--gst-debug-level = NIVEL
Establece el umbral para imprimir mensajes de depuración. Se imprimirá un nivel superior
más mensajes. El rango útil es 0-9, siendo 0 el valor predeterminado. Nivel 6 (LOG
level) mostrará toda la información que normalmente se requiere para fines de depuración.
Los niveles más altos solo son útiles en casos muy específicos. Vea arriba para la lista completa
de niveles.

--gst-debug-sin-color
GStreamer normalmente imprime mensajes de depuración para que los mensajes estén codificados por colores
cuando se imprime en un terminal que maneja secuencias de escape ANSI. Usando esta opción
causas GStreamer para imprimir mensajes sin color. Establecer el GST_DEBUG_NO_COLOR
La variable de entorno logrará lo mismo.

--gst-depuración-modo-color
GStreamer normalmente imprime mensajes de depuración para que los mensajes estén codificados por colores
cuando se imprime en un terminal que maneja secuencias de escape ANSI (en * nix), o utiliza
API de consola W32 para colorear los mensajes impresos en una consola (en W32). Usando esto
causas de la opción GStreamer para imprimir mensajes sin color ('desactivado' o 'desactivado'),
imprimir mensajes con colores predeterminados ('encendido' o 'automático'), o imprimir mensajes usando ANSI
secuencias de escape para colorear ('unix'). Establecer el GST_DEBUG_COLOR_MODE
La variable de entorno logrará lo mismo.

--gst-depuración-deshabilitar
Desactiva la depuración.

--gst-depuración-ayuda
Imprime una lista de categorías de depuración disponibles y su nivel de depuración predeterminado.

--gst-complemento-vomitar
GStreamer indicadores de información para configurar Habilitar la impresión de errores durante la carga GStreamer
plugins

--gst-plugin-path = RUTA
Agregue directorios separados con ':' a la ruta de búsqueda del complemento

--gst-plugin-load = PLUGINS
Precargue los complementos especificados en una lista separada por comas. Otra forma de especificar
los complementos para precargar es usar la variable de entorno GST_PLUGIN_PATH

TUBERÍA DESCRIPCIÓN

Una tubería consiste elementos y enlaces. Elements se puede poner en contenedores de diferentes tipos.
Elements, enlaces y contenedores se puede especificar en una descripción de canalización en cualquier orden.

Elements

TIPO DE ELEMENTO [PROPIEDAD1 ...]

Crea un elemento de tipo ELEMENTTYPE y establece las PROPIEDADES.

Propiedades

PROPIEDAD = VALOR ...

Establece la propiedad en el valor especificado. Puedes usar gst-inspeccionar(1) para conocer
propiedades y valores permitidos de diferentes elementos.
Las propiedades de enumeración se pueden establecer por nombre, apodo o valor.

bins

[TIPO BIN.] ( [PROPIEDAD1 ...] DESCRIPCIÓN DE LA TUBERÍA)

Especifica que se crea un bin de tipo BINTYPE y se establecen las propiedades dadas. Cada
El elemento entre las llaves se coloca en el contenedor. Tenga en cuenta el punto que debe usarse
después de BINTYPE. Casi nunca necesitará esta funcionalidad, solo es realmente útil
para aplicaciones que utilizan la API gst_launch_parse () con 'bin' como bintype. Asi es
posible construir tuberías parciales en lugar de una tubería completa de nivel superior.

Enlaces

[[SRCELEMENT]. [PAD1, ...]] ! [[SINKELEMENT]. [PAD1, ...]] [[SRCELEMENT]. [PAD1, ...]] ! TAPAS !
[[SINKELEMENT]. [PAD1, ...]]

Vincula el elemento con el nombre SRCELEMENT al elemento con el nombre SINKELEMENT, usando el
tapas especificadas en CAPS como filtro. Los nombres se pueden establecer en elementos con la propiedad name.
Si se omite el nombre, el elemento que se especificó directamente delante o después del
se utiliza el enlace. Esto funciona en contenedores. Si se proporciona un padname, el enlace se realiza con estos
almohadillas. Si no se dan nombres de pad, se prueban todas las posibilidades y se utiliza un pad correspondiente.
Si se dan varios nombres de pad, ambos lados deben tener el mismo número de pads especificado y
se realizan varios enlaces en el orden indicado.
Entonces, el enlace más simple es un simple signo de exclamación, que vincula el elemento a la izquierda de
a la derecha del elemento.

de datos

TIPO DE MEDIO [, PROPIEDAD[, PROPIEDADES ...]]] [; TAPAS[; GORRAS ...]]

Crea una capacidad con el tipo de medio dado y, opcionalmente, con propiedades dadas. los
el tipo de medio se puede escapar usando "o". Si desea encadenar mayúsculas, puede agregar más mayúsculas
en el mismo formato después.

Propiedades

NAME =[(ESCRIBE)]VALOR
en listas y rangos: [(ESCRIBE)]VALOR

Establece la propiedad solicitada en las capacidades. El nombre es un valor alfanumérico y el
type puede tener los siguientes valores que no distinguen entre mayúsculas y minúsculas:
- i or int para valores enteros o rangos
- f or flotar para valores flotantes o rangos
- b, bool or booleano para valores booleanos
- s, str or cadena para cuerdas
- fracción para fracciones (velocidad de fotogramas, relación de aspecto de píxeles)
- l or lista para listas
Si no se proporcionó ningún tipo, se intentará el siguiente orden: entero, flotante, booleano, cadena.
Los valores enteros deben poder analizarse mediante strtol (), flota por strtod (). Los valores de FOURCC pueden
ser enteros o cadenas. Los valores booleanos son (no distinguen entre mayúsculas y minúsculas) si, no, su verdadero or false y
puede que las cadenas se escapen con "o".
Los rangos están en este formato: [VALUE, VALUE]
Las listas utilizan este formato: {VALOR [, VALOR ...] }

TUBERÍA EJEMPLOS

En los ejemplos siguientes se asume que dispone de los complementos correctos. En general,
"osssink" se puede sustituir por otro complemento de salida de audio como "esdsink",
"alsasink", "osxaudiosink" o "artsdsink". Asimismo, se puede sustituir "xvimagesink"
con "ximagesink", "sdlvideosink", "osxvideosink" o "aasink". Sin embargo, tenga en cuenta que
diferentes sumideros pueden aceptar diferentes formatos e incluso el mismo sumidero puede aceptar
diferentes formatos en diferentes máquinas, por lo que es posible que deba agregar elementos de conversión como
audioconvert y audioresample (para audio) o videoconvert (para video) frente al
hundirse para que las cosas funcionen.

Audio reproducción

lanzamiento de gst archivosrc ubicación = music.mp3 ! increíblemente ! conversión de audio ! muestra de audio !
sumidero
Reproduzca el archivo de música mp3 "music.mp3" utilizando un complemento basado en libmad y envíelo a un OSS
dispositivo

lanzamiento de gst archivosrc ubicación = music.ogg ! oggdemux ! vorbisdec ! conversión de audio !
muestra de audio ! sumidero
Reproducir un archivo de formato Ogg Vorbis

lanzamiento de gst gnomevfssrc ubicación = music.mp3 ! increíblemente ! sumidero
lanzamiento de gst gnomevfssrc ubicación =http://domain.com/music.mp3 ! increíblemente ! conversión de audio !
muestra de audio ! sumidero
Reproduzca un archivo mp3 o una secuencia http usando GNOME-VFS

lanzamiento de gst gnomevfssrc location = smb: //computer/music.mp3 ! increíblemente ! conversión de audio !
muestra de audio ! sumidero
Use GNOME-VFS para reproducir un archivo mp3 ubicado en un servidor SMB

Formato conversión

lanzamiento de gst archivosrc ubicación = music.mp3 ! increíblemente ! conversión de audio ! vorbisenc ! oggmux !
disipador de archivos ubicación = music.ogg
Convierta un archivo de música mp3 en un archivo Ogg Vorbis

lanzamiento de gst archivosrc ubicación = music.mp3 ! increíblemente ! conversión de audio ! flamenca ! disipador de archivos
ubicación = test.flac
Convierta al formato FLAC

Otro

lanzamiento de gst archivosrc ubicación = music.wav ! analizar ! conversión de audio ! muestra de audio !
sumidero
Reproduce un archivo .WAV que contiene datos de audio sin procesar (PCM).

lanzamiento de gst archivosrc ubicación = music.wav ! analizar ! conversión de audio ! vorbisenc !
oggmux ! disipador de archivos ubicación = music.ogg
lanzamiento de gst archivosrc ubicación = music.wav ! analizar ! conversión de audio ! paralítico ! disipador de archivos
ubicación = music.mp3
Convierta un archivo .WAV que contenga datos de audio sin procesar en un archivo Ogg Vorbis o mp3

lanzamiento de gst cdparanoiasrc modo = continuo ! conversión de audio ! paralítico ! id3v2mux !
disipador de archivos ubicación = cd.mp3
extrae todas las pistas del disco compacto y las convierte en un solo archivo mp3

lanzamiento de gst cdparanoiasrc pista = 5 ! conversión de audio ! paralítico ! id3v2mux ! disipador de archivos
ubicación = track5.mp3
extrae la pista 5 del CD y la convierte en un solo archivo mp3

Gracias a gst-inspeccionar(1), es posible descubrir configuraciones como la anterior para cdparanoiasrc
que le dirá que extraiga todo el CD o solo pistas del mismo. Alternativamente, puede usar
un URI y gst-launch-1.0 encontrarán un elemento (como cdparanoia) que admita eso
protocolo para usted, por ejemplo:
lanzamiento de gst cdda: // 5 ! paralítico vbr = nuevo calidad-vbr = 6 ! disipador de archivos ubicación = track5.mp3

lanzamiento de gst ossrc ! conversión de audio ! vorbisenc ! oggmux ! disipador de archivos
ubicación = input.ogg
graba el sonido de su entrada de audio y lo codifica en un archivo ogg

Video

lanzamiento de gst archivosrc ubicación = JB_FF9_TheGravityOfLove.mpg ! dvddemux ! mpeg2dec !
xvimagesink
Muestra solo la parte de video de un archivo de video MPEG-1, y se envía a una ventana de visualización X

lanzamiento de gst archivosrc ubicación = / flflfj.vob ! dvddemux ! mpeg2dec ! sdlvideosink
Muestra la parte de video de un archivo .vob (usado en DVD), saliendo a una ventana SDL

lanzamiento de gst archivosrc ubicación = película.mpg ! dvddemux nombre = demuxer demultiplexor ! cola !
mpeg2dec ! sdlvideosink demultiplexor ! cola ! increíblemente ! conversión de audio ! muestra de audio ! sumidero
Reproduzca partes de video y audio de una película MPEG

lanzamiento de gst archivosrc ubicación = película.mpg ! mpegdemux nombre = demuxer demultiplexor ! cola !
mpeg2dec ! videoconvertir ! sdlvideosink demultiplexor ! cola ! increíblemente ! conversión de audio !
muestra de audio ! sumidero
Reproducir una película AVI con un flujo de subtítulos de texto externo

Este ejemplo también muestra cómo hacer referencia a pads específicos por nombre si un elemento (aquí:
textoverlay) tiene múltiples pads de fuente o sumidero.

lanzamiento de gst superposición de texto nombre = superposición ! videoconvertir ! videoescala ! autovideosink
archivosrc ubicación = película.avi ! decodificador ! videoconvertir ! superposición.video_sink archivosrc
ubicación = movie.srt ! subparse ! superposición.text_sink

Reproduzca una película AVI con un flujo de subtítulos de texto externo usando playbin

lanzamiento de gst papelera uri = file: ///path/to/movie.avi suburi = file: ///path/to/movie.srt

Nuestra red en streaming

Transmita video usando RTP y elementos de red.

lanzamiento de gst v4l2src ! video / x-raw, ancho = 128, alto = 96, formato = UYVY ! videoconvertir !
ffenc_h263 ! video / x-h263 ! rtph263ppay pt = 96 ! sumidero host = 192.168.1.1 puerto = 5000
Este comando se ejecutará en el transmisor

lanzamiento de gst uppsrc puerto = 5000 ! aplicación / x-rtp, frecuencia de reloj = 90000, carga útil = 96 !
rtph263pdepago retardo de cola = 0 ! ffdec_h263 ! xvimagesink
Utilice este comando en el receptor

Diagnóstico

lanzamiento de gst -v falsosrc núm-búferes = 16 ! fregadero falso
Genere un flujo nulo e ignórelo (e imprima los detalles).

lanzamiento de gst audiotestsrc ! conversión de audio ! muestra de audio ! sumidero
Genere un tono sinusoidal puro para probar la salida de audio

lanzamiento de gst videotestsrc ! xvimagesink
lanzamiento de gst videotestsrc ! ximagesink
Genere un patrón de prueba familiar para probar la salida de video

Automático enlace

Puede utilizar el elemento decodebin para seleccionar automáticamente los elementos correctos para obtener un
tubería de trabajo.

lanzamiento de gst archivosrc ubicación = archivo de música ! decodificador ! conversión de audio ! muestra de audio !
sumidero
Reproduce cualquier formato de audio compatible

lanzamiento de gst archivosrc ubicación = archivo de video ! decodificador nombre = decodificador descifrador. ! cola !
conversión de audio ! muestra de audio ! sumidero descifrador. ! videoconvertir ! xvimagesink
Reproduzca cualquier formato de video compatible con salida de video y audio. Se utilizan hilos
automáticamente. Para hacerlo aún más fácil, puede usar el elemento playbin:

lanzamiento de gst papelera uri = file: ///home/joe/foo.avi

Filtrado personales

Estos ejemplos le muestran cómo utilizar mayúsculas filtradas.

lanzamiento de gst videotestsrc ! 'video / x-raw, formato = YUY2; video / x-raw, formato = YV12' !
xvimagesink
Muestre una imagen de prueba y use el formato de video YUY2 o YV12 para esto.

lanzamiento de gst ossrc ! 'audio / x-raw, tasa = [32000,64000], formato = {S16LE, S24LE, S32LE}' !
onda ! disipador de archivos ubicación = grabación.wav
grabar audio y escribirlo en un archivo .wav. Forzar el uso de muestras firmadas de 16 a 32 bits y un
frecuencia de muestreo entre 32 kHz y 64 kHz.

MEDIO AMBIENTE VARIABLES

GST_DEBUG
Lista separada por comas de categorías y niveles de depuración (p. Ej.
GST_DEBUG = tótem: 4, typefind: 5). '*' está permitido como comodín como parte de la depuración
nombres de categorías (por ejemplo, GST_DEBUG = * sink: 6, * audio *: 6). Desde 1.2.0 también es posible
para especificar el nivel de registro por nombre (1 = ERROR, 2 = WARN, 3 = FIXME, 4 = INFO, 5 = DEBUG, 6 = LOG,
7 = TRACE, 9 = MEMDUMP) (por ejemplo, GST_DEBUG = * audio *: LOG)

GST_DEBUG_NO_COLOR
Cuando se establece esta variable de entorno, la salida de depuración coloreada está deshabilitada.

GST_DEBUG_DUMP_DOT_DIR
Cuando se establece en una ruta de sistema de archivos, almacena archivos 'punto' de gráficos de canalización allí. Estas
luego se puede convertir en una imagen usando la utilidad 'punto' de graphviz
conjunto de herramientas, como esta: punto foo.dot -Tsvg -o foo.svg (png o jpg también son posibles
como formato de salida). También hay una utilidad llamada 'xdot' que le permite ver
el archivo .dot directamente sin convertirlo primero.

GST_REGISTRO
Ruta del archivo de registro del complemento. El valor predeterminado es ~ / .cache / gstreamer-1.0 / registro-
CPU.bin donde CPU es el tipo de máquina / cpu para el que se compiló GStreamer, por ejemplo, 'i486',
'i686', 'x86-64',

GST_REGISTRY_UPDATE
Configure en "no" para obligar a GStreamer a asumir que no se han agregado complementos.
o ha sido eliminado. Esto hará que GStreamer omita la comprobación inicial de si una reconstrucción
de la caché del registro es necesario o no. Esto puede ser útil en incrustado
entornos donde los complementos instalados nunca cambian. No utilice esta opción en
cualquier otra configuración.

GST_PLUGIN_RUTA
Especifica una lista de directorios para buscar complementos adicionales. Estos toman
precedencia sobre los complementos del sistema.

GST_PLUGIN_SYSTEM_PATH
Especifica una lista de complementos que siempre se cargan de forma predeterminada. Si no se establece, este
por defecto es la ruta instalada por el sistema y los complementos instalados en la casa del usuario
directorio

GST_DEBUG_FILE
Establezca esta variable en una ruta de archivo para redirigir todos los mensajes de depuración de GStreamer a esta
expediente. Si no se configura, los mensajes de depuración se enviarán al error estándar.

CÓDIGO_ORC
Variable de entorno útil de Orc. Establezca ORC_CODE = debug para habilitar depuradores como gdb
para crear trazas útiles a partir del código generado por Orc. Establecer ORC_CODE = copia de seguridad o
ORC_CODE = emular si sospecha que el generador de código SIMD de Orc está produciendo incorrectamente
código. (Algunos complementos importantes de GStreamer como videotestsrc, audioconvert o
ejemplo de audio use Orc).

G_DEBUG
Variable de entorno GLib útil. Establezca G_DEBUG = fatal_warnings para hacer GStreamer
los programas abortan cuando se produce una advertencia crítica, como un error de afirmación. Este es
útil si desea averiguar qué parte del código provocó que se
desencadenado y en qué circunstancias. Simplemente configure G_DEBUG como se mencionó anteriormente y
ejecute el programa en gdb (o deje que se descargue el núcleo). Luego, obtenga un seguimiento de la pila en la forma habitual
.

Utilice gst-launch-1.0 en línea utilizando los servicios de onworks.net