org.hd.d.pg2k.svrCore.mediahandler
Class gif

java.lang.Object
  org.hd.d.pg2k.svrCore.MIME.AbstractHandler
      org.hd.d.pg2k.svrCore.MIME.AbstractImageHandler
          org.hd.d.pg2k.svrCore.mediahandler.gif

All Implemented Interfaces:

Handler

public final class gif
extends AbstractImageHandler

Default handler for gif file (MIME type image/gif).

TARGET_BPP

private static final int TARGET_BPP

Target bits-per-pixel for thumbnail images; strictly positive. Does not need to leave all images perfect, but most should be OK. Note that we'll be limited from above by the absolute size limits of thumbnails in general.

A value in the range 4--8 is probably good.

See Also:

Constant Field Values

FILE_OVERHEAD

private static final int FILE_OVERHEAD

Estimated file overhead constant, ie what would a 0x0 file size be; non-negative. This factor helps avoid penalising small images by having the overhead eat into the bits that should be being used by the image.

One byte less than a 1x1 white image produced by PSP7.

See Also:

Constant Field Values

EST_BYTES_PER_IMAGE_PIXEL_IN_MEMORY

private static final int EST_BYTES_PER_IMAGE_PIXEL_IN_MEMORY

Estimated (maximum) bytes per pixel of a decoded image in memory. GIFs use a max-256-entry palette, so a reasonable in-memory representation will use one byte per pixel or less.

See Also:

Constant Field Values

maxThumbnailQuality

private static final int maxThumbnailQuality

Maximum quality allowed in a thumbnail; taken to be colour depth. Assume that this is the same as the maximum number of bits in memory we expect an image to take.

See Also:

Constant Field Values

normalThumbnailQuality

private static final int normalThumbnailQuality

Normal/initial quality for a thumbnail. This is reasonable for most images, though erring slightly on the side of retention of image quality at cost of download speed.

See Also:

Constant Field Values

minThumbnailQuality

private static final int minThumbnailQuality

Maximum quality allowed in a thumbnail; taken to be colour depth. Must be positive and can be as little as monochrome, ie one bit.

See Also:

Constant Field Values

thumbnailParams

private static final Handler.ThumbnailParams thumbnailParams

Gather together thumbnail parameters.

gif

public gif()

getExhibitType

public ExhibitMIME.ExhibitTypeParameters getExhibitType()

Get internal type of ExhibitMIME type; never null.

get2DImageDimensions

public java.awt.Dimension get2DImageDimensions(java.io.InputStream is)
                                        throws java.io.IOException

Get dimensions X and Y of a GIF exhibit, else null if dimensions cannot be computed. This reads the opening bytes of the exhibit directly to extract the dimensions, rather than loading and interpretting the whole image.

This input stream must be of the correct type, eg the magic number already checked.

This does not close its input stream when done.

Specified by:

get2DImageDimensions in interface Handler

Overrides:

get2DImageDimensions in class AbstractImageHandler

Parameters:

is - the exhibit as a binary data stream

Throws:

java.io.IOException - in case of problems with corrupt data (or a broken exhibit)

getThumbnailParams

public Handler.ThumbnailParams getThumbnailParams()

Get ThumbnailParameters for GIF handler; non-null.

Specified by:

getThumbnailParams in interface Handler

Overrides:

getThumbnailParams in class AbstractHandler

_reduceColoursQualityThreshold

protected int _reduceColoursQualityThreshold()

Description copied from class: AbstractImageHandler

Guide colour-reduction to reduce quality and size of lossless image formats. Defaults to -1, implying that the image format is a lossy format for which the ImageWriteParam.setCompressionQuality() mechanism is enough to trade encoded image size for quality.

Else this is a positive value n, typically 8 or 24, which sets a quality level at/below which the number of colours in the image is reduced to (capped at) 2^n, and the image representation may be tweaked too (eg converted to a palette/indexed format) as a strong hint to the encoder.

Overrides:

_reduceColoursQualityThreshold in class AbstractImageHandler