From patchwork Wed Apr 27 15:00:57 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Leo Izen X-Patchwork-Id: 35451 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:3b9e:b0:7d:cfb5:dc7c with SMTP id b30csp3028142pzh; Wed, 27 Apr 2022 08:01:34 -0700 (PDT) X-Google-Smtp-Source: ABdhPJw5xDGS4wjPxACh66zAW6T19RfzOTyUGS+FJA9ERwc1XvjaivUKAnU0vTZm+iIox54DFvOm X-Received: by 2002:a05:6402:e:b0:423:d5ff:8fce with SMTP id d14-20020a056402000e00b00423d5ff8fcemr30641249edu.407.1651071694459; Wed, 27 Apr 2022 08:01:34 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1651071694; cv=none; d=google.com; s=arc-20160816; b=yycEGu2wbQGiBDG3HSbviYf+EpvYItsyAcQOKYSjXXCpqRf6VA+T5YXc9JcrtzhW2y 79ICw5I4U4Pti8pBdTnwbEiwXRVgFRyinBGvzlWWuMx48gRbCgYQYzxAOK9DW4zB9LAF orI8OpVqYaZUuJMX41vVZNviudcZ5SqkO7GQhk+hFYwp3XdjLScy4zVsCV9vy/2tzByg QEmuMmOJgoM/dsbcF1jolkWtUY1mebzN6Jp3uVZNmIRJY/RgqhoLVz5ZUUwTC5++DCFd +L8tnytkk1BokK7DvoCMHa7K9e3mBSCddfEkXznBdGsaok8fT7yHfpmorPlfZwiAB7TX NO3A== 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=n1bGM6KD1LwNkj0xFZQbQI6gCPlI8PUJ0QXBhnBRBVE=; b=ckZ4fTWp/eAMrO7k7u541lOkBiqWeFlzpibuvfvsmq8DAZJy8O4rs33Y+1xeMuo1Zt np2sY6WreMM+RgEDTQZzSt8nH3Q9nabJ2/DWFaTZpI6ZBJ+fjoejpPyiHk1VUvZjWwzh XnxWaENuDr39Z35muVFZ5+BnZCrl1s7rP/PBMqCO3sVEAppCqtyGptU6RSdN/270eTqV gr6fPGI4UdEJSbgAEQ166FnV+jiUxyfKpqCNaNk6AbvBq+0VVk/EidSYI5wE+rGLOTEj VBGzQXwLD0nSK5rBEEQ5vGjBOA+u/8HVBoFUjXpDCbq4q7pxh2YtviRvSvuRm+B1AuZB dGkA== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20210112 header.b=EXijNj55; 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 q12-20020a1709066b0c00b006f00c0f394dsi1501390ejr.773.2022.04.27.08.01.33; Wed, 27 Apr 2022 08:01:34 -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=EXijNj55; 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 5319668B467; Wed, 27 Apr 2022 18:01:29 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-qv1-f43.google.com (mail-qv1-f43.google.com [209.85.219.43]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 165A368B2B5 for ; Wed, 27 Apr 2022 18:01:22 +0300 (EEST) Received: by mail-qv1-f43.google.com with SMTP id e17so1208521qvj.11 for ; Wed, 27 Apr 2022 08:01:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=aq1B6yjyDFMEP4a0cioD654OZRY4BAn3mhoJfRF+ycY=; b=EXijNj55UqWMlGO15ID0HYYQZTpDPZCHsex42KHOeNMkTAlSkt1rEUd9S0S/MaYa1o gEPg2ydUIjUTc8uWIhWmUWaUsSm717L91+w7TLVeASJW5aLVBRu3T0upEUv6FrQ5eOkv TIkY1NYWPutVLuRdp3u86F2054VGT9/8i56n3Oo+EhJoTwfjWj1luMjXixA5u5f/eHPu sAQe2BZDMMriNDceiMU9s5bD90YkWQn5hzuAaO0xLfexnvftVjH+d7XXBjRx6vmNqFuA NyYgbElpP1G5lMkUZhHi8UHHIzgxflOcqbMLs4syL9+Ls/vp4K3NgipsqHy4z8Prw5iU UAAw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=aq1B6yjyDFMEP4a0cioD654OZRY4BAn3mhoJfRF+ycY=; b=ROQLuMN2/NeM0//kYP8HT78qej3Xeun/5jsTl7BbNGgWE9KVdWrTb/6/UkmpPPFtnz rd6uGNQXOQeb6ZJJ6VkMgf3NcLqjMeLj3bW2PMGN0VnAWfZ7qjQOCe5w55IO9DoH/gCX VAt67gz2buaujZGgDx7u2vm2LudIUY0bjaRHTd5p2rs7H9HigsPSA8ogXYulMjCIxXbC 4SO5XJX3SGM5GTSiU2zgHyzxKkbnglC8pcaklzFqHuwzMIwiHNsFHKBJiWByWYS+POaJ XUtiGxTREbWke0gkR2XcGTs9Z/mAszhQsOoWgu52f7KJaC/n5y6WagLOz9AQtkx+Gu61 JNjQ== X-Gm-Message-State: AOAM531C5rWcBOpIVyZqRWiKYypSPxiKwZ/ycE6XVMq8RNyAKkD1vDPb qEHMRMSsURbzJfLe1yv264Wn+eenWok= X-Received: by 2002:a05:6214:1d25:b0:441:6b43:6e29 with SMTP id f5-20020a0562141d2500b004416b436e29mr20193642qvd.28.1651071680513; Wed, 27 Apr 2022 08:01:20 -0700 (PDT) Received: from gauss.local (c-68-41-54-207.hsd1.mi.comcast.net. [68.41.54.207]) by smtp.gmail.com with ESMTPSA id t13-20020a05622a01cd00b002f36d2a0865sm4605624qtw.53.2022.04.27.08.01.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 27 Apr 2022 08:01:19 -0700 (PDT) From: Leo Izen To: ffmpeg-devel@ffmpeg.org Date: Wed, 27 Apr 2022 11:00:57 -0400 Message-Id: <20220427150057.339274-1-leo.izen@gmail.com> X-Mailer: git-send-email 2.36.0 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v2] doc/encoders: document libjxl encoder options 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: Leo Izen Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: C2trT6e0rvMM Add more detailed documenation for the libjxl encoder wrapper than is present currently inside libavcodec. --- doc/encoders.texi | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/doc/encoders.texi b/doc/encoders.texi index aac9f25e55..51f0dc3fcb 100644 --- a/doc/encoders.texi +++ b/doc/encoders.texi @@ -1809,6 +1809,41 @@ by ":". See the SVT-AV1 encoder user guide for a list of accepted parameters. @end table +@section libjxl + +libjxl JPEG XL encoder wrapper. + +Requires the presence of the libjxl headers and library during +configuration. You need to explicitly configure the build with +@code{--enable-libjxl}. + +@subsection Options + +The libjxl wrapper supports the following options: + +@table @option + +@item distance +Set the target Butteraugli distance. This is a quality setting: lower +distance yields higher quality, with distance=1.0 roughly comparable to +libjpeg Quality 90 for photographic content. Setting distance=0.0 yields +true lossless encoding. Valid values range between 0.0 and 15.0, and sane +values rarely exceed 5.0. Setting distance=0.1 is usually attains +transparency for most input. The default is 1.0. + +@item effort +Set the encoding effort used. Higher effort values produce more consistent +quality and usually produces a better quality/bpp curve, at the cost of +more CPU time required. Valid values range from 1 to 9, and the default is 7. + +@item modular +Force the encoder to use Modular mode instead of choosing automatically. The +default is to use VarDCT for lossy encoding and Modular for lossless. VarDCT +is generally superior to Modular for lossy encoding but does not support +lossless encoding. + +@end table + @section libkvazaar Kvazaar H.265/HEVC encoder.