Class GenericRefinementRegionDecodingProcedure
This class is purely algorithmic. It has no knowledge of how its inputs
are obtained and no dependency on segment headers or input streams.
The entry point is the static decode() method; callers
supply the ArithmeticDecoder and CX context model directly,
so they decide whether to create fresh instances or share existing ones:
GenericRefinementRegion— creates its ownArithmeticDecoderandCX, then callsdecode().- Symbol dictionary refinement (§6.5.8.2) — passes the
parent dictionary's shared
ArithmeticDecoderandCX. - Text region refinement (§6.4) — passes the parent text
region's shared
ArithmeticDecoderandCX.
This class cannot be instantiated by callers. The private constructor and
the internal run(int, int, short, boolean, Bitmap, int, int, short[], short[]) method exist solely to let the many private helper
methods share state through fields rather than through long parameter lists.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic classEncapsulates the template-specific operations: context bit formation (GenericRefinementRegionDecodingProcedure.Template.form(short, short, short, short, short)) and initial CX index selection (GenericRefinementRegionDecodingProcedure.Template.setIndex(CX)).private static classprivate static class -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final ArithmeticDecoderprivate final CXprivate boolean[]private short[]private short[]private booleanprivate Bitmapprivate intprivate intprivate BitmapThe bitmap being built; held as a field to avoid passing it everywhere.private static final intprivate static final intstatic final GenericRefinementRegionDecodingProcedure.TemplateSingleton template 0 instance (stateless).static final GenericRefinementRegionDecodingProcedure.TemplateSingleton template 1 instance (stateless).private short -
Constructor Summary
ConstructorsModifierConstructorDescriptionprivateGenericRefinementRegionDecodingProcedure(ArithmeticDecoder arithDecoder, CX cx) -
Method Summary
Modifier and TypeMethodDescriptionprivate intbuildContextT1(int x, int y) static Bitmapdecode(ArithmeticDecoder arithDecoder, CX cx, int width, int height, short grTemplate, boolean isTPGROn, Bitmap referenceBitmap, int referenceDX, int referenceDY, short[] grAtX, short[] grAtY) Executes the Generic Refinement Region decoding procedure (§6.3.5.6) and returns the decoded bitmap.private voiddecodeLineExplicitT1(int y, int width) private voiddecodeLineTPGRT1(int y, int width) private voiddecodeOptimized(int lineNumber, int width, int rowStride, int refRowStride, int paddedWidth, int deltaRefStride, int lineOffset) private intprivate voiddecodeTemplate(int lineNumber, int width, int rowStride, int refRowStride, int paddedWidth, int deltaRefStride, int lineOffset, int byteIndex, int currentLine, int refByteIndex, GenericRefinementRegionDecodingProcedure.Template templateFormation) private voiddecodeTypicalPredictedLine(int lineNumber, int width, int rowStride, int refRowStride, int paddedWidth, int deltaRefStride) private voiddecodeTypicalPredictedLineTemplate0(int lineNumber, int width, int rowStride, int refRowStride, int paddedWidth, int deltaRefStride, int byteIndex, int currentLine, int refByteIndex) private voiddecodeTypicalPredictedLineTemplate1(int lineNumber, int width, int rowStride, int refRowStride, int paddedWidth, int deltaRefStride, int byteIndex, int currentLine, int refByteIndex) private intgetPixelSafe(Bitmap bitmap, int x, int y) private intgetReferenceBit(int x, int y) private intgetRegionBit(int x, int y) private intoverrideAtTemplate0(int context, int x, int y, int result, int minorX) private Bitmaprun(int width, int height, short grTemplate, boolean isTPGROn, Bitmap referenceBitmap, int referenceDX, int referenceDY, short[] grAtX, short[] grAtY) private void
-
Field Details
-
SLTP_CONTEXT_TEMPLATE0
private static final int SLTP_CONTEXT_TEMPLATE0- See Also:
-
SLTP_CONTEXT_TEMPLATE1
private static final int SLTP_CONTEXT_TEMPLATE1- See Also:
-
T0
Singleton template 0 instance (stateless). -
T1
Singleton template 1 instance (stateless). -
arithDecoder
-
cx
-
templateID
private short templateID -
template
-
referenceBitmap
-
referenceDX
private int referenceDX -
referenceDY
private int referenceDY -
grAtX
private short[] grAtX -
grAtY
private short[] grAtY -
override
private boolean override -
grAtOverride
private boolean[] grAtOverride -
regionBitmap
The bitmap being built; held as a field to avoid passing it everywhere.
-
-
Constructor Details
-
GenericRefinementRegionDecodingProcedure
-
-
Method Details
-
decode
public static Bitmap decode(ArithmeticDecoder arithDecoder, CX cx, int width, int height, short grTemplate, boolean isTPGROn, Bitmap referenceBitmap, int referenceDX, int referenceDY, short[] grAtX, short[] grAtY) throws IOException Executes the Generic Refinement Region decoding procedure (§6.3.5.6) and returns the decoded bitmap.A short-lived instance is created internally so that the many private helper methods can share state through fields rather than through long parameter lists. No state survives the return of this method.
- Parameters:
arithDecoder- the arithmetic decoder — shared with the parent when called from a symbol dictionary or text region, or freshly created when called from a standalone segment; must not benullcx- the context model — shared or fresh, as above; must not benullwidth- decoded bitmap width (GRW); must be > 0height- decoded bitmap height (GRH); must be > 0grTemplate- template index: must be 0 or 1 (GRTEMPLATE)isTPGROn- whether typical prediction is enabled (TPGRON)referenceBitmap- the reference / base bitmap (GRREFERENCE); must not benullreferenceDX- horizontal offset of reference bitmap (GRREFERENCEDX)referenceDY- vertical offset of reference bitmap (GRREFERENCEDY)grAtX- AT pixel X offsets; required forgrTemplate == 0, must be a non-null array of length 2 in that case; ignored forgrTemplate == 1grAtY- AT pixel Y offsets; same requirements asgrAtX- Returns:
- the decoded bitmap
- Throws:
IllegalArgumentException- if any parameter constraint above is violatedIOException- if an underlying I/O operation fails
-
run
private Bitmap run(int width, int height, short grTemplate, boolean isTPGROn, Bitmap referenceBitmap, int referenceDX, int referenceDY, short[] grAtX, short[] grAtY) throws IOException - Throws:
IOException
-
getPixelSafe
-
getReferenceBit
private int getReferenceBit(int x, int y) -
getRegionBit
private int getRegionBit(int x, int y) -
buildContextT1
private int buildContextT1(int x, int y) -
decodeLineExplicitT1
- Throws:
IOException
-
decodeLineTPGRT1
- Throws:
IOException
-
decodeSLTP
- Throws:
IOException
-
decodeOptimized
private void decodeOptimized(int lineNumber, int width, int rowStride, int refRowStride, int paddedWidth, int deltaRefStride, int lineOffset) throws IOException - Throws:
IOException
-
decodeTemplate
private void decodeTemplate(int lineNumber, int width, int rowStride, int refRowStride, int paddedWidth, int deltaRefStride, int lineOffset, int byteIndex, int currentLine, int refByteIndex, GenericRefinementRegionDecodingProcedure.Template templateFormation) throws IOException - Throws:
IOException
-
updateOverride
private void updateOverride() -
decodeTypicalPredictedLine
private void decodeTypicalPredictedLine(int lineNumber, int width, int rowStride, int refRowStride, int paddedWidth, int deltaRefStride) throws IOException - Throws:
IOException
-
decodeTypicalPredictedLineTemplate0
private void decodeTypicalPredictedLineTemplate0(int lineNumber, int width, int rowStride, int refRowStride, int paddedWidth, int deltaRefStride, int byteIndex, int currentLine, int refByteIndex) throws IOException - Throws:
IOException
-
decodeTypicalPredictedLineTemplate1
private void decodeTypicalPredictedLineTemplate1(int lineNumber, int width, int rowStride, int refRowStride, int paddedWidth, int deltaRefStride, int byteIndex, int currentLine, int refByteIndex) throws IOException - Throws:
IOException
-
overrideAtTemplate0
private int overrideAtTemplate0(int context, int x, int y, int result, int minorX)
-