OpenEXR decoder. More...

#include <float.h>
#include <zlib.h>
#include "libavutil/imgutils.h"
#include "libavutil/intfloat.h"
#include "libavutil/opt.h"
#include "avcodec.h"
#include "bytestream.h"
#include "get_bits.h"
#include "internal.h"
#include "mathops.h"
#include "thread.h"

Data Structures
struct	EXRChannel

struct	EXRThreadData

struct	EXRContext

struct	HufDec

Macros
#define	HALF_FLOAT_MIN_BIASED_EXP_AS_SINGLE_FP_EXP 0x38000000

#define	HALF_FLOAT_MAX_BIASED_EXP_AS_SINGLE_FP_EXP 0x47800000

#define	FLOAT_MAX_BIASED_EXP (0xFF << 23)

#define	HALF_FLOAT_MAX_BIASED_EXP (0x1F << 10)

#define	USHORT_RANGE (1 << 16)

#define	BITMAP_SIZE (1 << 13)

#define	HUF_ENCBITS 16

#define	HUF_DECBITS 14

#define	HUF_ENCSIZE ((1 << HUF_ENCBITS) + 1)

#define	HUF_DECSIZE (1 << HUF_DECBITS)

#define	HUF_DECMASK (HUF_DECSIZE - 1)

#define	SHORT_ZEROCODE_RUN 59

#define	LONG_ZEROCODE_RUN 63

#define	SHORTEST_LONG_RUN (2 + LONG_ZEROCODE_RUN - SHORT_ZEROCODE_RUN)

#define	LONGEST_LONG_RUN (255 + SHORTEST_LONG_RUN)

#define	get_char(c, lc, gb)

#define	get_code(po, rlc, c, lc, gb, out, oe)

#define	NBITS 16

#define	A_OFFSET (1 << (NBITS - 1))

#define	MOD_MASK ((1 << NBITS) - 1)

#define	OFFSET(x) offsetof(EXRContext, x)

#define	VD AV_OPT_FLAG_VIDEO_PARAM \| AV_OPT_FLAG_DECODING_PARAM

Enumerations
enum	ExrCompr { EXR_RAW, EXR_RLE, EXR_ZIP1, EXR_ZIP16, EXR_PIZ, EXR_PXR24, EXR_B44, EXR_B44A, EXR_UNKN }

enum	ExrPixelType { EXR_UINT, EXR_HALF, EXR_FLOAT, EXR_UNKNOWN }

Functions
static union av_intfloat32	exr_half2float (uint16_t hf)
	Convert a half float as a uint16_t into a full float.

static uint16_t	exr_flt2uint (uint32_t v)
	Convert from 32-bit float as uint32_t to uint16_t.

static uint16_t	exr_halflt2uint (uint16_t v)
	Convert from 16-bit float as uint16_t to uint16_t.

static void	predictor (uint8_t *src, int size)

static void	reorder_pixels (uint8_t src, uint8_t dst, int size)

static int	zip_uncompress (const uint8_t src, int compressed_size, int uncompressed_size, EXRThreadData td)

static int	rle_uncompress (const uint8_t src, int compressed_size, int uncompressed_size, EXRThreadData td)

static uint16_t	reverse_lut (const uint8_t bitmap, uint16_t lut)

static void	apply_lut (const uint16_t lut, uint16_t dst, int dsize)

static void	huf_canonical_code_table (uint64_t *hcode)

static int	huf_unpack_enc_table (GetByteContext gb, int32_t im, int32_t iM, uint64_t hcode)

static int	huf_build_dec_table (const uint64_t hcode, int im, int iM, HufDec hdecod)

static int	huf_decode (const uint64_t hcode, const HufDec hdecod, GetByteContext gb, int nbits, int rlc, int no, uint16_t out)

static int	huf_uncompress (GetByteContext gb, uint16_t dst, int dst_size)

static void	wdec14 (uint16_t l, uint16_t h, uint16_t a, uint16_t b)

static void	wdec16 (uint16_t l, uint16_t h, uint16_t a, uint16_t b)

static void	wav_decode (uint16_t *in, int nx, int ox, int ny, int oy, uint16_t mx)

static int	piz_uncompress (EXRContext s, const uint8_t src, int ssize, int dsize, EXRThreadData *td)

static int	pxr24_uncompress (EXRContext s, const uint8_t src, int compressed_size, int uncompressed_size, EXRThreadData *td)

