encoderspecs.java

jpeg2000算法实现

/*
 * CVS identifier:
 *
 * $Id: EncoderSpecs.java,v 1.32 2000/12/22 12:48:26 grosbois Exp $
 *
 * Class:                   EncoderSpecs
 *
 * Description:             Hold all encoder specifications
 *
 *
 *
 * COPYRIGHT:
 * 
 * This software module was originally developed by Rapha雔 Grosbois and
 * Diego Santa Cruz (Swiss Federal Institute of Technology-EPFL); Joel
 * Askel鰂 (Ericsson Radio Systems AB); and Bertrand Berthelot, David
 * Bouchard, F閘ix Henry, Gerard Mozelle and Patrice Onno (Canon Research
 * Centre France S.A) in the course of development of the JPEG2000
 * standard as specified by ISO/IEC 15444 (JPEG 2000 Standard). This
 * software module is an implementation of a part of the JPEG 2000
 * Standard. Swiss Federal Institute of Technology-EPFL, Ericsson Radio
 * Systems AB and Canon Research Centre France S.A (collectively JJ2000
 * Partners) agree not to assert against ISO/IEC and users of the JPEG
 * 2000 Standard (Users) any of their rights under the copyright, not
 * including other intellectual property rights, for this software module
 * with respect to the usage by ISO/IEC and Users of this software module
 * or modifications thereof for use in hardware or software products
 * claiming conformance to the JPEG 2000 Standard. Those intending to use
 * this software module in hardware or software products are advised that
 * their use may infringe existing patents. The original developers of
 * this software module, JJ2000 Partners and ISO/IEC assume no liability
 * for use of this software module or modifications thereof. No license
 * or right to this software module is granted for non JPEG 2000 Standard
 * conforming products. JJ2000 Partners have full right to use this
 * software module for his/her own purpose, assign or donate this
 * software module to any third party and to inhibit third parties from
 * using this software module for non JPEG 2000 Standard conforming
 * products. This copyright notice must be included in all copies or
 * derivative works of this software module.
 * 
 * Copyright (c) 1999/2000 JJ2000 Partners.
 * */
package jj2000.j2k.encoder;

import jj2000.j2k.quantization.quantizer.*;
import jj2000.j2k.image.forwcomptransf.*;
import jj2000.j2k.wavelet.analysis.*;
import jj2000.j2k.entropy.encoder.*;
import jj2000.j2k.quantization.*;
import jj2000.j2k.wavelet.*;
import jj2000.j2k.entropy.*;
import jj2000.j2k.util.*;
import jj2000.j2k.image.*;
import jj2000.j2k.roi.*;
import jj2000.j2k.*;

/** 
 * This class holds references to each module specifications used in the
 * encoding chain. This avoid big amount of arguments in method calls. A
 * specification contains values of each tile-component for one module. All
 * members must be instance of ModuleSpec class (or its children).
 *
 * @see ModuleSpec 
 * */
public class EncoderSpecs{

    /** ROI maxshift value specifications */
    public MaxShiftSpec rois;

    /** Quantization type specifications */
    public QuantTypeSpec qts;

    /** Quantization normalized base step size specifications */
    public QuantStepSizeSpec qsss;

    /** Number of guard bits specifications */
    public GuardBitsSpec gbs;

    /** Analysis wavelet filters specifications */
    public AnWTFilterSpec wfs;

    /** Component transformation specifications */
    public CompTransfSpec cts;

    /** Number of decomposition levels specifications */
    public IntegerSpec dls;

    /** The length calculation specifications */
    public StringSpec lcs;

    /** The termination type specifications */
    public StringSpec tts;

    /** Error resilience segment symbol use specifications */
    public StringSpec sss;

    /** Causal stripes specifications */
    public StringSpec css;

    /** Regular termination specifications */
    public StringSpec rts;

    /** MQ reset specifications */
    public StringSpec mqrs;

    /** By-pass mode specifications */
    public StringSpec bms;
    
    /** Precinct partition specifications */
    public PrecinctSizeSpec pss;

    /** Start of packet (SOP) marker use specification */
    public StringSpec sops;

    /** End of packet header (EPH) marker use specification */
    public StringSpec ephs;

    /** Code-blocks sizes specification */
    public CBlkSizeSpec cblks;

    /** Progression/progression changes specification */
    public ProgressionSpec ps;

    /** The number of tiles within the image */
    public int nTiles;

    /** The number of components within the image */
    public int nComp;

    /** 
     * Initialize all members with the given number of tiles and components
     * and the command-line arguments stored in a ParameterList instance
     *
     * @param nt Number of tiles
     *
     * @param nc Number of components
     *
     * @param imgsrc The image source (used to get the image size)
     *
     * @param pl The ParameterList instance
     * */
    public EncoderSpecs(int nt, int nc, BlkImgDataSrc imgsrc, 
                       ParameterList pl){
        nTiles = nt;
        nComp  = nc;

        // ROI
        rois = new MaxShiftSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP);

        // Quantization
        pl.checkList(Quantizer.OPT_PREFIX,
                     pl.toNameArray(Quantizer.getParameterInfo()));
        qts  = new QuantTypeSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,pl);
        qsss = new QuantStepSizeSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,pl);
        gbs  = new GuardBitsSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,pl);

        // Wavelet transform
        wfs = new AnWTFilterSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,qts,pl);
        dls = new IntegerSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,pl,"Wlev");

        // Component transformation
        cts = new ForwCompTransfSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE,wfs,pl);

        // Entropy coder
        String[] strLcs = {"near_opt","lazy_good","lazy"};
        lcs = new StringSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,
                             "Clen_calc",strLcs,pl);
        String[] strTerm = {"near_opt","easy","predict","full"};
        tts = new StringSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,
                             "Cterm",strTerm,pl);
        String[] strBoolean = {"on","off"};
        sss = new StringSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,
                             "Cseg_symbol",strBoolean,pl);
        css = new StringSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,
                             "Ccausal",strBoolean,pl);
        rts = new StringSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,
                             "Creg_term",strBoolean,pl);
        mqrs = new StringSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,
                              "CresetMQ",strBoolean,pl);
        bms = new StringSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,
                             "Cbypass",strBoolean,pl);
        cblks = new CBlkSizeSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,pl);
        
        // Precinct partition
        pss = new PrecinctSizeSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE_COMP,
                                   imgsrc,dls,pl);

        // Codestream
        sops = new StringSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE,"Psop",
                              strBoolean,pl);
        ephs = new StringSpec(nt,nc,ModuleSpec.SPEC_TYPE_TILE,"Peph",
                              strBoolean,pl);

    }
}