From patchwork Mon Mar 27 00:22:53 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefano Sabatini X-Patchwork-Id: 40853 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:7a30:b0:df:834d:2c1a with SMTP id t48csp930354pzh; Sun, 26 Mar 2023 17:23:05 -0700 (PDT) X-Google-Smtp-Source: AKy350ZzWUjWTO9ue7rT8TfTqxuTXSc87MAejA6GEDhIqQpJCFrO+nK5NOGYiC7dWKE3wvLwmszv X-Received: by 2002:aa7:c65a:0:b0:501:c3de:dc5c with SMTP id z26-20020aa7c65a000000b00501c3dedc5cmr10494726edr.18.1679876585644; Sun, 26 Mar 2023 17:23:05 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1679876585; cv=none; d=google.com; s=arc-20160816; b=Xrb6Kurkp21unCaRfsXAFj/t3hUzkWQFUPxh22Xfr8yJI5Z1jNc7PWCNIjE5v/QQF3 mVX/OKqmdVcxEU31sm1JxN4yHV/l7VQr/cqNwnKtlVcv82iepzZSa16zJN2H4Xn1K4YT vE8CQ3RJKV9ZonrYLSWRSJb+niMrXEmHKbITDeH1jZtdwjJ28+jAMGDU6eLQwK1qMkTc +ijXh4kX+0WHMG9YEQlg9HrGvZbEMmfWY02zqWbhzGH/+W/SBaOczwLnp2U0AewK/vGa yA3FG3ozNIgMc5lQrQVt6b0OS4gCDMbHA8O9yicB5eqaIB7lwHQEVCmPsQZ+juIOmHHR lN6A== 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:message-id:date:to:from :dkim-signature:delivered-to; bh=Z1my7LvS8KGaAWiyF3y8fhYlsUcyvmBv63rdzhDeAJQ=; b=ZV47WjV5Cq7k4qufxZkOLBfqzR3Jm3Eg3v8VSe6Lt1ZA+wUvmcsWMHlhSmg6Bi4izY gZGM+JloOHP7E9FjUtcwSD4uPRI7Np/vS6KYEXykTiS3qGNQ/cxV6WR/q3pxT3GVqcap c0bREo9BprxFg3aCyO966gJAHGB30LwvzMmViUAexEc/NpSe+SgaCxuJxZW2jfAzICBw d3Pzcj68FZxPL/Vvf/D1dt7+ezGa0szr/g2mFdNflNOcL4d3Ga1qmdEZzwVesQlLMsGy fn25dOgzIB2BpzxE/NUcsRqoCGjCP9T0bMxehWWcMso1rfrSNZVgeg925RIe8cXHtfsB VBWw== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20210112 header.b=cU2UzFf0; 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; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id x16-20020aa7dad0000000b00501d531e504si16360851eds.323.2023.03.26.17.23.05; Sun, 26 Mar 2023 17:23:05 -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=@gmail.com header.s=20210112 header.b=cU2UzFf0; 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; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id EA39F68C6B9; Mon, 27 Mar 2023 03:23:02 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-wm1-f45.google.com (mail-wm1-f45.google.com [209.85.128.45]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 943A268C698 for ; Mon, 27 Mar 2023 03:22:56 +0300 (EEST) Received: by mail-wm1-f45.google.com with SMTP id bg16-20020a05600c3c9000b003eb34e21bdfso6313654wmb.0 for ; Sun, 26 Mar 2023 17:22:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; t=1679876575; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=z770aH8vTnHs98C3psdfeaih3cI8eGuDufRSwPshBfA=; b=cU2UzFf0mERwvDuN/z64ucpwfI1efSntRz/CYIfOWEc03lzVp8CUrN+DAcnd7lyXIl l1R5GFtKRGejf7gWSUmFSePZ01//CK93/szu7RTfS/b2Ae07xGlLyWwIqJ6XQz2lyhEj 3rVIQ1GBX2YouRbqSKJCJVAblgoOyrsFjfJLM+WjGXJTPx9gD98GrNiDGfK6W6w3k7zm dKiZxuGvLtBOZlN19u4pb0WOmjpyJv9KxuPgVyIjjdPioiSaz8qZzTaCgLP3rnuYjeiz 0/F/3tujjL6VDo1GbOPZnvUFDc4ILoYLAkYKqFd/mjYryD92tDC6cirUW9U6Uugb9WqC DYFg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1679876575; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=z770aH8vTnHs98C3psdfeaih3cI8eGuDufRSwPshBfA=; b=7PUA7UWB/M+e9aM75fMuSWa9dFoRUM24V8fl9sSqpIDhbcx074lg7XChFfmUHT3iEz 1UCdivG7IwpVcVqhjA1ALMthk2nNJJ31nu6ukdaAsDy00gWkKGIHrCynDhykX6DtexrA 9v98AYH1eXN/exvKhfYhX8fUBrgIOA2xx8pJEDO2LOQSfMbZPvBk2PkpR3XtvpdiYYDZ GwIDzVhYY52JOGnZBj7eJyqTZqu4vGYI8iWYOu2D48GYuLkIbAmSOoyF+0lpCQH2O23+ UW/4MNjz52uU+4cuFkwRKATgZc7XCXWn5E6SWVUlY1I8SW32v67N36jusQWEFGavVGMQ Wqrg== X-Gm-Message-State: AO0yUKWJknMjwYIA8v5VGjDOtL81+rNoIICTrcMyuqDt8q46LY9vmbxp sSJ0ZnNMm5V8ONLikGSuL15n4FlpfcA= X-Received: by 2002:a05:600c:2249:b0:3e2:2467:d3f5 with SMTP id a9-20020a05600c224900b003e22467d3f5mr7543905wmm.25.1679876574466; Sun, 26 Mar 2023 17:22:54 -0700 (PDT) Received: from mariano (dynamic-adsl-62-10-98-143.clienti.tiscali.it. [62.10.98.143]) by smtp.gmail.com with ESMTPSA id p5-20020a05600c358500b003ef6f87118dsm716969wmq.42.2023.03.26.17.22.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 26 Mar 2023 17:22:53 -0700 (PDT) Received: by mariano (Postfix, from userid 1000) id 05208BFB73; Mon, 27 Mar 2023 02:22:53 +0200 (CEST) From: Stefano Sabatini To: FFmpeg development discussions and patches Date: Mon, 27 Mar 2023 02:22:53 +0200 Message-Id: <20230327002253.96051-1-stefasab@gmail.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH] doc/ffmpeg: slightly rework introductory examples 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: Stefano Sabatini Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: fFps2h7gSHVu In particular, add a sentence to introduce the example, and add a simpler starting example. Address issue: http://trac.ffmpeg.org/ticket/8730 --- doc/ffmpeg.texi | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi index adfc2726ff..68a6bc6e22 100644 --- a/doc/ffmpeg.texi +++ b/doc/ffmpeg.texi @@ -49,22 +49,30 @@ Do not mix input and output files -- first specify all input files, then all output files. Also do not mix options which belong to different files. All options apply ONLY to the next input or output file and are reset between files. +Some simple examples follow. + @itemize @item -To set the video bitrate of the output file to 64 kbit/s: +Convert an input media file to a different format: +@example +ffmpeg -i input.avi output.avi +@end example + +@item +Set the video bitrate of the output file to 64 kbit/s: @example ffmpeg -i input.avi -b:v 64k -bufsize 64k output.avi @end example @item -To force the frame rate of the output file to 24 fps: +Force the frame rate of the output file to 24 fps: @example ffmpeg -i input.avi -r 24 output.avi @end example @item -To force the frame rate of the input file (valid for raw formats only) -to 1 fps and the frame rate of the output file to 24 fps: +Force the frame rate of the input file (valid for raw formats only) to 1 fps and +the frame rate of the output file to 24 fps: @example ffmpeg -r 1 -i input.m2v -r 24 output.avi @end example