Package gov.nih.mipav.model.file

Enum libxl.JxlEncoderFrameSettingId

java.lang.Object
java.lang.Enum<libxl.JxlEncoderFrameSettingId>
gov.nih.mipav.model.file.libxl.JxlEncoderFrameSettingId
All Implemented Interfaces:
Serializable, Comparable<libxl.JxlEncoderFrameSettingId>, java.lang.constant.Constable
Enclosing class:
libxl
static enum libxl.JxlEncoderFrameSettingId extends Enum<libxl.JxlEncoderFrameSettingId>
Id of encoder options for a frame. This includes options such as setting encoding effort/speed or overriding the use of certain coding tools, for this frame. This does not include non-frame related encoder options such as for boxes.

  • Enum Constant Details

    • JXL_ENC_FRAME_SETTING_EFFORT

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_EFFORT
      Sets encoder effort/speed level without affecting decoding speed. Valid values are, from faster to slower speed: 1:lightning 2:thunder 3:falcon 4:cheetah 5:hare 6:wombat 7:squirrel 8:kitten 9:tortoise 10:glacier. Default: squirrel (7).

    • JXL_ENC_FRAME_SETTING_DECODING_SPEED

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_DECODING_SPEED
      Sets the decoding speed tier for the provided options. Minimum is 0 (slowest to decode, best quality/density), and maximum is 4 (fastest to decode, at the cost of some quality/density). Default is 0.

    • JXL_ENC_FRAME_SETTING_RESAMPLING

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_RESAMPLING
      Sets resampling option. If enabled, the image is downsampled before compression, and upsampled to original size in the decoder. Integer option, use -1 for the default behavior (resampling only applied for low quality), 1 for no downsampling (1x1), 2 for 2x2 downsampling, 4 for 4x4 downsampling, 8 for 8x8 downsampling.

    • JXL_ENC_FRAME_SETTING_EXTRA_CHANNEL_RESAMPLING

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_EXTRA_CHANNEL_RESAMPLING
      Similar to ::JXL_ENC_FRAME_SETTING_RESAMPLING, but for extra channels. Integer option, use -1 for the default behavior (depends on encoder implementation), 1 for no downsampling (1x1), 2 for 2x2 downsampling, 4 for 4x4 downsampling, 8 for 8x8 downsampling.

    • JXL_ENC_FRAME_SETTING_ALREADY_DOWNSAMPLED

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_ALREADY_DOWNSAMPLED
      Indicates the frame added with @ref JxlEncoderAddImageFrame is already downsampled by the downsampling factor set with @ref JXL_ENC_FRAME_SETTING_RESAMPLING. The input frame must then be given in the downsampled resolution, not the full image resolution. The downsampled resolution is given by ceil(xsize / resampling), ceil(ysize / resampling) with xsize and ysize the dimensions given in the basic info, and resampling the factor set with ::JXL_ENC_FRAME_SETTING_RESAMPLING. Use 0 to disable, 1 to enable. Default value is 0.

    • JXL_ENC_FRAME_SETTING_PHOTON_NOISE

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_PHOTON_NOISE
      Adds noise to the image emulating photographic film noise, the higher the given number, the grainier the image will be. As an example, a value of 100 gives low noise whereas a value of 3200 gives a lot of noise. The default value is 0.

    • JXL_ENC_FRAME_SETTING_NOISE

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_NOISE
      Enables adaptive noise generation. This setting is not recommended for use, please use ::JXL_ENC_FRAME_SETTING_PHOTON_NOISE instead. Use -1 for the default (encoder chooses), 0 to disable, 1 to enable.

    • JXL_ENC_FRAME_SETTING_DOTS

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_DOTS
      Enables or disables dots generation. Use -1 for the default (encoder chooses), 0 to disable, 1 to enable.

    • JXL_ENC_FRAME_SETTING_PATCHES

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_PATCHES
      Enables or disables patches generation. Use -1 for the default (encoder chooses), 0 to disable, 1 to enable.

    • JXL_ENC_FRAME_SETTING_EPF

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_EPF
      Edge preserving filter level, -1 to 3. Use -1 for the default (encoder chooses), 0 to 3 to set a strength.

    • JXL_ENC_FRAME_SETTING_GABORISH

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_GABORISH
      Enables or disables the gaborish filter. Use -1 for the default (encoder chooses), 0 to disable, 1 to enable.

    • JXL_ENC_FRAME_SETTING_MODULAR

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_MODULAR
      Enables modular encoding. Use -1 for default (encoder chooses), 0 to enforce VarDCT mode (e.g. for photographic images), 1 to enforce modular mode (e.g. for lossless images).

    • JXL_ENC_FRAME_SETTING_KEEP_INVISIBLE

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_KEEP_INVISIBLE
      Enables or disables preserving color of invisible pixels. Use -1 for the default (1 if lossless, 0 if lossy), 0 to disable, 1 to enable.

    • JXL_ENC_FRAME_SETTING_GROUP_ORDER

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_GROUP_ORDER
      Determines the order in which 256x256 regions are stored in the codestream for progressive rendering. Use -1 for the encoder default, 0 for scanline order, 1 for center-first order.

    • JXL_ENC_FRAME_SETTING_GROUP_ORDER_CENTER_X

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_GROUP_ORDER_CENTER_X
      Determines the horizontal position of center for the center-first group order. Use -1 to automatically use the middle of the image, 0..xsize to specifically set it.

    • JXL_ENC_FRAME_SETTING_GROUP_ORDER_CENTER_Y

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_GROUP_ORDER_CENTER_Y
      Determines the center for the center-first group order. Use -1 to automatically use the middle of the image, 0..ysize to specifically set it.

    • JXL_ENC_FRAME_SETTING_RESPONSIVE

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_RESPONSIVE
      Enables or disables progressive encoding for modular mode. Use -1 for the encoder default, 0 to disable, 1 to enable.

    • JXL_ENC_FRAME_SETTING_PROGRESSIVE_AC

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_PROGRESSIVE_AC
      Set the progressive mode for the AC coefficients of VarDCT, using spectral progression from the DCT coefficients. Use -1 for the encoder default, 0 to disable, 1 to enable.

    • JXL_ENC_FRAME_SETTING_QPROGRESSIVE_AC

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_QPROGRESSIVE_AC
      Set the progressive mode for the AC coefficients of VarDCT, using quantization of the least significant bits. Use -1 for the encoder default, 0 to disable, 1 to enable.

    • JXL_ENC_FRAME_SETTING_PROGRESSIVE_DC

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_PROGRESSIVE_DC
      Set the progressive mode using lower-resolution DC images for VarDCT. Use -1 for the encoder default, 0 to disable, 1 to have an extra 64x64 lower resolution pass, 2 to have a 512x512 and 64x64 lower resolution pass.

    • JXL_ENC_FRAME_SETTING_CHANNEL_COLORS_GLOBAL_PERCENT

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_CHANNEL_COLORS_GLOBAL_PERCENT
      Use Global channel palette if the amount of colors is smaller than this percentage of range. Use 0-100 to set an explicit percentage, -1 to use the encoder default. Used for modular encoding.

    • JXL_ENC_FRAME_SETTING_CHANNEL_COLORS_GROUP_PERCENT

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_CHANNEL_COLORS_GROUP_PERCENT
      Use Local (per-group) channel palette if the amount of colors is smaller than this percentage of range. Use 0-100 to set an explicit percentage, -1 to use the encoder default. Used for modular encoding.

    • JXL_ENC_FRAME_SETTING_PALETTE_COLORS

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_PALETTE_COLORS
      Use color palette if amount of colors is smaller than or equal to this amount, or -1 to use the encoder default. Used for modular encoding.

    • JXL_ENC_FRAME_SETTING_LOSSY_PALETTE

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_LOSSY_PALETTE
      Enables or disables delta palette. Use -1 for the default (encoder chooses), 0 to disable, 1 to enable. Used in modular mode.

    • JXL_ENC_FRAME_SETTING_COLOR_TRANSFORM

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_COLOR_TRANSFORM
      Color transform for internal encoding: -1 = default, 0=XYB, 1=none (RGB), 2=YCbCr. The XYB setting performs the forward XYB transform. None and YCbCr both perform no transform, but YCbCr is used to indicate that the encoded data losslessly represents YCbCr values.

    • JXL_ENC_FRAME_SETTING_MODULAR_COLOR_SPACE

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_MODULAR_COLOR_SPACE
      Reversible color transform for modular encoding: -1=default, 0-41=RCT index, e.g. index 0 = none, index 6 = YCoCg. If this option is set to a non-default value, the RCT will be globally applied to the whole frame. The default behavior is to try several RCTs locally per modular group, depending on the speed and distance setting.

    • JXL_ENC_FRAME_SETTING_MODULAR_GROUP_SIZE

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_MODULAR_GROUP_SIZE
      Group size for modular encoding: -1=default, 0=128, 1=256, 2=512, 3=1024.

    • JXL_ENC_FRAME_SETTING_MODULAR_PREDICTOR

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_MODULAR_PREDICTOR
      Predictor for modular encoding. -1 = default, 0=zero, 1=left, 2=top, 3=avg0, 4=select, 5=gradient, 6=weighted, 7=topright, 8=topleft, 9=leftleft, 10=avg1, 11=avg2, 12=avg3, 13=toptop predictive average 14=mix 5 and 6, 15=mix everything.

    • JXL_ENC_FRAME_SETTING_MODULAR_MA_TREE_LEARNING_PERCENT

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_MODULAR_MA_TREE_LEARNING_PERCENT
      Fraction of pixels used to learn MA trees as a percentage. -1 = default, 0 = no MA and fast decode, 50 = default value, 100 = all, values above 100 are also permitted. Higher values use more encoder memory.

    • JXL_ENC_FRAME_SETTING_MODULAR_NB_PREV_CHANNELS

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_MODULAR_NB_PREV_CHANNELS
      Number of extra (previous-channel) MA tree properties to use. -1 = default, 0-11 = valid values. Recommended values are in the range 0 to 3, or 0 to amount of channels minus 1 (including all extra channels, and excluding color channels when using VarDCT mode). Higher value gives slower encoding and slower decoding.

    • JXL_ENC_FRAME_SETTING_JPEG_RECON_CFL

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_JPEG_RECON_CFL
      Enable or disable CFL (chroma-from-luma) for lossless JPEG recompression. -1 = default, 0 = disable CFL, 1 = enable CFL.

    • JXL_ENC_FRAME_INDEX_BOX

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_INDEX_BOX
      Prepare the frame for indexing in the frame index box. 0 = ignore this frame (same as not setting a value), 1 = index this frame within the Frame Index Box. If any frames are indexed, the first frame needs to be indexed, too. If the first frame is not indexed, and a later frame is attempted to be indexed, ::JXL_ENC_ERROR will occur. If non-keyframes, i.e., frames with cropping, blending or patches are attempted to be indexed, ::JXL_ENC_ERROR will occur.

    • JXL_ENC_FRAME_SETTING_BROTLI_EFFORT

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_BROTLI_EFFORT
      Sets brotli encode effort for use in JPEG recompression and compressed metadata boxes (brob). Can be -1 (default) or 0 (fastest) to 11 (slowest). Default is based on the general encode effort in case of JPEG recompression, and 4 for brob boxes.

    • JXL_ENC_FRAME_SETTING_JPEG_COMPRESS_BOXES

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_JPEG_COMPRESS_BOXES
      Enables or disables brotli compression of metadata boxes derived from a JPEG frame when using @ref JxlEncoderAddJPEGFrame. This has no effect on boxes added using @ref JxlEncoderAddBox. -1 = default, 0 = disable compression, 1 = enable compression.

    • JXL_ENC_FRAME_SETTING_BUFFERING

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_BUFFERING
      Control what kind of buffering is used, when using chunked image frames. -1 = default (let the encoder decide) 0 = buffers everything, basically the same as non-streamed code path (mainly for testing) 1 = buffers everything for images that are smaller than 2048 x 2048, and uses streaming input and output for larger images 2 = uses streaming input and output for all images that are larger than one group, i.e. 256 x 256 pixels by default 3 = currently same as 2 When using streaming input and output the encoder minimizes memory usage at the cost of compression density. Also note that images produced with streaming mode might not be progressively decodable.

    • JXL_ENC_FRAME_SETTING_JPEG_KEEP_EXIF

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_JPEG_KEEP_EXIF
      Keep or discard Exif metadata boxes derived from a JPEG frame when using

    • JXL_ENC_FRAME_SETTING_JPEG_KEEP_XMP

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_JPEG_KEEP_XMP
      Keep or discard XMP metadata boxes derived from a JPEG frame when using

    • JXL_ENC_FRAME_SETTING_JPEG_KEEP_JUMBF

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_JPEG_KEEP_JUMBF
      Keep or discard JUMBF metadata boxes derived from a JPEG frame when using

    • JXL_ENC_FRAME_SETTING_USE_FULL_IMAGE_HEURISTICS

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_USE_FULL_IMAGE_HEURISTICS
      If this mode is disabled, the encoder will not make any image quality decisions that are computed based on the full image, but stored only once (e.g. the X quant multiplier in the frame header). Used mainly for testing equivalence of streaming and non-streaming code. 0 = disabled, 1 = enabled (default)

    • JXL_ENC_FRAME_SETTING_DISABLE_PERCEPTUAL_HEURISTICS

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_DISABLE_PERCEPTUAL_HEURISTICS
      Disable perceptual optimizations. 0 = optimizations enabled (default), 1 = optimizations disabled.

    • JXL_ENC_FRAME_SETTING_FILL_ENUM

      public static final libxl.JxlEncoderFrameSettingId JXL_ENC_FRAME_SETTING_FILL_ENUM
      Enum value not to be used as an option. This value is added to force the C compiler to have the enum to take a known size.

  • Field Details

    • numVal

      private final int numVal

  • Constructor Details

    • JxlEncoderFrameSettingId

      private JxlEncoderFrameSettingId(int numVal)

  • Method Details

    • values

      public static libxl.JxlEncoderFrameSettingId[] values()
      Returns an array containing the constants of this enum type, in the order they are declared.
      Returns:
      an array containing the constants of this enum type, in the order they are declared

    • valueOf

      public static libxl.JxlEncoderFrameSettingId valueOf(String name)
      Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum type has no constant with the specified name
      NullPointerException - if the argument is null

    • getNumVal

      public int getNumVal()