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 1C4DE45C40 for ; Tue, 28 Mar 2023 23:22:33 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 554B568CD4B; Wed, 29 Mar 2023 02:22:32 +0300 (EEST) Received: from mail-ed1-f54.google.com (mail-ed1-f54.google.com [209.85.208.54]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id AEEC268CC54 for ; Wed, 29 Mar 2023 02:22:26 +0300 (EEST) Received: by mail-ed1-f54.google.com with SMTP id r11so56264083edd.5 for ; Tue, 28 Mar 2023 16:22:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; t=1680045745; h=user-agent:in-reply-to:content-disposition:mime-version:references :mail-followup-to:message-id:subject:to:from:date:from:to:cc:subject :date:message-id:reply-to; bh=/6EwPxYOrDL9QGvOUTJkShkD+j5YAFBnC1ms27w5yU4=; b=pab/DrRDAN5oa43lyiKVvOVmiU6qJgRdcBWut+XwXWgYYp6Pq4hTMJn6MVtVLxkhF9 cflpfg63FPSqmUMT+eD1hdjVwTF/kk8XtfwdiV9UI2CCJrY/1wBwCvx097GSSa441DQy 5DzU+fPbDVamw8/yYiH7vGyoi2X36sVX7Zz3FX7y1bMCRk7ehfF5/Iymf9R6xYWFzNmo DbHj3TodthHkdidO90XUqCGEMcc2pvtm7y5rYQQkKstXUqnegV8N8XE6jcjjKWh2y2w3 +aYE6tRbZjliTYdZ7bFLxcvQ20nnicQnBUA3ieWsgrBu/kqbyDVHE+4vqmX+blbgHNGd CoQw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1680045745; h=user-agent:in-reply-to:content-disposition:mime-version:references :mail-followup-to:message-id:subject:to:from:date:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=/6EwPxYOrDL9QGvOUTJkShkD+j5YAFBnC1ms27w5yU4=; b=75mjJPYg3P8Fuumo/x/pvscFJGnJIP5QGRjtFWqKn4maonEdtAwuqxLomt/7Zgkphi XB7NZ62H54gDoTS/JY9gVRJu8iL8bQ6WRgDboagVQFKOtyVUxKZH1YUro/edGLk1kMS8 yZXKRk+gT1AWaz/Ctb2V/J4YjFNZkNaapAZlho0nXzu/6o93FMZkigyjPPU9IZO9zMWa lEeJr3lJeviPgFRwO3cUbqpadhzT0CJO1oyxJJuiFk2X29eKRGmM5h9Nflxx4fFiyygU 3oBRt8vdRsQ5vfjytWAqbFTYKx62e656l4RD9gBkmT2GkVuyJKoO/TmGMfrbeivoa7J6 W/fw== X-Gm-Message-State: AAQBX9dRQwQ7V+c69mqpMvcXu8z/TOPzCU6Cwra8yClzK9M4d6BAp1IE vGJ2lIzmFzLkFpi+/iVAx59GoI6LkIQGXvpz X-Google-Smtp-Source: AKy350aSfoI4BtfPlnTWSkgmqL4ifpBybEw1b6mWwj0J+WwwH3FHgLqM4z5TvcXPZNMyrCen6po2mg== X-Received: by 2002:a17:906:15c1:b0:931:fee9:e961 with SMTP id l1-20020a17090615c100b00931fee9e961mr18438356ejd.62.1680045745492; Tue, 28 Mar 2023 16:22:25 -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 g4-20020a170906520400b0093a35f65a30sm10580035ejm.41.2023.03.28.16.22.24 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 28 Mar 2023 16:22:24 -0700 (PDT) Received: by mariano (Postfix, from userid 1000) id 897D5BFB73; Wed, 29 Mar 2023 01:22:23 +0200 (CEST) Date: Wed, 29 Mar 2023 01:22:23 +0200 From: Stefano Sabatini To: FFmpeg development discussions and patches Message-ID: <20230328232223.GR26811@mariano> Mail-Followup-To: FFmpeg development discussions and patches References: <20230327002253.96051-1-stefasab@gmail.com> <47d095a4-5c13-b5a1-358a-0e002eb54c9e@gyani.pro> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="nmemrqcdn5VTmUEE" Content-Disposition: inline In-Reply-To: <47d095a4-5c13-b5a1-358a-0e002eb54c9e@gyani.pro> User-Agent: Mutt/1.13.2 (2019-12-18) Subject: Re: [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 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" Archived-At: List-Archive: List-Post: --nmemrqcdn5VTmUEE Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On date Monday 2023-03-27 10:59:34 +0530, Gyan Doshi wrote: > > > On 2023-03-27 05:52 am, Stefano Sabatini wrote: > > 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 > > It's not clear that the output is a different format. > A different extension, maybe. Done with a fer more changes. --nmemrqcdn5VTmUEE Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="0001-doc-ffmpeg-slightly-rework-introductory-examples.patch" >From a92d8f8152cce3e349d21732248c6ccdecd000df Mon Sep 17 00:00:00 2001 From: Stefano Sabatini Date: Mon, 27 Mar 2023 02:22:28 +0200 Subject: [PATCH 1/3] doc/ffmpeg: slightly rework introductory examples In particular, add a sentence to introduce the example, and add a simpler starting example with no options. Also use different format for input.avi and output.mp4, to convey that the conversion also works on the container format. Address issue: http://trac.ffmpeg.org/ticket/8730 --- doc/ffmpeg.texi | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi index adfc2726ff..33dc271b8d 100644 --- a/doc/ffmpeg.texi +++ b/doc/ffmpeg.texi @@ -49,24 +49,33 @@ 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, by re-encoding media streams +to the target format: +@example +ffmpeg -i input.avi output.mp4 +@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 +ffmpeg -i input.avi -b:v 64k -bufsize 64k output.mp4 @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 +ffmpeg -i input.avi -r 24 output.mp4 @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 +ffmpeg -r 1 -i input.m2v -r 24 output.mp4 @end example @end itemize -- 2.25.1 --nmemrqcdn5VTmUEE Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ 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". --nmemrqcdn5VTmUEE--