From patchwork Thu Mar 28 20:11:31 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marth64 X-Patchwork-Id: 47602 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:9f96:b0:1a3:b6bb:3029 with SMTP id mm22csp1589075pzb; Thu, 28 Mar 2024 13:12:22 -0700 (PDT) X-Forwarded-Encrypted: i=2; AJvYcCX4b57n24p2zLumXKcGqKUZwbBIBcF4j8V20+xI+rlSPc3IFGeQDEfbDSdlRjr3jJOrDG5R8T8qzBApBHlYHMcLwJ4uREh2m5A/iw== X-Google-Smtp-Source: AGHT+IEvlpLTLB/uyv5lW3Mtv/7Yz9XwyGc+N7yvmnp889WLYIXoElLk3rW41KiOg2RqBzz4gXci X-Received: by 2002:a05:6512:2389:b0:513:30fd:2991 with SMTP id c9-20020a056512238900b0051330fd2991mr448774lfv.0.1711656742382; Thu, 28 Mar 2024 13:12:22 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1711656742; cv=none; d=google.com; s=arc-20160816; b=xuDLXov3Wu4sFRA9lSsrNDeKEa2L+GjwjE5TbR9kGkaBCPrWWGeJRmnDLwLkKUPhzC tpuV1D/njtZdrlc09OWdgGr2VOgI1fMOUQllkWfSwV8s1ro4uZiVkZaY4vchxXT8W3+W EuQQmpToqevj5ba+g5V9dNrNUx4fBLP1Dr9i0hwV1fqnff7qHK/NWrBcloNTD+Ax/pv6 /+JNQDxI+Lrk1CzElxmE1PLT4T3DgnE4fvGlfJcbzPJQ/pCggBnhVMJ0aAUsI4Va3bAR iHyz92XU3cKj/9R7+GJPnDRKyxccQJyacZH6T2FxJPhwt1Kxl/ZV4BdmXmb3CS2Dp4Ue ldFA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:cc:reply-to :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:subject:mime-version:references:in-reply-to :message-id:date:to:from:dkim-signature:delivered-to; bh=7dUqaDMRooslTAFrIEd3kKvw4Cobp/Tqvvf1NujJw/8=; fh=PlWMzmI9LD2qGS7ipLrQl8z0iaQTLQLHzoGuXcBzpCg=; b=eUscOr648mBjTs3M5cTO/a7lc7gg3GrTix9tH4Sp28sW0n3Ty9i0O5S5jxVGCEZjiA zyc/j5ljWOM4wTShzBrmCf1CdnJbMQVzvl6sWwk0D9SPkHTYHnbs7WdJZTTPheLnVOKO wmuj7jW6xUVsAA39NRD/4fPhjQ1IgTqoZ/0UZzG5E1j1vWYfXy/USohYvy66pIIBBdDO psTX6+B37lM+suoIQtdeo25B2NmHUdXT4k92tlz+kmnf7Ma/HloG8dZDB66Hwt3sPW5E JBClV7DJswJHG0J3yp2mojeq5ocb8POirXEzMPNb+gWzmIlLf1maYhFtwGidcHmxtgXm tdKA==; dara=google.com ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@proxyid.net header.s=google header.b=a2e8Hnx2; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id s10-20020a170906bc4a00b00a46a9e0c35asi1050354ejv.152.2024.03.28.13.12.21; Thu, 28 Mar 2024 13:12:22 -0700 (PDT) Received-SPF: pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) client-ip=79.124.17.100; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@proxyid.net header.s=google header.b=a2e8Hnx2; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id E72A368D71C; Thu, 28 Mar 2024 22:11:50 +0200 (EET) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-pl1-f226.google.com (mail-pl1-f226.google.com [209.85.214.226]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id E72FE68D5CC for ; Thu, 28 Mar 2024 22:11:39 +0200 (EET) Received: by mail-pl1-f226.google.com with SMTP id d9443c01a7336-1e2232e30f4so6571445ad.2 for ; Thu, 28 Mar 2024 13:11:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=proxyid.net; s=google; t=1711656698; x=1712261498; 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=Tu3xPEMlQocjPY2MXErqKe95m6no5xMG5V7DB1sHkYw=; b=a2e8Hnx2hqYX2MeLUjKmLOwA+iY5POpe3Vof64fuJw5YsPTjz8/NhpnN18yY8PO378 REmzRBAxY16GcEHoEZHcoFw817Uvl9BqMrheENsK2M5OaigipNHFWMx9ivZI9/CkXAp2 Nhtn4e5GIRGGRALSVq51ldX0t1577aJsjRfE3hGORqPCyfI3p15UCIr0VHCh3JUxNWIr dDU/Juxl2uuvYrxe7lifEBGe9YdAsg/SJymhL4/AMdPfuX4/DxMq9Pm9YHnV2YPjg5Ri +w6TxfVT4e/dM4N9wQ2HcuzosYBB1CD6ycFs6Kye/o4cOCjkHGWIdbZTplGhxZnIAw2N 1jSQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1711656698; x=1712261498; 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=Tu3xPEMlQocjPY2MXErqKe95m6no5xMG5V7DB1sHkYw=; b=wtkbxp2+ZvX9E8GntjMjmX/wIuoRuYulzRb5OpJXTPuhXLKR5F4WR4CiifaVSEvJTE gAzsSSAcO3uNSiz2eEgKibJGDXHFqbqRF6j0s/oNX7SMqsN2CXnDenN7s9WdzScoif6G PtOnLzyudDLhW5QZQMD6B0C62x5OGjK7UcoitTHmZnfqHBy2htLp4LrPGPhullUe0jw3 /TD4lcyZIReFXFBri+G7gg4n9e9+oDEKuPSv2MUiuf4mLglg6LdaBIEXBmf7Ekqzd/1R AmatpLc4quKt9dxMqj165vqkVCDRboMuDHzvZGGbpiAi3fKSFqpjl2iJFX87EGZABvTs S0Fg== X-Gm-Message-State: AOJu0YwfS4wX7PB4b+bX1IWFZLAwnt/BmoBhecQm4tVwoLn9fUMJ80ln yxLpls69n/wsbYLRxw5f89YfqezTKBOa7biwlQfRLj+Qd423HbPCydcnQQAnQRWxlWCcGIqbTA8 CSbo78ujClCVkHXkTCYK6ZHN/KlMzRIVO1WkB2xKe X-Received: by 2002:a17:902:f684:b0:1e0:f473:fd8d with SMTP id l4-20020a170902f68400b001e0f473fd8dmr618647plg.48.1711656698195; Thu, 28 Mar 2024 13:11:38 -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 b8-20020a170902d88800b001e0c9462e9fsm61791plz.57.2024.03.28.13.11.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 28 Mar 2024 13:11:38 -0700 (PDT) X-Relaying-Domain: proxyid.net From: Marth64 To: ffmpeg-devel@ffmpeg.org Date: Thu, 28 Mar 2024 15:11:31 -0500 Message-Id: <20240328201132.1804716-5-marth64@proxyid.net> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240328201132.1804716-1-marth64@proxyid.net> References: <20240328201132.1804716-1-marth64@proxyid.net> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v10 4/5] doc/muxers: refresh the RCWT muxer's doc to be consistent with the demuxer 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 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: jpAuluKmlf43 Signed-off-by: Marth64 --- doc/muxers.texi | 29 +++++++++++++++++++---------- 1 file changed, 19 insertions(+), 10 deletions(-) diff --git a/doc/muxers.texi b/doc/muxers.texi index a10a8e216f..4161401059 100644 --- a/doc/muxers.texi +++ b/doc/muxers.texi @@ -3038,19 +3038,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 @@ -3060,6 +3059,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