static int	decode_block (AVCodecContext avctx, void tdata, int jobnr, int threadnr)

static int	check_header_variable (EXRContext s, const char value_name, const char *value_type, unsigned int minimum_length)
	Check if the variable name corresponds to its data type.

static int	decode_header (EXRContext *s)

static int	decode_frame (AVCodecContext avctx, void data, int got_frame, AVPacket avpkt)

static av_cold int	decode_init (AVCodecContext *avctx)

static int	decode_init_thread_copy (AVCodecContext *avctx)

static av_cold int	decode_end (AVCodecContext *avctx)

Variables
static const AVOption	options []

static const AVClass	exr_class

AVCodec	ff_exr_decoder

Detailed Description

OpenEXR decoder.

Author: Jimmy Christensen

For more information on the OpenEXR format, visit: http://openexr.com/

exr_flt2uint() and exr_halflt2uint() is credited to Reimar Döffinger. exr_half2float() is credited to Aaftab Munshi, Dan Ginsburg, Dave Shreiner.

Definition in file exr.c.

Macro Definition Documentation

#define HALF_FLOAT_MIN_BIASED_EXP_AS_SINGLE_FP_EXP 0x38000000

Definition at line 118 of file exr.c.

Referenced by exr_half2float().

#define HALF_FLOAT_MAX_BIASED_EXP_AS_SINGLE_FP_EXP 0x47800000

Definition at line 122 of file exr.c.

#define FLOAT_MAX_BIASED_EXP (0xFF << 23)

Definition at line 125 of file exr.c.

Referenced by exr_half2float().

#define HALF_FLOAT_MAX_BIASED_EXP (0x1F << 10)

Definition at line 127 of file exr.c.

Referenced by exr_half2float().

#define USHORT_RANGE (1 << 16)

Definition at line 312 of file exr.c.

Referenced by reverse_lut().

#define BITMAP_SIZE (1 << 13)

Definition at line 313 of file exr.c.

Referenced by piz_uncompress().

#define HUF_ENCBITS 16

Definition at line 338 of file exr.c.

#define HUF_DECBITS 14

Definition at line 339 of file exr.c.

Referenced by huf_build_dec_table(), and huf_decode().

#define HUF_ENCSIZE ((1 << HUF_ENCBITS) + 1)

Definition at line 341 of file exr.c.

Referenced by huf_canonical_code_table(), and huf_uncompress().

#define HUF_DECSIZE (1 << HUF_DECBITS)

Definition at line 342 of file exr.c.

Referenced by huf_uncompress().

#define HUF_DECMASK (HUF_DECSIZE - 1)

Definition at line 343 of file exr.c.

Referenced by huf_decode().

#define SHORT_ZEROCODE_RUN 59

Definition at line 374 of file exr.c.

Referenced by huf_unpack_enc_table().

#define LONG_ZEROCODE_RUN 63

Definition at line 375 of file exr.c.

Referenced by huf_unpack_enc_table().

#define SHORTEST_LONG_RUN (2 + LONG_ZEROCODE_RUN - SHORT_ZEROCODE_RUN)

Definition at line 376 of file exr.c.

Referenced by huf_unpack_enc_table().

#define LONGEST_LONG_RUN (255 + SHORTEST_LONG_RUN)

Definition at line 377 of file exr.c.

#define get_char	(	c,
		lc,
		gb
	)

Value:

{                                                                             \
        c   = (c << 8) | bytestream2_get_byte(gb);                            \
        lc += 8;                                                              \
}

Definition at line 456 of file exr.c.

Referenced by huf_decode().

#define get_code	(	po,
		rlc,
		c,
		lc,
		gb,
		out,
		oe
	)

Value:

{                                                                             \
        if (po == rlc) {                                                      \
            if (lc < 8)                                                       \
                get_char(c, lc, gb);                                          \
            lc -= 8;                                                          \
                                                                              \
            cs = c >> lc;                                                     \
                                                                              \
            if (out + cs > oe)                                                \
                return AVERROR_INVALIDDATA;                                   \
                                                                              \
            s = out[-1];                                                      \
                                                                              \
            while (cs-- > 0)                                                  \
                *out++ = s;                                                   \
        } else if (out < oe) {                                                \
            *out++ = po;                                                      \
        } else {                                                              \
            return AVERROR_INVALIDDATA;                                       \
        }                                                                     \
}

Definition at line 462 of file exr.c.

Referenced by huf_decode().

#define NBITS 16

