Method

VipsImagejxlsave

Declaration [src]

int
vips_jxlsave (
  VipsImage* in,
  const char* filename,
  ...
)

Description [src]

Optional arguments:

  • tier: %gint, decode speed tier
  • distance: %gdouble, maximum encoding error
  • effort: %gint, encoding effort
  • lossless: %gboolean, enables lossless compression
  • Q: %gint, quality setting

Write a VIPS image to a file in JPEG-XL format.

The JPEG-XL loader and saver are experimental features and may change in future libvips versions.

tier sets the overall decode speed the encoder will target. Minimum is 0 (highest quality), and maximum is 4 (lowest quality). Default is 0.

distance sets the target maximum encoding error. Minimum is 0 (highest quality), and maximum is 15 (lowest quality). Default is 1.0 (visually lossless).

As a convenience, you can also use Q to set distance. Q uses approximately the same scale as regular JPEG.

Set lossless to enable lossless compression.

This method is not directly available to language bindings.

Parameters

filename

Type: const char*

File to write to.

The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
...

Type: 

NULL-terminated list of optional named arguments.

Return value

Type: int

0 on success, -1 on error.