gst-launch-1.0 - מקוון בענן

תָכְנִית:

שֵׁם

gst-launch - בנה והפעל צינור GStreamer

תַקצִיר

השקת gst [אוֹפְּצִיָה...] צנרת-תיאור

תיאור

השקת gst הוא כלי שבונה ופועל בסיסי GStreamer צינורות.

בצורה פשוטה, PIPELINE-DESCRIPTION היא רשימה של אלמנטים המופרדים בקריאה
סימנים (!). ניתן לצרף מאפיינים לאלמנטים, בטופס נכס=ערך.

לתיאור מלא של תיאורי צינור אפשריים עיין בסעיף צינור
תיאור למטה או עיין בתיעוד של GStreamer.

שים לב ש השקת gst הוא בעיקר כלי איתור באגים עבור מפתחים ומשתמשים. אתה
לא צריך לבנות אפליקציות על גבי זה. עבור יישומים, השתמש ב-gst_parse_launch()
פונקציה של GStreamer API כדרך קלה לבנות צינורות מצינור
תיאורים.

אפשרויות

השקת gst מקבל את האפשרויות הבאות:

- עזרה הדפס תקציר עזרה ודגלים זמינים

-ב, --מִלוּלִי
מידע על סטטוס פלט והודעות על נכס

-q, --שֶׁקֶט
אל תדפיס מידע על התקדמות

-M, --הודעות
הודעות פלט שפורסמו באוטובוס של הצינור

-ט, -תגים
תגי פלט (הידועים גם בשם מטא נתונים)

, --eos-on-shutdown
כפה אירוע EOS על מקורות לפני כיבוי הצינור. זה שימושי ל
ודא ש-muxers יוצרים קבצים קריאים כאשר צינור muxing מושבת
בכוח באמצעות Control-C.

-אני, --אינדקס
איסוף והדפיס נתונים סטטיסטיים של אינדקס. זה שימושי בעיקר עבור השמעה או הקלטה
צינורות.

-ו, --אין אשמה
אל תתקין מטפל בתקלות

-T, --זֵכֶר
הדפס עקבות הקצאת זיכרון. יש להפעיל את התכונה בזמן הקומפילציה כדי
לעבוד.

GSTREAMER אפשרויות
השקת gst מקבל גם את האפשרויות הבאות המשותפות לכל GStreamer
אפליק

--gst-גרסה
מדפיס את מחרוזת הגרסה של GStreamer ספריית הליבה.

--gst-fatal-warnings
סיבות GStreamer לבטל אם מופיעה הודעת אזהרה. זה שווה ערך ל
הגדרת משתנה הסביבה G_DEBUG ל-'fatal_warnings' (ראה סעיף
סביבה משתנים להלן למידע נוסף).

--gst-debug=STRING
רשימה מופרדת בפסיקים של צמדי category_name:level לציון רמות ניפוי באגים
לכל קטגוריה. הרמה היא בטווח 0-9 כאשר 0 לא יציג הודעות, ו-9
יציג את כל ההודעות. התו הכללי * יכול לשמש כדי להתאים שמות קטגוריות. הערה
שסדר הקטגוריות והרמות חשוב, תווים כלליים בסוף עשויים
לעקוף רמות שהוגדרו קודם לכן. רמות היומן הן: 1=שגיאה, 2=אזהרה, 3=FIXME,
4=INFO, 5=DEBUG, 6=LOG, 7=TRACE, 9=MEMDUMP. מאז GStreamer 1.2 אפשר גם להשתמש
שמות רמת ניפוי הבאגים, למשל --gst-debug=*sink:LOG. תיאור מלא של
ניתן למצוא רמות שונות של ניפוי באגים בתיעוד ה-API של ספריית הליבה של GStreamer,
בקטע "הפעלת יישומי GStreamer".

השתמש ב--gst-debug-help כדי להציג שמות קטגוריות

דוגמה: GST_CAT:5,GST_ELEMENT_*:3,oggdemux:5