Definition at line 617 of file exr.c.

#define A_OFFSET (1 << (NBITS - 1))

Definition at line 618 of file exr.c.

Referenced by wdec16().

#define MOD_MASK ((1 << NBITS) - 1)

Definition at line 619 of file exr.c.

Referenced by wdec16().

#define OFFSET ( x ) offsetof(EXRContext, x)

Definition at line 1422 of file exr.c.

#define VD AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_DECODING_PARAM

Definition at line 1423 of file exr.c.

Enumeration Type Documentation

enum ExrCompr

Enumerator:

EXR_RAW
EXR_RLE
EXR_ZIP1
EXR_ZIP16
EXR_PIZ
EXR_PXR24
EXR_B44
EXR_B44A
EXR_UNKN

Definition at line 48 of file exr.c.

enum ExrPixelType

Enumerator:

EXR_UINT
EXR_HALF
EXR_FLOAT
EXR_UNKNOWN

Definition at line 60 of file exr.c.

Function Documentation

static union av_intfloat32 exr_half2float ( uint16_t hf )

staticwrite

Convert a half float as a uint16_t into a full float.

Parameters

hf	half float as uint16_t

Returns: float value

Definition at line 136 of file exr.c.

Referenced by decode_init().

static uint16_t exr_flt2uint ( uint32_t v )

inlinestatic

Convert from 32-bit float as uint32_t to uint16_t.

Parameters

v	32-bit float

Returns: normalized 16-bit unsigned int

Definition at line 187 of file exr.c.

Referenced by decode_block(), and decode_init().

static uint16_t exr_halflt2uint ( uint16_t v )

inlinestatic

Convert from 16-bit float as uint16_t to uint16_t.

Parameters

v	16-bit float

Returns: normalized 16-bit unsigned int

Definition at line 207 of file exr.c.

Referenced by decode_block(), and decode_init().

static void predictor	(	uint8_t *	src,
		int	size
	)

static

Definition at line 220 of file exr.c.

Referenced by adpcm_compress_trellis(), adpcm_decode_frame(), adpcm_ima_expand_nibble(), adpcm_ima_oki_expand_nibble(), adpcm_ima_qt_expand_nibble(), adpcm_ima_wav_expand_nibble(), adpcm_ms_compress_sample(), adpcm_ms_expand_nibble(), decode_audio_s16(), dpcm_decode_frame(), ff_mjpeg_decode_sos(), ljpeg_decode_rgb_scan(), ljpeg_encode_bgr(), ljpeg_encode_yuv(), rle_uncompress(), tta_decode_frame(), and zip_uncompress().

static void reorder_pixels	(	uint8_t *	src,
		uint8_t *	dst,
		int	size
	)

static

Definition at line 232 of file exr.c.

Referenced by rle_uncompress(), and zip_uncompress().

static int zip_uncompress	(	const uint8_t *	src,
		int	compressed_size,
		int	uncompressed_size,
		EXRThreadData *	td
	)

static

Definition at line 252 of file exr.c.

Referenced by decode_block().

static int rle_uncompress	(	const uint8_t *	src,
		int	compressed_size,
		int	uncompressed_size,
		EXRThreadData *	td
	)

static

Definition at line 267 of file exr.c.

Referenced by decode_block().

static uint16_t reverse_lut	(	const uint8_t *	bitmap,
		uint16_t *	lut
	)

static

Definition at line 315 of file exr.c.

Referenced by piz_uncompress().

static void apply_lut	(	const uint16_t *	lut,
		uint16_t *	dst,
		int	dsize
	)

static

Definition at line 330 of file exr.c.

Referenced by piz_uncompress().

static void huf_canonical_code_table ( uint64_t * hcode )

static

Definition at line 351 of file exr.c.

Referenced by huf_unpack_enc_table().

static int huf_unpack_enc_table	(	GetByteContext *	gb,
		int32_t	im,
		int32_t	iM,
		uint64_t *	hcode
	)

static

Definition at line 379 of file exr.c.

Referenced by huf_uncompress().

static int huf_build_dec_table	(	const uint64_t *	hcode,
		int	im,
		int	iM,
		HufDec *	hdecod
	)

static

Definition at line 419 of file exr.c.

Referenced by huf_uncompress().

static int huf_decode	(	const uint64_t *	hcode,
		const HufDec *	hdecod,
		GetByteContext *	gb,
		int	nbits,
		int	rlc,
		int	no,
		uint16_t *	out
	)

