From patchwork Sun Mar 24 02:25:03 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marth64 X-Patchwork-Id: 47397 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:c889:b0:1a3:b6bb:3029 with SMTP id hb9csp483458pzb; Sat, 23 Mar 2024 19:25:52 -0700 (PDT) X-Forwarded-Encrypted: i=2; AJvYcCVz4+JBPRcPYfzLEvGPzXqwg9yC6QW57XCyhcJ1VIvkd31c1gKXmy0NA9RyG3IYqT5LmaTdbQHRw3fpJPpS89E4ARKvGstCY2UL2A== X-Google-Smtp-Source: AGHT+IHBMeXkjudoxU2MTNdVpMwr1jgHDyLgjJRAhOe/zDr2dgtS6l2vscnowBw+0fv3aiHLhzuA X-Received: by 2002:ac2:4e8d:0:b0:513:dc91:f14d with SMTP id o13-20020ac24e8d000000b00513dc91f14dmr2116098lfr.31.1711247152349; Sat, 23 Mar 2024 19:25:52 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1711247152; cv=none; d=google.com; s=arc-20160816; b=h0s51mCz2eCwIC2wC4ZrrmLr3QP1yqz/t4XMi/G066g2bERa97MNRuB3p5qpKbzheL eSiaNSnWWGEip/j0TjFBt78kPeOdWFCl9UFCT2jUUbcooakpnMFXUH4qPYr6NecfP7wj SQXg5g6gSnkerYDhaba1GdJkaUUKMbJYMJeZO/oZHD3k/gqTFAdz4ZOMExo7fm4JAiEr hQLrgiCvjv5xLsKCgI2Nwu7/ZcoetExAiHKHPs9ZWLT35qQ3BUAnoe00tnuk3d+RAo+d Ihdd41iFuR0gdlpHwEEnI8oLdKwpaAsYTC+vYUktCYJtwy0qlXTq7N/JmVD5HU1URB82 izJA== 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=BI5xi/B8TzcfF+Z791SwUrLZxEWKfLRAKgVKDtaaDCNLP7B2cr8XuxzBZ8MkE23W4R Hvh1DsB7Rc9ZYhzkfe6QmoWG6D6x7Tr8gJJEvmlNKANT7Hwzl7aqU7O47n+16R7TH6HG Fmbi+A1ZUGv11SUoaDBoVWZd6suYasKIl0IY3CXM9axA2NFGEGIk89M0JHofLrJ6vvyp MzGMyidBNEZNiYEfnnrHYEoG30VQqMSW3HbGFSE6LCnwCeQ6fc+4pEq7lsuYYMH/wkHr IE161cVzoqu/zpHgaY21/oXfJLr0WoP8iMXFkCckXpdjYF5Xc/ofVBqcx7b4HdF/jFW9 zOCw==; 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="Uauk4G3/"; 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 qb7-20020a1709077e8700b00a44811f4551si1263123ejc.46.2024.03.23.19.25.52; Sat, 23 Mar 2024 19:25:52 -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="Uauk4G3/"; 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 257E168D42C; Sun, 24 Mar 2024 04:25:22 +0200 (EET) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-qv1-f98.google.com (mail-qv1-f98.google.com [209.85.219.98]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id ACF3A68D3A2 for ; Sun, 24 Mar 2024 04:25:11 +0200 (EET) Received: by mail-qv1-f98.google.com with SMTP id 6a1803df08f44-69107859bedso23107296d6.2 for ; Sat, 23 Mar 2024 19:25:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=proxyid.net; s=google; t=1711247110; x=1711851910; 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=Uauk4G3/gkZoGFgQnvjspPraHFgSn4aDmoyNXgn3mUn4P71PiYfPZRiEUXHGWNrQYe 3WFYcDnCKZpoDzllglwkScjYbhp3cfl+Nnmvphqaw1pgiJV+ZOX1p7yo0hlcuf+9qOR2 IBVDwQOv6z1GGE4BjlK69Kf1OWE/eTDzI9cpEuyTMZBkBB5xveExl0H4jyKsmG6cUFEg 3lrPeVRiEeBUvhZjCf0mJ8zOu4hXfiLbGebn1E4jQCYBxHg4kOOT8O0HXqjpu5BrFiII 8E8gVoB4yeowHTrjRJPvtwO1oaayP8Qf/PJ3/Ma6Z0PD82N24pdMIRJOMyUs1JFVedtO jwwg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1711247110; x=1711851910; 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=g/q+nTzw++MMUzOpo/4uuHNYbHOjDF6MFTzX9PbV9SPDPA9vCiUkGlKu5VtyfFMGIF 7m8xgh12lucX/nz6+bRFfn7Jpkw0p0xgiwJsCAi9D5iVLQ//JvXUJLsubjhFkuNwkeeg zKFaWbD1iQ8oMYQz5DgTaZFq3zMeZOEV5NuwdGHiwS7zlE3Efziip75Y6e145tX4r6bv vo2qVEeDruHVMDTk3pxzRwMHi1MnSVr5LgOpRGp9DHjbYcC5tX+071z8Pd7AGutFZSQg 2DUWjm2841Bgx274jXyMGZBvr5QA1iE+HJI8+DUgNVuMcS6uzP8Cmmt4LaDiEpnMAIv2 XS2Q== X-Gm-Message-State: AOJu0YzvgBcx61p/8hg8NKu+xXzLwuANgyneZUc3HeVP/Utz2QUUhVup pE7O9khIjob5It5CERlysAgOXLkiLYhE4wK1b/sQDuvDQ149p/kxx04p6LrnpGCe/1OEDZtLFrX KS1M27JPt82QU1DoqUEdjz/8rWLEb+IYGh34g5bXh X-Received: by 2002:a05:6214:2402:b0:696:3163:9f57 with SMTP id fv2-20020a056214240200b0069631639f57mr4798539qvb.46.1711247110475; Sat, 23 Mar 2024 19:25:10 -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 gu4-20020a056214260400b00690ba140f7esm362113qvb.56.2024.03.23.19.25.10 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 23 Mar 2024 19:25:10 -0700 (PDT) X-Relaying-Domain: proxyid.net From: Marth64 To: ffmpeg-devel@ffmpeg.org Date: Sat, 23 Mar 2024 21:25:03 -0500 Message-Id: <20240324022504.1419451-5-marth64@proxyid.net> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240324022504.1419451-1-marth64@proxyid.net> References: <20240324022504.1419451-1-marth64@proxyid.net> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v9 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: U4LmPP+Lqk3o 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