001: /*
002: * $RCSfile: ROI.java,v $
003: * $Revision: 1.1 $
004: * $Date: 2005/02/11 05:02:22 $
005: * $State: Exp $
006: *
007: * Class: ROI
008: *
009: * Description: This class describes a single ROI
010: *
011: *
012: *
013: * COPYRIGHT:
014: *
015: * This software module was originally developed by Raphaël Grosbois and
016: * Diego Santa Cruz (Swiss Federal Institute of Technology-EPFL); Joel
017: * Askelöf (Ericsson Radio Systems AB); and Bertrand Berthelot, David
018: * Bouchard, Félix Henry, Gerard Mozelle and Patrice Onno (Canon Research
019: * Centre France S.A) in the course of development of the JPEG2000
020: * standard as specified by ISO/IEC 15444 (JPEG 2000 Standard). This
021: * software module is an implementation of a part of the JPEG 2000
022: * Standard. Swiss Federal Institute of Technology-EPFL, Ericsson Radio
023: * Systems AB and Canon Research Centre France S.A (collectively JJ2000
024: * Partners) agree not to assert against ISO/IEC and users of the JPEG
025: * 2000 Standard (Users) any of their rights under the copyright, not
026: * including other intellectual property rights, for this software module
027: * with respect to the usage by ISO/IEC and Users of this software module
028: * or modifications thereof for use in hardware or software products
029: * claiming conformance to the JPEG 2000 Standard. Those intending to use
030: * this software module in hardware or software products are advised that
031: * their use may infringe existing patents. The original developers of
032: * this software module, JJ2000 Partners and ISO/IEC assume no liability
033: * for use of this software module or modifications thereof. No license
034: * or right to this software module is granted for non JPEG 2000 Standard
035: * conforming products. JJ2000 Partners have full right to use this
036: * software module for his/her own purpose, assign or donate this
037: * software module to any third party and to inhibit third parties from
038: * using this software module for non JPEG 2000 Standard conforming
039: * products. This copyright notice must be included in all copies or
040: * derivative works of this software module.
041: *
042: * Copyright (c) 1999/2000 JJ2000 Partners.
043: */
044: package jj2000.j2k.roi.encoder;
045:
046: import jj2000.j2k.codestream.writer.*;
047: import jj2000.j2k.wavelet.analysis.*;
048: import jj2000.j2k.quantization.*;
049: import jj2000.j2k.image.input.*;
050: import jj2000.j2k.wavelet.*;
051: import jj2000.j2k.image.*;
052: import jj2000.j2k.util.*;
053: import jj2000.j2k.roi.*;
054:
055: /**
056: * This class contains the shape of a single ROI. In the current
057: * implementation only rectangles and circles are supported.
058: *
059: * @see ROIMaskGenerator
060: */
061: public class ROI {
062:
063: /** ImgReaderPGM object with the arbrtrary ROI */
064: public ImgReaderPGM maskPGM = null;
065:
066: /** Where or not the ROI shape is arbitrary */
067: public boolean arbShape;
068:
069: /** Flag indicating whether the ROI is rectangular or not */
070: public boolean rect;
071:
072: /** The components for which the ROI is relevant */
073: public int comp;
074:
075: /** x coordinate of upper left corner of rectangular ROI */
076: public int ulx;
077:
078: /** y coordinate of upper left corner of rectangular ROI */
079: public int uly;
080:
081: /** width of rectangular ROI */
082: public int w;
083:
084: /** height of rectangular ROI */
085: public int h;
086:
087: /** x coordinate of center of circular ROI */
088: public int x;
089:
090: /** y coordinate of center of circular ROI */
091: public int y;
092:
093: /** radius of circular ROI */
094: public int r;
095:
096: /**
097: * Constructor for ROI with arbitrary shape
098: *
099: * @param comp The component the ROI belongs to
100: *
101: * @param maskPGM ImgReaderPGM containing the ROI
102: */
103: public ROI(int comp, ImgReaderPGM maskPGM) {
104: arbShape = true;
105: rect = false;
106: this .comp = comp;
107: this .maskPGM = maskPGM;
108: }
109:
110: /**
111: * Constructor for rectangular ROIs
112: *
113: * @param comp The component the ROI belongs to
114: *
115: * @param x x-coordinate of upper left corner of ROI
116: *
117: * @param y y-coordinate of upper left corner of ROI
118: *
119: * @param w width of ROI
120: *
121: * @param h height of ROI
122: */
123: public ROI(int comp, int ulx, int uly, int w, int h) {
124: arbShape = false;
125: this .comp = comp;
126: this .ulx = ulx;
127: this .uly = uly;
128: this .w = w;
129: this .h = h;
130: rect = true;
131: }
132:
133: /**
134: * Constructor for circular ROIs
135: *
136: * @param comp The component the ROI belongs to
137: *
138: * @param x x-coordinate of center of ROI
139: *
140: * @param y y-coordinate of center of ROI
141: *
142: * @param w radius of ROI
143: */
144: public ROI(int comp, int x, int y, int rad) {
145: arbShape = false;
146: this .comp = comp;
147: this .x = x;
148: this .y = y;
149: this .r = rad;
150: }
151:
152: /**
153: * This function prints all relevant data for the ROI
154: */
155: public String toString() {
156: if (arbShape) {
157: return "ROI with arbitrary shape, PGM file= " + maskPGM;
158: } else if (rect)
159: return "Rectangular ROI, comp=" + comp + " ulx=" + ulx
160: + " uly=" + uly + " w=" + w + " h=" + h;
161: else
162: return "Circular ROI, comp=" + comp + " x=" + x + " y="
163: + y + " radius=" + r;
164:
165: }
166:
167: }
|