From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100]) by master.gitmailbox.com (Postfix) with ESMTP id 849E649751 for ; Tue, 19 Mar 2024 22:45:25 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id B389D68D45D; Wed, 20 Mar 2024 00:44:44 +0200 (EET) Received: from mail-io1-f97.google.com (mail-io1-f97.google.com [209.85.166.97]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id D14DB68D10C for ; Wed, 20 Mar 2024 00:44:34 +0200 (EET) Received: by mail-io1-f97.google.com with SMTP id ca18e2360f4ac-7bed9fb159fso220951739f.1 for ; Tue, 19 Mar 2024 15:44:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=proxyid.net; s=google; t=1710888273; x=1711493073; darn=ffmpeg.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=8K7CLJI+lLqkwGRGz/1NnvUTLMStymmmBMLfP6oxzmI=; b=bXNyj092eIN0VYbjA2rMaBm/LZKSDaEQGvlpIjyPzqVjJLvcWRZUBzgvNer6UL4j/E NAmgK524E+QbMefIFnxAqpCAClXqTkflKkOd8Oys5F9LJ0g45Yaa8k5b6LpBDfCI4yA6 suiS89XQCvNyoTuH3tzcN8GnNr5cKfj1ZSQfp7FtxLqvqzloVJIFCpiBmnvMN313JV07 P3fheakF5+kg+2okSMeCQ2hzDmRTJ5X1/LHKsP+Zeu+R8s8DHhf+RaQg7egZD7LFnaOF fGKyETFAKGWTuayeVfQeXRd8dvZZ1fImgnLmrUEwGrJiiPuU2npC8kToZMwQoaJWKv7T u7yA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1710888273; x=1711493073; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=8K7CLJI+lLqkwGRGz/1NnvUTLMStymmmBMLfP6oxzmI=; b=PepMQ+YIRTLtlg/2jQbwziL5gbfJhVp71+JmkB1/AESVYaOvmPOtlm9gSUiFPx6nix 6j5a3aUuQcL2U6mYhcUqXu2ZvXHldU5xTlrlx/wPwaI4OZSyZWwJp4kNgENEKDE1KeuK SDweMoD88OtfBAYZbYwilBM36a0a+3G8PfOh8hf8tBMMZfJ9/40U54zhKO/ciz9zbfIl NTsGRxwZkh4MPsbWTXMT1eZ/2whjo2dTSaBLgUj6P7j9CArrUWMEerXHjZs8ZopSXJmS ADUBD0f1GlQ+BUvGteFg3UCfsUcz0OnQWJgPISGcRH3Nq93gvucou/n6/8aUuxvAveDL FpGg== X-Gm-Message-State: AOJu0YyaAM2baqumJI0yWNmeKfe7wKbgoY79wB/PTHk0AudwGKhDCEz5 xWbdhZZsvapoT4o+SstayFwe61F534i+r+wm27jJREwV+Pfe3PxqVMLSfWz8Mzwac6qzFCK7LnD dU30W84gJRgh2OuOmgZ4ky4RSX4gYc9envTnL8QNi X-Google-Smtp-Source: AGHT+IEMlwWrHSBm8jsxi3DOcZxtfmk4qq0srJC/IMB0aHyMjGY2FM1uLeIi81Vtp7YjP45wJT92nsUUzjXG X-Received: by 2002:a6b:f212:0:b0:7c8:e976:7268 with SMTP id q18-20020a6bf212000000b007c8e9767268mr587050ioh.0.1710888273536; Tue, 19 Mar 2024 15:44:33 -0700 (PDT) Received: from wsx-cc1-001.. (c-76-141-249-38.hsd1.il.comcast.net. [76.141.249.38]) by smtp-relay.gmail.com with ESMTPS id y22-20020a5d94d6000000b007c8c35f9b16sm465699ior.34.2024.03.19.15.44.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 19 Mar 2024 15:44:33 -0700 (PDT) X-Relaying-Domain: proxyid.net From: Marth64 To: ffmpeg-devel@ffmpeg.org Date: Tue, 19 Mar 2024 17:44:28 -0500 Message-Id: <20240319224429.3133701-4-marth64@proxyid.net> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240319224429.3133701-1-marth64@proxyid.net> References: <20240319224429.3133701-1-marth64@proxyid.net> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v6 3/4] doc/{muxers, demuxers}: add RCWT demuxer doc and refresh the muxer's doc to be consistent X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Cc: Marth64 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" Archived-At: List-Archive: List-Post: Signed-off-by: Marth64 --- doc/demuxers.texi | 26 ++++++++++++++++++++++++++ doc/muxers.texi | 29 +++++++++++++++++++---------- 2 files changed, 45 insertions(+), 10 deletions(-) diff --git a/doc/demuxers.texi b/doc/demuxers.texi index b70f3a38d7..47e82eda55 100644 --- a/doc/demuxers.texi +++ b/doc/demuxers.texi @@ -1038,6 +1038,32 @@ the command: ffplay -f rawvideo -pixel_format rgb24 -video_size 320x240 -framerate 10 input.raw @end example +@anchor{rcwtdec} +@section rcwt + +RCWT (Raw Captions With Time) is a format native to ccextractor, a commonly +used open source tool for processing 608/708 Closed Captions (CC) sources. +For more information on the format, see @ref{rcwtenc,,,ffmpeg-formats}. + +This demuxer implements the specification as of March 2024, which has +been stable and unchanged since April 2014. + +@subsection Examples + +@itemize +@item +Render Closed Captions to ASSA (using FFmpeg's CC decoder): +@example +ffmpeg -i CC.rcwt.bin CC.ass +@end example + +@item +Convert an RCWT backup to SCC: +@example +ffmpeg -i CC.rcwt.bin -c:s copy CC.scc +@end example +@end itemize + @section sbg SBaGen script demuxer. diff --git a/doc/muxers.texi b/doc/muxers.texi index d9dd72e613..0695a317d4 100644 --- a/doc/muxers.texi +++ b/doc/muxers.texi @@ -2987,19 +2987,18 @@ ogg files can be safely chained. @end table -@anchor{rcwt} +@anchor{rcwtenc} @section rcwt -Raw Captions With Time (RCWT) is a format native to ccextractor, a commonly -used open source tool for processing 608/708 closed caption (CC) sources. -It can be used to archive the original, raw CC bitstream and to produce -a source file for later CC processing or conversion. As a result, -it also allows for interopability with ccextractor for processing CC data -extracted via ffmpeg. The format is simple to parse and can be used -to retain all lines and variants of CC. +RCWT (Raw Captions With Time) is a format native to ccextractor, a commonly +used open source tool for processing 608/708 Closed Captions (CC) sources. +It can be used to archive the original extracted CC bitstream and to produce +a source file for later processing or conversion. The format allows +for interoperability between ccextractor and FFmpeg, is simple to parse, +and can be used to create a backup of the CC presentation. -This muxer implements the specification as of 2024-01-05, which has -been stable and unchanged for 10 years as of this writing. +This muxer implements the specification as of March 2024, which has +been stable and unchanged since April 2014. This muxer will have some nuances from the way that ccextractor muxes RCWT. No compatibility issues when processing the output with ccextractor @@ -3009,6 +3008,16 @@ and outputs will not be a bit-exact match. A free specification of RCWT can be found here: @url{https://github.com/CCExtractor/ccextractor/blob/master/docs/BINARY_FILE_FORMAT.TXT} +@subsection Examples + +@itemize +@item +Extract Closed Captions to RCWT using lavfi: +@example +ffmpeg -f lavfi -i "movie=INPUT.mkv[out+subcc]" -map 0:s:0 -c:s copy CC.rcwt.bin +@end example +@end itemize + @anchor{segment} @section segment, stream_segment, ssegment -- 2.34.1 _______________________________________________ ffmpeg-devel mailing list ffmpeg-devel@ffmpeg.org https://ffmpeg.org/mailman/listinfo/ffmpeg-devel To unsubscribe, visit link above, or email ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".