cod_params

Manages the information associated with JPEG2000 COD and COC marker segments. Tile- and component-specific forms are allowed (in fact, required for a complete code-stream description); however, not all attributes are allowed to have component-specific values; these are marked in the list below as having the ALL_COMPONENTS flag set.

The cluster name is "COD", but you are recommended to use the macro COD_params, in functions which take a cluster name like kdu_params::access_cluster.

The following attributes are defined. For an explanation of pattern strings, consult the comments appearing with kdu_params::parse_string.

• Macro = Cycc; Pattern = "B", [ALL_COMPONENTS] — RGB to Luminance-Chrominance conversion? Default is to convert 3 component images to a luminance-chrominance representation, using either the reversible or the irreversible colour transform, depending on the state of Creversible.
• Macro = Clayers; Pattern = "I", [ALL_COMPONENTS] — Number of quality layers. Default is 1.
• Macro = Cuse_sop; Pattern = "B", [ALL_COMPONENTS] — Include SOP markers (i.e., resync markers)? Default is no SOP markers.
• Macro = Cuse_eph; Pattern = "B", [ALL_COMPONENTS] — Include EPH markers (marker end of each packet header)? Default is no EPH markers.
• Macro = Corder; Pattern = "(LRCP=0,RLCP=1,RPCL=2,PCRL=3,CPRL=4)", [ALL_COMPONENTS] Default progression order (may be overridden by POCorder. The four character identifiers have the following interpretation: L=layer; R=resolution; C=component; P=position. The first character in the identifier refers to the index which progresses most slowly, while the last refers to the index which progresses most quickly. Default is "LRCP". When working with the kdu_params::set and kdu_params::get functions, use one of the macros, Corder_LRCP, Corder_RLCP, Corder_RPCL, Corder_PCRL or Corder_CPRL to set or test for specific progression orders.
• Macro = Calign_blk_last; Pattern = "BB", [ALL_COMPONENTS] — If true, the code-block partition is aligned so that the last sample in each nominal block (ignoring the effect of boundaries) is aligned at a multiple of the block dimension (a power of 2). Equivalently, the first sample in each nominal block lies at a location which is a multiple of the block dimension, plus 1. By default (i.e., false), the first sample of each block is aligned at a multiple of the block dimension. The alignment is specified separately for both dimensions, with the vertical dimension specified first.
• Macro = Clevels; Pattern = "I" — Number of wavelet decomposition levels, or stages. Default is 5.
• Macro = Creversible; Pattern = "B" — Reversible compression? Default is irreversible].
• Macro = Ckernels; Pattern = "(W9X7=0,W5X3=1)" — Wavelet kernels to use. Default is W5X3 for reversible compression and W9X7 for irreversible compression. When working with the kdu_params::set and kdu_params::get functions, use one of the macros, Ckernels_W9X7 or Ckernels_W5X3 to set or test for specific sets of wavelet kernels.
• Macro = Cuse_precincts; Pattern = "B" — Explicitly specify whether or not precinct dimensions are supplied. Default is false, unless Cprecincts is used.
• Macro = Cprecincts; Pattern = "II", [MULTI_RECORD, CAN_EXTRAPOLATE] — Precinct dimensions (must be powers of 2). Multiple records may be supplied, in which case the first record refers to the highest resolution level and subsequent records to lower resolution levels. The last specified record is used for any remaining lower resolution levels. Inside each record, vertical coordinates appear first.
• Macro = Cblk; Pattern = "II" — Nominal code-block dimensions (must be powers of 2 and no less than 4). Actual dimensions are subject to precinct, tile and image dimensions. Vertical coordinates appear first. Default block dimensions are {64,64}.
• Macro = Cmodes; Pattern = "[BYPASS=1|RESET=2|RESTART=4|CAUSAL=8|ERTERM=16|SEGMARK=32]" — Block coder mode switches. Any combination is legal. By default, all mode switches are turned off. When working with the kdu_params::set and kdu_params::get functions, use the macros, Cmodes_BYPASS, Cmodes_RESET, Cmodes_RESTART, Cmodes_CAUSAL, Cmodes_ERTERM and Cmodes_SEGMARK to set and test for specific modes.
• Macro = Cweight; Pattern = "F", Multiplier for subband weighting factors (see Clev_weights and Cband_weights below). Scaling all the weights by a single quantity has no impact on their relative significance. However, you may supply a separate weight for each component, or even each tile-component, allowing you to control the relative signicance of image components or tile-components in a simple manner.
• Macro = Clev_weights; Pattern = "F", [MULTI_RECORD, CAN_EXTRAPOLATE] — Weighting factors for each successive resolution level, starting from the highest resolution and working down to the lowest (but not including the LL band!!). The last supplied weight is repeated as necessary. Weight values are squared to obtain energy weights for weighted MSE calculations. The LL subband always has a weight of 1.0, regardless of the number of resolution levels. However, the weights associated with all subbands, including the LL band, are multiplied by the value supplied by Cweight, which may be specialized to individual components or tile-components.
• Macro = Cband_weights; Pattern = "F", [MULTI_RECORD, CAN_EXTRAPOLATE] — Weighting factors for each successive subband, starting from the highest frequency subbands and working down (i.e., HH1, LH1, HL1, HH2, ...). The last supplied weight is repeated as necessary for all remaining subbands (except the LL band). If Clev_weights is also supplied, both sets of weighting factors are combined (multiplied). Weight values are squared to obtain energy weights for weighted MSE calculations. The LL subband always has a weight of 1.0, which avoids problems which may occur when tiles or image components have different numbers of resolution levels. To modify the relative weighting of components or tile-components, including their LL subbands, use the Cweight option; its weighting factors are multiplied by those specified using Cband_weights and Clev_weights.

cod_params {Java: Cod_params}