FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Data Structures | Macros | Enumerations | Functions | Variables
exr.c File Reference

OpenEXR decoder. More...

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

Go to the source code of this file.

Data Structures

struct  EXRChannel
 
struct  EXRTileAttribute
 
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, outb)
 
#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_DWA, EXR_DWB, EXR_UNKN
}
 
enum  ExrPixelType { EXR_UINT, EXR_HALF, EXR_FLOAT, EXR_UNKNOWN }
 
enum  ExrTileLevelMode { EXR_TILE_LEVEL_ONE, EXR_TILE_LEVEL_MIPMAP, EXR_TILE_LEVEL_RIPMAP, EXR_TILE_LEVEL_UNKNOWN }
 
enum  ExrTileLevelRound { EXR_TILE_ROUND_UP, EXR_TILE_ROUND_DOWN, EXR_TILE_ROUND_UNKNOWN }
 

Functions

static union av_intfloat32 exr_half2float (uint16_t hf)
 Convert a half float as a uint16_t into a full float. More...
 
static uint16_t exr_flt2uint (int32_t v)
 Convert from 32-bit float as uint32_t to uint16_t. More...
 
static uint16_t exr_halflt2uint (uint16_t v)
 Convert from 16-bit float as uint16_t to uint16_t. More...
 
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 void unpack_14 (const uint8_t b[14], uint16_t s[16])
 
static void unpack_3 (const uint8_t b[3], uint16_t s[16])
 
static int b44_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. More...
 
static int decode_header (EXRContext *s, AVFrame *frame)
 
static int decode_frame (AVCodecContext *avctx, void *data, int *got_frame, AVPacket *avpkt)
 
static av_cold int decode_init (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 154 of file exr.c.

Referenced by exr_half2float().

#define HALF_FLOAT_MAX_BIASED_EXP_AS_SINGLE_FP_EXP   0x47800000

Definition at line 158 of file exr.c.

#define FLOAT_MAX_BIASED_EXP   (0xFF << 23)

Definition at line 161 of file exr.c.

Referenced by exr_half2float().

#define HALF_FLOAT_MAX_BIASED_EXP   (0x1F << 10)

Definition at line 163 of file exr.c.

Referenced by exr_half2float().

#define USHORT_RANGE   (1 << 16)

Definition at line 348 of file exr.c.

Referenced by reverse_lut().

#define BITMAP_SIZE   (1 << 13)

Definition at line 349 of file exr.c.

Referenced by piz_uncompress().

#define HUF_ENCBITS   16

Definition at line 374 of file exr.c.

#define HUF_DECBITS   14

Definition at line 375 of file exr.c.

Referenced by huf_build_dec_table(), and huf_decode().

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

Definition at line 377 of file exr.c.

Referenced by huf_canonical_code_table(), and huf_uncompress().

#define HUF_DECSIZE   (1 << HUF_DECBITS)

Definition at line 378 of file exr.c.

Referenced by huf_uncompress().

#define HUF_DECMASK   (HUF_DECSIZE - 1)

Definition at line 379 of file exr.c.

Referenced by huf_decode().

#define SHORT_ZEROCODE_RUN   59

Definition at line 410 of file exr.c.

Referenced by huf_unpack_enc_table().

#define LONG_ZEROCODE_RUN   63

Definition at line 411 of file exr.c.

Referenced by huf_unpack_enc_table().

#define SHORTEST_LONG_RUN   (2 + LONG_ZEROCODE_RUN - SHORT_ZEROCODE_RUN)

Definition at line 412 of file exr.c.

Referenced by huf_unpack_enc_table().

#define LONGEST_LONG_RUN   (255 + SHORTEST_LONG_RUN)

Definition at line 413 of file exr.c.

#define get_char (   c,
  lc,
  gb 
)
Value:
{ \
c = (c << 8) | bytestream2_get_byte(gb); \
lc += 8; \
}
static double c[64]

Definition at line 492 of file exr.c.

Referenced by huf_decode().

#define get_code (   po,
  rlc,
  c,
  lc,
  gb,
  out,
  oe,
  outb 
)
Value:
{ \
if (po == rlc) { \
if (lc < 8) \
get_char(c, lc, gb); \
lc -= 8; \
\
cs = c >> lc; \
if (out + cs > oe || out == outb) \
\
s = out[-1]; \
\
while (cs-- > 0) \
*out++ = s; \
} else if (out < oe) { \
*out++ = po; \
} else { \
} \
}
const char * s
Definition: avisynth_c.h:768
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
#define get_char(c, lc, gb)
Definition: exr.c:492
return
if(ret< 0)
Definition: vf_mcdeint.c:282
static double c[64]
FILE * out
Definition: movenc.c:54

Definition at line 498 of file exr.c.

Referenced by huf_decode().

#define NBITS   16

Definition at line 654 of file exr.c.

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

