2 * JPEG 2000 decoding support via OpenJPEG
3 * Copyright (c) 2009 Jaikrishnan Menon <realityman@gmx.net>
5 * This file is part of Libav.
7 * Libav is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * Libav is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with Libav; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 * JPEG 2000 decoder using libopenjpeg
30 #include "libavutil/common.h"
31 #include "libavutil/imgutils.h"
32 #include "libavutil/intreadwrite.h"
33 #include "libavutil/opt.h"
34 #include "libavutil/pixfmt.h"
40 #define JP2_SIG_TYPE 0x6A502020
41 #define JP2_SIG_VALUE 0x0D0A870A
43 // pix_fmts with lower bpp have to be listed before
44 // similar pix_fmts with higher bpp.
45 #define RGB_PIXEL_FORMATS AV_PIX_FMT_RGB24, AV_PIX_FMT_RGBA, \
46 AV_PIX_FMT_RGB48, AV_PIX_FMT_RGBA64
48 #define GRAY_PIXEL_FORMATS AV_PIX_FMT_GRAY8, AV_PIX_FMT_YA8, \
51 #define YUV_PIXEL_FORMATS AV_PIX_FMT_YUV410P, AV_PIX_FMT_YUV411P, \
52 AV_PIX_FMT_YUVA420P, \
53 AV_PIX_FMT_YUV420P, AV_PIX_FMT_YUV422P, \
54 AV_PIX_FMT_YUV440P, AV_PIX_FMT_YUV444P, \
55 AV_PIX_FMT_YUV420P9, AV_PIX_FMT_YUV422P9, \
56 AV_PIX_FMT_YUV444P9, \
57 AV_PIX_FMT_YUV420P10, AV_PIX_FMT_YUV422P10, \
58 AV_PIX_FMT_YUV444P10, \
59 AV_PIX_FMT_YUV420P16, AV_PIX_FMT_YUV422P16, \
62 #define XYZ_PIXEL_FORMATS AV_PIX_FMT_XYZ12
64 static const enum AVPixelFormat rgb_pix_fmts
[] = {
67 static const enum AVPixelFormat gray_pix_fmts
[] = {
70 static const enum AVPixelFormat yuv_pix_fmts
[] = {
73 static const enum AVPixelFormat any_pix_fmts
[] = {
74 RGB_PIXEL_FORMATS
, GRAY_PIXEL_FORMATS
, YUV_PIXEL_FORMATS
, XYZ_PIXEL_FORMATS
77 typedef struct LibOpenJPEGContext
{
79 opj_dparameters_t dec_params
;
84 static int libopenjpeg_matches_pix_fmt(const opj_image_t
*img
,
85 enum AVPixelFormat pix_fmt
)
87 const AVPixFmtDescriptor
*desc
= av_pix_fmt_desc_get(pix_fmt
);
90 if (desc
->nb_components
!= img
->numcomps
) {
94 switch (desc
->nb_components
) {
97 desc
->comp
[3].depth
>= img
->comps
[3].prec
&&
98 1 == img
->comps
[3].dx
&&
99 1 == img
->comps
[3].dy
;
102 desc
->comp
[2].depth
>= img
->comps
[2].prec
&&
103 1 << desc
->log2_chroma_w
== img
->comps
[2].dx
&&
104 1 << desc
->log2_chroma_h
== img
->comps
[2].dy
;
107 desc
->comp
[1].depth
>= img
->comps
[1].prec
&&
108 1 << desc
->log2_chroma_w
== img
->comps
[1].dx
&&
109 1 << desc
->log2_chroma_h
== img
->comps
[1].dy
;
112 desc
->comp
[0].depth
>= img
->comps
[0].prec
&&
113 1 == img
->comps
[0].dx
&&
114 1 == img
->comps
[0].dy
;
122 static enum AVPixelFormat
libopenjpeg_guess_pix_fmt(const opj_image_t
*image
)
125 const enum AVPixelFormat
*possible_fmts
= NULL
;
126 int possible_fmts_nb
= 0;
128 switch (image
->color_space
) {
130 possible_fmts
= rgb_pix_fmts
;
131 possible_fmts_nb
= FF_ARRAY_ELEMS(rgb_pix_fmts
);
134 possible_fmts
= gray_pix_fmts
;
135 possible_fmts_nb
= FF_ARRAY_ELEMS(gray_pix_fmts
);
138 possible_fmts
= yuv_pix_fmts
;
139 possible_fmts_nb
= FF_ARRAY_ELEMS(yuv_pix_fmts
);
142 possible_fmts
= any_pix_fmts
;
143 possible_fmts_nb
= FF_ARRAY_ELEMS(any_pix_fmts
);
147 for (index
= 0; index
< possible_fmts_nb
; ++index
)
148 if (libopenjpeg_matches_pix_fmt(image
, possible_fmts
[index
])) {
149 return possible_fmts
[index
];
152 return AV_PIX_FMT_NONE
;
155 static inline int libopenjpeg_ispacked(enum AVPixelFormat pix_fmt
)
157 const AVPixFmtDescriptor
*desc
= av_pix_fmt_desc_get(pix_fmt
);
158 int i
, component_plane
;
160 if (pix_fmt
== AV_PIX_FMT_GRAY16
)
163 component_plane
= desc
->comp
[0].plane
;
164 for (i
= 1; i
< desc
->nb_components
; i
++)
165 if (component_plane
!= desc
->comp
[i
].plane
)
170 static void libopenjpeg_copy_to_packed8(AVFrame
*picture
, opj_image_t
*image
)
175 for (y
= 0; y
< picture
->height
; y
++) {
176 index
= y
* picture
->width
;
177 img_ptr
= picture
->data
[0] + y
* picture
->linesize
[0];
178 for (x
= 0; x
< picture
->width
; x
++, index
++)
179 for (c
= 0; c
< image
->numcomps
; c
++)
180 *img_ptr
++ = image
->comps
[c
].data
[index
];
184 static void libopenjpeg_copy_to_packed16(AVFrame
*picture
, opj_image_t
*image
)
190 for (x
= 0; x
< image
->numcomps
; x
++)
191 adjust
[x
] = FFMAX(FFMIN(16 - image
->comps
[x
].prec
, 8), 0);
193 for (y
= 0; y
< picture
->height
; y
++) {
194 index
= y
* picture
->width
;
195 img_ptr
= (uint16_t *) (picture
->data
[0] + y
* picture
->linesize
[0]);
196 for (x
= 0; x
< picture
->width
; x
++, index
++)
197 for (c
= 0; c
< image
->numcomps
; c
++)
198 *img_ptr
++ = image
->comps
[c
].data
[index
] << adjust
[c
];
202 static void libopenjpeg_copyto8(AVFrame
*picture
, opj_image_t
*image
)
208 for (index
= 0; index
< image
->numcomps
; index
++) {
209 comp_data
= image
->comps
[index
].data
;
210 for (y
= 0; y
< image
->comps
[index
].h
; y
++) {
211 img_ptr
= picture
->data
[index
] + y
* picture
->linesize
[index
];
212 for (x
= 0; x
< image
->comps
[index
].w
; x
++) {
213 *img_ptr
= (uint8_t) *comp_data
;
221 static void libopenjpeg_copyto16(AVFrame
*p
, opj_image_t
*image
)
227 for (index
= 0; index
< image
->numcomps
; index
++) {
228 comp_data
= image
->comps
[index
].data
;
229 for (y
= 0; y
< image
->comps
[index
].h
; y
++) {
230 img_ptr
= (uint16_t *)(p
->data
[index
] + y
* p
->linesize
[index
]);
231 for (x
= 0; x
< image
->comps
[index
].w
; x
++) {
232 *img_ptr
= *comp_data
;
240 static av_cold
int libopenjpeg_decode_init(AVCodecContext
*avctx
)
242 LibOpenJPEGContext
*ctx
= avctx
->priv_data
;
244 opj_set_default_decoder_parameters(&ctx
->dec_params
);
248 static int libopenjpeg_decode_frame(AVCodecContext
*avctx
,
249 void *data
, int *got_frame
,
252 uint8_t *buf
= avpkt
->data
;
253 int buf_size
= avpkt
->size
;
254 LibOpenJPEGContext
*ctx
= avctx
->priv_data
;
255 ThreadFrame frame
= { .f
= data
};
256 AVFrame
*picture
= data
;
257 const AVPixFmtDescriptor
*desc
;
261 int width
, height
, ret
;
268 // Check if input is a raw jpeg2k codestream or in jp2 wrapping
269 if ((AV_RB32(buf
) == 12) &&
270 (AV_RB32(buf
+ 4) == JP2_SIG_TYPE
) &&
271 (AV_RB32(buf
+ 8) == JP2_SIG_VALUE
)) {
272 dec
= opj_create_decompress(CODEC_JP2
);
274 /* If the AVPacket contains a jp2c box, then skip to
275 * the starting byte of the codestream. */
276 if (AV_RB32(buf
+ 4) == AV_RB32("jp2c"))
278 dec
= opj_create_decompress(CODEC_J2K
);
282 av_log(avctx
, AV_LOG_ERROR
, "Error initializing decoder.\n");
283 return AVERROR_UNKNOWN
;
285 opj_set_event_mgr((opj_common_ptr
) dec
, NULL
, NULL
);
287 ctx
->dec_params
.cp_limit_decoding
= LIMIT_TO_MAIN_HEADER
;
288 ctx
->dec_params
.cp_reduce
= ctx
->lowres
;
289 ctx
->dec_params
.cp_layer
= ctx
->lowqual
;
290 // Tie decoder with decoding parameters
291 opj_setup_decoder(dec
, &ctx
->dec_params
);
292 stream
= opj_cio_open((opj_common_ptr
) dec
, buf
, buf_size
);
295 av_log(avctx
, AV_LOG_ERROR
,
296 "Codestream could not be opened for reading.\n");
297 opj_destroy_decompress(dec
);
298 return AVERROR_UNKNOWN
;
301 // Decode the header only.
302 image
= opj_decode_with_info(dec
, stream
, NULL
);
303 opj_cio_close(stream
);
306 av_log(avctx
, AV_LOG_ERROR
, "Error decoding codestream.\n");
307 opj_destroy_decompress(dec
);
308 return AVERROR_UNKNOWN
;
311 width
= image
->x1
- image
->x0
;
312 height
= image
->y1
- image
->y0
;
315 width
= (width
+ (1 << ctx
->lowres
) - 1) >> ctx
->lowres
;
316 height
= (height
+ (1 << ctx
->lowres
) - 1) >> ctx
->lowres
;
319 ret
= ff_set_dimensions(avctx
, width
, height
);
323 if (avctx
->pix_fmt
!= AV_PIX_FMT_NONE
)
324 if (!libopenjpeg_matches_pix_fmt(image
, avctx
->pix_fmt
))
325 avctx
->pix_fmt
= AV_PIX_FMT_NONE
;
327 if (avctx
->pix_fmt
== AV_PIX_FMT_NONE
)
328 avctx
->pix_fmt
= libopenjpeg_guess_pix_fmt(image
);
330 if (avctx
->pix_fmt
== AV_PIX_FMT_NONE
) {
331 av_log(avctx
, AV_LOG_ERROR
, "Unable to determine pixel format\n");
332 ret
= AVERROR_INVALIDDATA
;
336 for (i
= 0; i
< image
->numcomps
; i
++)
337 if (image
->comps
[i
].prec
> avctx
->bits_per_raw_sample
)
338 avctx
->bits_per_raw_sample
= image
->comps
[i
].prec
;
340 if ((ret
= ff_thread_get_buffer(avctx
, &frame
, 0)) < 0) {
341 av_log(avctx
, AV_LOG_ERROR
, "ff_thread_get_buffer() failed\n");
345 ctx
->dec_params
.cp_limit_decoding
= NO_LIMITATION
;
346 // Tie decoder with decoding parameters.
347 opj_setup_decoder(dec
, &ctx
->dec_params
);
348 stream
= opj_cio_open((opj_common_ptr
) dec
, buf
, buf_size
);
350 av_log(avctx
, AV_LOG_ERROR
,
351 "Codestream could not be opened for reading.\n");
352 ret
= AVERROR_UNKNOWN
;
356 opj_image_destroy(image
);
357 // Decode the codestream
358 image
= opj_decode_with_info(dec
, stream
, NULL
);
359 opj_cio_close(stream
);
362 av_log(avctx
, AV_LOG_ERROR
, "Error decoding codestream.\n");
363 ret
= AVERROR_UNKNOWN
;
367 desc
= av_pix_fmt_desc_get(avctx
->pix_fmt
);
368 pixel_size
= desc
->comp
[0].step
;
369 ispacked
= libopenjpeg_ispacked(avctx
->pix_fmt
);
371 switch (pixel_size
) {
374 libopenjpeg_copy_to_packed8(picture
, image
);
376 libopenjpeg_copyto8(picture
, image
);
381 libopenjpeg_copy_to_packed8(picture
, image
);
383 libopenjpeg_copyto16(picture
, image
);
389 libopenjpeg_copy_to_packed8(picture
, image
);
395 libopenjpeg_copy_to_packed16(picture
, image
);
399 avpriv_report_missing_feature(avctx
, "Pixel size %d", pixel_size
);
400 ret
= AVERROR_PATCHWELCOME
;
408 opj_image_destroy(image
);
409 opj_destroy_decompress(dec
);
413 #define OFFSET(x) offsetof(LibOpenJPEGContext, x)
414 #define VD AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_DECODING_PARAM
416 static const AVOption options
[] = {
417 { "lowqual", "Limit the number of layers used for decoding",
418 OFFSET(lowqual
), AV_OPT_TYPE_INT
, { .i64
= 0 }, 0, INT_MAX
, VD
},
419 { "lowres", "Lower the decoding resolution by a power of two",
420 OFFSET(lowres
), AV_OPT_TYPE_INT
, { .i64
= 0 }, 0, INT_MAX
, VD
},
424 static const AVClass
class = {
425 .class_name
= "libopenjpeg",
426 .item_name
= av_default_item_name
,
428 .version
= LIBAVUTIL_VERSION_INT
,
431 AVCodec ff_libopenjpeg_decoder
= {
432 .name
= "libopenjpeg",
433 .long_name
= NULL_IF_CONFIG_SMALL("OpenJPEG JPEG 2000"),
434 .type
= AVMEDIA_TYPE_VIDEO
,
435 .id
= AV_CODEC_ID_JPEG2000
,
436 .priv_data_size
= sizeof(LibOpenJPEGContext
),
437 .init
= libopenjpeg_decode_init
,
438 .decode
= libopenjpeg_decode_frame
,
439 .capabilities
= AV_CODEC_CAP_DR1
| AV_CODEC_CAP_FRAME_THREADS
,
440 .priv_class
= &class,
441 .wrapper_name
= "libopenjpeg",