Go to the documentation of this file.
44 #include <jxl/encode.h>
45 #include <jxl/thread_parallel_runner.h>
86 return (100.0 -
quality) * 0.10;
88 return 0.1 + (100.0 -
quality) * 0.09;
107 JxlEncoderReset(
ctx->encoder);
110 if (JxlEncoderSetParallelRunner(
ctx->encoder, JxlThreadParallelRunner,
ctx->runner)
111 != JXL_ENC_SUCCESS) {
116 ctx->options = JxlEncoderFrameSettingsCreate(
ctx->encoder,
NULL);
132 JxlMemoryManager manager;
135 ctx->encoder = JxlEncoderCreate(&manager);
147 ctx->buffer_size = 4096;
156 if (
ctx->distance < 0.0) {
168 if (
ctx->distance > 0.0 &&
ctx->distance < 0.01)
169 ctx->distance = 0.01;
209 jxl_color->primaries = JXL_PRIMARIES_SRGB;
210 jxl_color->white_point = JXL_WHITE_POINT_D65;
213 jxl_color->primaries = JXL_PRIMARIES_2100;
214 jxl_color->white_point = JXL_WHITE_POINT_D65;
217 jxl_color->primaries = JXL_PRIMARIES_P3;
218 jxl_color->white_point = JXL_WHITE_POINT_DCI;
221 jxl_color->primaries = JXL_PRIMARIES_P3;
222 jxl_color->white_point = JXL_WHITE_POINT_D65;
225 av_log(avctx,
AV_LOG_WARNING,
"Unknown primaries, assuming BT.709/sRGB. Colors may be wrong.\n");
226 jxl_color->primaries = JXL_PRIMARIES_SRGB;
227 jxl_color->white_point = JXL_WHITE_POINT_D65;
235 jxl_color->primaries = JXL_PRIMARIES_CUSTOM;
236 jxl_color->white_point = JXL_WHITE_POINT_CUSTOM;
238 jxl_color->primaries_red_xy[0] =
av_q2d(
desc->prim.r.x);
239 jxl_color->primaries_red_xy[1] =
av_q2d(
desc->prim.r.y);
240 jxl_color->primaries_green_xy[0] =
av_q2d(
desc->prim.g.x);
241 jxl_color->primaries_green_xy[1] =
av_q2d(
desc->prim.g.y);
242 jxl_color->primaries_blue_xy[0] =
av_q2d(
desc->prim.b.x);
243 jxl_color->primaries_blue_xy[1] =
av_q2d(
desc->prim.b.y);
244 jxl_color->white_point_xy[0] =
av_q2d(
desc->wp.x);
245 jxl_color->white_point_xy[1] =
av_q2d(
desc->wp.y);
261 JxlColorEncoding jxl_color;
262 JxlPixelFormat *jxl_fmt = &
ctx->jxl_fmt;
264 #if JPEGXL_NUMERIC_VERSION >= JPEGXL_COMPUTE_NUMERIC_VERSION(0, 8, 0)
265 JxlBitDepth jxl_bit_depth;
269 JxlEncoderInitBasicInfo(&
info);
273 info.num_extra_channels = (jxl_fmt->num_channels + 1) & 0x1;
274 info.num_color_channels = jxl_fmt->num_channels -
info.num_extra_channels;
278 info.alpha_bits = (
info.num_extra_channels > 0) *
info.bits_per_sample;
280 info.exponent_bits_per_sample =
info.bits_per_sample > 16 ? 8 : 5;
281 info.alpha_exponent_bits =
info.alpha_bits ?
info.exponent_bits_per_sample : 0;
282 jxl_fmt->data_type =
info.bits_per_sample > 16 ? JXL_TYPE_FLOAT : JXL_TYPE_FLOAT16;
284 info.exponent_bits_per_sample = 0;
285 info.alpha_exponent_bits = 0;
286 jxl_fmt->data_type =
info.bits_per_sample <= 8 ? JXL_TYPE_UINT8 : JXL_TYPE_UINT16;
289 #if JPEGXL_NUMERIC_VERSION >= JPEGXL_COMPUTE_NUMERIC_VERSION(0, 8, 0)
290 jxl_bit_depth.bits_per_sample = bits_per_sample;
291 jxl_bit_depth.type = JXL_BIT_DEPTH_FROM_PIXEL_FORMAT;
293 info.exponent_bits_per_sample : 0;
299 av_log(avctx,
AV_LOG_WARNING,
"This encoder does not support limited (tv) range, colors will be wrong!\n");
304 info.uses_original_profile =
ctx->distance == 0.0 || !
ctx->xyb;
307 info.orientation =
frame->linesize[0] >= 0 ? JXL_ORIENT_IDENTITY : JXL_ORIENT_FLIP_VERTICAL;
310 info.have_animation = 1;
311 info.animation.have_timecodes = 0;
312 info.animation.num_loops = 0;
318 if (JxlEncoderSetBasicInfo(
ctx->encoder, &
info) != JXL_ENC_SUCCESS) {
325 jxl_color.rendering_intent = JXL_RENDERING_INTENT_RELATIVE;
330 jxl_color.transfer_function = JXL_TRANSFER_FUNCTION_709;
333 jxl_color.transfer_function = JXL_TRANSFER_FUNCTION_LINEAR;
336 jxl_color.transfer_function = JXL_TRANSFER_FUNCTION_SRGB;
339 jxl_color.transfer_function = JXL_TRANSFER_FUNCTION_DCI;
342 jxl_color.transfer_function = JXL_TRANSFER_FUNCTION_PQ;
345 jxl_color.transfer_function = JXL_TRANSFER_FUNCTION_HLG;
348 jxl_color.transfer_function = JXL_TRANSFER_FUNCTION_GAMMA;
349 jxl_color.gamma = 1/2.2f;
352 jxl_color.transfer_function = JXL_TRANSFER_FUNCTION_GAMMA;
353 jxl_color.gamma = 1/2.8f;
357 av_log(avctx,
AV_LOG_WARNING,
"Unknown transfer function, assuming Linear Light. Colors may be wrong.\n");
358 jxl_color.transfer_function = JXL_TRANSFER_FUNCTION_LINEAR;
360 av_log(avctx,
AV_LOG_WARNING,
"Unknown transfer function, assuming IEC61966-2-1/sRGB. Colors may be wrong.\n");
361 jxl_color.transfer_function = JXL_TRANSFER_FUNCTION_SRGB;
367 if (
info.num_color_channels == 1)
368 jxl_color.color_space = JXL_COLOR_SPACE_GRAY;
370 jxl_color.color_space = JXL_COLOR_SPACE_RGB;
379 if (sd && sd->
size && JxlEncoderSetICCProfile(
ctx->encoder, sd->
data, sd->
size) != JXL_ENC_SUCCESS)
381 if (JxlEncoderSetColorEncoding(
ctx->encoder, &jxl_color) != JXL_ENC_SUCCESS)
384 #if JPEGXL_NUMERIC_VERSION >= JPEGXL_COMPUTE_NUMERIC_VERSION(0, 8, 0)
385 if (JxlEncoderSetFrameBitDepth(
ctx->options, &jxl_bit_depth) != JXL_ENC_SUCCESS)
391 if (JxlEncoderGetRequiredCodestreamLevel(
ctx->encoder) > 5) {
392 if (JxlEncoderSetCodestreamLevel(
ctx->encoder, 10) != JXL_ENC_SUCCESS)
413 JxlPixelFormat *jxl_fmt = &
ctx->jxl_fmt;
416 if (JxlEncoderFrameSettingsSetOption(
ctx->options, JXL_ENC_FRAME_SETTING_EFFORT,
ctx->effort)
417 != JXL_ENC_SUCCESS) {
422 if (JxlEncoderSetFrameDistance(
ctx->options,
ctx->distance) != JXL_ENC_SUCCESS) {
432 if (JxlEncoderFrameSettingsSetOption(
ctx->options, JXL_ENC_FRAME_SETTING_MODULAR,
433 ctx->modular ||
ctx->distance <= 0.0 ? 1 : -1) != JXL_ENC_SUCCESS) {
438 jxl_fmt->endianness = JXL_NATIVE_ENDIAN;
439 if (
frame->linesize[0] >= 0) {
440 jxl_fmt->align =
frame->linesize[0];
443 jxl_fmt->align = -
frame->linesize[0];
457 JxlEncoderStatus jret;
459 uint8_t *next_out =
ctx->buffer;
462 jret = JxlEncoderProcessOutput(
ctx->encoder, &next_out, &
available);
463 if (jret == JXL_ENC_ERROR) {
469 if (jret == JXL_ENC_SUCCESS)
471 if (jret == JXL_ENC_NEED_MORE_OUTPUT) {
478 size_t new_size =
ctx->buffer_size * 2;
483 ctx->buffer_size = new_size;
484 next_out =
ctx->buffer + *bytes_written;
504 size_t bytes_written = 0;
521 if (JxlEncoderAddImageFrame(
ctx->options, &
ctx->jxl_fmt,
data,
ctx->jxl_fmt.align *
frame->height)
522 != JXL_ENC_SUCCESS) {
530 JxlEncoderCloseInput(
ctx->encoder);
540 memcpy(
pkt->
data,
ctx->buffer, bytes_written);
561 size_t bytes_written = 0;
587 ctx->frame ?
ctx->frame->pts -
ctx->prev->pts :
596 if (JxlEncoderSetFrameHeader(
ctx->options, &
frame_header) != JXL_ENC_SUCCESS) {
605 if (JxlEncoderAddImageFrame(
ctx->options, &
ctx->jxl_fmt,
data,
ctx->jxl_fmt.align *
ctx->prev->height)
606 != JXL_ENC_SUCCESS) {
612 JxlEncoderCloseInput(
ctx->encoder);
622 memcpy(
pkt->
data,
ctx->buffer, bytes_written);
639 JxlThreadParallelRunnerDestroy(
ctx->runner);
647 JxlEncoderDestroy(
ctx->encoder);
657 #define OFFSET(x) offsetof(LibJxlEncodeContext, x)
658 #define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
662 {
"distance",
"Maximum Butteraugli distance (quality setting, "
665 {
"xyb",
"Use XYB-encoding for lossy images",
OFFSET(xyb),
704 .p.wrapper_name =
"libjxl",
708 .
p.
name =
"libjxl_anim",
724 .p.wrapper_name =
"libjxl",
JxlEncoderFrameSettings * options
#define AV_LOG_WARNING
Something somehow does not look correct.
AVPixelFormat
Pixel format.
@ AV_CODEC_ID_JPEGXL_ANIM
size_t ff_libjxl_get_threadcount(int threads)
Transform threadcount in ffmpeg to one used by libjxl.
#define FF_CODEC_CAP_INIT_CLEANUP
The codec allows calling the close function for deallocation even if the init function returned a fai...
static int libjxl_process_output(AVCodecContext *avctx, size_t *bytes_written)
Run libjxl's output processing loop, reallocating the packet as necessary if libjxl needs more space ...
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
@ AV_PIX_FMT_YA8
8 bits gray, 8 bits alpha
AVFrameSideData * av_frame_get_side_data(const AVFrame *frame, enum AVFrameSideDataType type)
Struct that contains both white point location and primaries location, providing the complete descrip...
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
#define AVERROR_EOF
End of file.
@ AVCOL_TRC_LINEAR
"Linear transfer characteristics"
#define AV_CODEC_FLAG_QSCALE
Use fixed qscale.
#define AV_PIX_FMT_FLAG_FLOAT
The pixel format contains IEEE-754 floating point values.
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
This structure describes decoded (raw) audio or video data.
enum AVColorTransferCharacteristic color_trc
Color Transfer Characteristic.
@ AVCOL_RANGE_JPEG
Full range content.
#define FF_CODEC_CAP_NOT_INIT_THREADSAFE
The codec is not known to be init-threadsafe (i.e.
int av_get_bits_per_pixel(const AVPixFmtDescriptor *pixdesc)
Return the number of bits per pixel used by the pixel format described by pixdesc.
int64_t duration
Duration of this packet in AVStream->time_base units, 0 if unknown.
AVColorPrimaries
Chromaticity coordinates of the source primaries.
trying all byte sequences megabyte in length and selecting the best looking sequence will yield cases to try But a word about quality
static av_cold int libjxl_anim_encode_init(AVCodecContext *avctx)
Initializer for the animation encoder.
AVCodec p
The public AVCodec.
@ AVCOL_TRC_IEC61966_2_1
IEC 61966-2-1 (sRGB or sYCC)
static int libjxl_anim_encode_frame(AVCodecContext *avctx, AVPacket *pkt)
Encode one frame of the animation.
int thread_count
thread count is used to decide how many independent tasks should be passed to execute()
@ AVCOL_TRC_GAMMA28
also ITU-R BT470BG
int flags
AV_CODEC_FLAG_*.
#define AV_PIX_FMT_GRAY16
#define FF_CODEC_ENCODE_CB(func)
@ AVCOL_TRC_GAMMA22
also ITU-R BT470M / ITU-R BT1700 625 PAL & SECAM
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
enum AVColorPrimaries color_primaries
Chromaticity coordinates of the source primaries.
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
int global_quality
Global quality for codecs which cannot change it per frame.
const AVColorPrimariesDesc * av_csp_primaries_desc_from_id(enum AVColorPrimaries prm)
Retrieves a complete gamut description from an enum constant describing the color primaries.
static double av_q2d(AVRational a)
Convert an AVRational to a double.
#define AV_CODEC_CAP_OTHER_THREADS
Codec supports multithreading through a method other than slice- or frame-level multithreading.
#define AV_CODEC_CAP_ENCODER_REORDERED_OPAQUE
This encoder can reorder user opaque values from input AVFrames and return them with corresponding ou...
int bits_per_raw_sample
Bits per sample/pixel of internal libavcodec pixel/sample format.
#define AV_PIX_FMT_RGBF32
#define AV_PIX_FMT_GRAYF32
#define CODEC_LONG_NAME(str)
@ AV_PIX_FMT_RGBA
packed RGBA 8:8:8:8, 32bpp, RGBARGBA...
#define AV_PIX_FMT_RGBA64
#define LIBAVUTIL_VERSION_INT
Describe the class of an AVClass context structure.
enum AVColorRange color_range
MPEG vs JPEG YUV range.
uint8_t nb_components
The number of components each pixel has, (1-4)
#define FF_CODEC_RECEIVE_PACKET_CB(func)
@ AVCOL_PRI_BT709
also ITU-R BT1361 / IEC 61966-2-4 / SMPTE RP 177 Annex B
const char * av_default_item_name(void *ptr)
Return the context name.
@ AV_FRAME_DATA_ICC_PROFILE
The data contains an ICC profile as an opaque octet buffer following the format described by ISO 1507...
static int libjxl_init_jxl_encoder(AVCodecContext *avctx)
Initalize the encoder on a per-file basis.
@ AV_PIX_FMT_GRAY8
Y , 8bpp.
uint64_t flags
Combination of AV_PIX_FMT_FLAG_...
@ AVCOL_RANGE_UNSPECIFIED
@ AVCOL_PRI_BT2020
ITU-R BT2020.
AVRational time_base
This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented.
@ AVCOL_TRC_SMPTE2084
SMPTE ST 2084 for 10-, 12-, 14- and 16-bit systems.
@ AVCOL_PRI_SMPTE431
SMPTE ST 431-2 (2011) / DCI P3.
int(* init)(AVBSFContext *ctx)
@ AV_PIX_FMT_RGB24
packed RGB 8:8:8, 24bpp, RGBRGB...
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() or get_encode_buffer() for allocating buffers and supports custom allocators.
static int libjxl_preprocess_stream(AVCodecContext *avctx, const AVFrame *frame, int animated)
Sends metadata to libjxl based on the first frame of the stream, such as pixel format,...
static int libjxl_encode_frame(AVCodecContext *avctx, AVPacket *pkt, const AVFrame *frame, int *got_packet)
Encode an entire frame.
static int libjxl_preprocess_frame(AVCodecContext *avctx, const AVFrame *frame, const uint8_t **data)
Sends frame information to libjxl on a per-frame basis.
const FFCodec ff_libjxl_encoder
int64_t dts
Decompression timestamp in AVStream->time_base units; the time at which the packet is decompressed.
#define AVERROR_EXTERNAL
Generic error in an external library.
static float quality_to_distance(float quality)
Map a quality setting for -qscale roughly from libjpeg quality numbers to libjxl's butteraugli distan...
@ AVCOL_TRC_BT709
also ITU-R BT1361
@ AV_OPT_TYPE_FLOAT
Underlying C type is float.
static int libjxl_populate_primaries(void *avctx, JxlColorEncoding *jxl_color, enum AVColorPrimaries prm)
Populate a JxlColorEncoding with the given enum AVColorPrimaries.
int64_t pts
Presentation timestamp in AVStream->time_base units; the time at which the decompressed packet will b...
static av_cold int libjxl_encode_init(AVCodecContext *avctx)
Global encoder initialization.
const FFCodec ff_libjxl_anim_encoder
static av_cold int libjxl_encode_close(AVCodecContext *avctx)
void av_frame_move_ref(AVFrame *dst, AVFrame *src)
Move everything contained in src to dst and reset src.
void av_frame_unref(AVFrame *frame)
Unreference all the buffers referenced by frame and reset the frame fields.
const char * name
Name of the codec implementation.
static enum AVPixelFormat libjxl_supported_pixfmts[]
@ AVCOL_RANGE_MPEG
Narrow or limited range content.
#define FF_CODEC_CAP_ICC_PROFILES
Codec supports embedded ICC profiles (AV_FRAME_DATA_ICC_PROFILE).
static const AVClass libjxl_encode_class
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
main external API structure.
@ AVCOL_TRC_ARIB_STD_B67
ARIB STD-B67, known as "Hybrid log-gamma".
static int FUNC() frame_header(CodedBitstreamContext *ctx, RWContext *rw, JPEGRawFrameHeader *current)
int ff_get_encode_buffer(AVCodecContext *avctx, AVPacket *avpkt, int64_t size, int flags)
Get a buffer for a packet.
static const AVOption libjxl_encode_options[]
@ AV_OPT_TYPE_INT
Underlying C type is int.
#define AV_PIX_FMT_RGBAF32
int64_t duration
Duration of the stream, in AV_TIME_BASE fractional seconds.
int ff_encode_get_frame(AVCodecContext *avctx, AVFrame *frame)
Called by encoders to get the next frame for encoding.
#define FF_CODEC_CAP_AUTO_THREADS
Codec handles avctx->thread_count == 0 (auto) internally.
Structure to hold side data for an AVFrame.
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
@ AVCOL_PRI_SMPTE432
SMPTE ST 432-1 (2010) / P3 D65 / Display P3.
This structure stores compressed data.
void ff_libjxl_init_memory_manager(JxlMemoryManager *manager)
Initialize and populate a JxlMemoryManager with av_malloc() and av_free() so libjxl will use these fu...
static float distance(float x, float y, int band)
@ AVCOL_TRC_SMPTE428
SMPTE ST 428-1.
#define FF_QP2LAMBDA
factor to convert from H.263 QP to lambda
void * av_realloc(void *ptr, size_t size)
Allocate, reallocate, or free a block of memory.