From patchwork Tue Jan 2 05:59:12 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jun Zhao X-Patchwork-Id: 7067 Delivered-To: ffmpegpatchwork@gmail.com Received: by 10.2.79.195 with SMTP id r64csp14331399jad; Mon, 1 Jan 2018 22:06:38 -0800 (PST) X-Google-Smtp-Source: ACJfBovmm7SRgN1LI34tdNm2PRvNx7N1/7+PNPRHz9EsmFim/Lhkru3jBoBXTTabkp0OtVB637Fg X-Received: by 10.28.202.11 with SMTP id a11mr37244836wmg.77.1514873198506; Mon, 01 Jan 2018 22:06:38 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1514873198; cv=none; d=google.com; s=arc-20160816; b=UYG7KqzcLIsrobTm55yAC/jl3OQAz6gh52WtgReADzO5DwzEC5T3/WIqilkAUMSBqC TZb5WjBwexfzoFFMmlr/kUrvAeQJDHyTRM1AD9V/9Q6X7twGI2VpOQD8mp9S5GlJFE7U 5NocMGJ85D6sjX3KhR+KOZKP5lXQYi9I1XKyk7iSaTPT6tuVmw8QhIjTBTVSDYKDY+Bp RZz6HZKy8qfJvKouWR8zIjq4MS8J5j0DPAumj7s/LKS2o1smNTDqs28Oaof12h8Cd3DA B1FMZBY1Oswa+aXvm9JzKRdSqpiPJQa7N1zCFORAioQeeEgAP/XEmiVhhMMORYyEIWKr RClw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:reply-to:list-subscribe:list-help:list-post :list-archive:list-unsubscribe:list-id:precedence:subject :content-language:mime-version:user-agent:date:message-id:from:to :dkim-signature:delivered-to:arc-authentication-results; bh=kk6FUj3s2KMV25TkqbddyOc3s6/XmGoaE87u/x7XzeA=; b=o3O6Tg3Kd8mHef7aWeb88NWEU2TI1iFPMk7gDzqC+v6pCmPkX6ezN3cyTbPPEn5RKf MkdLLnPaU6wKeAx4sMHv/T3tz3QG/fXZ1ZyDjDaJvNPu97eFh/SHji8TZLrissygg+vI EanD/TfVv2+tA/MdIVDFuPQX4Uwu4rtKm0lb3Hq71sj3aw3PvDKzpmm+Qf+Vmk3oCW+q MRI9Whk1G5pKLV1R2qg3t8cYmFD2w+LjWQODKwO+AgFQYSAHmpiv3Il7iY2eGjOW0m7U 6EukBRzIMhpB5dQDmKzjrYC7ecoUrcsGsvCIaViaYyGMH3EUcofCuMXq6hAxn4GRl862 2+6A== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20161025 header.b=cf4QaXes; 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=NONE 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 a46si17782064wra.452.2018.01.01.22.06.37; Mon, 01 Jan 2018 22:06:38 -0800 (PST) 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=20161025 header.b=cf4QaXes; 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=NONE 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 CC24E6804C1; Tue, 2 Jan 2018 08:06:20 +0200 (EET) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-pl0-f49.google.com (mail-pl0-f49.google.com [209.85.160.49]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id D106E680362 for ; Tue, 2 Jan 2018 08:06:14 +0200 (EET) Received: by mail-pl0-f49.google.com with SMTP id d21so28084834pll.1 for ; Mon, 01 Jan 2018 22:06:30 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=to:from:subject:message-id:date:user-agent:mime-version :content-language; bh=pMfe8bmi42Ps5qADHpcGg9T8C5oY9JN+QPYA2kSRB+k=; b=cf4QaXesek1/w4SXq9hJ4BwtyQDpMai4uqWnFC4AFdLwSwuPEq+Q8TddNFVPQebgwC GOCoJ7r0UGB4S4ZXs2D/37Y2VEEUjUmUmWKz30HDnzLeQnz25BTseI8YiSfyeg6J5TFy nTZyKnZ2ehLmoWuThHw2mZR/Clox7QA04Sirs0/HtmZiZfuMpa6l/PrGbYtEsvmDnTRe BSaHAdRD200uJgTvLSEP5CctvM1zhqo4YltWvrkBiyfefvu2gHOgyfGylCbuXgirLNOX oP4EypsQnilgVnvfKOsfb12+NBzx91sl5XWgYwevVunJaEGlpcug/AkMiE6KTWHPRWBr 9V3Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:to:from:subject:message-id:date:user-agent :mime-version:content-language; bh=pMfe8bmi42Ps5qADHpcGg9T8C5oY9JN+QPYA2kSRB+k=; b=G4O+ofI8eQP34pCvhMP9evNGTtJ+mv+Iq1+JVhxfc5cJilkkAm9WhkTd7tqKx8a8Iw Eo12CgqxxL/DoOgqqRgazx/e/UjmRrfySgq13YRnQVx7Ff2WI1MrEdMSbdmd3VVJ9WNo vTcWhKHjf9ajyHUBWPwgefFrgqt4hBfc6L2fqPKClnEj19UgEzBfbe2iwrZW6zWTQW+l d/l3AP9b5jkiRYMzOm+KUNRPXyxKTkQpGcX6eyzUQSW6UupxV2v+F528Q4nuuI9ywKUO OTzZnGl4nZDVFNwxi3VHycheJkDmqs+RFYIfg5M+oW/yN3ziPRWe02B7he6CEzRF6HDS Iu7A== X-Gm-Message-State: AKGB3mI59ISqmMRBB1E+OCVe29ZTcDC7LIl5RWx5K2T1WTRd8lm8QHTP Yt8E9bxI4hTf8jDbTSw+3qk= X-Received: by 10.84.129.37 with SMTP id 34mr42722893plb.86.1514872757539; Mon, 01 Jan 2018 21:59:17 -0800 (PST) Received: from [10.67.68.20] ([192.55.54.45]) by smtp.gmail.com with ESMTPSA id j62sm85265490pfc.18.2018.01.01.21.59.15 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 01 Jan 2018 21:59:16 -0800 (PST) To: FFmpeg development discussions and patches , Mark Thompson , wm4 , Michael Niedermayer From: Jun Zhao Message-ID: <7319e050-b9bb-ab11-dea5-053725b65e79@gmail.com> Date: Tue, 2 Jan 2018 13:59:12 +0800 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.5.2 MIME-Version: 1.0 Content-Language: en-US Subject: [FFmpeg-devel] [PATCH] doc/codecs: Add missing documentation for hwaccel_flags. X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.20 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" From e030510864c28d4b17c8d1eb09ab00f274bf5dcc Mon Sep 17 00:00:00 2001 From: Jun Zhao Date: Tue, 2 Jan 2018 13:55:29 +0800 Subject: [PATCH] doc/codecs: Add missing documentation for hwaccel_flags. document the hwaccel_flags option for decoding. Signed-off-by: Jun Zhao --- doc/codecs.texi | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/doc/codecs.texi b/doc/codecs.texi index 7e20374334..190f03b293 100644 --- a/doc/codecs.texi +++ b/doc/codecs.texi @@ -1254,6 +1254,33 @@ ffprobe -dump_separator " Maximum number of pixels per image. This value can be used to avoid out of memory failures due to large images. +@item hwaccel_flags @var{flags} (@emph{decoding,video}) +Set hardware accelerated decoding flags. (if active) + +Possible values: +@table @samp +@item ignore_level +Ignore level, should be used for decoding even if the codec level used is unknown +or higher than the maximum supported level reported by the hardware driver. + +It's generally a good idea to pass this flag unless you have a specific +reason not to, as hardware tends to under-report supported levels. +@item allow_high_depth +Allow to output YUV pixel formats with a different chroma sampling than 4:2:0 +and/or other than 8 bits per component +@item allow_profile_mismatch +Attempt to decode anyway if hardware accelerated decoder's supported profiles do not +exactly match the stream. + +For example, this can be used to try to decode baseline profile H.264 +streams in hardware - it will often succeed, because many streams marked +as baseline profile actually conform to constrained baseline profile. + +Warning: If the stream is actually not supported then the behaviour is +undefined, and may include returning entirely incorrect output +while indicating success. +@end table + @item apply_cropping @var{bool} (@emph{decoding,video}) Enable cropping if cropping parameters are multiples of the required alignment for the left and top parameters. If the alignment is not met the