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>
39 #include "compat/getopt.h"
42 #include "windirent.h"
50 #define _stricmp strcasecmp
51 #define _strnicmp strncasecmp
54 /* ----------------------------------------------------------------------- */
68 /* ----------------------------------------------------------------------- */
70 typedef struct dircnt{
71 /** Buffer for holding images read from Directory*/
73 /** Pointer to the buffer*/
78 typedef struct img_folder{
79 /** The directory path of the folder containing input images*/
82 const char *out_format;
85 /** Enable Cod Format for output*/
90 void decode_help_display() {
91 fprintf(stdout,"HELP for j2k_to_image\n----\n\n");
92 fprintf(stdout,"- the -h option displays this help information on screen\n\n");
95 fprintf(stdout,"List of parameters for the JPEG 2000 "
101 fprintf(stdout,"\n");
102 fprintf(stdout,"\n");
103 fprintf(stdout," -ImgDir \n");
104 fprintf(stdout," Image file Directory path \n");
105 fprintf(stdout," -OutFor \n");
106 fprintf(stdout," REQUIRED only if -ImgDir is used\n");
107 fprintf(stdout," Need to specify only format without filename <BMP> \n");
108 fprintf(stdout," Currently accepts PGM, PPM, PNM, PGX, PNG, BMP, TIF, RAW and TGA formats\n");
109 fprintf(stdout," -i <compressed file>\n");
110 fprintf(stdout," REQUIRED only if an Input image directory not specified\n");
111 fprintf(stdout," Currently accepts J2K-files, JP2-files and JPT-files. The file type\n");
112 fprintf(stdout," is identified based on its suffix.\n");
113 fprintf(stdout," -o <decompressed file>\n");
114 fprintf(stdout," REQUIRED\n");
115 fprintf(stdout," Currently accepts PGM, PPM, PNM, PGX, PNG, BMP, TIF, RAW and TGA files\n");
116 fprintf(stdout," Binary data is written to the file (not ascii). If a PGX\n");
117 fprintf(stdout," filename is given, there will be as many output files as there are\n");
118 fprintf(stdout," components: an indice starting from 0 will then be appended to the\n");
119 fprintf(stdout," output filename, just before the \"pgx\" extension. If a PGM filename\n");
120 fprintf(stdout," is given and there are more than one component, only the first component\n");
121 fprintf(stdout," will be written to the file.\n");
122 fprintf(stdout," -r <reduce factor>\n");
123 fprintf(stdout," Set the number of highest resolution levels to be discarded. The\n");
124 fprintf(stdout," image resolution is effectively divided by 2 to the power of the\n");
125 fprintf(stdout," number of discarded levels. The reduce factor is limited by the\n");
126 fprintf(stdout," smallest total number of decomposition levels among tiles.\n");
127 fprintf(stdout," -l <number of quality layers to decode>\n");
128 fprintf(stdout," Set the maximum number of quality layers to decode. If there are\n");
129 fprintf(stdout," less quality layers than the specified number, all the quality layers\n");
130 fprintf(stdout," are decoded.\n");
131 fprintf(stdout," -x \n");
132 fprintf(stdout," Create an index file *.Idx (-x index_name.Idx) \n");
133 fprintf(stdout,"\n");
136 fprintf(stdout," -W <options>\n");
137 fprintf(stdout," Activates the JPWL correction capability, if the codestream complies.\n");
138 fprintf(stdout," Options can be a comma separated list of <param=val> tokens:\n");
139 fprintf(stdout," c, c=numcomps\n");
140 fprintf(stdout," numcomps is the number of expected components in the codestream\n");
141 fprintf(stdout," (search of first EPB rely upon this, default is %d)\n", JPWL_EXPECTED_COMPONENTS);
142 #endif /* USE_JPWL */
144 fprintf(stdout,"\n");
147 /* -------------------------------------------------------------------------- */
149 int get_num_images(char *imgdirpath){
151 struct dirent* content;
154 /*Reading the input images from given input directory*/
156 dir= opendir(imgdirpath);
158 fprintf(stderr,"Could not open Folder %s\n",imgdirpath);
162 while((content=readdir(dir))!=NULL){
163 if(strcmp(".",content->d_name)==0 || strcmp("..",content->d_name)==0 )
170 int load_images(dircnt_t *dirptr, char *imgdirpath){
172 struct dirent* content;
175 /*Reading the input images from given input directory*/
177 dir= opendir(imgdirpath);
179 fprintf(stderr,"Could not open Folder %s\n",imgdirpath);
182 fprintf(stderr,"Folder opened successfully\n");
185 while((content=readdir(dir))!=NULL){
186 if(strcmp(".",content->d_name)==0 || strcmp("..",content->d_name)==0 )
189 strcpy(dirptr->filename[i],content->d_name);
195 int get_file_format(char *filename) {
197 static const char *extension[] = {"pgx", "pnm", "pgm", "ppm", "bmp","tif", "raw", "tga", "png", "j2k", "jp2", "jpt", "j2c", "jpc" };
198 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 };
199 char * ext = strrchr(filename, '.');
204 for(i = 0; i < sizeof(format)/sizeof(*format); i++) {
205 if(_strnicmp(ext, extension[i], 3) == 0) {
214 char get_next_file(int imageno,dircnt_t *dirptr,img_fol_t *img_fol, opj_dparameters_t *parameters){
215 char image_filename[OPJ_PATH_LEN], infilename[OPJ_PATH_LEN],outfilename[OPJ_PATH_LEN],temp_ofname[OPJ_PATH_LEN];
216 char *temp_p, temp1[OPJ_PATH_LEN]="";
218 strcpy(image_filename,dirptr->filename[imageno]);
219 fprintf(stderr,"File Number %d \"%s\"\n",imageno,image_filename);
220 parameters->decod_format = get_file_format(image_filename);
221 if (parameters->decod_format == -1)
223 sprintf(infilename,"%s/%s",img_fol->imgdirpath,image_filename);
224 strncpy(parameters->infile, infilename, sizeof(infilename));
227 strcpy(temp_ofname,strtok(image_filename,"."));
228 while((temp_p = strtok(NULL,".")) != NULL){
229 strcat(temp_ofname,temp1);
230 sprintf(temp1,".%s",temp_p);
232 if(img_fol->set_out_format==1){
233 sprintf(outfilename,"%s/%s.%s",img_fol->imgdirpath,temp_ofname,img_fol->out_format);
234 strncpy(parameters->outfile, outfilename, sizeof(outfilename));
239 /* -------------------------------------------------------------------------- */
240 int parse_cmdline_decoder(int argc, char **argv, opj_dparameters_t *parameters,img_fol_t *img_fol, char *indexfilename) {
241 /* parse the command line */
243 option_t long_option[]={
244 {"ImgDir",REQ_ARG, NULL ,'y'},
245 {"OutFor",REQ_ARG, NULL ,'O'},
248 const char optlist[] = "i:o:r:l:x:"
253 #endif /* USE_JPWL */
256 totlen=sizeof(long_option);
257 img_fol->set_out_format = 0;
259 int c = getopt_long(argc, argv,optlist,long_option,totlen);
263 case 'i': /* input file */
265 char *infile = optarg;
266 parameters->decod_format = get_file_format(infile);
267 switch(parameters->decod_format) {
274 "!! Unrecognized format for infile : %s [accept only *.j2k, *.jp2, *.jpc or *.jpt] !!\n\n",
278 strncpy(parameters->infile, infile, sizeof(parameters->infile)-1);
282 /* ----------------------------------------------------- */
284 case 'o': /* output file */
286 char *outfile = optarg;
287 parameters->cod_format = get_file_format(outfile);
288 switch(parameters->cod_format) {
298 fprintf(stderr, "Unknown output format image %s [only *.pnm, *.pgm, *.ppm, *.pgx, *.bmp, *.tif, *.raw or *.tga]!! \n", outfile);
301 strncpy(parameters->outfile, outfile, sizeof(parameters->outfile)-1);
305 /* ----------------------------------------------------- */
307 case 'O': /* output format */
311 sprintf(outformat,".%s",of);
312 img_fol->set_out_format = 1;
313 parameters->cod_format = get_file_format(outformat);
314 switch(parameters->cod_format) {
316 img_fol->out_format = "pgx";
319 img_fol->out_format = "ppm";
322 img_fol->out_format = "bmp";
325 img_fol->out_format = "tif";
328 img_fol->out_format = "raw";
331 img_fol->out_format = "raw";
334 img_fol->out_format = "png";
337 fprintf(stderr, "Unknown output format image %s [only *.pnm, *.pgm, *.ppm, *.pgx, *.bmp, *.tif, *.raw or *.tga]!! \n", outformat);
344 /* ----------------------------------------------------- */
347 case 'r': /* reduce option */
349 sscanf(optarg, "%d", ¶meters->cp_reduce);
353 /* ----------------------------------------------------- */
356 case 'l': /* layering option */
358 sscanf(optarg, "%d", ¶meters->cp_layer);
362 /* ----------------------------------------------------- */
364 case 'h': /* display an help description */
365 decode_help_display();
368 /* ------------------------------------------------------ */
370 case 'y': /* Image Directory path */
372 img_fol->imgdirpath = (char*)malloc(strlen(optarg) + 1);
373 strcpy(img_fol->imgdirpath,optarg);
374 img_fol->set_imgdir=1;
377 /* ----------------------------------------------------- */
378 case 'x': /* Creation of index file */
380 char *index = optarg;
381 strncpy(indexfilename, index, OPJ_PATH_LEN);
384 /* ----------------------------------------------------- */
388 case 'W': /* activate JPWL correction */
392 token = strtok(optarg, ",");
393 while(token != NULL) {
395 /* search expected number of components */
400 compno = JPWL_EXPECTED_COMPONENTS; /* predefined no. of components */
402 if(sscanf(token, "c=%d", &compno) == 1) {
404 if ((compno < 1) || (compno > 256)) {
405 fprintf(stderr, "ERROR -> invalid number of components c = %d\n", compno);
408 parameters->jpwl_exp_comps = compno;
410 } else if (!strcmp(token, "c")) {
412 parameters->jpwl_exp_comps = compno; /* auto for default size */
415 fprintf(stderr, "ERROR -> invalid components specified = %s\n", token);
420 /* search maximum number of tiles */
425 tileno = JPWL_MAXIMUM_TILES; /* maximum no. of tiles */
427 if(sscanf(token, "t=%d", &tileno) == 1) {
429 if ((tileno < 1) || (tileno > JPWL_MAXIMUM_TILES)) {
430 fprintf(stderr, "ERROR -> invalid number of tiles t = %d\n", tileno);
433 parameters->jpwl_max_tiles = tileno;
435 } else if (!strcmp(token, "t")) {
437 parameters->jpwl_max_tiles = tileno; /* auto for default size */
440 fprintf(stderr, "ERROR -> invalid tiles specified = %s\n", token);
445 /* next token or bust */
446 token = strtok(NULL, ",");
448 parameters->jpwl_correct = true;
449 fprintf(stdout, "JPWL correction capability activated\n");
450 fprintf(stdout, "- expecting %d components\n", parameters->jpwl_exp_comps);
453 #endif /* USE_JPWL */
456 /* ----------------------------------------------------- */
459 fprintf(stderr,"WARNING -> this option is not valid \"-%c %s\"\n",c, optarg);
464 /* check for possible errors */
465 if(img_fol->set_imgdir==1){
466 if(!(parameters->infile[0]==0)){
467 fprintf(stderr, "Error: options -ImgDir and -i cannot be used together !!\n");
470 if(img_fol->set_out_format == 0){
471 fprintf(stderr, "Error: When -ImgDir is used, -OutFor <FORMAT> must be used !!\n");
472 fprintf(stderr, "Only one format allowed! Valid format PGM, PPM, PNM, PGX, BMP, TIF, RAW and TGA!!\n");
475 if(!((parameters->outfile[0] == 0))){
476 fprintf(stderr, "Error: options -ImgDir and -o cannot be used together !!\n");
480 if((parameters->infile[0] == 0) || (parameters->outfile[0] == 0)) {
481 fprintf(stderr, "Example: %s -i image.j2k -o image.pgm\n",argv[0]);
482 fprintf(stderr, " Try: %s -h\n",argv[0]);
490 /* -------------------------------------------------------------------------- */
493 sample error callback expecting a FILE* client object
495 void error_callback(const char *msg, void *client_data) {
496 FILE *stream = (FILE*)client_data;
497 fprintf(stream, "[ERROR] %s", msg);
500 sample warning callback expecting a FILE* client object
502 void warning_callback(const char *msg, void *client_data) {
503 FILE *stream = (FILE*)client_data;
504 fprintf(stream, "[WARNING] %s", msg);
507 sample debug callback expecting no client object
509 void info_callback(const char *msg, void *client_data) {
511 fprintf(stdout, "[INFO] %s", msg);
514 /* -------------------------------------------------------------------------- */
516 int main(int argc, char **argv) {
517 opj_dparameters_t parameters; /* decompression parameters */
519 opj_event_mgr_t event_mgr; /* event manager */
520 opj_image_t *image = NULL;
522 unsigned char *src = NULL;
527 opj_dinfo_t* dinfo = NULL; /* handle to a decompressor */
528 opj_cio_t *cio = NULL;
529 opj_codestream_info_t cstr_info; /* Codestream information structure */
530 char indexfilename[OPJ_PATH_LEN]; /* index file name */
532 /* configure the event callbacks (not required) */
533 memset(&event_mgr, 0, sizeof(opj_event_mgr_t));
534 event_mgr.error_handler = error_callback;
535 event_mgr.warning_handler = warning_callback;
536 event_mgr.info_handler = info_callback;
538 /* set decoding parameters to default values */
539 opj_set_default_decoder_parameters(¶meters);
541 /* Initialize indexfilename and img_fol */
543 memset(&img_fol,0,sizeof(img_fol_t));
545 /* parse input and get user encoding parameters */
546 if(parse_cmdline_decoder(argc, argv, ¶meters,&img_fol, indexfilename) == 1) {
550 /* Initialize reading of directory */
551 if(img_fol.set_imgdir==1){
552 num_images=get_num_images(img_fol.imgdirpath);
554 dirptr=(dircnt_t*)malloc(sizeof(dircnt_t));
556 dirptr->filename_buf = (char*)malloc(num_images*OPJ_PATH_LEN*sizeof(char)); // Stores at max 10 image file names
557 dirptr->filename = (char**) malloc(num_images*sizeof(char*));
559 if(!dirptr->filename_buf){
562 for(i=0;i<num_images;i++){
563 dirptr->filename[i] = dirptr->filename_buf + i*OPJ_PATH_LEN;
566 if(load_images(dirptr,img_fol.imgdirpath)==1){
570 fprintf(stdout,"Folder is empty\n");
577 /*Encoding image one by one*/
578 for(imageno = 0; imageno < num_images ; imageno++) {
580 fprintf(stderr,"\n");
582 if(img_fol.set_imgdir==1){
583 if (get_next_file(imageno, dirptr,&img_fol, ¶meters)) {
584 fprintf(stderr,"skipping file...\n");
589 /* read the input file and put it in memory */
590 /* ---------------------------------------- */
591 fsrc = fopen(parameters.infile, "rb");
593 fprintf(stderr, "ERROR -> failed to open %s for reading\n", parameters.infile);
596 fseek(fsrc, 0, SEEK_END);
597 file_length = ftell(fsrc);
598 fseek(fsrc, 0, SEEK_SET);
599 src = (unsigned char *) malloc(file_length);
600 fread(src, 1, file_length, fsrc);
603 /* decode the code-stream */
604 /* ---------------------- */
606 switch(parameters.decod_format) {
609 /* JPEG-2000 codestream */
611 /* get a decoder handle */
612 dinfo = opj_create_decompress(CODEC_J2K);
614 /* catch events using our callbacks and give a local context */
615 opj_set_event_mgr((opj_common_ptr)dinfo, &event_mgr, stderr);
617 /* setup the decoder decoding parameters using user parameters */
618 opj_setup_decoder(dinfo, ¶meters);
620 /* open a byte stream */
621 cio = opj_cio_open((opj_common_ptr)dinfo, src, file_length);
623 /* decode the stream and fill the image structure */
624 if (*indexfilename) // If need to extract codestream information
625 image = opj_decode_with_info(dinfo, cio, &cstr_info);
627 image = opj_decode(dinfo, cio);
629 fprintf(stderr, "ERROR -> j2k_to_image: failed to decode image!\n");
630 opj_destroy_decompress(dinfo);
635 /* close the byte stream */
638 /* Write the index to disk */
639 if (*indexfilename) {
641 bSuccess = write_index_file(&cstr_info, indexfilename);
643 fprintf(stderr, "Failed to output index file\n");
651 /* JPEG 2000 compressed image data */
653 /* get a decoder handle */
654 dinfo = opj_create_decompress(CODEC_JP2);
656 /* catch events using our callbacks and give a local context */
657 opj_set_event_mgr((opj_common_ptr)dinfo, &event_mgr, stderr);
659 /* setup the decoder decoding parameters using the current image and user parameters */
660 opj_setup_decoder(dinfo, ¶meters);
662 /* open a byte stream */
663 cio = opj_cio_open((opj_common_ptr)dinfo, src, file_length);
665 /* decode the stream and fill the image structure */
666 if (*indexfilename) // If need to extract codestream information
667 image = opj_decode_with_info(dinfo, cio, &cstr_info);
669 image = opj_decode(dinfo, cio);
671 fprintf(stderr, "ERROR -> j2k_to_image: failed to decode image!\n");
672 opj_destroy_decompress(dinfo);
677 /* close the byte stream */
680 /* Write the index to disk */
681 if (*indexfilename) {
683 bSuccess = write_index_file(&cstr_info, indexfilename);
685 fprintf(stderr, "Failed to output index file\n");
693 /* JPEG 2000, JPIP */
695 /* get a decoder handle */
696 dinfo = opj_create_decompress(CODEC_JPT);
698 /* catch events using our callbacks and give a local context */
699 opj_set_event_mgr((opj_common_ptr)dinfo, &event_mgr, stderr);
701 /* setup the decoder decoding parameters using user parameters */
702 opj_setup_decoder(dinfo, ¶meters);
704 /* open a byte stream */
705 cio = opj_cio_open((opj_common_ptr)dinfo, src, file_length);
707 /* decode the stream and fill the image structure */
708 if (*indexfilename) // If need to extract codestream information
709 image = opj_decode_with_info(dinfo, cio, &cstr_info);
711 image = opj_decode(dinfo, cio);
713 fprintf(stderr, "ERROR -> j2k_to_image: failed to decode image!\n");
714 opj_destroy_decompress(dinfo);
719 /* close the byte stream */
722 /* Write the index to disk */
723 if (*indexfilename) {
725 bSuccess = write_index_file(&cstr_info, indexfilename);
727 fprintf(stderr, "Failed to output index file\n");
734 fprintf(stderr, "skipping file..\n");
738 /* free the memory containing the code-stream */
742 /* create output image */
743 /* ------------------- */
744 switch (parameters.cod_format) {
745 case PXM_DFMT: /* PNM PGM PPM */
746 if (imagetopnm(image, parameters.outfile)) {
747 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
750 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
754 case PGX_DFMT: /* PGX */
755 if(imagetopgx(image, parameters.outfile)){
756 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
759 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
763 case BMP_DFMT: /* BMP */
764 if(imagetobmp(image, parameters.outfile)){
765 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
768 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
772 case TIF_DFMT: /* TIFF */
773 if(imagetotif(image, parameters.outfile)){
774 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
777 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
780 #endif /* HAVE_LIBTIFF */
781 case RAW_DFMT: /* RAW */
782 if(imagetoraw(image, parameters.outfile)){
783 fprintf(stdout,"Error generating raw file. Outfile %s not generated\n",parameters.outfile);
786 fprintf(stdout,"Successfully generated Outfile %s\n",parameters.outfile);
790 case TGA_DFMT: /* TGA */
791 if(imagetotga(image, parameters.outfile)){
792 fprintf(stdout,"Error generating tga file. Outfile %s not generated\n",parameters.outfile);
795 fprintf(stdout,"Successfully generated Outfile %s\n",parameters.outfile);
799 case PNG_DFMT: /* PNG */
800 if(imagetopng(image, parameters.outfile)){
801 fprintf(stdout,"Error generating png file. Outfile %s not generated\n",parameters.outfile);
804 fprintf(stdout,"Successfully generated Outfile %s\n",parameters.outfile);
807 #endif /* HAVE_LIBPNG */
808 /* Can happen if output file is TIFF or PNG
809 * and HAVE_LIBTIF or HAVE_LIBPNG is undefined
812 fprintf(stderr,"Outfile %s not generated\n",parameters.outfile);
815 /* free remaining structures */
817 opj_destroy_decompress(dinfo);
819 /* free codestream information structure */
821 opj_destroy_cstr_info(&cstr_info);
822 /* free image data structure */
823 opj_image_destroy(image);