2 * Copyright (c) 2001-2003, David Janssens
3 * Copyright (c) 2002-2003, Yannick Verschueren
4 * Copyright (c) 2002-2003, Communications and remote sensing Laboratory, Universite catholique de Louvain, Belgium
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS'
17 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
20 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
24 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
25 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26 * POSSIBILITY OF SUCH DAMAGE.
34 #ifndef DONT_HAVE_GETOPT
37 #include "compat/getopt.h"
43 printf("HELP\n----\n\n");
45 ("- the option -help displays the readme.txt file on screen\n\n");
48 printf("List of parameters for the coder JPEG 2000 :\n");
51 ("- The markers COD and QCD are writed both of two in the main_header and never appear in the tile_header. The markers in the main header are : SOC SIZ COD QCD COM.\n");
54 ("- This coder can encode mega image, a test was made on a 24000x24000 pixels color image. You need enough disk space memory (twice the original) to encode the image. (i.e. for a 1.5 Gb image you need a minimum of 3Gb of disk memory)\n");
56 printf("REMARKS :\n");
57 printf("---------\n");
60 ("* the value of rate enter in the code line is the compression factor !\n");
61 printf("exemple :\n");
64 ("-r 20,10,1 means quality 1 : compress 20x, quality 2 : compress 10x and quality 3 : compress 1x = lossless\n");
66 printf("By default :\n");
67 printf("------------\n");
69 printf(" * lossless\n");
70 printf(" * 1 tile\n");
71 printf(" * size of precinct 2^15 x 2^15 (means 1 precinct)\n");
72 printf(" * size of code-block 64 x 64\n");
73 printf(" * Number of resolution : 6\n");
74 printf(" * No SOP marker in the codestream\n");
75 printf(" * No EPH marker in the codestream\n");
76 printf(" * No sub-sampling in x and y direction\n");
77 printf(" * No mode switch activated\n");
78 printf(" * progression order : LRCP\n");
79 printf(" * No index file\n");
80 printf(" * No ROI upshifted\n");
81 printf(" * No offset of the origin of the image\n");
82 printf(" * No offset of the origin of the tiles\n");
83 printf(" * Reversible DWT 5-3\n");
85 printf("Parameters :\n");
86 printf("------------\n");
89 ("-i : source file (-i source.pnm also *.pgm, *.ppm) required\n");
91 printf("-o : destination file (-o dest.j2k) required\n");
93 printf("-help : Display the help information optional\n ");
95 printf("-r : different rates (-r 20,10,5) optional\n ");
97 printf("-n : Number of resolution (-n 3) optional\n");
99 printf("-b : size of code block (-b 32,32) optional\n");
101 printf("-c : size of precinct (-c 128,128) optional\n");
103 printf("-t : size of tile (-t 512,512) optional\n");
106 ("-p : progression order (-p LRCP) [LRCP, RLCP, RPCL, PCRL, CPRL] optional\n");
109 ("-s : subsampling factor (-s 2,2) [-s X,Y] optional\n");
112 ("-SOP : write SOP marker before each packet optional\n");
115 ("-EPH : write EPH marker after each header packet optional\n");
118 ("-M : mode switch (-M 3) [1=BYPASS(LAZY) 2=RESET 4=RESTART(TERMALL) 8=VSC 16=ERTERM(SEGTERM) 32=SEGMARK(SEGSYM)] optional\n");
120 (" for several mode switch you have to add the value of each mode you want\n");
122 (" ex : RESTART(4) + RESET(2) + SEGMARK(32) = -M 38\n");
125 ("-x : Create an index file *.Idx (-x index_name.Idx) optional\n");
128 ("-ROI:c=%%d,U=%%d : quantization indices upshifted for component c=%%d [\%%d = 0,1,2]\n");
130 (" with a value of U=%%d [0 <= %%d <= 37] (i.e. -ROI:c=0,U=25) optional\n");
133 ("-d : offset of the origin of the image (-d 150,300) optional\n");
136 ("-T : offset of the origin of the tiles (-T 100,75) optional\n");
139 ("-I : Use the irreversible DWT 9-7 (-I) optional\n");
141 printf("IMPORTANT :\n");
142 printf("-----------\n");
144 printf("* subsampling bigger than 2 can produce error\n");
146 printf("The index file respect the structure below :\n");
147 printf("---------------------------------------------\n");
149 printf("Image_height Image_width\n");
150 printf("progression order\n");
151 printf("Tiles_size_X Tiles_size_Y\n");
152 printf("Components_nb\n");
153 printf("Layers_nb\n");
154 printf("decomposition_levels\n");
155 printf("Precincts_size_X Precincts_size_Y\n");
156 printf("Main_header_end_position\n");
157 printf("Codestream_size\n");
158 printf("Tile0 start_pos end_Theader end_pos\n");
159 printf("Tile1 '' '' ''\n");
161 printf("TileN '' '' ''\n");
162 printf("Tpacket_0 Tile layer res. comp. prec. start_pos end_pos\n");
164 printf("Tpacket_M '' '' '' '' '' '' ''\n");
167 int give_progression(char progression[4])
169 if (progression[0] == 'L' && progression[1] == 'R'
170 && progression[2] == 'C' && progression[3] == 'P') {
173 if (progression[0] == 'R' && progression[1] == 'L'
174 && progression[2] == 'C' && progression[3] == 'P') {
177 if (progression[0] == 'R' && progression[1] == 'P'
178 && progression[2] == 'C' && progression[3] == 'L') {
181 if (progression[0] == 'P' && progression[1] == 'C'
182 && progression[2] == 'R' && progression[3] == 'L') {
185 if (progression[0] == 'C' && progression[1] == 'P'
186 && progression[2] == 'R'
187 && progression[3] == 'L') {
198 double dwt_norms_97[4][10] = {
199 {1.000, 1.965, 4.177, 8.403, 16.90, 33.84, 67.69, 135.3, 270.6, 540.9},
200 {2.022, 3.989, 8.355, 17.04, 34.27, 68.63, 137.3, 274.6, 549.0},
201 {2.022, 3.989, 8.355, 17.04, 34.27, 68.63, 137.3, 274.6, 549.0},
202 {2.080, 3.865, 8.307, 17.18, 34.71, 69.59, 139.3, 278.6, 557.2}
208 for (l = 0; a > 1; l++) {
214 void encode_stepsize(int stepsize, int numbps, int *expn, int *mant)
217 p = floorlog2(stepsize) - 13;
218 n = 11 - floorlog2(stepsize);
219 *mant = (n < 0 ? stepsize >> -n : stepsize << n) & 0x7ff;
223 void calc_explicit_stepsizes(j2k_tccp_t * tccp, int prec)
225 int numbands, bandno;
226 numbands = 3 * tccp->numresolutions - 2;
227 for (bandno = 0; bandno < numbands; bandno++) {
230 int resno, level, orient, gain;
231 resno = bandno == 0 ? 0 : (bandno - 1) / 3 + 1;
232 orient = bandno == 0 ? 0 : (bandno - 1) % 3 + 1;
233 level = tccp->numresolutions - 1 - resno;
235 tccp->qmfbid == 0 ? 0 : (orient ==
237 || orient == 2 ? 1 : 2));
238 if (tccp->qntsty == J2K_CCP_QNTSTY_NOQNT) {
241 double norm = dwt_norms_97[orient][level];
242 stepsize = (1 << (gain + 1)) / norm;
244 encode_stepsize((int) floor(stepsize * 8192.0), prec + gain,
245 &tccp->stepsizes[bandno].expn,
246 &tccp->stepsizes[bandno].mant);
250 int main(int argc, char **argv)
253 int NumResolution, numD_min; /* NumResolution : number of resolution */
254 int Tile_arg; /* Tile_arg = 0 (not in argument) ou = 1 (in argument) */
255 int CSty; /* CSty : coding style */
256 int Prog_order; /* progression order (default LRCP) */
258 int numpocs, numpocs_tile; /* Number of progression order change (POC) default 0 */
259 int prcw_init, prch_init; /* Initialisation precincts' size */
260 int cblockw_init, cblockh_init; /* Initialisation codeblocks' size */
261 int mode, value; /* Mode switch (cblk_style) */
262 int subsampling_dx, subsampling_dy; /* subsampling value for dx and dy */
263 int ROI_compno, ROI_shift; /* region of interrest */
264 int Dim[2]; /* portion of the image coded */
265 int TX0, TY0; /* tile off-set */
267 j2k_cp_t cp, cp_init; /* cp_init is used to initialise in multiple tiles */
268 j2k_tcp_t *tcp, *tcp_init; /* tcp_init is used to initialise in multiple tile */
269 j2k_poc_t POC[32]; /* POC : used in case of Progression order change */
293 ROI_compno = -1; /* no ROI */
305 cp_init.tcps = (j2k_tcp_t *) malloc(sizeof(j2k_tcp_t)); /* initialisation if only one tile */
306 tcp_init = &cp_init.tcps[0];
307 tcp_init->numlayers = 0;
312 "i:o:r:q:t:n:c:b:x:p:s:d:h:P:S:E:M:R:T:C:I");
316 case 'i': /* IN fill */
329 if ((S1 == 'p' && S2 == 'g' && S3 == 'x')
330 || (S1 == 'P' && S2 == 'G' && S3 == 'X')) {
335 if ((S1 == 'p' && S2 == 'n' && S3 == 'm')
336 || (S1 == 'P' && S2 == 'N' && S3 == 'M')
337 || (S1 == 'p' && S2 == 'g' && S3 == 'm') || (S1 == 'P'
340 || (S1 == 'P' && S2 == 'P' && S3 == 'M') || (S1 == 'p'
348 if ((S1 == 'b' && S2 == 'm' && S3 == 'p')
349 || (S1 == 'B' && S2 == 'M' && S3 == 'P')) {
354 "!! Unrecognized format for infile : %c%c%c [accept only *.pnm, *.pgm, *.ppm, *.pgx or *.bmp] !!\n\n",
358 /* ----------------------------------------------------- */
359 case 'o': /* OUT fill */
362 /* ----------------------------------------------------- */
363 case 'r': /* rates rates/distorsion */
365 while (sscanf(s, "%d", &tcp_init->rates[tcp_init->numlayers])
367 tcp_init->numlayers++;
368 while (*s && *s != ',') {
378 /* ----------------------------------------------------- */
379 case 'q': /* rates fixed */
381 sscanf(s, "%d", &tcp_init->numlayers);
383 if (tcp_init->numlayers > 9)
386 (int *) malloc(tcp_init->numlayers * NumResolution * 3 *
389 for (i = 0; i < tcp_init->numlayers; i++) {
390 tcp_init->rates[i] = 1;
391 sscanf(s, "%d,", &cp.matrice[i * NumResolution * 3]);
393 if (cp.matrice[i * NumResolution * 3] > 9)
395 cp.matrice[i * NumResolution * 3 + 1] = 0;
396 cp.matrice[i * NumResolution * 3 + 2] = 0;
397 for (j = 1; j < NumResolution; j++) {
398 sscanf(s, "%d,%d,%d",
399 &cp.matrice[i * NumResolution * 3 + j * 3 + 0],
400 &cp.matrice[i * NumResolution * 3 + j * 3 + 1],
401 &cp.matrice[i * NumResolution * 3 + j * 3 + 2]);
403 if (cp.matrice[i * NumResolution * 3 + j * 3] > 9)
405 if (cp.matrice[i * NumResolution * 3 + j * 3 + 1] > 9)
407 if (cp.matrice[i * NumResolution * 3 + j * 3 + 2] > 9)
410 if (i < tcp_init->numlayers - 1)
415 /* ----------------------------------------------------- */
416 case 't': /* tiles */
417 sscanf(optarg, "%d,%d", &cp.tdx, &cp.tdy);
420 /* ----------------------------------------------------- */
421 case 'n': /* resolution */
422 sscanf(optarg, "%d", &NumResolution);
424 /* ----------------------------------------------------- */
425 case 'c': /* precinct dimension */
426 sscanf(optarg, "%d,%d", &prcw_init, &prch_init);
429 /* ----------------------------------------------------- */
430 case 'b': /* code-block dimension */
431 sscanf(optarg, "%d,%d", &cblockw_init, &cblockh_init);
432 if (cblockw_init * cblockh_init > 4096 || cblockw_init > 1024
433 || cblockw_init < 4 || cblockh_init > 1024
434 || cblockh_init < 4) {
436 "!! Size of code_block error (option -b) !!\n\nRestriction :\n * width*height<=4096\n * 4<=width,height<= 1024\n\n");
440 /* ----------------------------------------------------- */
441 case 'x': /* creation of index file */
445 /* ----------------------------------------------------- */
446 case 'p': /* progression order */
448 for (i = 0; i < 4; i++) {
452 Prog_order = give_progression(progression);
454 if (Prog_order == -1) {
456 "Unrecognized progression order [LRCP, RLCP, RPCL, PCRL, CPRL] !!\n");
460 /* ----------------------------------------------------- */
461 case 's': /* subsampling factor */
462 if (sscanf(optarg, "%d,%d", &subsampling_dx, &subsampling_dy)
465 "'-s' sub-sampling argument error ! [-s dx,dy]\n");
469 /* ----------------------------------------------------- */
470 case 'd': /* coordonnate of the reference grid */
471 if (sscanf(optarg, "%d,%d", &Dim[0], &Dim[1]) != 2) {
473 "-d 'coordonnate of the reference grid' argument error !! [-d x0,y0]\n");
477 /* ----------------------------------------------------- */
478 case 'h': /* Display an help description */
482 /* ----------------------------------------------------- */
484 fprintf(stderr, "/----------------------------------\\\n");
485 fprintf(stderr, "| POC option not fully tested !! |\n");
486 fprintf(stderr, "\\----------------------------------/\n");
489 while (sscanf(s, "T%d=%d,%d,%d,%d,%d,%s", &POC[numpocs].tile,
490 &POC[numpocs].resno0, &POC[numpocs].compno0,
491 &POC[numpocs].layno1, &POC[numpocs].resno1,
492 &POC[numpocs].compno1,
493 POC[numpocs].progorder) == 7) {
495 give_progression(POC[numpocs].progorder);
496 /* POC[numpocs].tile; */
498 while (*s && *s != '/') {
506 /* ------------------------------------------------------ */
507 case 'S': /* SOP marker */
510 /* ------------------------------------------------------ */
511 case 'E': /* EPH marker */
514 /* ------------------------------------------------------ */
515 case 'M': /* Mode switch pas tous au point !! */
516 if (sscanf(optarg, "%d", &value) == 1) {
517 for (i = 0; i <= 5; i++) {
518 int cache = value & (1 << i);
524 /* ------------------------------------------------------ */
526 if (sscanf(optarg, "OI:c=%d,U=%d", &ROI_compno, &ROI_shift) !=
529 "ROI error !! [-ROI:c='compno',U='shift']\n");
533 /* ------------------------------------------------------ */
534 case 'T': /* Tile offset */
535 if (sscanf(optarg, "%d,%d", &TX0, &TY0) != 2) {
537 "-T 'tile offset' argument error !! [-T X0,Y0]");
541 /* ------------------------------------------------------ */
542 case 'C': /* Add a comment */
545 /* ------------------------------------------------------ */
546 case 'I': /* reversible or not */
549 /* ------------------------------------------------------ */
560 if (!infile || !outfile) {
562 "usage: image_to_j2k -i image-file -o j2k-file (+ options)\n");
566 if (cp.disto_alloc & cp.fixed_alloc) {
568 "Error: option -r and -q can not be used together !!\n");
572 /* if no rate entered, lossless by default */
573 if (tcp_init->numlayers == 0) {
574 tcp_init->rates[tcp_init->numlayers] = 1;
575 tcp_init->numlayers++;
579 if (TX0 > Dim[0] || TY0 > Dim[1]) {
581 "Error: Tile offset dimension is unnappropriate --> TX0(%d)<=IMG_X0(%d) TYO(%d)<=IMG_Y0(%d) \n",
582 TX0, Dim[0], TY0, Dim[1]);
586 for (i = 0; i < numpocs; i++) {
587 if (POC[i].prg == -1) {
589 "Unrecognized progression order in option -P (POC n %d) [LRCP, RLCP, RPCL, PCRL, CPRL] !!\n",
594 switch (cp.image_type) {
598 (infile, &img, cp.tdy, subsampling_dx, subsampling_dy, Dim,
600 fprintf(stderr, "not a pgx file\n");
605 (infile, &img, -1, subsampling_dx, subsampling_dy, Dim,
607 fprintf(stderr, " not a pgx file\n");
614 if (!pnmtoimage(infile, &img, subsampling_dx, subsampling_dy, Dim)) {
615 fprintf(stderr, " not a pnm file\n");
621 if (!bmptoimage(infile, &img, subsampling_dx, subsampling_dy, Dim)) {
622 fprintf(stderr, " not a bmp file\n");
627 /* to respect profile - 0 */
628 /* ---------------------- */
630 /* while (int_ceildiv(img.x1,(1<<numD_min))-int_ceildiv(img.x0,(1<<numD_min))>120 || int_ceildiv(img.y1,(1<<numD_min))-int_ceildiv(img.y0,(1<<numD_min))>160) numD_min++;
631 if ((numD_min+1)>NumResolution)
633 fprintf(stderr,"\n********************************************************************************\n\n");
634 fprintf(stderr, "In view to respect Profile-0, the number of resolution used is %d in place of %d\n\n",numD_min+1,NumResolution);
635 fprintf(stderr, "********************************************************************************\n\n");
636 NumResolution=numD_min+1;
640 cp.tw = int_ceildiv(img.x1 - cp.tx0, cp.tdx);
641 cp.th = int_ceildiv(img.y1 - cp.ty0, cp.tdy);
643 cp.tdx = img.x1 - cp.tx0;
644 cp.tdy = img.y1 - cp.ty0;
647 /* Initialization for PPM marker */
653 /* Init the mutiple tiles */
654 /* ---------------------- */
655 cp.tcps = (j2k_tcp_t *) malloc(cp.tw * cp.th * sizeof(j2k_tcp_t));
657 for (tileno = 0; tileno < cp.tw * cp.th; tileno++) {
658 tcp = &cp.tcps[tileno];
659 tcp->numlayers = tcp_init->numlayers;
660 for (j = 0; j < tcp->numlayers; j++) {
661 tcp->rates[j] = tcp_init->rates[j];
664 tcp->prg = Prog_order;
665 tcp->mct = img.numcomps == 3 ? 1 : 0;
667 tcp->ppt_data = NULL;
673 /* intialisation of POC */
675 for (i = 0; i < numpocs; i++) {
676 if (tileno == POC[i].tile - 1 || POC[i].tile == -1) {
677 tcp_poc = &tcp->pocs[numpocs_tile];
678 tcp_poc->resno0 = POC[numpocs_tile].resno0;
679 tcp_poc->compno0 = POC[numpocs_tile].compno0;
680 tcp_poc->layno1 = POC[numpocs_tile].layno1;
681 tcp_poc->resno1 = POC[numpocs_tile].resno1;
682 tcp_poc->compno1 = POC[numpocs_tile].compno1;
683 tcp_poc->prg = POC[numpocs_tile].prg;
684 tcp_poc->tile = POC[numpocs_tile].tile;
689 tcp->numpocs = numpocs_tile;
691 (j2k_tccp_t *) malloc(img.numcomps * sizeof(j2k_tccp_t));
693 for (i = 0; i < img.numcomps; i++) {
694 tccp = &tcp->tccps[i];
695 tccp->csty = CSty & 0x01; /* 0 => one precinct || 1 => custom precinct */
696 tccp->numresolutions = NumResolution;
697 tccp->cblkw = int_floorlog2(cblockw_init);
698 tccp->cblkh = int_floorlog2(cblockh_init);
699 tccp->cblksty = mode;
700 tccp->qmfbid = ir ? 0 : 1;
702 ir ? J2K_CCP_QNTSTY_SEQNT : J2K_CCP_QNTSTY_NOQNT;
705 tccp->roishift = ROI_shift;
708 if (CSty & J2K_CCP_CSTY_PRT) {
710 for (j = 0; j < tccp->numresolutions; j++) {
711 int size_prcw, size_prch;
713 prcw_init >> (tccp->numresolutions - j - 1);
715 prch_init >> (tccp->numresolutions - j - 1);
720 int_floorlog2(prcw_init >>
721 (tccp->numresolutions - j - 1));
727 int_floorlog2(prch_init >>
728 (tccp->numresolutions - j - 1));
732 for (j = 0; j < tccp->numresolutions; j++) {
737 calc_explicit_stepsizes(tccp, img.comps[i].prec);
741 len = j2k_encode(&img, &cp, outfile, cp.tdx * cp.tdy * 2, index);
743 fprintf(stderr, "failed to encode image\n");
747 /* Remove the temporary files */
748 /* -------------------------- */
749 if (cp.image_type) { /* PNM PGM PPM */
750 for (i = 0; i < img.numcomps; i++) {
752 sprintf(&tmp, "Compo%d", i);
753 if (remove(&tmp) == -1) {
754 fprintf(stderr, "failed to kill %s file !\n", &tmp);
758 for (i = 0; i < cp.th; i++) {
760 sprintf(&tmp, "bandtile%d", i + 1);
762 if (remove(&tmp) == -1) {
763 fprintf(stderr, "failed to kill %s file !\n", &tmp);