--gst-debug-level=LEVEL
מגדיר את הסף להדפסת הודעות איתור באגים. רמה גבוהה יותר תודפס
הודעות נוספות. הטווח השימושי הוא 0-9, כאשר ברירת המחדל היא 0. רמה 6 (LOG
level) יציג את כל המידע הנדרש בדרך כלל למטרות ניפוי באגים.
רמות גבוהות יותר שימושיות רק במקרים ספציפיים מאוד. ראה למעלה לרשימה המלאה
של רמות.

--gst-debug-no-color
GStreamer בדרך כלל מדפיס הודעות ניפוי באגים כך שההודעות יהיו מקודד בצבע
כאשר מודפס למסוף שמטפל ברצפי בריחה של ANSI. שימוש באפשרות זו
גורמים GStreamer כדי להדפיס הודעות ללא צבע. הגדרת ה GST_DEBUG_NO_COLOR
משתנה סביבה ישיג את אותו הדבר.

--gst-debug-color-mode
GStreamer בדרך כלל מדפיס הודעות ניפוי באגים כך שההודעות יהיו מקודד בצבע
כאשר מודפס למסוף שמטפל ברצפי בריחה של ANSI (ב-*nix), או משתמש
ממשק API של W32 לצביעת ההודעות המודפסות בקונסולה (ב-W32). משתמש בזה
אופציות גורמות GStreamer כדי להדפיס הודעות ללא צבע ('כבוי' או 'נטרול'),
הדפס הודעות עם צבעי ברירת מחדל ('פועל' או 'אוטומטי'), או הדפס הודעות באמצעות ANSI
רצפי בריחה לצביעה ('unix'). הגדרת ה GST_DEBUG_COLOR_MODE
משתנה סביבה ישיג את אותו הדבר.

--gst-debug-disable
משבית איתור באגים.

--gst-debug-help
מדפיס רשימה של קטגוריות ניפוי באגים זמינות ורמת ברירת המחדל שלהן.

--gst-plugin-spew
GStreamer דגלי מידע להגדרה אפשר תדפיס של שגיאות בזמן הטעינה GStreamer
תוספים

--gst-plugin-path=PATH
הוסף ספריות מופרדות ב-':' לנתיב החיפוש של הפלאגין

--gst-plugin-load=PLUGINS
טען מראש תוספים שצוינו ברשימה מופרדת בפסיקים. דרך נוספת לפרט
תוספים לטעינה מראש היא להשתמש במשתנה הסביבה GST_PLUGIN_PATH

צנרת תיאור

צינור מורכב אלמנטים ו קישורים. גורמים ניתן להכניס לתוכו פחים מסוגים שונים.
גורמים, קישורים ו פחים ניתן לציין בתיאור צינור בכל סדר.

גורמים

ELEMENTTYPE [נכס1 ...]

יוצר אלמנט מסוג ELEMENTTYPE ומגדיר את המאפיינים.

פרויקטים

PROPERTY=VALUE...

מגדיר את המאפיין לערך שצוין. אתה יכול להשתמש gst-inspect(1) לברר
מאפיינים וערכים מותרים של אלמנטים שונים.
ניתן להגדיר מאפייני ספירה לפי שם, כינוי או ערך.

פחים

[BINTYPE.] ( [נכס1 ...] PIPELINE-DESCRIPTION )

מציין כי נוצר סל מסוג BINTYPE והמאפיינים הנתונים מוגדרים. כֹּל
אלמנט בין הפלטה מוכנס לפח. שימו לב לנקודה שבה יש להשתמש
אחרי ה-BINTYPE. כמעט אף פעם לא תזדקק לפונקציונליות הזו, היא רק שימושית באמת
עבור יישומים המשתמשים ב-gst_launch_parse() API עם 'bin' בתור bintype. ככה זה
אפשר לבנות צנרת חלקית במקום צינור ברמה עליונה מלאה.

קישורים

[[SRCELEMENT].[PAD1,...]] ! [[SINKELEMENT].[PAD1,...]] [[SRCELEMENT].[PAD1,...]] ! כובעים !
[[SINKELEMENT].[PAD1,...]]