Definition at line 655 of file exr.c.

Referenced by wdec16().

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

Definition at line 656 of file exr.c.

Referenced by wdec16().

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

Definition at line 1855 of file exr.c.

Definition at line 1856 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_DWA 
EXR_DWB 
EXR_UNKN 

Definition at line 53 of file exr.c.

Enumerator
EXR_UINT 
EXR_HALF 
EXR_FLOAT 
EXR_UNKNOWN 

Definition at line 67 of file exr.c.

Enumerator
EXR_TILE_LEVEL_ONE 
EXR_TILE_LEVEL_MIPMAP 
EXR_TILE_LEVEL_RIPMAP 
EXR_TILE_LEVEL_UNKNOWN 

Definition at line 74 of file exr.c.

Enumerator
EXR_TILE_ROUND_UP 
EXR_TILE_ROUND_DOWN 
EXR_TILE_ROUND_UNKNOWN 

Definition at line 81 of file exr.c.

Function Documentation

static union av_intfloat32 exr_half2float ( uint16_t  hf)
static

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

Parameters
hfhalf float as uint16_t
Returns
float value

Definition at line 172 of file exr.c.

Referenced by decode_init().

static uint16_t exr_flt2uint ( int32_t  v)
inlinestatic

Convert from 32-bit float as uint32_t to uint16_t.

Parameters
v32-bit float
Returns
normalized 16-bit unsigned int

Definition at line 223 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
v16-bit float
Returns
normalized 16-bit unsigned int

Definition at line 243 of file exr.c.

Referenced by decode_block(), and decode_init().

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

Definition at line 268 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 288 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 303 of file exr.c.

Referenced by decode_block().

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

Definition at line 351 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 366 of file exr.c.

Referenced by piz_uncompress().

static void huf_canonical_code_table ( uint64_t *  hcode)
static

Definition at line 387 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 415 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 455 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 521 of file exr.c.

Referenced by huf_uncompress().

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

Definition at line 590 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 641 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 658 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 668 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 747 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 827 of file exr.c.

Referenced by decode_block().

static void unpack_14 ( const uint8_t  b[14],
uint16_t  s[16] 
)
static

Definition at line 911 of file exr.c.

Referenced by b44_uncompress().

static void unpack_3 ( const uint8_t  b[3],
uint16_t  s[16] 
)
static

Definition at line 946 of file exr.c.

Referenced by b44_uncompress().

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

Definition at line 962 of file exr.c.

Referenced by decode_block().

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

Definition at line 1039 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
sthe EXRContext
value_namename of the variable to check
value_typetype of the variable to check
minimum_lengthminimum 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 1286 of file exr.c.

Referenced by decode_header().

static int decode_header ( EXRContext s,
AVFrame frame 
)
static

Definition at line 1315 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 1640 of file exr.c.

static av_cold int decode_init ( AVCodecContext avctx)
static

Definition at line 1781 of file exr.c.

static av_cold int decode_end ( AVCodecContext avctx)
static

Definition at line 1837 of file exr.c.

Variable Documentation

const AVOption options[]
static

Definition at line 1857 of file exr.c.

const AVClass exr_class
static
Initial value:
= {
.class_name = "EXR",
.item_name = av_default_item_name,
.option = options,
}
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
static const AVOption options[]
Definition: exr.c:1857
av_default_item_name

Definition at line 1902 of file exr.c.

AVCodec ff_exr_decoder
Initial value:
= {
.name = "exr",
.long_name = NULL_IF_CONFIG_SMALL("OpenEXR image"),
.priv_data_size = sizeof(EXRContext),
.init_thread_copy = ONLY_IF_THREADS_ENABLED(decode_init_thread_copy),
.close = decode_end,
.decode = decode_frame,
.priv_class = &exr_class,
}
static int init_thread_copy(AVCodecContext *avctx)
Definition: tta.c:392
static av_cold int init(AVCodecContext *avctx)
Definition: avrndec.c:35
static av_cold int decode_init(AVCodecContext *avctx)
Definition: exr.c:1781
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:179
#define AV_CODEC_CAP_FRAME_THREADS
Codec supports frame-level multithreading.
Definition: avcodec.h:1057
#define ONLY_IF_THREADS_ENABLED(x)
Define a function with only the non-default version specified.
Definition: internal.h:218
#define AV_CODEC_CAP_SLICE_THREADS
Codec supports slice-based (or partition-based) multithreading.
Definition: avcodec.h:1061
static av_cold int decode_end(AVCodecContext *avctx)
Definition: exr.c:1837
static int decode_frame(AVCodecContext *avctx, void *data, int *got_frame, AVPacket *avpkt)
Definition: exr.c:1640
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() for allocating buffers and supports custom allocators.
Definition: avcodec.h:994
static const AVClass exr_class
Definition: exr.c:1902

Definition at line 1909 of file exr.c.