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.
37 #include "openjpegConfigure.h"
39 #include "compat/getopt.h"
46 #define _stricmp strcasecmp
47 #define _strnicmp strncasecmp
50 /* ----------------------------------------------------------------------- */
64 /* ----------------------------------------------------------------------- */
66 typedef struct dircnt{
67 /** Buffer for holding images read from Directory*/
69 /** Pointer to the buffer*/
74 typedef struct img_folder{
75 /** The directory path of the folder containing input images*/
78 const char *out_format;
81 /** Enable Cod Format for output*/
86 void decode_help_display() {
87 fprintf(stdout,"HELP\n----\n\n");
88 fprintf(stdout,"- the -h option displays this help information on screen\n\n");
91 fprintf(stdout,"List of parameters for the JPEG 2000 "
99 fprintf(stdout," -ImgDir \n");
100 fprintf(stdout," Image file Directory path \n");
101 fprintf(stdout," -OutFor \n");
102 fprintf(stdout," REQUIRED only if -ImgDir is used\n");
103 fprintf(stdout," Need to specify only format without filename <BMP> \n");
104 fprintf(stdout," Currently accepts PGM, PPM, PNM, PGX, BMP, TIF, RAW and TGA formats\n");
105 fprintf(stdout," -i <compressed file>\n");
106 fprintf(stdout," REQUIRED only if an Input image directory not specified\n");
107 fprintf(stdout," Currently accepts J2K-files, JP2-files and JPT-files. The file type\n");
108 fprintf(stdout," is identified based on its suffix.\n");
109 fprintf(stdout," -o <decompressed file>\n");
110 fprintf(stdout," REQUIRED\n");
111 fprintf(stdout," Currently accepts PGM, PPM, PNM, PGX, BMP, TIF, RAW and TGA files\n");
112 fprintf(stdout," Binary data is written to the file (not ascii). If a PGX\n");
113 fprintf(stdout," filename is given, there will be as many output files as there are\n");
114 fprintf(stdout," components: an indice starting from 0 will then be appended to the\n");
115 fprintf(stdout," output filename, just before the \"pgx\" extension. If a PGM filename\n");
116 fprintf(stdout," is given and there are more than one component, only the first component\n");
117 fprintf(stdout," will be written to the file.\n");
118 fprintf(stdout," -r <reduce factor>\n");
119 fprintf(stdout," Set the number of highest resolution levels to be discarded. The\n");
120 fprintf(stdout," image resolution is effectively divided by 2 to the power of the\n");
121 fprintf(stdout," number of discarded levels. The reduce factor is limited by the\n");
122 fprintf(stdout," smallest total number of decomposition levels among tiles.\n");
123 fprintf(stdout," -l <number of quality layers to decode>\n");
124 fprintf(stdout," Set the maximum number of quality layers to decode. If there are\n");
125 fprintf(stdout," less quality layers than the specified number, all the quality layers\n");
126 fprintf(stdout," are decoded.\n");
127 fprintf(stdout," -x \n");
128 fprintf(stdout," Create an index file *.Idx (-x index_name.Idx) \n");
129 fprintf(stdout,"\n");
132 fprintf(stdout," -W <options>\n");
133 fprintf(stdout," Activates the JPWL correction capability, if the codestream complies.\n");
134 fprintf(stdout," Options can be a comma separated list of <param=val> tokens:\n");
135 fprintf(stdout," c, c=numcomps\n");
136 fprintf(stdout," numcomps is the number of expected components in the codestream\n");
137 fprintf(stdout," (search of first EPB rely upon this, default is %d)\n", JPWL_EXPECTED_COMPONENTS);
138 #endif /* USE_JPWL */
140 fprintf(stdout,"\n");
143 /* -------------------------------------------------------------------------- */
145 int get_num_images(char *imgdirpath){
147 struct dirent* content;
150 /*Reading the input images from given input directory*/
152 dir= opendir(imgdirpath);
154 fprintf(stderr,"Could not open Folder %s\n",imgdirpath);
158 while((content=readdir(dir))!=NULL){
159 if(strcmp(".",content->d_name)==0 || strcmp("..",content->d_name)==0 )
166 int load_images(dircnt_t *dirptr, char *imgdirpath){
168 struct dirent* content;
171 /*Reading the input images from given input directory*/
173 dir= opendir(imgdirpath);
175 fprintf(stderr,"Could not open Folder %s\n",imgdirpath);
178 fprintf(stderr,"Folder opened successfully\n");
181 while((content=readdir(dir))!=NULL){
182 if(strcmp(".",content->d_name)==0 || strcmp("..",content->d_name)==0 )
185 strcpy(dirptr->filename[i],content->d_name);
191 int get_file_format(char *filename) {
193 static const char *extension[] = {"pgx", "pnm", "pgm", "ppm", "bmp","tif", "raw", "tga", "png", "j2k", "jp2", "jpt", "j2c", "jpc" };
194 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 };
195 char * ext = strrchr(filename, '.');
200 for(i = 0; i < sizeof(format)/sizeof(*format); i++) {
201 if(_strnicmp(ext, extension[i], 3) == 0) {
210 char get_next_file(int imageno,dircnt_t *dirptr,img_fol_t *img_fol, opj_dparameters_t *parameters){
211 char image_filename[OPJ_PATH_LEN], infilename[OPJ_PATH_LEN],outfilename[OPJ_PATH_LEN],temp_ofname[OPJ_PATH_LEN];
212 char *temp_p, temp1[OPJ_PATH_LEN]="";
214 strcpy(image_filename,dirptr->filename[imageno]);
215 fprintf(stderr,"File Number %d \"%s\"\n",imageno,image_filename);
216 parameters->decod_format = get_file_format(image_filename);
217 if (parameters->decod_format == -1)
219 sprintf(infilename,"%s/%s",img_fol->imgdirpath,image_filename);
220 strncpy(parameters->infile, infilename, sizeof(infilename));
223 strcpy(temp_ofname,strtok(image_filename,"."));
224 while((temp_p = strtok(NULL,".")) != NULL){
225 strcat(temp_ofname,temp1);
226 sprintf(temp1,".%s",temp_p);
228 if(img_fol->set_out_format==1){
229 sprintf(outfilename,"%s/%s.%s",img_fol->imgdirpath,temp_ofname,img_fol->out_format);
230 strncpy(parameters->outfile, outfilename, sizeof(outfilename));
235 /* -------------------------------------------------------------------------- */
236 int parse_cmdline_decoder(int argc, char **argv, opj_dparameters_t *parameters,img_fol_t *img_fol, char *indexfilename) {
237 /* parse the command line */
239 option_t long_option[]={
240 {"ImgDir",REQ_ARG, NULL ,'y'},
241 {"OutFor",REQ_ARG, NULL ,'O'},
244 const char optlist[] = "i:o:r:l:hx:"
249 #endif /* USE_JPWL */
252 totlen=sizeof(long_option);
253 img_fol->set_out_format = 0;
255 int c = getopt_long(argc, argv,optlist,long_option,totlen);
259 case 'i': /* input file */
261 char *infile = optarg;
262 parameters->decod_format = get_file_format(infile);
263 switch(parameters->decod_format) {
270 "!! Unrecognized format for infile : %s [accept only *.j2k, *.jp2, *.jpc or *.jpt] !!\n\n",
274 strncpy(parameters->infile, infile, sizeof(parameters->infile)-1);
278 /* ----------------------------------------------------- */
280 case 'o': /* output file */
282 char *outfile = optarg;
283 parameters->cod_format = get_file_format(outfile);
284 switch(parameters->cod_format) {
294 fprintf(stderr, "Unknown output format image %s [only *.pnm, *.pgm, *.ppm, *.pgx, *.bmp, *.tif, *.raw or *.tga]!! \n", outfile);
297 strncpy(parameters->outfile, outfile, sizeof(parameters->outfile)-1);
301 /* ----------------------------------------------------- */
303 case 'O': /* output format */
307 sprintf(outformat,".%s",of);
308 img_fol->set_out_format = 1;
309 parameters->cod_format = get_file_format(outformat);
310 switch(parameters->cod_format) {
312 img_fol->out_format = "pgx";
315 img_fol->out_format = "ppm";
318 img_fol->out_format = "bmp";
321 img_fol->out_format = "tif";
324 img_fol->out_format = "raw";
327 img_fol->out_format = "raw";
330 img_fol->out_format = "png";
333 fprintf(stderr, "Unknown output format image %s [only *.pnm, *.pgm, *.ppm, *.pgx, *.bmp, *.tif, *.raw or *.tga]!! \n", outformat);
340 /* ----------------------------------------------------- */
343 case 'r': /* reduce option */
345 sscanf(optarg, "%d", ¶meters->cp_reduce);
349 /* ----------------------------------------------------- */
352 case 'l': /* layering option */
354 sscanf(optarg, "%d", ¶meters->cp_layer);
358 /* ----------------------------------------------------- */
360 case 'h': /* display an help description */
361 decode_help_display();
364 /* ------------------------------------------------------ */
366 case 'y': /* Image Directory path */
368 img_fol->imgdirpath = (char*)malloc(strlen(optarg) + 1);
369 strcpy(img_fol->imgdirpath,optarg);
370 img_fol->set_imgdir=1;
373 /* ----------------------------------------------------- */
374 case 'x': /* Creation of index file */
376 char *index = optarg;
377 strncpy(indexfilename, index, OPJ_PATH_LEN);
380 /* ----------------------------------------------------- */
384 case 'W': /* activate JPWL correction */
388 token = strtok(optarg, ",");
389 while(token != NULL) {
391 /* search expected number of components */
396 compno = JPWL_EXPECTED_COMPONENTS; /* predefined no. of components */
398 if(sscanf(token, "c=%d", &compno) == 1) {
400 if ((compno < 1) || (compno > 256)) {
401 fprintf(stderr, "ERROR -> invalid number of components c = %d\n", compno);
404 parameters->jpwl_exp_comps = compno;
406 } else if (!strcmp(token, "c")) {
408 parameters->jpwl_exp_comps = compno; /* auto for default size */
411 fprintf(stderr, "ERROR -> invalid components specified = %s\n", token);
416 /* search maximum number of tiles */
421 tileno = JPWL_MAXIMUM_TILES; /* maximum no. of tiles */
423 if(sscanf(token, "t=%d", &tileno) == 1) {
425 if ((tileno < 1) || (tileno > JPWL_MAXIMUM_TILES)) {
426 fprintf(stderr, "ERROR -> invalid number of tiles t = %d\n", tileno);
429 parameters->jpwl_max_tiles = tileno;
431 } else if (!strcmp(token, "t")) {
433 parameters->jpwl_max_tiles = tileno; /* auto for default size */
436 fprintf(stderr, "ERROR -> invalid tiles specified = %s\n", token);
441 /* next token or bust */
442 token = strtok(NULL, ",");
444 parameters->jpwl_correct = true;
445 fprintf(stdout, "JPWL correction capability activated\n");
446 fprintf(stdout, "- expecting %d components\n", parameters->jpwl_exp_comps);
449 #endif /* USE_JPWL */
452 /* ----------------------------------------------------- */
455 fprintf(stderr,"WARNING -> this option is not valid \"-%c %s\"\n",c, optarg);
460 /* check for possible errors */
461 if(img_fol->set_imgdir==1){
462 if(!(parameters->infile[0]==0)){
463 fprintf(stderr, "Error: options -ImgDir and -i cannot be used together !!\n");
466 if(img_fol->set_out_format == 0){
467 fprintf(stderr, "Error: When -ImgDir is used, -OutFor <FORMAT> must be used !!\n");
468 fprintf(stderr, "Only one format allowed! Valid format PGM, PPM, PNM, PGX, BMP, TIF, RAW and TGA!!\n");
471 if(!((parameters->outfile[0] == 0))){
472 fprintf(stderr, "Error: options -ImgDir and -o cannot be used together !!\n");
476 if((parameters->infile[0] == 0) || (parameters->outfile[0] == 0)) {
477 fprintf(stderr, "Error: One of the options -i or -ImgDir must be specified\n");
478 fprintf(stderr, "Error: When using -i, -o must be used\n");
479 fprintf(stderr, "usage: image_to_j2k -i *.j2k/jp2/j2c -o *.pgm/ppm/pnm/pgx/bmp/tif/raw/tga(+ options)\n");
487 /* -------------------------------------------------------------------------- */
490 sample error callback expecting a FILE* client object
492 void error_callback(const char *msg, void *client_data) {
493 FILE *stream = (FILE*)client_data;
494 fprintf(stream, "[ERROR] %s", msg);
497 sample warning callback expecting a FILE* client object
499 void warning_callback(const char *msg, void *client_data) {
500 FILE *stream = (FILE*)client_data;
501 fprintf(stream, "[WARNING] %s", msg);
504 sample debug callback expecting no client object
506 void info_callback(const char *msg, void *client_data) {
508 fprintf(stdout, "[INFO] %s", msg);
511 /* -------------------------------------------------------------------------- */
513 int main(int argc, char **argv) {
514 opj_dparameters_t parameters; /* decompression parameters */
516 opj_event_mgr_t event_mgr; /* event manager */
517 opj_image_t *image = NULL;
519 unsigned char *src = NULL;
524 opj_dinfo_t* dinfo = NULL; /* handle to a decompressor */
525 opj_cio_t *cio = NULL;
526 opj_codestream_info_t cstr_info; /* Codestream information structure */
527 char indexfilename[OPJ_PATH_LEN]; /* index file name */
529 /* configure the event callbacks (not required) */
530 memset(&event_mgr, 0, sizeof(opj_event_mgr_t));
531 event_mgr.error_handler = error_callback;
532 event_mgr.warning_handler = warning_callback;
533 event_mgr.info_handler = info_callback;
535 /* set decoding parameters to default values */
536 opj_set_default_decoder_parameters(¶meters);
538 /* Initialize indexfilename and img_fol */
540 memset(&img_fol,0,sizeof(img_fol_t));
542 /* parse input and get user encoding parameters */
543 if(parse_cmdline_decoder(argc, argv, ¶meters,&img_fol, indexfilename) == 1) {
547 /* Initialize reading of directory */
548 if(img_fol.set_imgdir==1){
549 num_images=get_num_images(img_fol.imgdirpath);
551 dirptr=(dircnt_t*)malloc(sizeof(dircnt_t));
553 dirptr->filename_buf = (char*)malloc(num_images*OPJ_PATH_LEN*sizeof(char)); // Stores at max 10 image file names
554 dirptr->filename = (char**) malloc(num_images*sizeof(char*));
556 if(!dirptr->filename_buf){
559 for(i=0;i<num_images;i++){
560 dirptr->filename[i] = dirptr->filename_buf + i*OPJ_PATH_LEN;
563 if(load_images(dirptr,img_fol.imgdirpath)==1){
567 fprintf(stdout,"Folder is empty\n");
574 /*Encoding image one by one*/
575 for(imageno = 0; imageno < num_images ; imageno++) {
577 fprintf(stderr,"\n");
579 if(img_fol.set_imgdir==1){
580 if (get_next_file(imageno, dirptr,&img_fol, ¶meters)) {
581 fprintf(stderr,"skipping file...\n");
586 /* read the input file and put it in memory */
587 /* ---------------------------------------- */
588 fsrc = fopen(parameters.infile, "rb");
590 fprintf(stderr, "ERROR -> failed to open %s for reading\n", parameters.infile);
593 fseek(fsrc, 0, SEEK_END);
594 file_length = ftell(fsrc);
595 fseek(fsrc, 0, SEEK_SET);
596 src = (unsigned char *) malloc(file_length);
597 fread(src, 1, file_length, fsrc);
600 /* decode the code-stream */
601 /* ---------------------- */
603 switch(parameters.decod_format) {
606 /* JPEG-2000 codestream */
608 /* get a decoder handle */
609 dinfo = opj_create_decompress(CODEC_J2K);
611 /* catch events using our callbacks and give a local context */
612 opj_set_event_mgr((opj_common_ptr)dinfo, &event_mgr, stderr);
614 /* setup the decoder decoding parameters using user parameters */
615 opj_setup_decoder(dinfo, ¶meters);
617 /* open a byte stream */
618 cio = opj_cio_open((opj_common_ptr)dinfo, src, file_length);
620 /* decode the stream and fill the image structure */
621 if (*indexfilename) // If need to extract codestream information
622 image = opj_decode_with_info(dinfo, cio, &cstr_info);
624 image = opj_decode(dinfo, cio);
626 fprintf(stderr, "ERROR -> j2k_to_image: failed to decode image!\n");
627 opj_destroy_decompress(dinfo);
632 /* close the byte stream */
635 /* Write the index to disk */
636 if (*indexfilename) {
638 bSuccess = write_index_file(&cstr_info, indexfilename);
640 fprintf(stderr, "Failed to output index file\n");
648 /* JPEG 2000 compressed image data */
650 /* get a decoder handle */
651 dinfo = opj_create_decompress(CODEC_JP2);
653 /* catch events using our callbacks and give a local context */
654 opj_set_event_mgr((opj_common_ptr)dinfo, &event_mgr, stderr);
656 /* setup the decoder decoding parameters using the current image and user parameters */
657 opj_setup_decoder(dinfo, ¶meters);
659 /* open a byte stream */
660 cio = opj_cio_open((opj_common_ptr)dinfo, src, file_length);
662 /* decode the stream and fill the image structure */
663 if (*indexfilename) // If need to extract codestream information
664 image = opj_decode_with_info(dinfo, cio, &cstr_info);
666 image = opj_decode(dinfo, cio);
668 fprintf(stderr, "ERROR -> j2k_to_image: failed to decode image!\n");
669 opj_destroy_decompress(dinfo);
674 /* close the byte stream */
677 /* Write the index to disk */
678 if (*indexfilename) {
680 bSuccess = write_index_file(&cstr_info, indexfilename);
682 fprintf(stderr, "Failed to output index file\n");
690 /* JPEG 2000, JPIP */
692 /* get a decoder handle */
693 dinfo = opj_create_decompress(CODEC_JPT);
695 /* catch events using our callbacks and give a local context */
696 opj_set_event_mgr((opj_common_ptr)dinfo, &event_mgr, stderr);
698 /* setup the decoder decoding parameters using user parameters */
699 opj_setup_decoder(dinfo, ¶meters);
701 /* open a byte stream */
702 cio = opj_cio_open((opj_common_ptr)dinfo, src, file_length);
704 /* decode the stream and fill the image structure */
705 if (*indexfilename) // If need to extract codestream information
706 image = opj_decode_with_info(dinfo, cio, &cstr_info);
708 image = opj_decode(dinfo, cio);
710 fprintf(stderr, "ERROR -> j2k_to_image: failed to decode image!\n");
711 opj_destroy_decompress(dinfo);
716 /* close the byte stream */
719 /* Write the index to disk */
720 if (*indexfilename) {
722 bSuccess = write_index_file(&cstr_info, indexfilename);
724 fprintf(stderr, "Failed to output index file\n");
731 fprintf(stderr, "skipping file..\n");
735 /* free the memory containing the code-stream */
739 /* create output image */
740 /* ------------------- */
741 switch (parameters.cod_format) {
742 case PXM_DFMT: /* PNM PGM PPM */
743 if (imagetopnm(image, parameters.outfile)) {
744 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
747 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
751 case PGX_DFMT: /* PGX */
752 if(imagetopgx(image, parameters.outfile)){
753 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
756 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
760 case BMP_DFMT: /* BMP */
761 if(imagetobmp(image, parameters.outfile)){
762 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
765 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
769 case TIF_DFMT: /* TIFF */
770 if(imagetotif(image, parameters.outfile)){
771 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
774 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
778 case RAW_DFMT: /* RAW */
779 if(imagetoraw(image, parameters.outfile)){
780 fprintf(stdout,"Error generating raw file. Outfile %s not generated\n",parameters.outfile);
783 fprintf(stdout,"Successfully generated Outfile %s\n",parameters.outfile);
787 case TGA_DFMT: /* TGA */
788 if(imagetotga(image, parameters.outfile)){
789 fprintf(stdout,"Error generating tga file. Outfile %s not generated\n",parameters.outfile);
792 fprintf(stdout,"Successfully generated Outfile %s\n",parameters.outfile);
796 case PNG_DFMT: /* PNG */
797 if(imagetopng(image, parameters.outfile)){
798 fprintf(stdout,"Error generating png file. Outfile %s not generated\n",parameters.outfile);
801 fprintf(stdout,"Successfully generated Outfile %s\n",parameters.outfile);
806 /* free remaining structures */
808 opj_destroy_decompress(dinfo);
810 /* free codestream information structure */
812 opj_destroy_cstr_info(&cstr_info);
813 /* free image data structure */
814 opj_image_destroy(image);