מקשר את האלמנט עם השם SRCELEMENT לאלמנט עם השם SINKELEMENT, באמצעות ה-
כובעים המצוינים ב-CAPS כמסנן. ניתן להגדיר שמות על אלמנטים עם המאפיין name.
אם השם מושמט, הרכיב שצוין ישירות לפני או אחרי ה-
נעשה שימוש בקישור. זה עובד על פני פחים. אם ניתן שם pad, הקישור נעשה עם אלה
רפידות. אם לא ניתנו שמות של פנקסים, כל האפשרויות מנוסו ונעשה שימוש בפנקס תואם.
אם ניתנים מספר שמות משטחים, שני הצדדים חייבים לכלול את אותו מספר רפידות שצוין ו
קישורים מרובים נעשים בסדר הנתון.
אז הקישור הפשוט ביותר הוא סימן קריאה פשוט, שמקשר את האלמנט משמאלו
זה לאלמנט שמימין לו.

כמוסות

סוג המדיה [, תכונה[, תכונה ...]]] [; כובעים[; כובעים ...]]

יוצר יכולת עם סוג המדיה הנתון ואופציונלי עם מאפיינים נתונים. ה
ניתן לחרוג מהסוג מדיה באמצעות " או '. אם ברצונך לשרשר כובעים, אתה יכול להוסיף כובעים נוספים
באותו פורמט לאחר מכן.

פרויקטים

NAME =[(סוּג)]ערך
ברשימות ובטווחים: [(סוּג)]ערך

מגדיר את המאפיין המבוקש ביכולות. השם הוא ערך אלפאנומרי וה-
לסוג יכולים להיות הערכים הבאים שאינם תלויי רישיות:
- i or int עבור ערכים או טווחים שלמים
- f or לצוף עבור ערכים או טווחים צפים
- b, bool or בוליאני עבור ערכים בוליאניים
- s, str or מחרוזת עבור מחרוזות
- שבריר עבור שברים (קצב פריימים, יחס גובה-רוחב של פיקסל)
- l or רשימה לרשימות
אם לא ניתן סוג, ננסה הסדר הבא: מספר שלם, צף, בוליאני, מחרוזת.
ערכי מספרים שלמים חייבים להיות ניתנים לניתוח על ידי strtol (), צף ליד strtod(). ערכי FOURCC עשויים גם כן
להיות מספרים שלמים או מחרוזות. ערכים בוליאניים הם (לא רגישים לאותיות גדולות) כן, לא, נָכוֹן or שקר ו
ייתכן שהמחרוזות יקבלו בריחה עם " או '.
הטווחים הם בפורמט הזה: [ VALUE, VALUE ]
רשימות משתמשות בפורמט הזה: { VALUE [, ערך ...] }

צנרת דוגמאות

הדוגמאות שלהלן מניחות שיש לך את התוספים הנכונים זמינים. בכללי,
ניתן להחליף את "osssink" בתוסף פלט אודיו אחר כגון "esdsink",
"alsasink", "osxaudiosink", או "artsdsink". כמו כן, ניתן להחליף את "xvimagesink".
עם "ximagesink", "sdlvideosink", "osxvideosink" או "aasink". זכור למרות זאת
כיורים שונים עשויים לקבל פורמטים שונים ואפילו אותו כיור עשוי לקבל
פורמטים שונים במכונות שונות, אז אולי תצטרך להוסיף רכיבי ממיר כמו
המרת אודיו ו-resample אודיו (עבור אודיו) או המרת וידאו (עבור וידאו) לפני ה-
לשקוע כדי לגרום לדברים לעבוד.

אודיו השמעה

השקת gst filesrc location=music.mp3 ! מטורף ! המרת שמע ! דגימת אודיו חוזרת !
ossink
הפעל את קובץ המוזיקה mp3 "music.mp3" באמצעות תוסף מבוסס libmad ופלט למערכת OSS
מכשיר