static

Definition at line 485 of file exr.c.

Referenced by huf_uncompress().

static int huf_uncompress	(	GetByteContext *	gb,
		uint16_t *	dst,
		int	dst_size
	)

static

Definition at line 553 of file exr.c.

Referenced by piz_uncompress().

static void wdec14	(	uint16_t	l,
		uint16_t	h,
		uint16_t *	a,
		uint16_t *	b
	)

inlinestatic

Definition at line 604 of file exr.c.

Referenced by wav_decode().

static void wdec16	(	uint16_t	l,
		uint16_t	h,
		uint16_t *	a,
		uint16_t *	b
	)

inlinestatic

Definition at line 621 of file exr.c.

Referenced by wav_decode().

static void wav_decode	(	uint16_t *	in,
		int	nx,
		int	ox,
		int	ny,
		int	oy,
		uint16_t	mx
	)

static

Definition at line 631 of file exr.c.

Referenced by piz_uncompress().

static int piz_uncompress	(	EXRContext *	s,
		const uint8_t *	src,
		int	ssize,
		int	dsize,
		EXRThreadData *	td
	)

static

Definition at line 710 of file exr.c.

Referenced by decode_block().

static int pxr24_uncompress	(	EXRContext *	s,
		const uint8_t *	src,
		int	compressed_size,
		int	uncompressed_size,
		EXRThreadData *	td
	)

static

Definition at line 773 of file exr.c.

Referenced by decode_block().

static int decode_block	(	AVCodecContext *	avctx,
		void *	tdata,
		int	jobnr,
		int	threadnr
	)

static

Definition at line 827 of file exr.c.

Referenced by decode_frame().

static int check_header_variable	(	EXRContext *	s,
		const char *	value_name,
		const char *	value_type,
		unsigned int	minimum_length
	)

static

Check if the variable name corresponds to its data type.

Parameters

s	the EXRContext
value_name	name of the variable to check
value_type	type of the variable to check
minimum_length	minimum length of the variable data

Returns: bytes to read containing variable data -1 if variable is not found 0 if buffer ended prematurely

Definition at line 979 of file exr.c.

Referenced by decode_header().

static int decode_header ( EXRContext * s )

static

Definition at line 1008 of file exr.c.

Referenced by decode_frame().

static int decode_frame	(	AVCodecContext *	avctx,
		void *	data,
		int *	got_frame,
		AVPacket *	avpkt
	)

static

Definition at line 1241 of file exr.c.

static av_cold int decode_init ( AVCodecContext * avctx )

static

Definition at line 1345 of file exr.c.

static int decode_init_thread_copy ( AVCodecContext * avctx )

static

Definition at line 1393 of file exr.c.

static av_cold int decode_end ( AVCodecContext * avctx )

static

Definition at line 1404 of file exr.c.

Variable Documentation

const AVOption options[]

static

Initial value:

= {
    { "layer", "Set the decoding layer", OFFSET(layer),
        AV_OPT_TYPE_STRING, { .str = "" }, 0, 0, VD },
    { "gamma", "Set the float gamma value when decoding", OFFSET(gamma),
        AV_OPT_TYPE_FLOAT, { .dbl = 1.0f }, 0.001, FLT_MAX, VD },
    { NULL },
}

Definition at line 1424 of file exr.c.

const AVClass exr_class

static

Initial value:

= {
    .class_name = "EXR",
    .item_name  = av_default_item_name,
    .option     = options,
    .version    = LIBAVUTIL_VERSION_INT,
}

Definition at line 1432 of file exr.c.

AVCodec ff_exr_decoder

Initial value:

= {
    .name             = "exr",
    .long_name        = NULL_IF_CONFIG_SMALL("OpenEXR image"),
    .type             = AVMEDIA_TYPE_VIDEO,
    .id               = AV_CODEC_ID_EXR,
    .priv_data_size   = sizeof(EXRContext),
    .init             = decode_init,
    .init_thread_copy = ONLY_IF_THREADS_ENABLED(decode_init_thread_copy),
    .close            = decode_end,
    .decode           = decode_frame,
    .capabilities     = CODEC_CAP_DR1 | CODEC_CAP_FRAME_THREADS |
                        CODEC_CAP_SLICE_THREADS,
    .priv_class       = &exr_class,
}

Definition at line 1439 of file exr.c.

Data Structures

Macros

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

Enumeration Type Documentation

Function Documentation

Variable Documentation