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");
44 printf("- the option -help displays the readme.txt file on screen\n\n");
47 printf("List of parameters for the coder JPEG 2000 :\n");
50 ("- 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");
53 ("- 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");
55 printf("REMARKS :\n");
56 printf("---------\n");
59 ("* the value of rate enter in the code line is the compression factor !\n");
60 printf("exemple :\n");
63 ("-r 20,10,1 means quality 1 : compress 20x, quality 2 : compress 10x and quality 3 : compress 1x = lossless\n");
65 printf("By default :\n");
66 printf("------------\n");
68 printf(" * lossless\n");
69 printf(" * 1 tile\n");
70 printf(" * size of precinct 2^15 x 2^15 (means 1 precinct)\n");
71 printf(" * size of code-block 64 x 64\n");
72 printf(" * Number of resolution : 6\n");
73 printf(" * No SOP marker in the codestream\n");
74 printf(" * No EPH marker in the codestream\n");
75 printf(" * No sub-sampling in x and y direction\n");
76 printf(" * No mode switch activated\n");
77 printf(" * progression order : LRCP\n");
78 printf(" * No index file\n");
79 printf(" * No ROI upshifted\n");
80 printf(" * No offset of the origin of the image\n");
81 printf(" * No offset of the origin of the tiles\n");
82 printf(" * Reversible DWT 5-3\n");
84 printf("Parameters :\n");
85 printf("------------\n");
88 ("-i : source file (-i source.pnm also *.pgm, *.ppm) required\n");
90 printf("-o : destination file (-o dest.j2k) required\n");
92 printf("-help : Display the help information optional\n ");
94 printf("-r : different rates (-r 20,10,5) optional\n ");
96 printf("-n : Number of resolution (-n 3) optional\n");
98 printf("-b : size of code block (-b 32,32) optional\n");
100 printf("-c : size of precinct (-c 128,128) optional\n");
102 printf("-t : size of tile (-t 512,512) optional\n");
105 ("-p : progression order (-p LRCP) [LRCP, RLCP, RPCL, PCRL, CPRL] optional\n");
108 ("-s : subsampling factor (-s 2,2) [-s X,Y] optional\n");
111 ("-SOP : write SOP marker before each packet optional\n");
114 ("-EPH : write EPH marker after each header packet optional\n");
117 ("-M : mode switch (-M 3) [1=BYPASS(LAZY) 2=RESET 4=RESTART(TERMALL) 8=VSC 16=ERTERM(SEGTERM) 32=SEGMARK(SEGSYM)] optional\n");
119 (" for several mode switch you have to add the value of each mode you want\n");
121 (" ex : RESTART(4) + RESET(2) + SEGMARK(32) = -M 38\n");
124 ("-x : Create an index file *.Idx (-x index_name.Idx) optional\n");
127 ("-ROI:c=%%d,U=%%d : quantization indices upshifted for component c=%%d [\%%d = 0,1,2]\n");
129 (" with a value of U=%%d [0 <= %%d <= 37] (i.e. -ROI:c=0,U=25) optional\n");
132 ("-d : offset of the origin of the image (-d 150,300) optional\n");
135 ("-T : offset of the origin of the tiles (-T 100,75) optional\n");
137 printf("-I : Use the irreversible DWT 9-7 (-I) optional\n");
139 printf("IMPORTANT :\n");
140 printf("-----------\n");
142 printf("* subsampling bigger than 2 can produce error\n");
144 printf("The index file respect the structure below :\n");
145 printf("---------------------------------------------\n");
147 printf("Image_height Image_width\n");
148 printf("progression order\n");
149 printf("Tiles_size_X Tiles_size_Y\n");
150 printf("Components_nb\n");
151 printf("Layers_nb\n");
152 printf("decomposition_levels\n");
153 printf("Precincts_size_X Precincts_size_Y\n");
154 printf("Main_header_end_position\n");
155 printf("Codestream_size\n");
156 printf("Tile0 start_pos end_Theader end_pos\n");
157 printf("Tile1 '' '' ''\n");
159 printf("TileN '' '' ''\n");
160 printf("Tpacket_0 Tile layer res. comp. prec. start_pos end_pos\n");
162 printf("Tpacket_M '' '' '' '' '' '' ''\n");
165 int give_progression(char progression[4])
167 if (progression[0] == 'L' && progression[1] == 'R'
168 && progression[2] == 'C' && progression[3] == 'P') {
171 if (progression[0] == 'R' && progression[1] == 'L'
172 && progression[2] == 'C' && progression[3] == 'P') {
175 if (progression[0] == 'R' && progression[1] == 'P'
176 && progression[2] == 'C' && progression[3] == 'L') {
179 if (progression[0] == 'P' && progression[1] == 'C'
180 && progression[2] == 'R' && progression[3] == 'L') {
183 if (progression[0] == 'C' && progression[1] == 'P'
184 && progression[2] == 'R' && progression[3] == 'L') {
195 double dwt_norms_97[4][10] = {
196 {1.000, 1.965, 4.177, 8.403, 16.90, 33.84, 67.69, 135.3, 270.6, 540.9},
197 {2.022, 3.989, 8.355, 17.04, 34.27, 68.63, 137.3, 274.6, 549.0},
198 {2.022, 3.989, 8.355, 17.04, 34.27, 68.63, 137.3, 274.6, 549.0},
199 {2.080, 3.865, 8.307, 17.18, 34.71, 69.59, 139.3, 278.6, 557.2}
205 for (l = 0; a > 1; l++) {
211 void encode_stepsize(int stepsize, int numbps, int *expn, int *mant)
214 p = floorlog2(stepsize) - 13;
215 n = 11 - floorlog2(stepsize);
216 *mant = (n < 0 ? stepsize >> -n : stepsize << n) & 0x7ff;
220 void calc_explicit_stepsizes(j2k_tccp_t * tccp, int prec)
222 int numbands, bandno;
223 numbands = 3 * tccp->numresolutions - 2;
224 for (bandno = 0; bandno < numbands; bandno++) {
227 int resno, level, orient, gain;
228 resno = bandno == 0 ? 0 : (bandno - 1) / 3 + 1;
229 orient = bandno == 0 ? 0 : (bandno - 1) % 3 + 1;
230 level = tccp->numresolutions - 1 - resno;
232 tccp->qmfbid == 0 ? 0 : (orient ==
234 || orient == 2 ? 1 : 2));
235 if (tccp->qntsty == J2K_CCP_QNTSTY_NOQNT) {
238 double norm = dwt_norms_97[orient][level];
239 stepsize = (1 << (gain + 1)) / norm;
241 encode_stepsize((int) floor(stepsize * 8192.0), prec + gain,
242 &tccp->stepsizes[bandno].expn,
243 &tccp->stepsizes[bandno].mant);
247 int main(int argc, char **argv)
250 int NumResolution, numD_min; /* NumResolution : number of resolution */
251 int Tile_arg; /* Tile_arg = 0 (not in argument) ou = 1 (in argument) */
252 int CSty; /* CSty : coding style */
253 int Prog_order; /* progression order (default LRCP) */
255 int numpocs, numpocs_tile; /* Number of progression order change (POC) default 0 */
256 int prcw_init[J2K_MAXRLVLS]; /* Initialisation Precinct width */
257 int prch_init[J2K_MAXRLVLS]; /* Initialisation Precinct height */
258 //int prcw_init, prch_init; /* Initialisation precincts' size */
259 int cblockw_init, cblockh_init; /* Initialisation codeblocks' size */
260 int mode, value; /* Mode switch (cblk_style) */
261 int subsampling_dx, subsampling_dy; /* subsampling value for dx and dy */
262 int ROI_compno, ROI_shift; /* region of interrest */
263 int Dim[2]; /* portion of the image coded */
264 int TX0, TY0; /* tile off-set */
266 j2k_cp_t cp, cp_init; /* cp_init is used to initialise in multiple tiles */
267 j2k_tcp_t *tcp, *tcp_init; /* tcp_init is used to initialise in multiple tile */
268 j2k_poc_t POC[32]; /* POC : used in case of Progression order change */
277 int res_spec = 0; /* For various precinct sizes specification */
294 ROI_compno = -1; /* no ROI */
306 cp_init.tcps = (j2k_tcp_t *) malloc(sizeof(j2k_tcp_t)); /* initialisation if only one tile */
307 tcp_init = &cp_init.tcps[0];
308 tcp_init->numlayers = 0;
311 int c = getopt(argc, argv,
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'
347 if ((S1 == 'b' && S2 == 'm' && S3 == 'p')
348 || (S1 == 'B' && S2 == 'M' && S3 == 'P')) {
353 "!! Unrecognized format for infile : %c%c%c [accept only *.pnm, *.pgm, *.ppm, *.pgx or *.bmp] !!\n\n",
357 /* ----------------------------------------------------- */
358 case 'o': /* OUT fill */
361 /* ----------------------------------------------------- */
362 case 'r': /* rates rates/distorsion */
364 while (sscanf(s, "%d", &tcp_init->rates[tcp_init->numlayers])
366 tcp_init->numlayers++;
367 while (*s && *s != ',') {
377 /* ----------------------------------------------------- */
378 case 'q': /* rates fixed */
380 sscanf(s, "%d", &tcp_init->numlayers);
382 if (tcp_init->numlayers > 9)
385 (int *) malloc(tcp_init->numlayers * NumResolution * 3 *
388 for (i = 0; i < tcp_init->numlayers; i++) {
389 tcp_init->rates[i] = 1;
390 sscanf(s, "%d,", &cp.matrice[i * NumResolution * 3]);
392 if (cp.matrice[i * NumResolution * 3] > 9)
394 cp.matrice[i * NumResolution * 3 + 1] = 0;
395 cp.matrice[i * NumResolution * 3 + 2] = 0;
396 for (j = 1; j < NumResolution; j++) {
397 sscanf(s, "%d,%d,%d",
398 &cp.matrice[i * NumResolution * 3 + j * 3 + 0],
399 &cp.matrice[i * NumResolution * 3 + j * 3 + 1],
400 &cp.matrice[i * NumResolution * 3 + j * 3 + 2]);
402 if (cp.matrice[i * NumResolution * 3 + j * 3] > 9)
404 if (cp.matrice[i * NumResolution * 3 + j * 3 + 1] > 9)
406 if (cp.matrice[i * NumResolution * 3 + j * 3 + 2] > 9)
409 if (i < tcp_init->numlayers - 1)
414 /* ----------------------------------------------------- */
415 case 't': /* tiles */
416 sscanf(optarg, "%d,%d", &cp.tdx, &cp.tdy);
419 /* ----------------------------------------------------- */
420 case 'n': /* resolution */
421 sscanf(optarg, "%d", &NumResolution);
423 /* ----------------------------------------------------- */
424 case 'c': /* precinct dimension */
428 sscanf(s, "[%d,%d]%c", &prcw_init[res_spec],
429 &prch_init[res_spec], &sep);
432 s = strpbrk(s, "]") + 2;
433 } while (sep == ',');
435 /* ----------------------------------------------------- */
436 case 'b': /* code-block dimension */
437 sscanf(optarg, "%d,%d", &cblockw_init, &cblockh_init);
438 if (cblockw_init * cblockh_init > 4096 || cblockw_init > 1024
439 || cblockw_init < 4 || cblockh_init > 1024 || cblockh_init < 4) {
441 "!! Size of code_block error (option -b) !!\n\nRestriction :\n * width*height<=4096\n * 4<=width,height<= 1024\n\n");
445 /* ----------------------------------------------------- */
446 case 'x': /* creation of index file */
450 /* ----------------------------------------------------- */
451 case 'p': /* progression order */
453 for (i = 0; i < 4; i++) {
457 Prog_order = give_progression(progression);
459 if (Prog_order == -1) {
461 "Unrecognized progression order [LRCP, RLCP, RPCL, PCRL, CPRL] !!\n");
465 /* ----------------------------------------------------- */
466 case 's': /* subsampling factor */
467 if (sscanf(optarg, "%d,%d", &subsampling_dx, &subsampling_dy)
470 "'-s' sub-sampling argument error ! [-s dx,dy]\n");
474 /* ----------------------------------------------------- */
475 case 'd': /* coordonnate of the reference grid */
476 if (sscanf(optarg, "%d,%d", &Dim[0], &Dim[1]) != 2) {
478 "-d 'coordonnate of the reference grid' argument error !! [-d x0,y0]\n");
482 /* ----------------------------------------------------- */
483 case 'h': /* Display an help description */
487 /* ----------------------------------------------------- */
489 fprintf(stderr, "/----------------------------------\\\n");
490 fprintf(stderr, "| POC option not fully tested !! |\n");
491 fprintf(stderr, "\\----------------------------------/\n");
494 while (sscanf(s, "T%d=%d,%d,%d,%d,%d,%s", &POC[numpocs].tile,
495 &POC[numpocs].resno0, &POC[numpocs].compno0,
496 &POC[numpocs].layno1, &POC[numpocs].resno1,
497 &POC[numpocs].compno1, POC[numpocs].progorder) == 7) {
498 POC[numpocs].prg = give_progression(POC[numpocs].progorder);
499 /* POC[numpocs].tile; */
501 while (*s && *s != '/') {
509 /* ------------------------------------------------------ */
510 case 'S': /* SOP marker */
513 /* ------------------------------------------------------ */
514 case 'E': /* EPH marker */
517 /* ------------------------------------------------------ */
518 case 'M': /* Mode switch pas tous au point !! */
519 if (sscanf(optarg, "%d", &value) == 1) {
520 for (i = 0; i <= 5; i++) {
521 int cache = value & (1 << i);
527 /* ------------------------------------------------------ */
529 if (sscanf(optarg, "OI:c=%d,U=%d", &ROI_compno, &ROI_shift) != 2) {
530 fprintf(stderr, "ROI error !! [-ROI:c='compno',U='shift']\n");
534 /* ------------------------------------------------------ */
535 case 'T': /* Tile offset */
536 if (sscanf(optarg, "%d,%d", &TX0, &TY0) != 2) {
537 fprintf(stderr, "-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, cp)) {
606 fprintf(stderr, " not a pgx file\n");
613 if (!pnmtoimage(infile, &img, subsampling_dx, subsampling_dy, Dim)) {
614 fprintf(stderr, " not a pnm file\n");
620 if (!bmptoimage(infile, &img, subsampling_dx, subsampling_dy, Dim)) {
621 fprintf(stderr, " not a bmp file\n");
626 /* to respect profile - 0 */
627 /* ---------------------- */
629 /* 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++;
630 if ((numD_min+1)>NumResolution)
632 fprintf(stderr,"\n********************************************************************************\n\n");
633 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);
634 fprintf(stderr, "********************************************************************************\n\n");
635 NumResolution=numD_min+1;
639 cp.tw = int_ceildiv(img.x1 - cp.tx0, cp.tdx);
640 cp.th = int_ceildiv(img.y1 - cp.ty0, cp.tdy);
642 cp.tdx = img.x1 - cp.tx0;
643 cp.tdy = img.y1 - cp.ty0;
646 /* Initialization for PPM marker */
652 /* Init the mutiple tiles */
653 /* ---------------------- */
654 cp.tcps = (j2k_tcp_t *) malloc(cp.tw * cp.th * sizeof(j2k_tcp_t));
656 for (tileno = 0; tileno < cp.tw * cp.th; tileno++) {
657 tcp = &cp.tcps[tileno];
658 tcp->numlayers = tcp_init->numlayers;
659 for (j = 0; j < tcp->numlayers; j++) {
660 tcp->rates[j] = tcp_init->rates[j];
663 tcp->prg = Prog_order;
664 tcp->mct = img.numcomps == 3 ? 1 : 0;
666 tcp->ppt_data = NULL;
672 /* intialisation of POC */
674 for (i = 0; i < numpocs; i++) {
675 if (tileno == POC[i].tile - 1 || POC[i].tile == -1) {
676 tcp_poc = &tcp->pocs[numpocs_tile];
677 tcp_poc->resno0 = POC[numpocs_tile].resno0;
678 tcp_poc->compno0 = POC[numpocs_tile].compno0;
679 tcp_poc->layno1 = POC[numpocs_tile].layno1;
680 tcp_poc->resno1 = POC[numpocs_tile].resno1;
681 tcp_poc->compno1 = POC[numpocs_tile].compno1;
682 tcp_poc->prg = POC[numpocs_tile].prg;
683 tcp_poc->tile = POC[numpocs_tile].tile;
688 tcp->numpocs = numpocs_tile;
689 tcp->tccps = (j2k_tccp_t *) malloc(img.numcomps * sizeof(j2k_tccp_t));
691 for (i = 0; i < img.numcomps; i++) {
692 tccp = &tcp->tccps[i];
693 tccp->csty = CSty & 0x01; /* 0 => one precinct || 1 => custom precinct */
694 tccp->numresolutions = NumResolution;
695 tccp->cblkw = int_floorlog2(cblockw_init);
696 tccp->cblkh = int_floorlog2(cblockh_init);
697 tccp->cblksty = mode;
698 tccp->qmfbid = ir ? 0 : 1;
699 tccp->qntsty = ir ? J2K_CCP_QNTSTY_SEQNT : J2K_CCP_QNTSTY_NOQNT;
702 tccp->roishift = ROI_shift;
705 if (CSty & J2K_CCP_CSTY_PRT) {
707 for (j = tccp->numresolutions - 1; j >= 0; j--) {
709 if (prcw_init[p] < 1)
712 tccp->prcw[j] = int_floorlog2(prcw_init[p]);
714 if (prch_init[p] < 1)
717 tccp->prch[j] = int_floorlog2(prch_init[p]);
719 int size_prcw, size_prch;
720 size_prcw = prcw_init[res_spec - 1] >> (p - (res_spec - 1));
721 size_prch = prch_init[res_spec - 1] >> (p - (res_spec - 1));
725 tccp->prcw[j] = int_floorlog2(size_prcw);
729 tccp->prch[j] = int_floorlog2(size_prch);
732 /*printf("\nsize precinct pour level %d : %d,%d\n", j,
733 tccp->prcw[j], tccp->prch[j]);*/
736 for (j = 0; j < tccp->numresolutions; j++) {
741 calc_explicit_stepsizes(tccp, img.comps[i].prec);
745 len = j2k_encode(&img, &cp, outfile, cp.tdx * cp.tdy * 2, index);
747 fprintf(stderr, "failed to encode image\n");
751 /* Remove the temporary files */
752 /* -------------------------- */
753 if (cp.image_type) { /* PNM PGM PPM */
754 for (i = 0; i < img.numcomps; i++) {
756 sprintf(&tmp, "Compo%d", i);
757 if (remove(&tmp) == -1) {
758 fprintf(stderr, "failed to kill %s file !\n", &tmp);
762 for (i = 0; i < cp.th; i++) {
764 sprintf(&tmp, "bandtile%d", i + 1);
766 if (remove(&tmp) == -1) {
767 fprintf(stderr, "failed to kill %s file !\n", &tmp);