השקת gst filesrc location=music.ogg ! oggdemux ! vorbisdec ! המרת שמע !
דגימת אודיו חוזרת ! ossink
הפעל קובץ בפורמט Ogg Vorbis

השקת gst gnomevfssrc location=music.mp3 ! מטורף ! ossink
השקת gst gnomevfssrc מיקום=http://domain.com/music.mp3 ! מטורף ! המרת שמע !
דגימת אודיו חוזרת ! ossink
הפעל קובץ mp3 או זרם http באמצעות GNOME-VFS

השקת gst gnomevfssrc location=smb://computer/music.mp3 ! מטורף ! המרת שמע !
דגימת אודיו חוזרת ! ossink
השתמש ב-GNOME-VFS כדי לנגן קובץ mp3 הממוקם בשרת SMB

פוּרמָט המרה

השקת gst filesrc location=music.mp3 ! מטורף ! המרת שמע ! vorbisenc ! oggmux !
סינון קבצים location=music.ogg
המר קובץ מוסיקה mp3 לקובץ Ogg Vorbis

השקת gst filesrc location=music.mp3 ! מטורף ! המרת שמע ! flacenc ! סינון קבצים
location=test.flac
המר לפורמט FLAC

אחר

השקת gst filesrc location=music.wav ! wavparse ! המרת שמע ! דגימת אודיו חוזרת !
ossink
מנגן קובץ WAV המכיל נתוני אודיו גולמיים (PCM).

השקת gst filesrc location=music.wav ! wavparse ! המרת שמע ! vorbisenc !
oggmux ! סינון קבצים location=music.ogg
השקת gst filesrc location=music.wav ! wavparse ! המרת שמע ! צוֹלֵעַ ! סינון קבצים
location=music.mp3
המר קובץ .WAV המכיל נתוני אודיו גולמיים לקובץ Ogg Vorbis או mp3

השקת gst cdparanoiasrc מצב=רציף ! המרת שמע ! צוֹלֵעַ ! id3v2mux !
סינון קבצים location=cd.mp3
קורע את כל הרצועות מהקומפקט וממיר אותם לקובץ mp3 יחיד

השקת gst cdparanoiasrc מסלול=5 ! המרת שמע ! צוֹלֵעַ ! id3v2mux ! סינון קבצים
location=track5.mp3
קורע את רצועה 5 מהתקליטור וממיר אותו לקובץ mp3 בודד

שימוש gst-inspect(1), אפשר לגלות הגדרות כמו האמור לעיל עבור cdparanoiasrc
שיגיד לו לקרוע את כל התקליטור או רק רצועות שלו. לחלופין, אתה יכול להשתמש
URI ו-gst-launch-1.0 ימצאו אלמנט (כגון cdparanoia) שתומך בכך
פרוטוקול עבורך, למשל:
השקת gst cdda://5 ! צוֹלֵעַ vbr=חדש vbr-quality=6 ! סינון קבצים location=track5.mp3

השקת gst osssrc ! המרת שמע ! vorbisenc ! oggmux ! סינון קבצים
location=input.ogg
מקליט צליל מכניסת השמע שלך ומקודד אותו לקובץ ogg

וִידֵאוֹ

השקת gst filesrc location=JB_FF9_TheGravityOfLove.mpg ! dvddemux ! mpeg2dec !
xvimagesink
הצג רק את חלק הווידאו של קובץ וידאו MPEG-1, פלט לחלון תצוגה X

השקת gst filesrc location=/flflfj.vob ! dvddemux ! mpeg2dec ! sdlvideosink
הצג את חלק הווידאו של קובץ .vob (בשימוש בתקליטורי DVD), המוציא לחלון SDL

השקת gst filesrc location=movie.mpg ! dvddemux name=demuxer דמוקסר. ! תור !
mpeg2dec ! sdlvideosink דמוקסר. ! תור ! מטורף ! המרת שמע ! דגימת אודיו חוזרת ! ossink
הפעל קטעי וידאו ושמע של סרט MPEG

