gst-*: add Korean translation (#22525)

2026-08-30 17:33:50 +08:00 · 2026-05-23 15:03:30 +09:00
parent 837a41352e
commit bf52e4c66f
23 changed files with 285 additions and 12 deletions
@@ -0,0 +1,16 @@
+# gst-device-monitor-1.0
+
+> GStreamer에서 감지한 장치 목록 표시.
+> 더 많은 정보: <https://manned.org/gst-device-monitor-1.0>.
+
+- 현재 연결된 모든 장치 목록 표시:
+
+`gst-device-monitor-1.0`
+
+- 현재 장치 목록을 표시하고 변경 사항을 계속 모니터링:
+
+`gst-device-monitor-1.0 {{[-f|--follow]}}`
+
+- 특정 유형의 장치 목록 표시:
+
+`gst-device-monitor-1.0 {{Audio|Video}}/{{Source|Sink}}`
@@ -0,0 +1,8 @@
+# gst-discoverer-1.0
+
+> 파일 메타데이터 및 스트림 정보 표시.
+> 더 많은 정보: <https://manned.org/gst-discoverer-1.0>.
+
+- 파일 메타데이터 출력:
+
+`gst-discoverer-1.0 {{경로/대상/파일}}`
@@ -1,12 +1,36 @@
 # gst-inspect-1.0

-> GStreamer 플러그인에 대한 정보를 출력.
+> GStreamer 플러그인 정보 출력.
 > 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/tools/gst-inspect.html>.

- 플러그인 정보 출력:
+- 특정 플러그인 정보 출력:

 `gst-inspect-1.0 {{플러그인}}`

- 장치의 하드웨어 트랜스코딩 기능을 나열:
+- 장치의 하드웨어 트랜스코딩 기능 목록 표시:

-`gst-inspect-1.0 {{vaapi|nvcodec}}`
+`gst-inspect-1.0 {{va|vaapi|nvcodec|...}}`
+
+- 사용 가능한 컨테이너 플러그인 목록 표시:
+
+`gst-inspect-1.0 {{matroska|avi|ogg|isomp4|...}}`
+
+- 사용 가능한 오디오 코덱 목록 표시:
+
+`gst-inspect-1.0 {{opus|vorbis|flac|...}}`
+
+- GStreamer 핵심 요소 목록 표시:
+
+`gst-inspect-1.0 coreelements`
+
+- 그래픽 API를 사용하는 플러그인 목록 표시:
+
+`gst-inspect-1.0 {{vulkan|opengl|...}}`
+
+- 사용 가능한 이미지 코덱 목록 표시:
+
+`gst-inspect-1.0 {{png|jpeg|...}}`
+
+- 사용 가능한 모든 플러그인 목록 표시:
+
+`gst-inspect-1.0`
@@ -0,0 +1,8 @@
+# gst-launch-1.0 audiomixer
+
+> 여러 오디오 스트림을 하나로 믹싱.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/audiomixer/audiomixer.html>.
+
+- 두 개의 오디오 스트림을 함께 믹싱:
+
+`gst-launch-1.0 {{audiotestsrc}} ! {{element_name}}. {{audiotestsrc}} ! {{element_name}}. audiomixer name={{element_name}} ! {{fakesink}}`
@@ -0,0 +1,12 @@
+# gst-launch-1.0 audiotestsrc
+
+> 기본 오디오 신호 생성.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/audiotestsrc/index.html>.
+
+- 사인파(sine wave) 생성 및 재생:
+
+`gst-launch-1.0 audiotestsrc ! {{자동_오디오_출력요소}}`
+
+- 생성할 파형 유형 지정:
+
+`gst-launch-1.0 audiotestsrc wave={{sine|square|saw|white-noise|pink-noise|ticks|...}} ! {{자동_오디오_출력요소}}`
@@ -0,0 +1,20 @@
+# gst-launch-1.0 capsfilter
+
+> 파이프라인 capability 필터링.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/coreelements/capsfilter.html>.
+
+- 그레이스케일 형식만 허용하도록 필터링:
+
+`gst-launch-1.0 {{테스트용_비디오_소스}} ! capsfilter caps=video/x-raw,format=GRAY8 ! {{videoconvert ! autovideosink}}`
+
+- 위와 동일한 작업을 축약 문법으로 수행:
+
+`gst-launch-1.0 {{테스트용_비디오_소스}} ! video/x-raw,format=GRAY8 ! {{videoconvert ! autovideosink}}`
+
+- 비디오 capability를 특정 해상도로 제한:
+
+`gst-launch-1.0 {{테스트용_비디오_소스}} ! video/x-raw,width={{640}},height={{480}} ! {{videoconvert ! autovideosink}}`
+
+- 특정 프레임레이트 지정:
+
+`gst-launch-1.0 {{테스트용_비디오_소스}} ! video/x-raw,framerate={{30}}/1 ! {{videoconvert ! autovideosink}}`
@@ -0,0 +1,8 @@
+# gst-launch-1.0 decodebin
+
+> 데이터를 자동으로 디코딩.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/playback/decodebin.html>.
+
+- 데이터를 raw 형식으로 디코딩:
+
+`gst-launch-1.0 {{소스}} ! decodebin ! {{출력_목적지}}`
@@ -0,0 +1,13 @@
+# gst-launch-1.0 fakesink
+
+> 모든 데이터를 받아들이고 버리는 sink.
+> 파이프라인의 어느 부분이 문제인지 테스트할 때 유용.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/coreelements/fakesink.html>.
+
+- 출력 없이 파이프라인 데이터를 소비:
+
+`gst-launch-1.0 {{파이프라인}} ! fakesink`
+
+- 수신한 데이터 정보를 출력:
+
+`gst-launch-1.0 {{[-v|--verbose]}} {{파이프라인}} ! fakesink silent=false`
@@ -0,0 +1,8 @@
+# gst-launch-1.0 filesrc
+
+> 파일로부터 데이터 읽기.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/coreelements/filesrc.html>.
+
+- 파일에서 데이터를 읽어 파이프라인으로 전달:
+
+`gst-launch-1.0 filesrc location={{경로/대상/파일}} ! {{파이프라인}}`
@@ -0,0 +1,8 @@
+# gst-launch-1.0 identity
+
+> 요소를 통과하는 데이터 진단.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/coreelements/identity.html>.
+
+- 전달되는 데이터 정보를 출력:
+
+`gst-launch-1.0 {{[-v|--verbose]}} {{소스}} ! identity silent=false ! {{sink}}`
@@ -0,0 +1,12 @@
+# gst-launch-1.0 libcamerasrc
+
+> libcamera 장치로부터 프레임 읽기.
+> 더 많은 정보: <https://libcamera.org/getting-started.html#using-gstreamer-plugin>.
+
+- 비디오를 창에서 출력:
+
+`gst-launch-1.0 libcamerasrc ! videoconvert ! autovideosink`
+
+- 특정 장치를 지정하여 비디오 입력 읽기:
+
+`gst-launch-1.0 libcamerasrc camera-name={{카메라_이름}} ! {{비디오_포맷_변환_요소 ! 자동_선택된_비디오_출력}}`
@@ -0,0 +1,20 @@
+# gst-launch-1.0 playbin
+
+> 독립 실행형 미디어 플레이어.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/playback/playbin.html>.
+
+- 로컬 파일 재생:
+
+`gst-launch-1.0 playbin uri=file:///{{경로/대상/파일}}`
+
+- 인터넷의 파일 재생:
+
+`gst-launch-1.0 playbin uri={{https://example.com/경로/대상/파일}}`
+
+- CD의 4번 트랙 재생:
+
+`gst-launch-1.0 playbin uri=cdda://4`
+
+- 디스크 드라이브의 DVD 재생:
+
+`gst-launch-1.0 playbin uri=dvd://`
@@ -0,0 +1,16 @@
+# gst-launch-1.0 pulsesrc
+
+> Pulseaudio 소스로부터 오디오 데이터 읽기.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/pulseaudio/pulsesrc.html>.
+
+- 기본 마이크 입력 듣기:
+
+`gst-launch-1.0 pulsesrc ! autoaudiosink`
+
+- 이름으로 오디오 소스 지정 (부분 문자열 매칭 가능):
+
+`gst-launch-1.0 pulsesrc device="{{장치_이름}}" ! autoaudiosink`
+
+- 기본 오디오 출력 장치의 모니터 출력 녹음:
+
+`gst-launch-1.0 pulsesrc device=@DEFAULT_MONITOR@ ! {{opusenc}} ! {{oggmux}} ! filesink location={{경로/대상/파일.ogg}}`
@@ -0,0 +1,8 @@
+# gst-launch-1.0 queue
+
+> 파이프라인을 멀티스레드화하고 데이터를 버퍼링.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/coreelements/queue.html>.
+
+- 하나의 블로킹 요소가 전체 파이프라인을 막지 않도록, 여러 스레드로 분리:
+
+`gst-launch-1.0 {{소스}} ! queue ! {{출력}}`
@@ -0,0 +1,8 @@
+# gst-launch-1.0 uridecodebin
+
+> URI로부터 데이터를 로드하고 자동으로 디코딩.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/playback/uridecodebin.html>.
+
+- 인터넷으로부터 데이터를 로드하고 디코딩 후 출력 장치(sink)로 전달:
+
+`gst-launch-1.0 uridecodebin uri={{https://example.com/경로/대상/파일}} ! {{출력_장치}}`
@@ -0,0 +1,8 @@
+# gst-launch-1.0 videoconvert
+
+> Raw 비디오 픽셀 포맷 간 변환.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/videoconvertscale/videoconvert.html>.
+
+- 출력 장치와 호환되는 픽셀 포맷으로 변환:
+
+`gst-launch-1.0 {{소스}} ! videoconvert ! {{출력_장치}}`
@@ -0,0 +1,8 @@
+# gst-launch-1.0 videorate
+
+> 입력 비디오 프레임레이트 정규화.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/videorate/index.html>.
+
+- 프레임레이트를 정규화하고 새로운 타임스탬프 적용:
+
+`gst-launch-1.0 {{소스}} ! videorate ! {{출력_장치}}`
@@ -0,0 +1,12 @@
+# gst-launch-1.0 videoscale
+
+> 비디오 프레임 크기 조정.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/videoconvertscale/videoscale.html>.
+
+- 입력과 출력 capability에 맞게 비디오 크기 조정:
+
+`gst-launch-1.0 {{입력}} ! videoscale ! {{출력}}`
+
+- 지정한 해상도로 비디오 크기 조정:
+
+`gst-launch-1.0 {{입력}} ! videoscale ! video/x-raw,width={{너비}},height={{높이}} ! {{출력}}`
@@ -0,0 +1,12 @@
+# gst-launch-1.0 videotestsrc
+
+> 테스트용 비디오 데이터 생성.
+> 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/videotestsrc/index.html>.
+
+- SMPTE 컬러 바 비디오 생성:
+
+`gst-launch-1.0 videotestsrc ! {{자동_선택된_비디오_출력}}`
+
+- 생성할 테스트 비디오 패턴 지정:
+
+`gst-launch-1.0 videotestsrc pattern={{smpte|snow|green|ball|circular|...}} ! {{자동_선택된_비디오_출력}}`
@@ -1,21 +1,37 @@
 # gst-launch-1.0

-> GStreamer 파이프라인 빌드 및 실행.
+> GStreamer 파이프라인 생성 및 실행.
 > 관련 항목: `gst-inspect-1.0`, `ffmpeg`.
 > 더 많은 정보: <https://gstreamer.freedesktop.org/documentation/tools/gst-launch.html>.

- 창에서 테스트 비디오 재생:
+- 테스트 비디오를 창에서 재생:

-`gst-launch-1.0 videotestsrc ! xvimagesink`
+`gst-launch-1.0 videotestsrc ! autovideosink`

- 창에서 미디어 파일 재생:
+- 테스트 오디오 재생 및 자세한 출력 활성화:
+
+`gst-launch-1.0 audiotestsrc {{[-v|--verbose]}} ! autoaudiosink`
+
+- 미디어 파일을 창에서 재생:

 `gst-launch-1.0 playbin uri={{프로토콜}}://{{호스트}}/{{경로/대상/파일}}`

- 미디어 파일을 다시 인코딩:
+- 미디어 파일 재인코딩:

-`gst-launch-1.0 filesrc location={{경로/대상/파일}} ! {{파일_타입}}demux ! {{코덱_타입}}dec ! {{코덱_타입}}enc ! {{파일_타입}}mux ! filesink location={{경로/대상/파일}}`
+`gst-launch-1.0 filesrc location={{경로/대상/파일}} ! {{파일_타입}}demux ! {{코덱_파일}}dec ! {{코덱_파일}}enc ! {{파일_타입}}mux ! filesink location={{경로/대상/파일}}`

- RTSP 서버로 파일 스트리밍:
+- 파일을 RTSP 서버로 스트리밍:

-`gst-launch-1.0 filesrc location={{경로/대상/파일}} ! rtspclientsink location=rtsp://{{호스트_아이피}}/{{경로/대상/파일}}`
+`gst-launch-1.0 filesrc location={{경로/대상/파일}} ! rtspclientsink location=rtsp://{{host_ip}}/{{경로/대상/파일}}`
+
+- `<Ctrl c>`로 종료 시 MP4 같은 컨테이너의 마무리를 위해 EOS(End Of Stream) 이벤트 강제 전송:
+
+`gst-launch-1.0 {{[-e|--eos-on-shutdown]}} videotestsrc ! x264enc ! mp4mux ! filesink location={{경로/대상/파일.mp4}}`
+
+- 테스트 비디오와 테스트 오디오를 하나의 파일로 멀티플렉싱:
+
+`gst-launch-1.0 {{[-e|--eos-on-shutdown]}} videotestsrc ! {{x264enc}} ! {{요소_이름}}. audiotestsrc ! {{opusenc}} ! {{요소_이름}}. {{matroskamux}} name={{요소_이름}} ! filesink location={{경로/대상/파일.mkv}}`
+
+- 디버그 출력 활성화 및 파이프라인을 `.dot` 파일로 덤프하여 `dot` 같은 도구로 렌더링 가능하게 저장:
+
+`GST_DEBUG={{1..5}} GST_DEBUG_DUMP_DOT_DIR={{경로/대상/디렉터리}} gst-launch-1.0 {{파이프라인}}`
@@ -0,0 +1,8 @@
+# gst-play-1.0
+
+> Gstreamer의 playbin 요소를 사용하여 미디어 파일 재생.
+> 더 많은 정보: <https://manned.org/gst-play-1.0>.
+
+- 미디어 파일 재생:
+
+`gst-play-1.0 {{파일1|디렉터리1|주소1 파일2|디렉터리2|주소2 ...}}`
@@ -0,0 +1,12 @@
+# gst-transcoder-1.0
+
+> 미디어 파일 형식을 다른 형식으로 변환.
+> 더 많은 정보: <https://wiki.st.com/stm32mpu/wiki/Gst-transcoder>.
+
+- 사용 가능한 트랜스코딩 대상 목록 표시:
+
+`gst-transcoder-1.0 {{[-l|--list-targets]}}`
+
+- 한 미디어 형식을 다른 형식으로 변환:
+
+`gst-transcoder-1.0 {{경로/대상/입력_파일.webm}} {{경로/대상/출력_파일.mp4}}`
@@ -0,0 +1,8 @@
+# gst-typefind-1.0
+
+> 파일의 MIME 타입 확인.
+> 더 많은 정보: <https://manned.org/gst-typefind-1.0>.
+
+- 파일의 MIME 타입 출력:
+
+`gst-typefind-1.0 {{경로/대상/파일}}`