2 * Copyright (c) 2002-2007, Communications and Remote Sensing Laboratory, Universite catholique de Louvain (UCL), Belgium
3 * Copyright (c) 2002-2007, Professor Benoit Macq
4 * Copyright (c) 2001-2003, David Janssens
5 * Copyright (c) 2002-2003, Yannick Verschueren
6 * Copyright (c) 2003-2007, Francois-Olivier Devaux and Antonin Descampe
7 * Copyright (c) 2005, Herve Drolon, FreeImage Team
8 * Copyright (c) 2006-2007, Parvatha Elangovan
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS'
21 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
24 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30 * POSSIBILITY OF SUCH DAMAGE.
32 #include "opj_config.h"
40 #include "windirent.h"
49 #define _stricmp strcasecmp
50 #define _strnicmp strncasecmp
54 #include "opj_getopt.h"
66 #include "format_defs.h"
68 typedef struct dircnt{
69 /** Buffer for holding images read from Directory*/
71 /** Pointer to the buffer*/
76 typedef struct img_folder{
77 /** The directory path of the folder containing input images*/
80 const char *out_format;
83 /** Enable Cod Format for output*/
88 /* -------------------------------------------------------------------------- */
90 int get_num_images(char *imgdirpath);
91 int load_images(dircnt_t *dirptr, char *imgdirpath);
92 int get_file_format(char *filename);
93 char get_next_file(int imageno,dircnt_t *dirptr,img_fol_t *img_fol, opj_dparameters_t *parameters);
95 int parse_cmdline_decoder(int argc, char **argv, opj_dparameters_t *parameters,img_fol_t *img_fol, char *indexfilename);
96 int parse_DA_values( char* inArg, unsigned int *DA_x0, unsigned int *DA_y0, unsigned int *DA_x1, unsigned int *DA_y1);
98 /* -------------------------------------------------------------------------- */
99 void decode_help_display(void) {
100 fprintf(stdout,"HELP for j2k_to_image\n----\n\n");
101 fprintf(stdout,"- the -h option displays this help information on screen\n\n");
104 fprintf(stdout,"List of parameters for the JPEG 2000 "
107 #endif /* USE_JPWL */
110 fprintf(stdout,"\n");
111 fprintf(stdout,"\n");
112 fprintf(stdout," -ImgDir \n");
113 fprintf(stdout," Image file Directory path \n");
114 fprintf(stdout," -OutFor \n");
115 fprintf(stdout," REQUIRED only if -ImgDir is used\n");
116 fprintf(stdout," Need to specify only format without filename <BMP> \n");
117 fprintf(stdout," Currently accepts PGM, PPM, PNM, PGX, PNG, BMP, TIF, RAW and TGA formats\n");
118 fprintf(stdout," -i <compressed file>\n");
119 fprintf(stdout," REQUIRED only if an Input image directory not specified\n");
120 fprintf(stdout," Currently accepts J2K-files, JP2-files and JPT-files. The file type\n");
121 fprintf(stdout," is identified based on its suffix.\n");
122 fprintf(stdout," -o <decompressed file>\n");
123 fprintf(stdout," REQUIRED\n");
124 fprintf(stdout," Currently accepts PGM, PPM, PNM, PGX, PNG, BMP, TIF, RAW and TGA files\n");
125 fprintf(stdout," Binary data is written to the file (not ascii). If a PGX\n");
126 fprintf(stdout," filename is given, there will be as many output files as there are\n");
127 fprintf(stdout," components: an indice starting from 0 will then be appended to the\n");
128 fprintf(stdout," output filename, just before the \"pgx\" extension. If a PGM filename\n");
129 fprintf(stdout," is given and there are more than one component, only the first component\n");
130 fprintf(stdout," will be written to the file.\n");
131 fprintf(stdout," -r <reduce factor>\n");
132 fprintf(stdout," Set the number of highest resolution levels to be discarded. The\n");
133 fprintf(stdout," image resolution is effectively divided by 2 to the power of the\n");
134 fprintf(stdout," number of discarded levels. The reduce factor is limited by the\n");
135 fprintf(stdout," smallest total number of decomposition levels among tiles.\n");
136 fprintf(stdout," -l <number of quality layers to decode>\n");
137 fprintf(stdout," Set the maximum number of quality layers to decode. If there are\n");
138 fprintf(stdout," less quality layers than the specified number, all the quality layers\n");
139 fprintf(stdout," are decoded.\n");
140 fprintf(stdout," -x \n");
141 fprintf(stdout," Create an index file *.Idx (-x index_name.Idx) \n");
142 fprintf(stdout,"\n");
145 fprintf(stdout," -W <options>\n");
146 fprintf(stdout," Activates the JPWL correction capability, if the codestream complies.\n");
147 fprintf(stdout," Options can be a comma separated list of <param=val> tokens:\n");
148 fprintf(stdout," c, c=numcomps\n");
149 fprintf(stdout," numcomps is the number of expected components in the codestream\n");
150 fprintf(stdout," (search of first EPB rely upon this, default is %d)\n", JPWL_EXPECTED_COMPONENTS);
151 #endif /* USE_JPWL */
153 fprintf(stdout,"\n");
156 /* -------------------------------------------------------------------------- */
158 int get_num_images(char *imgdirpath){
160 struct dirent* content;
163 /*Reading the input images from given input directory*/
165 dir= opendir(imgdirpath);
167 fprintf(stderr,"Could not open Folder %s\n",imgdirpath);
171 while((content=readdir(dir))!=NULL){
172 if(strcmp(".",content->d_name)==0 || strcmp("..",content->d_name)==0 )
179 /* -------------------------------------------------------------------------- */
180 int load_images(dircnt_t *dirptr, char *imgdirpath){
182 struct dirent* content;
185 /*Reading the input images from given input directory*/
187 dir= opendir(imgdirpath);
189 fprintf(stderr,"Could not open Folder %s\n",imgdirpath);
192 fprintf(stderr,"Folder opened successfully\n");
195 while((content=readdir(dir))!=NULL){
196 if(strcmp(".",content->d_name)==0 || strcmp("..",content->d_name)==0 )
199 strcpy(dirptr->filename[i],content->d_name);
205 /* -------------------------------------------------------------------------- */
206 int get_file_format(char *filename) {
208 static const char *extension[] = {"pgx", "pnm", "pgm", "ppm", "bmp","tif", "raw", "tga", "png", "j2k", "jp2", "jpt", "j2c", "jpc" };
209 static const int format[] = { PGX_DFMT, PXM_DFMT, PXM_DFMT, PXM_DFMT, BMP_DFMT, TIF_DFMT, RAW_DFMT, TGA_DFMT, PNG_DFMT, J2K_CFMT, JP2_CFMT, JPT_CFMT, J2K_CFMT, J2K_CFMT };
210 char * ext = strrchr(filename, '.');
215 for(i = 0; i < sizeof(format)/sizeof(*format); i++) {
216 if(_strnicmp(ext, extension[i], 3) == 0) {
225 /* -------------------------------------------------------------------------- */
226 char get_next_file(int imageno,dircnt_t *dirptr,img_fol_t *img_fol, opj_dparameters_t *parameters){
227 char image_filename[OPJ_PATH_LEN], infilename[OPJ_PATH_LEN],outfilename[OPJ_PATH_LEN],temp_ofname[OPJ_PATH_LEN];
228 char *temp_p, temp1[OPJ_PATH_LEN]="";
230 strcpy(image_filename,dirptr->filename[imageno]);
231 fprintf(stderr,"File Number %d \"%s\"\n",imageno,image_filename);
232 parameters->decod_format = get_file_format(image_filename);
233 if (parameters->decod_format == -1)
235 sprintf(infilename,"%s/%s",img_fol->imgdirpath,image_filename);
236 strncpy(parameters->infile, infilename, sizeof(infilename));
239 strcpy(temp_ofname,strtok(image_filename,"."));
240 while((temp_p = strtok(NULL,".")) != NULL){
241 strcat(temp_ofname,temp1);
242 sprintf(temp1,".%s",temp_p);
244 if(img_fol->set_out_format==1){
245 sprintf(outfilename,"%s/%s.%s",img_fol->imgdirpath,temp_ofname,img_fol->out_format);
246 strncpy(parameters->outfile, outfilename, sizeof(outfilename));
251 /* -------------------------------------------------------------------------- */
253 * Parse the command line
255 /* -------------------------------------------------------------------------- */
256 int parse_cmdline_decoder(int argc, char **argv, opj_dparameters_t *parameters,img_fol_t *img_fol, char *indexfilename) {
257 /* parse the command line */
259 opj_option_t long_option[]={
260 {"ImgDir",REQ_ARG, NULL ,'y'},
261 {"OutFor",REQ_ARG, NULL ,'O'},
264 const char optlist[] = "i:o:r:l:x:"
269 #endif /* USE_JPWL */
272 totlen=sizeof(long_option);
273 img_fol->set_out_format = 0;
275 c = opj_getopt_long(argc, argv,optlist,long_option,totlen);
279 case 'i': /* input file */
281 char *infile = opj_optarg;
282 parameters->decod_format = get_file_format(infile);
283 switch(parameters->decod_format) {
292 "!! Unrecognized format for infile : %s [accept only *.j2k, *.jp2, *.jpc or *.jpt] !!\n\n",
296 strncpy(parameters->infile, infile, sizeof(parameters->infile)-1);
300 /* ----------------------------------------------------- */
302 case 'o': /* output file */
304 char *outfile = opj_optarg;
305 parameters->cod_format = get_file_format(outfile);
306 switch(parameters->cod_format) {
322 fprintf(stderr, "Unknown output format image %s [only *.pnm, *.pgm, *.ppm, *.pgx, *.bmp, *.tif, *.raw or *.tga]!! \n", outfile);
325 strncpy(parameters->outfile, outfile, sizeof(parameters->outfile)-1);
329 /* ----------------------------------------------------- */
331 case 'O': /* output format */
334 char *of = opj_optarg;
335 sprintf(outformat,".%s",of);
336 img_fol->set_out_format = 1;
337 parameters->cod_format = get_file_format(outformat);
338 switch(parameters->cod_format) {
340 img_fol->out_format = "pgx";
343 img_fol->out_format = "ppm";
346 img_fol->out_format = "bmp";
349 img_fol->out_format = "tif";
352 img_fol->out_format = "raw";
355 img_fol->out_format = "raw";
358 img_fol->out_format = "png";
361 fprintf(stderr, "Unknown output format image %s [only *.pnm, *.pgm, *.ppm, *.pgx, *.bmp, *.tif, *.raw or *.tga]!! \n", outformat);
368 /* ----------------------------------------------------- */
371 case 'r': /* reduce option */
373 sscanf(opj_optarg, "%d", ¶meters->cp_reduce);
377 /* ----------------------------------------------------- */
380 case 'l': /* layering option */
382 sscanf(opj_optarg, "%d", ¶meters->cp_layer);
386 /* ----------------------------------------------------- */
388 case 'h': /* display an help description */
389 decode_help_display();
392 /* ------------------------------------------------------ */
394 case 'y': /* Image Directory path */
396 img_fol->imgdirpath = (char*)malloc(strlen(opj_optarg) + 1);
397 strcpy(img_fol->imgdirpath,opj_optarg);
398 img_fol->set_imgdir=1;
401 /* ----------------------------------------------------- */
402 case 'x': /* Creation of index file */
404 char *index = opj_optarg;
405 strncpy(indexfilename, index, OPJ_PATH_LEN);
408 /* ----------------------------------------------------- */
412 case 'W': /* activate JPWL correction */
416 token = strtok(opj_optarg, ",");
417 while(token != NULL) {
419 /* search expected number of components */
424 compno = JPWL_EXPECTED_COMPONENTS; /* predefined no. of components */
426 if(sscanf(token, "c=%d", &compno) == 1) {
428 if ((compno < 1) || (compno > 256)) {
429 fprintf(stderr, "ERROR -> invalid number of components c = %d\n", compno);
432 parameters->jpwl_exp_comps = compno;
434 } else if (!strcmp(token, "c")) {
436 parameters->jpwl_exp_comps = compno; /* auto for default size */
439 fprintf(stderr, "ERROR -> invalid components specified = %s\n", token);
444 /* search maximum number of tiles */
449 tileno = JPWL_MAXIMUM_TILES; /* maximum no. of tiles */
451 if(sscanf(token, "t=%d", &tileno) == 1) {
453 if ((tileno < 1) || (tileno > JPWL_MAXIMUM_TILES)) {
454 fprintf(stderr, "ERROR -> invalid number of tiles t = %d\n", tileno);
457 parameters->jpwl_max_tiles = tileno;
459 } else if (!strcmp(token, "t")) {
461 parameters->jpwl_max_tiles = tileno; /* auto for default size */
464 fprintf(stderr, "ERROR -> invalid tiles specified = %s\n", token);
469 /* next token or bust */
470 token = strtok(NULL, ",");
472 parameters->jpwl_correct = OPJ_TRUE;
473 fprintf(stdout, "JPWL correction capability activated\n");
474 fprintf(stdout, "- expecting %d components\n", parameters->jpwl_exp_comps);
477 #endif /* USE_JPWL */
480 /* ----------------------------------------------------- */
483 fprintf(stderr,"WARNING -> this option is not valid \"-%c %s\"\n",c, opj_optarg);
488 /* check for possible errors */
489 if(img_fol->set_imgdir==1){
490 if(!(parameters->infile[0]==0)){
491 fprintf(stderr, "Error: options -ImgDir and -i cannot be used together !!\n");
494 if(img_fol->set_out_format == 0){
495 fprintf(stderr, "Error: When -ImgDir is used, -OutFor <FORMAT> must be used !!\n");
496 fprintf(stderr, "Only one format allowed! Valid format PGM, PPM, PNM, PGX, BMP, TIF, RAW and TGA!!\n");
499 if(!((parameters->outfile[0] == 0))){
500 fprintf(stderr, "Error: options -ImgDir and -o cannot be used together !!\n");
504 if((parameters->infile[0] == 0) || (parameters->outfile[0] == 0)) {
505 fprintf(stderr, "Example: %s -i image.j2k -o image.pgm\n",argv[0]);
506 fprintf(stderr, " Try: %s -h\n",argv[0]);
514 /* -------------------------------------------------------------------------- */
516 * Parse decoding area input values
519 /* -------------------------------------------------------------------------- */
520 int parse_DA_values( char* inArg, unsigned int *DA_x0, unsigned int *DA_y0, unsigned int *DA_x1, unsigned int *DA_y1)
526 result = strtok( inArg, delims );
528 while( (result != NULL) && (it < 4 ) ) {
529 values[it] = atoi(result);
530 result = strtok( NULL, delims );
538 *DA_x0 = values[0]; *DA_y0 = values[1];
539 *DA_x1 = values[2]; *DA_y1 = values[3];
544 /* -------------------------------------------------------------------------- */
547 sample error callback expecting a FILE* client object
549 void error_callback(const char *msg, void *client_data) {
550 FILE *stream = (FILE*)client_data;
551 fprintf(stream, "[ERROR] %s", msg);
554 sample warning callback expecting a FILE* client object
556 void warning_callback(const char *msg, void *client_data) {
557 FILE *stream = (FILE*)client_data;
558 fprintf(stream, "[WARNING] %s", msg);
561 sample debug callback expecting no client object
563 void info_callback(const char *msg, void *client_data) {
565 fprintf(stdout, "[INFO] %s", msg);
568 /* -------------------------------------------------------------------------- */
572 /* -------------------------------------------------------------------------- */
573 int main(int argc, char **argv)
577 opj_dparameters_t parameters; /* decompression parameters */
578 opj_event_mgr_t event_mgr; /* event manager */
579 opj_image_t* image = NULL;
580 opj_stream_t *cio = NULL; /* Stream */
581 opj_codec_t* dinfo = NULL; /* Handle to a decompressor */
582 opj_codestream_index_t* cstr_index = NULL;
584 char indexfilename[OPJ_PATH_LEN]; /* index file name */
586 OPJ_INT32 num_images, imageno;
588 dircnt_t *dirptr = NULL;
590 /* configure the event callbacks (not required) */
591 memset(&event_mgr, 0, sizeof(opj_event_mgr_t));
592 event_mgr.error_handler = error_callback;
593 event_mgr.warning_handler = warning_callback;
594 event_mgr.info_handler = info_callback;
596 /* set decoding parameters to default values */
597 opj_set_default_decoder_parameters(¶meters);
599 /* FIXME Initialize indexfilename and img_fol */
602 /* Initialize img_fol */
603 memset(&img_fol,0,sizeof(img_fol_t));
605 /* parse input and get user encoding parameters */
606 if(parse_cmdline_decoder(argc, argv, ¶meters,&img_fol, indexfilename) == 1) {
610 /* Set default event mgr */
611 opj_initialize_default_event_handler(&event_mgr, 1);
613 /* Initialize reading of directory */
614 if(img_fol.set_imgdir==1){
616 num_images=get_num_images(img_fol.imgdirpath);
618 dirptr=(dircnt_t*)malloc(sizeof(dircnt_t));
620 dirptr->filename_buf = (char*)malloc(num_images*OPJ_PATH_LEN*sizeof(char)); /* Stores at max 10 image file names */
621 dirptr->filename = (char**) malloc(num_images*sizeof(char*));
623 if(!dirptr->filename_buf){
626 for(it_image=0;it_image<num_images;it_image++){
627 dirptr->filename[it_image] = dirptr->filename_buf + it_image*OPJ_PATH_LEN;
630 if(load_images(dirptr,img_fol.imgdirpath)==1){
634 fprintf(stdout,"Folder is empty\n");
641 /*Decoding image one by one*/
642 for(imageno = 0; imageno < num_images ; imageno++) {
644 fprintf(stderr,"\n");
646 if(img_fol.set_imgdir==1){
647 if (get_next_file(imageno, dirptr,&img_fol, ¶meters)) {
648 fprintf(stderr,"skipping file...\n");
653 /* read the input file and put it in memory */
654 /* ---------------------------------------- */
655 fsrc = fopen(parameters.infile, "rb");
657 fprintf(stderr, "ERROR -> failed to open %s for reading\n", parameters.infile);
661 cio = opj_stream_create_default_file_stream(fsrc,1);
664 fprintf(stderr, "ERROR -> failed to create the stream from the file\n");
668 /* decode the JPEG2000 stream */
669 /* ---------------------- */
671 switch(parameters.decod_format) {
672 case J2K_CFMT: /* JPEG-2000 codestream */
674 /* Get a decoder handle */
675 dinfo = opj_create_decompress_v2(CODEC_J2K);
678 case JP2_CFMT: /* JPEG 2000 compressed image data */
680 /* Get a decoder handle */
681 dinfo = opj_create_decompress_v2(CODEC_JP2);
684 case JPT_CFMT: /* JPEG 2000, JPIP */
686 /* Get a decoder handle */
687 dinfo = opj_create_decompress_v2(CODEC_JPT);
691 fprintf(stderr, "skipping file..\n");
692 opj_stream_destroy(cio);
696 /* Setup the decoder decoding parameters using user parameters */
697 if ( !opj_setup_decoder_v2(dinfo, ¶meters, &event_mgr) ){
698 fprintf(stderr, "ERROR -> j2k_dump: failed to setup the decoder\n");
699 opj_stream_destroy(cio);
701 opj_destroy_codec(dinfo);
706 /* Read the main header of the codestream and if necessary the JP2 boxes*/
707 if(! opj_read_header(cio, dinfo, &image)){
708 fprintf(stderr, "ERROR -> j2k_dump: failed to read the header\n");
709 opj_stream_destroy(cio);
711 opj_destroy_codec(dinfo);
715 /* Get the decoded image */
716 if ( !( opj_decode_v2(dinfo, cio, image) && opj_end_decompress(dinfo,cio) ) ) {
717 fprintf(stderr, "ERROR -> j2k_to_image: failed to decode image!\n");
718 opj_destroy_codec(dinfo);
719 opj_stream_destroy(cio);
724 opj_dump_codec(dinfo, OPJ_J2K_MH_IND, stdout );
726 cstr_index = opj_get_cstr_index(dinfo);
728 /* Close the byte stream */
729 opj_stream_destroy(cio);
733 if(image->color_space == CLRSPC_SYCC){
734 color_sycc_to_rgb(image); /* FIXME */
737 if(image->icc_profile_buf) {
738 #if defined(HAVE_LIBLCMS1) || defined(HAVE_LIBLCMS2)
739 color_apply_icc_profile(image); /* FIXME */
741 free(image->icc_profile_buf);
742 image->icc_profile_buf = NULL; image->icc_profile_len = 0;
745 /* create output image */
746 /* ------------------- */
747 switch (parameters.cod_format) {
748 case PXM_DFMT: /* PNM PGM PPM */
749 if (imagetopnm(image, parameters.outfile)) {
750 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
753 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
757 case PGX_DFMT: /* PGX */
758 if(imagetopgx(image, parameters.outfile)){
759 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
762 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
766 case BMP_DFMT: /* BMP */
767 if(imagetobmp(image, parameters.outfile)){
768 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
771 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
775 case TIF_DFMT: /* TIFF */
776 if(imagetotif(image, parameters.outfile)){
777 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
780 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
783 #endif /* HAVE_LIBTIFF */
784 case RAW_DFMT: /* RAW */
785 if(imagetoraw(image, parameters.outfile)){
786 fprintf(stdout,"Error generating raw file. Outfile %s not generated\n",parameters.outfile);
789 fprintf(stdout,"Successfully generated Outfile %s\n",parameters.outfile);
793 case TGA_DFMT: /* TGA */
794 if(imagetotga(image, parameters.outfile)){
795 fprintf(stdout,"Error generating tga file. Outfile %s not generated\n",parameters.outfile);
798 fprintf(stdout,"Successfully generated Outfile %s\n",parameters.outfile);
802 case PNG_DFMT: /* PNG */
803 if(imagetopng(image, parameters.outfile)){
804 fprintf(stdout,"Error generating png file. Outfile %s not generated\n",parameters.outfile);
807 fprintf(stdout,"Successfully generated Outfile %s\n",parameters.outfile);
810 #endif /* HAVE_LIBPNG */
811 /* Can happen if output file is TIFF or PNG
812 * and HAVE_LIBTIF or HAVE_LIBPNG is undefined
815 fprintf(stderr,"Outfile %s not generated\n",parameters.outfile);
818 /* free remaining structures */
820 opj_destroy_codec(dinfo);
824 /* free image data structure */
825 opj_image_destroy(image);
827 /* destroy the codestream index */
828 opj_destroy_cstr_index(&cstr_index);