השקת gst filesrc location=movie.mpg ! mpegdemux name=demuxer דמוקסר. ! תור !
mpeg2dec ! המרת וידאו ! sdlvideosink דמוקסר. ! תור ! מטורף ! המרת שמע !
דגימת אודיו חוזרת ! ossink
הפעל סרט AVI עם זרם כתוביות טקסט חיצוני

דוגמה זו מראה גם כיצד להתייחס לפדים ספציפיים לפי שם אם אלמנט (כאן:
textoverlay) יש ריבוי כיור או רפידות מקור.

השקת gst שכבת טקסט שם=שכבת-על ! המרת וידאו ! סולם וידאו ! autovideosink
filesrc location=movie.avi ! decodebin ! המרת וידאו ! overlay.video_sink filesrc
location=movie.srt ! תת-נתח ! overlay.text_sink

הפעל סרט AVI עם זרם כתוביות חיצוני של טקסט באמצעות playbin

השקת gst playbin uri=file:///path/to/movie.avi suburi=file:///path/to/movie.srt

רשת נהירה

הזרמת וידאו באמצעות RTP ורכיבי רשת.

השקת gst v4l2src ! video/x-raw,width=128,height=96,format=UYVY ! המרת וידאו !
ffenc_h263 ! video/x-h263 ! rtph263ppay pt=96 ! udpsink מארח = 192.168.1.1 port = 5000
פקודה זו תופעל על המשדר

השקת gst udpsrc port = 5000 ! application/x-rtp, קצב שעון=90000, מטען=96 !
rtph263pdepay queue-delay=0 ! ffdec_h263 ! xvimagesink
השתמש בפקודה זו במקלט

אבחון

השקת gst -v fakesrc num-buffers=16 ! זיוף מזויף
צור זרם ריק והתעלם ממנו (והדפיס פרטים).

השקת gst audiotestsrc ! המרת שמע ! דגימת אודיו חוזרת ! ossink
צור צליל סינוס טהור כדי לבדוק את פלט האודיו

השקת gst videotestsrc ! xvimagesink
השקת gst videotestsrc ! ximagesink
צור דפוס בדיקה מוכר כדי לבדוק את פלט הווידאו

מכני עם סלילה אוטומטית מְקַשֵׁר

אתה יכול להשתמש באלמנט decodebin כדי לבחור אוטומטית את האלמנטים הנכונים כדי לקבל א
צינור עבודה.

השקת gst filesrc מיקום=קובץ מוזיקה ! decodebin ! המרת שמע ! דגימת אודיו חוזרת !
ossink
הפעל כל פורמט שמע נתמך

השקת gst filesrc מיקום=קובץ וידאו ! decodebin שם=מפענח מפענח. ! תור !
המרת שמע ! דגימת אודיו חוזרת ! ossink מפענח. ! המרת וידאו ! xvimagesink
הפעל כל פורמט וידאו נתמך עם פלט וידאו ואודיו. נעשה שימוש בחוטים
אוטומטית. כדי להקל עוד יותר, אתה יכול להשתמש ברכיב ה-playbin:

השקת gst playbin uri=file:///home/joe/foo.avi

מסונן חיבורים

דוגמאות אלה מראות לך כיצד להשתמש במכסים מסוננים.

השקת gst videotestsrc ! 'video/x-raw,format=YUY2;video/x-raw,format=YV12' !
xvimagesink
הצג תמונת בדיקה והשתמש בפורמט הווידאו YUY2 או YV12 לשם כך.

השקת gst osssrc ! 'audio/x-raw,rate=[32000,64000],format={S16LE,S24LE,S32LE}' !
wavenc ! סינון קבצים location=recording.wav
הקלט אודיו וכתוב אותו לקובץ .wav. כפוי שימוש בדגימות של 16 עד 32 סיביות חתומות וא
קצב דגימה בין 32kHz ל-64KHz.

הסביבה וריאציות

