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.
38 #include "compat/getopt.h"
44 #define stricmp strcasecmp
45 #define strnicmp strncasecmp
48 /* ----------------------------------------------------------------------- */
62 /* ----------------------------------------------------------------------- */
64 typedef struct dircnt{
65 /** Buffer for holding images read from Directory*/
67 /** Pointer to the buffer*/
72 typedef struct img_folder{
73 /** The directory path of the folder containing input images*/
79 /** Enable Cod Format for output*/
84 void decode_help_display() {
85 fprintf(stdout,"HELP\n----\n\n");
86 fprintf(stdout,"- the -h option displays this help information on screen\n\n");
89 fprintf(stdout,"List of parameters for the JPEG 2000 "
97 fprintf(stdout," -ImgDir \n");
98 fprintf(stdout," Image file Directory path \n");
99 fprintf(stdout," -OutFor \n");
100 fprintf(stdout," REQUIRED only if -ImgDir is used\n");
101 fprintf(stdout," Need to specify only format without filename <BMP> \n");
102 fprintf(stdout," Currently accepts PGM, PPM, PNM, PGX, BMP, TIF, RAW and TGA formats\n");
103 fprintf(stdout," -i <compressed file>\n");
104 fprintf(stdout," REQUIRED only if an Input image directory not specified\n");
105 fprintf(stdout," Currently accepts J2K-files, JP2-files and JPT-files. The file type\n");
106 fprintf(stdout," is identified based on its suffix.\n");
107 fprintf(stdout," -o <decompressed file>\n");
108 fprintf(stdout," REQUIRED\n");
109 fprintf(stdout," Currently accepts PGM, PPM, PNM, PGX, BMP, TIF, RAW and TGA files\n");
110 fprintf(stdout," Binary data is written to the file (not ascii). If a PGX\n");
111 fprintf(stdout," filename is given, there will be as many output files as there are\n");
112 fprintf(stdout," components: an indice starting from 0 will then be appended to the\n");
113 fprintf(stdout," output filename, just before the \"pgx\" extension. If a PGM filename\n");
114 fprintf(stdout," is given and there are more than one component, only the first component\n");
115 fprintf(stdout," will be written to the file.\n");
116 fprintf(stdout," -r <reduce factor>\n");
117 fprintf(stdout," Set the number of highest resolution levels to be discarded. The\n");
118 fprintf(stdout," image resolution is effectively divided by 2 to the power of the\n");
119 fprintf(stdout," number of discarded levels. The reduce factor is limited by the\n");
120 fprintf(stdout," smallest total number of decomposition levels among tiles.\n");
121 fprintf(stdout," -l <number of quality layers to decode>\n");
122 fprintf(stdout," Set the maximum number of quality layers to decode. If there are\n");
123 fprintf(stdout," less quality layers than the specified number, all the quality layers\n");
124 fprintf(stdout," are decoded.\n");
125 fprintf(stdout," -x \n");
126 fprintf(stdout," Create an index file *.Idx (-x index_name.Idx) \n");
127 fprintf(stdout,"\n");
130 fprintf(stdout," -W <options>\n");
131 fprintf(stdout," Activates the JPWL correction capability, if the codestream complies.\n");
132 fprintf(stdout," Options can be a comma separated list of <param=val> tokens:\n");
133 fprintf(stdout," c, c=numcomps\n");
134 fprintf(stdout," numcomps is the number of expected components in the codestream\n");
135 fprintf(stdout," (search of first EPB rely upon this, default is %d)\n", JPWL_EXPECTED_COMPONENTS);
136 #endif /* USE_JPWL */
138 fprintf(stdout,"\n");
141 /* -------------------------------------------------------------------------- */
143 int get_num_images(char *imgdirpath){
145 struct dirent* content;
148 /*Reading the input images from given input directory*/
150 dir= opendir(imgdirpath);
152 fprintf(stderr,"Could not open Folder %s\n",imgdirpath);
156 while((content=readdir(dir))!=NULL){
157 if(strcmp(".",content->d_name)==0 || strcmp("..",content->d_name)==0 )
164 int load_images(dircnt_t *dirptr, char *imgdirpath){
166 struct dirent* content;
169 /*Reading the input images from given input directory*/
171 dir= opendir(imgdirpath);
173 fprintf(stderr,"Could not open Folder %s\n",imgdirpath);
176 fprintf(stderr,"Folder opened successfully\n");
179 while((content=readdir(dir))!=NULL){
180 if(strcmp(".",content->d_name)==0 || strcmp("..",content->d_name)==0 )
183 strcpy(dirptr->filename[i],content->d_name);
189 int get_file_format(char *filename) {
191 static const char *extension[] = {"pgx", "pnm", "pgm", "ppm", "bmp","tif", "raw", "tga", "j2k", "jp2", "jpt", "j2c" };
192 static const int format[] = { PGX_DFMT, PXM_DFMT, PXM_DFMT, PXM_DFMT, BMP_DFMT, TIF_DFMT, RAW_DFMT, TGA_DFMT, J2K_CFMT, JP2_CFMT, JPT_CFMT, J2K_CFMT };
193 char * ext = strrchr(filename, '.');
198 for(i = 0; i < sizeof(format)/sizeof(*format); i++) {
199 if(strnicmp(ext, extension[i], 3) == 0) {
208 char get_next_file(int imageno,dircnt_t *dirptr,img_fol_t *img_fol, opj_dparameters_t *parameters){
209 char image_filename[OPJ_PATH_LEN], infilename[OPJ_PATH_LEN],outfilename[OPJ_PATH_LEN],temp_ofname[OPJ_PATH_LEN];
210 char *temp_p, temp1[OPJ_PATH_LEN]="";
212 strcpy(image_filename,dirptr->filename[imageno]);
213 fprintf(stderr,"File Number %d \"%s\"\n",imageno,image_filename);
214 parameters->decod_format = get_file_format(image_filename);
215 if (parameters->decod_format == -1)
217 sprintf(infilename,"%s/%s",img_fol->imgdirpath,image_filename);
218 strncpy(parameters->infile, infilename, sizeof(infilename));
221 strcpy(temp_ofname,strtok(image_filename,"."));
222 while((temp_p = strtok(NULL,".")) != NULL){
223 strcat(temp_ofname,temp1);
224 sprintf(temp1,".%s",temp_p);
226 if(img_fol->set_out_format==1){
227 sprintf(outfilename,"%s/%s.%s",img_fol->imgdirpath,temp_ofname,img_fol->out_format);
228 strncpy(parameters->outfile, outfilename, sizeof(outfilename));
233 /* -------------------------------------------------------------------------- */
234 int parse_cmdline_decoder(int argc, char **argv, opj_dparameters_t *parameters,img_fol_t *img_fol, char *indexfilename) {
235 /* parse the command line */
237 option_t long_option[]={
238 {"ImgDir",REQ_ARG, NULL ,'y'},
239 {"OutFor",REQ_ARG, NULL ,'O'},
242 const char optlist[] = "i:o:r:l:hx:"
247 #endif /* USE_JPWL */
250 totlen=sizeof(long_option);
251 img_fol->set_out_format = 0;
253 int c = getopt_long(argc, argv,optlist,long_option,totlen);
257 case 'i': /* input file */
259 char *infile = optarg;
260 parameters->decod_format = get_file_format(infile);
261 switch(parameters->decod_format) {
268 "!! Unrecognized format for infile : %s [accept only *.j2k, *.jp2, *.jpc or *.jpt] !!\n\n",
272 strncpy(parameters->infile, infile, sizeof(parameters->infile)-1);
276 /* ----------------------------------------------------- */
278 case 'o': /* output file */
280 char *outfile = optarg;
281 parameters->cod_format = get_file_format(outfile);
282 switch(parameters->cod_format) {
291 fprintf(stderr, "Unknown output format image %s [only *.pnm, *.pgm, *.ppm, *.pgx, *.bmp, *.tif, *.raw or *.tga]!! \n", outfile);
294 strncpy(parameters->outfile, outfile, sizeof(parameters->outfile)-1);
298 /* ----------------------------------------------------- */
300 case 'O': /* output format */
304 sprintf(outformat,".%s",of);
305 img_fol->set_out_format = 1;
306 parameters->cod_format = get_file_format(outformat);
307 switch(parameters->cod_format) {
309 img_fol->out_format = "pgx";
312 img_fol->out_format = "ppm";
315 img_fol->out_format = "bmp";
318 img_fol->out_format = "tif";
321 img_fol->out_format = "raw";
324 img_fol->out_format = "raw";
327 fprintf(stderr, "Unknown output format image %s [only *.pnm, *.pgm, *.ppm, *.pgx, *.bmp, *.tif, *.raw or *.tga]!! \n", outformat);
334 /* ----------------------------------------------------- */
337 case 'r': /* reduce option */
339 sscanf(optarg, "%d", ¶meters->cp_reduce);
343 /* ----------------------------------------------------- */
346 case 'l': /* layering option */
348 sscanf(optarg, "%d", ¶meters->cp_layer);
352 /* ----------------------------------------------------- */
354 case 'h': /* display an help description */
355 decode_help_display();
358 /* ------------------------------------------------------ */
360 case 'y': /* Image Directory path */
362 img_fol->imgdirpath = (char*)malloc(strlen(optarg) + 1);
363 strcpy(img_fol->imgdirpath,optarg);
364 img_fol->set_imgdir=1;
367 /* ----------------------------------------------------- */
368 case 'x': /* Creation of index file */
370 char *index = optarg;
371 strncpy(indexfilename, index, OPJ_PATH_LEN);
374 /* ----------------------------------------------------- */
378 case 'W': /* activate JPWL correction */
382 token = strtok(optarg, ",");
383 while(token != NULL) {
385 /* search expected number of components */
390 compno = JPWL_EXPECTED_COMPONENTS; /* predefined no. of components */
392 if(sscanf(token, "c=%d", &compno) == 1) {
394 if ((compno < 1) || (compno > 256)) {
395 fprintf(stderr, "ERROR -> invalid number of components c = %d\n", compno);
398 parameters->jpwl_exp_comps = compno;
400 } else if (!strcmp(token, "c")) {
402 parameters->jpwl_exp_comps = compno; /* auto for default size */
405 fprintf(stderr, "ERROR -> invalid components specified = %s\n", token);
410 /* search maximum number of tiles */
415 tileno = JPWL_MAXIMUM_TILES; /* maximum no. of tiles */
417 if(sscanf(token, "t=%d", &tileno) == 1) {
419 if ((tileno < 1) || (tileno > JPWL_MAXIMUM_TILES)) {
420 fprintf(stderr, "ERROR -> invalid number of tiles t = %d\n", tileno);
423 parameters->jpwl_max_tiles = tileno;
425 } else if (!strcmp(token, "t")) {
427 parameters->jpwl_max_tiles = tileno; /* auto for default size */
430 fprintf(stderr, "ERROR -> invalid tiles specified = %s\n", token);
435 /* next token or bust */
436 token = strtok(NULL, ",");
438 parameters->jpwl_correct = true;
439 fprintf(stdout, "JPWL correction capability activated\n");
440 fprintf(stdout, "- expecting %d components\n", parameters->jpwl_exp_comps);
443 #endif /* USE_JPWL */
446 /* ----------------------------------------------------- */
449 fprintf(stderr,"WARNING -> this option is not valid \"-%c %s\"\n",c, optarg);
454 /* check for possible errors */
455 if(img_fol->set_imgdir==1){
456 if(!(parameters->infile[0]==0)){
457 fprintf(stderr, "Error: options -ImgDir and -i cannot be used together !!\n");
460 if(img_fol->set_out_format == 0){
461 fprintf(stderr, "Error: When -ImgDir is used, -OutFor <FORMAT> must be used !!\n");
462 fprintf(stderr, "Only one format allowed! Valid format PGM, PPM, PNM, PGX, BMP, TIF, RAW and TGA!!\n");
465 if(!((parameters->outfile[0] == 0))){
466 fprintf(stderr, "Error: options -ImgDir and -o cannot be used together !!\n");
470 if((parameters->infile[0] == 0) || (parameters->outfile[0] == 0)) {
471 fprintf(stderr, "Error: One of the options -i or -ImgDir must be specified\n");
472 fprintf(stderr, "Error: When using -i, -o must be used\n");
473 fprintf(stderr, "usage: image_to_j2k -i *.j2k/jp2/j2c -o *.pgm/ppm/pnm/pgx/bmp/tif/raw/tga(+ options)\n");
481 /* -------------------------------------------------------------------------- */
484 sample error callback expecting a FILE* client object
486 void error_callback(const char *msg, void *client_data) {
487 FILE *stream = (FILE*)client_data;
488 fprintf(stream, "[ERROR] %s", msg);
491 sample warning callback expecting a FILE* client object
493 void warning_callback(const char *msg, void *client_data) {
494 FILE *stream = (FILE*)client_data;
495 fprintf(stream, "[WARNING] %s", msg);
498 sample debug callback expecting no client object
500 void info_callback(const char *msg, void *client_data) {
502 fprintf(stdout, "[INFO] %s", msg);
505 /* -------------------------------------------------------------------------- */
507 int main(int argc, char **argv) {
508 opj_dparameters_t parameters; /* decompression parameters */
510 opj_event_mgr_t event_mgr; /* event manager */
511 opj_image_t *image = NULL;
513 unsigned char *src = NULL;
518 opj_dinfo_t* dinfo = NULL; /* handle to a decompressor */
519 opj_cio_t *cio = NULL;
520 opj_codestream_info_t cstr_info; /* Codestream information structure */
521 char indexfilename[OPJ_PATH_LEN]; /* index file name */
523 /* configure the event callbacks (not required) */
524 memset(&event_mgr, 0, sizeof(opj_event_mgr_t));
525 event_mgr.error_handler = error_callback;
526 event_mgr.warning_handler = warning_callback;
527 event_mgr.info_handler = info_callback;
529 /* set decoding parameters to default values */
530 opj_set_default_decoder_parameters(¶meters);
532 /* Initialize indexfilename and img_fol */
534 memset(&img_fol,0,sizeof(img_fol_t));
536 /* parse input and get user encoding parameters */
537 if(parse_cmdline_decoder(argc, argv, ¶meters,&img_fol, indexfilename) == 1) {
541 /* Initialize reading of directory */
542 if(img_fol.set_imgdir==1){
543 num_images=get_num_images(img_fol.imgdirpath);
545 dirptr=(dircnt_t*)malloc(sizeof(dircnt_t));
547 dirptr->filename_buf = (char*)malloc(num_images*OPJ_PATH_LEN*sizeof(char)); // Stores at max 10 image file names
548 dirptr->filename = (char**) malloc(num_images*sizeof(char*));
550 if(!dirptr->filename_buf){
553 for(i=0;i<num_images;i++){
554 dirptr->filename[i] = dirptr->filename_buf + i*OPJ_PATH_LEN;
557 if(load_images(dirptr,img_fol.imgdirpath)==1){
561 fprintf(stdout,"Folder is empty\n");
568 /*Encoding image one by one*/
569 for(imageno = 0; imageno < num_images ; imageno++) {
571 fprintf(stderr,"\n");
573 if(img_fol.set_imgdir==1){
574 if (get_next_file(imageno, dirptr,&img_fol, ¶meters)) {
575 fprintf(stderr,"skipping file...\n");
580 /* read the input file and put it in memory */
581 /* ---------------------------------------- */
582 fsrc = fopen(parameters.infile, "rb");
584 fprintf(stderr, "ERROR -> failed to open %s for reading\n", parameters.infile);
587 fseek(fsrc, 0, SEEK_END);
588 file_length = ftell(fsrc);
589 fseek(fsrc, 0, SEEK_SET);
590 src = (unsigned char *) malloc(file_length);
591 fread(src, 1, file_length, fsrc);
594 /* decode the code-stream */
595 /* ---------------------- */
597 switch(parameters.decod_format) {
600 /* JPEG-2000 codestream */
602 /* get a decoder handle */
603 dinfo = opj_create_decompress(CODEC_J2K);
605 /* catch events using our callbacks and give a local context */
606 opj_set_event_mgr((opj_common_ptr)dinfo, &event_mgr, stderr);
608 /* setup the decoder decoding parameters using user parameters */
609 opj_setup_decoder(dinfo, ¶meters);
611 /* open a byte stream */
612 cio = opj_cio_open((opj_common_ptr)dinfo, src, file_length);
614 /* decode the stream and fill the image structure */
615 if (*indexfilename) // If need to extract codestream information
616 image = opj_decode_with_info(dinfo, cio, &cstr_info);
618 image = opj_decode(dinfo, cio);
620 fprintf(stderr, "ERROR -> j2k_to_image: failed to decode image!\n");
621 opj_destroy_decompress(dinfo);
626 /* close the byte stream */
629 /* Write the index to disk */
630 if (*indexfilename) {
632 bSuccess = write_index_file(&cstr_info, indexfilename);
634 fprintf(stderr, "Failed to output index file\n");
642 /* JPEG 2000 compressed image data */
644 /* get a decoder handle */
645 dinfo = opj_create_decompress(CODEC_JP2);
647 /* catch events using our callbacks and give a local context */
648 opj_set_event_mgr((opj_common_ptr)dinfo, &event_mgr, stderr);
650 /* setup the decoder decoding parameters using the current image and user parameters */
651 opj_setup_decoder(dinfo, ¶meters);
653 /* open a byte stream */
654 cio = opj_cio_open((opj_common_ptr)dinfo, src, file_length);
656 /* decode the stream and fill the image structure */
657 if (*indexfilename) // If need to extract codestream information
658 image = opj_decode_with_info(dinfo, cio, &cstr_info);
660 image = opj_decode(dinfo, cio);
662 fprintf(stderr, "ERROR -> j2k_to_image: failed to decode image!\n");
663 opj_destroy_decompress(dinfo);
668 /* close the byte stream */
671 /* Write the index to disk */
672 if (*indexfilename) {
674 bSuccess = write_index_file(&cstr_info, indexfilename);
676 fprintf(stderr, "Failed to output index file\n");
684 /* JPEG 2000, JPIP */
686 /* get a decoder handle */
687 dinfo = opj_create_decompress(CODEC_JPT);
689 /* catch events using our callbacks and give a local context */
690 opj_set_event_mgr((opj_common_ptr)dinfo, &event_mgr, stderr);
692 /* setup the decoder decoding parameters using user parameters */
693 opj_setup_decoder(dinfo, ¶meters);
695 /* open a byte stream */
696 cio = opj_cio_open((opj_common_ptr)dinfo, src, file_length);
698 /* decode the stream and fill the image structure */
699 if (*indexfilename) // If need to extract codestream information
700 image = opj_decode_with_info(dinfo, cio, &cstr_info);
702 image = opj_decode(dinfo, cio);
704 fprintf(stderr, "ERROR -> j2k_to_image: failed to decode image!\n");
705 opj_destroy_decompress(dinfo);
710 /* close the byte stream */
713 /* Write the index to disk */
714 if (*indexfilename) {
716 bSuccess = write_index_file(&cstr_info, indexfilename);
718 fprintf(stderr, "Failed to output index file\n");
725 fprintf(stderr, "skipping file..\n");
729 /* free the memory containing the code-stream */
733 /* create output image */
734 /* ------------------- */
735 switch (parameters.cod_format) {
736 case PXM_DFMT: /* PNM PGM PPM */
737 if (imagetopnm(image, parameters.outfile)) {
738 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
741 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
745 case PGX_DFMT: /* PGX */
746 if(imagetopgx(image, parameters.outfile)){
747 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
750 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
754 case BMP_DFMT: /* BMP */
755 if(imagetobmp(image, parameters.outfile)){
756 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
759 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
763 case TIF_DFMT: /* TIFF */
764 if(imagetotif(image, parameters.outfile)){
765 fprintf(stdout,"Outfile %s not generated\n",parameters.outfile);
768 fprintf(stdout,"Generated Outfile %s\n",parameters.outfile);
772 case RAW_DFMT: /* RAW */
773 if(imagetoraw(image, parameters.outfile)){
774 fprintf(stdout,"Error generating raw file. Outfile %s not generated\n",parameters.outfile);
777 fprintf(stdout,"Successfully generated Outfile %s\n",parameters.outfile);
781 case TGA_DFMT: /* TGA */
782 if(imagetotga(image, parameters.outfile)){
783 fprintf(stdout,"Error generating tga file. Outfile %s not generated\n",parameters.outfile);
786 fprintf(stdout,"Successfully generated Outfile %s\n",parameters.outfile);
791 /* free remaining structures */
793 opj_destroy_decompress(dinfo);
795 /* free codestream information structure */
797 opj_destroy_cstr_info(&cstr_info);
798 /* free image data structure */
799 opj_image_destroy(image);