From patchwork Tue Apr 26 21:08:34 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Leo Izen X-Patchwork-Id: 35444 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:3b9e:b0:7d:cfb5:dc7c with SMTP id b30csp2635004pzh; Tue, 26 Apr 2022 14:09:10 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwk6YRlK6xj4hw3Bxx0uHhi9zo50PEX92C5Gz+x9O/tZWsU8XhwHXR4/on01jXZ5UIt6zNe X-Received: by 2002:a17:907:7208:b0:6ef:6ca5:2daa with SMTP id dr8-20020a170907720800b006ef6ca52daamr22975545ejc.405.1651007350163; Tue, 26 Apr 2022 14:09:10 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1651007350; cv=none; d=google.com; s=arc-20160816; b=T2PF4oLD359Mye7+5/8k5TKngBCv+ueZdnz2TUJ/8oDz+mE9ZgwUTNAeZE9kx0qNYZ O5EARV7wYhEKofjUq4uoEpn7RHz3uxHH+4QGR/CNx0YAwOuRXjlQgJ4SLQM2aKvoAqqg 15+1gvHLpSoK3QM8aGFxSzVKBJv5C233qZ8gy2lyQWYI6H+g482DzdBLJiGe8N0ktx2M RFcfm5tshwfdNRyLAAAjXocfbCtGWSO9xFvOtOUOx6hLizBpw4beNwmSry+ppzwEaF+E 0RWfQYt6m4fKNQ96F03ffM3R22cBzqPPyuM+WXE+6ZFaQZBXbcTrGnFD4KvZ/gsz0nXM U3XQ== 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=S5ANkUD2aCwjIXIBqM/N6mtrBGN+orkN3zloJaiqIDo=; b=sK9gfKbrxOxwEDL9ddRSfSE0MXLIMWsX0LgRATn1U3Q4zksndNcdibLo2+sLr4Pxod 3beQ4Ubei9TEzFxDpO91fBbicyb+07quX/EyjY50CRtl2YX3DWmucS3a1YkY8l9cAHSR /LyYrKcWFzw3Y583bM1XnzRxBfRvCWmsocXgLO7AlMYrky410JmjsITLw9X/KsEhOsBH iZJiLN2LLz40EHUB2pRY1FBCdNgIlpq60AxRKMAYavfKTopmIeaBKLsiaFXN9s3Mkc94 CKQSZHXQa86QwgtgscBXwV3JzJuxeDEJpxrhaidSe6dvD1onaxWICqpzXaWk19PCKaXu YtiA== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20210112 header.b=qBWJ9ctS; 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 w4-20020a170906b18400b006e8d683e525si15275663ejy.404.2022.04.26.14.09.09; Tue, 26 Apr 2022 14:09:10 -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=qBWJ9ctS; 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 6435868B36A; Wed, 27 Apr 2022 00:09:05 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-qv1-f53.google.com (mail-qv1-f53.google.com [209.85.219.53]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 7642668B0D6 for ; Wed, 27 Apr 2022 00:08:58 +0300 (EEST) Received: by mail-qv1-f53.google.com with SMTP id ke5so12859277qvb.5 for ; Tue, 26 Apr 2022 14:08:58 -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=gJZchElEmdtOq8/eppHfgnwDhX4nLDd3Uq4ttM9h3xA=; b=qBWJ9ctSr5RVF7Yh+i76Jdpnq42uD244NN7rpntXjRKOHzZMKWri4uHJ0kx+yVcpgP IKJSFnytgCINh2GEDEViRQfAzQ9l/dJuT53DfGx4H8wnAynyKW2tfCvxcBsXW351hvuy E4Z+3EXiceYYITdglKIdiRPOhwC/mPwpXCE6NnN1SXP+z70LTrUemB3oCjywyOWJMr2l wfbNVhRs/ggKfUC7vuwLuA4+eugeRYOHybJnTcC0kyJrklr8I6bAOYTkV4zCBKpSZJAv qxyF1bFFcZwcciW51o0nhctj54QefSi5adSIIlXhuyKmSygL324grRekOhu/+bqCMoWC wccg== 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=gJZchElEmdtOq8/eppHfgnwDhX4nLDd3Uq4ttM9h3xA=; b=3qmWWzQCB/D0Y9pAFA3T/cEIQK9KIJCOfctjwtUTRcKpH+wfCpyI55OQ2170Amsrk1 c0G2IBuplr/Qkwhfja2uymN7n2yEp/jamHmmsOkRJRVTRG5zRIzTYS4tNE5HatKN54fj qMlLjUuk+R0RYs89zevx9YNZPxFFs6ocfLZ2veB9T0xhpIJP8bduCsi2JrOJp0zg78DJ +PcGDt9uhfAN8qhV4RHJKsq4j36SdP4EDZAl41M0QozXRGE8XoL4af8G7pfWflVmthz/ ejKvSefjsyoU2OJ3emLCSKrKFtwyCCmEP11Vd964fGExiVHbjScgkoBpQCgDSaHJyNws QaWQ== X-Gm-Message-State: AOAM530+Z/U277LvUEpM2Z15EkxgSCch/NQvYuStffs/LlLvlHdrWILi QpNt32GEGfCc3DE3bEvy7afvr7ENLcM= X-Received: by 2002:ad4:5caa:0:b0:446:54ef:60d4 with SMTP id q10-20020ad45caa000000b0044654ef60d4mr18026343qvh.86.1651007336905; Tue, 26 Apr 2022 14:08:56 -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 d65-20020a37b444000000b0069e9f79795fsm7027262qkf.67.2022.04.26.14.08.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 26 Apr 2022 14:08:56 -0700 (PDT) From: Leo Izen To: ffmpeg-devel@ffmpeg.org Date: Tue, 26 Apr 2022 17:08:34 -0400 Message-Id: <20220426210834.314078-1-leo.izen@gmail.com> X-Mailer: git-send-email 2.36.0 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH] 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: 795yXzl7d+zx Add more detailed documenation for the libjxl encoder wrapper than is present currently inside libavcodec. --- doc/encoders.texi | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/doc/encoders.texi b/doc/encoders.texi index aac9f25e55..99399d4674 100644 --- a/doc/encoders.texi +++ b/doc/encoders.texi @@ -1809,6 +1809,40 @@ 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. The default is to let the encoder pick +between VarDCT and Modular encoding modes based on encoding settings and the +type of input content. + +@end table + @section libkvazaar Kvazaar H.265/HEVC encoder.