GST_DEBUG
רשימה מופרדת בפסיקים של קטגוריות ורמות ניפוי באגים (למשל
GST_DEBUG=totem:4,typefind:5). '*' מותר כתו כללי כחלק מניפוי באגים
שמות קטגוריות (למשל GST_DEBUG=*sink:6,*audio*:6). מאז 1.2.0 זה גם אפשרי
כדי לציין את רמת היומן לפי שם (1=ERROR, 2=WARN, 3=FIXME, 4=INFO, 5=DEBUG, 6=LOG,
7=TRACE, 9=MEMDUMP) (למשל GST_DEBUG=*audio*:LOG)

GST_DEBUG_NO_COLOR
כאשר משתנה סביבה זה מוגדר, פלט ניפוי באגים צבעוני מושבת.

GST_DEBUG_DUMP_DOT_DIR
כאשר מוגדר לנתיב של מערכת קבצים, אחסן שם קבצי 'נקודות' של גרפי צינור. אלה
לאחר מכן ניתן להמיר לתמונה באמצעות כלי השירות 'נקודה' מ-graphviz
סט כלים, כמו זה: dot foo.dot -Tsvg -o foo.svg (אפשר גם Png או jpg
כפורמט פלט). יש גם כלי עזר בשם 'xdot' המאפשר לך לצפות
את קובץ ה-dot ישירות מבלי להמיר אותו תחילה.

GST_REGISTRY
הנתיב של קובץ הרישום של הפלאגין. ברירת המחדל היא ~/.cache/gstreamer-1.0/registry-
CPU.bin שבו CPU הוא סוג המכונה/מעבד ש-GStreamer הידור עבורו, למשל 'i486',
'i686', 'x86-64',

GST_REGISTRY_UPDATE
הגדר ל"לא" כדי לאלץ את GStreamer להניח שאף תוספים לא השתנו, נוספו
או הוסר. זה יגרום ל-GStreamer לדלג על הבדיקה הראשונית של בנייה מחדש
של מטמון הרישום נדרש או לא. זה עשוי להיות שימושי ב-Embed
סביבות שבהן התוספים המותקנים לעולם אינם משתנים. אל תשתמש באפשרות זו ב
כל הגדרה אחרת.

GST_PLUGIN_PATH
מציין רשימה של ספריות לסריקה לאיתור תוספים נוספים. אלה לוקחים
עדיפות על פני תוספי המערכת.

GST_PLUGIN_SYSTEM_PATH
מציין רשימה של תוספים שתמיד נטענים כברירת מחדל. אם לא מוגדר, זה
ברירת המחדל לנתיב המותקן במערכת, והתוספים המותקנים בבית המשתמש
בספרייה

GST_DEBUG_FILE
הגדר את המשתנה הזה לנתיב קובץ כדי להפנות את כל הודעות ניפוי הבאגים של GStreamer לזה
קוֹבֶץ. אם לא מוגדר, נפה באגים בהודעות עם פלט לשגיאה הסטנדרטית.

ORC_CODE
משתנה סביבה שימושי של Orc. הגדר את ORC_CODE=debug כדי לאפשר מאפי באגים כגון gdb
כדי ליצור עקבות לאחור שימושיות מקוד שנוצר על ידי Orc. הגדר ORC_CODE=גיבוי או
ORC_CODE=לדמות אם אתה חושד שמחולל קוד ה- SIMD של Orc מייצר שגוי
קוד. (לא מעט תוספים חשובים של GStreamer כמו videotestsrc, audioconvert או
אודיו-resample השתמש ב-Orc).

G_DEBUG
משתנה סביבה שימושי GLib. הגדר את G_DEBUG=fatal_warnings כדי ליצור GStreamer
תוכניות מפסיקות כאשר מתרחשת אזהרה קריטית כגון כשל בטענה. זה
שימושי אם אתה רוצה לגלות איזה חלק בקוד גרם לאזהרה הזו
מופעל ובאילו נסיבות. פשוט הגדר את G_DEBUG כפי שהוזכר לעיל ו
הפעל את התוכנית ב-gdb (או תן לה dump core). ואז לקבל מעקב מחסנית ברגיל
דרך.

השתמש ב-gst-launch-1.0 באינטרנט באמצעות שירותי onworks.net