libjxlenc.c File Reference

#include <string.h>
#include "libavutil/avutil.h"
#include "libavutil/csp.h"
#include "libavutil/error.h"
#include "libavutil/frame.h"
#include "libavutil/libm.h"
#include "libavutil/mem.h"
#include "libavutil/opt.h"
#include "libavutil/pixdesc.h"
#include "libavutil/pixfmt.h"
#include "libavutil/version.h"
#include "avcodec.h"
#include "encode.h"
#include "codec_internal.h"
#include <jxl/encode.h>
#include <jxl/thread_parallel_runner.h>
#include "libjxl.h"

Go to the source code of this file.

Data Structures
struct	LibJxlEncodeContext

Macros
#define	OFFSET(x)   offsetof(LibJxlEncodeContext, x)
#define	VE   AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM

Functions
static float	quality_to_distance (float quality)
	Map a quality setting for -qscale roughly from libjpeg quality numbers to libjxl's butteraugli distance for photographic content. More...
static int	libjxl_init_jxl_encoder (AVCodecContext *avctx)
	Initalize the encoder on a per-frame basis. More...
static av_cold int	libjxl_encode_init (AVCodecContext *avctx)
	Global encoder initialization. More...
static int	libjxl_populate_primaries (void *avctx, JxlColorEncoding *jxl_color, enum AVColorPrimaries prm)
	Populate a JxlColorEncoding with the given enum AVColorPrimaries. More...
static int	libjxl_encode_frame (AVCodecContext *avctx, AVPacket *pkt, const AVFrame *frame, int *got_packet)
	Encode an entire frame. More...
static av_cold int	libjxl_encode_close (AVCodecContext *avctx)

Variables
static const AVOption	libjxl_encode_options []
static const AVClass	libjxl_encode_class
const FFCodec	ff_libjxl_encoder

Detailed Description

JPEG XL encoder using libjxl

Definition in file libjxlenc.c.

Macro Definition Documentation

OFFSET

#define OFFSET

(

x

)

offsetof(LibJxlEncodeContext, x)

Definition at line 471 of file libjxlenc.c.

VE

#define VE   AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM

Definition at line 472 of file libjxlenc.c.

Function Documentation

quality_to_distance()

static float quality_to_distance ( float  quality )

static

Map a quality setting for -qscale roughly from libjpeg quality numbers to libjxl's butteraugli distance for photographic content.

Setting distance explicitly is preferred, but this will allow qscale to be used as a fallback.

This function is continuous and injective on [0, 100] which makes it monotonic.

Parameters

quality

0.0 to 100.0 quality setting, libjpeg quality

Returns

Butteraugli distance between 0.0 and 15.0

Definition at line 75 of file libjxlenc.c.

Referenced by libjxl_init_jxl_encoder().

libjxl_init_jxl_encoder()

static int libjxl_init_jxl_encoder ( AVCodecContext *  avctx )

static

Initalize the encoder on a per-frame basis.

All of these need to be set once each time the encoder is reset, which it must be each frame to make the image2 muxer work.

Returns

0 upon success, negative on failure.

Definition at line 96 of file libjxlenc.c.

Referenced by libjxl_encode_frame().

libjxl_encode_init()

static av_cold int libjxl_encode_init ( AVCodecContext *  avctx )

static

Global encoder initialization.

This only needs to be run once, not every frame.

Definition at line 162 of file libjxlenc.c.

libjxl_populate_primaries()

static int libjxl_populate_primaries ( void *  avctx, JxlColorEncoding *  jxl_color, enum AVColorPrimaries  prm  )

static

Populate a JxlColorEncoding with the given enum AVColorPrimaries.

Returns

< 0 upon failure, >= 0 upon success

Definition at line 195 of file libjxlenc.c.

Referenced by libjxl_encode_frame().

libjxl_encode_frame()

static int libjxl_encode_frame ( AVCodecContext *  avctx, AVPacket *  pkt, const AVFrame *  frame, int *  got_packet  )

static

Encode an entire frame.

Currently animation, is not supported by this encoder, so this will always reinitialize a new still image and encode a one-frame image (for image2 and image2pipe).

Definition at line 247 of file libjxlenc.c.

libjxl_encode_close()

static av_cold int libjxl_encode_close ( AVCodecContext *  avctx )

static

Definition at line 450 of file libjxlenc.c.

Variable Documentation

libjxl_encode_options

const AVOption libjxl_encode_options[]

static

Initial value:

= {
    { "effort",        "Encoding effort",                                  OFFSET(effort),     AV_OPT_TYPE_INT,    { .i64 =    7 },    1,     9, VE },
    { "distance",      "Maximum Butteraugli distance (quality setting, "
                        "lower = better, zero = lossless, default 1.0)",   OFFSET(distance),   AV_OPT_TYPE_FLOAT,  { .dbl = -1.0 }, -1.0,  15.0, VE },
    { "modular",       "Force modular mode",                               OFFSET(modular),    AV_OPT_TYPE_INT,    { .i64 =    0 },    0,     1, VE },
    { "xyb",           "Use XYB-encoding for lossy images",                OFFSET(xyb),
        AV_OPT_TYPE_INT,   { .i64 =    1 },    0,     1, VE },
    { NULL },
}

Definition at line 474 of file libjxlenc.c.

libjxl_encode_class

const AVClass libjxl_encode_class

static

Initial value:

= {
    .class_name = "libjxl",
    .item_name  = av_default_item_name,
    .option     = libjxl_encode_options,
    .version    = LIBAVUTIL_VERSION_INT,
}

Definition at line 484 of file libjxlenc.c.

ff_libjxl_encoder

const FFCodec ff_libjxl_encoder

Initial value:

= {
    .p.name           = "libjxl",
    CODEC_LONG_NAME("libjxl JPEG XL"),
    .p.type           = AVMEDIA_TYPE_VIDEO,
    .p.id             = AV_CODEC_ID_JPEGXL,
    .priv_data_size   = sizeof(LibJxlEncodeContext),
    .init             = libjxl_encode_init,
    FF_CODEC_ENCODE_CB(libjxl_encode_frame),
    .close            = libjxl_encode_close,
    .p.capabilities   = AV_CODEC_CAP_OTHER_THREADS |
                        AV_CODEC_CAP_DR1 |
                        AV_CODEC_CAP_ENCODER_REORDERED_OPAQUE,
    .caps_internal    = FF_CODEC_CAP_NOT_INIT_THREADSAFE |
                        FF_CODEC_CAP_AUTO_THREADS | FF_CODEC_CAP_INIT_CLEANUP |
                        FF_CODEC_CAP_ICC_PROFILES,
    .p.pix_fmts       = (const enum AVPixelFormat[]) {
        AV_PIX_FMT_RGB24, AV_PIX_FMT_RGBA,
        AV_PIX_FMT_RGB48, AV_PIX_FMT_RGBA64,
        AV_PIX_FMT_RGBF32, AV_PIX_FMT_RGBAF32,
        AV_PIX_FMT_GRAY8, AV_PIX_FMT_YA8,
        AV_PIX_FMT_GRAY16, AV_PIX_FMT_YA16,
        AV_PIX_FMT_GRAYF32,
        AV_PIX_FMT_NONE
    },
    .p.priv_class     = &libjxl_encode_class,
    .p.wrapper_name   = "libjxl",
}

Definition at line 491 of file libjxlenc.c.