public final class GifImage extends RasterImageResourceBase
Represents one image in GIF (Graphics Interchange Format) format with its metadata and additional methods
Disposed
Constructor and Description |
---|
GifImage(String name,
InputStream binaryContent)
Creates new GifImage instance from content, represented as byte stream,
and with specified name
|
GifImage(String name,
String contentInBase64)
Creates new GifImage instance from content, represented as base64-encoded
string, and with specified name
|
Modifier and Type | Method and Description |
---|---|
ImageType |
getType()
Returns ImageType.Gif
|
String |
getVersion()
Returns internal version of this GIF image (version is extracted from
header)
|
static boolean |
isValid(InputStream binaryContent)
Checks whether specified stream is a valid GIF image
|
static boolean |
isValid(String contentInBase64)
Checks whether specified base64-encoded string is a valid GIF image
|
GifImage |
reduceToNewHeight(int targetHeightInPixels)
Creates and returns a new reduced GIF image, but with specified new
reduced height and proportionally reduced width.
|
dispose, equals, generateBitmap, getAspectRatio, getByteContent, getFilenameWithExtension, getLength, getLinearDimensions, getName, getTextContent, isDisposed, save
public GifImage(String name, InputStream binaryContent)
Creates new GifImage instance from content, represented as byte stream, and with specified name
name
- Name of the GIF image. Cannot be null, empty or whitespaces.binaryContent
- Content as byte stream. Reading begins from original
position. Cannot be null. Should be readable and seekable. If this
instance will be disposed, this stream will be disposed too.IllegalArgumentException
InvalidImageFormatException
public GifImage(String name, String contentInBase64)
Creates new GifImage instance from content, represented as base64-encoded string, and with specified name
name
- Name of the GIF image. Cannot be null, empty or whitespaces.contentInBase64
- Content as base64-encoded string. Cannot be null,
empty or whitespaces. If it is not a GIF content, exception will be
thrown.IllegalArgumentException
InvalidImageFormatException
public ImageType getType()
Returns ImageType.Gif
getType
in interface IHtmlResource
getType
in interface IImageResource
getType
in class RasterImageResourceBase
public final String getVersion()
Returns internal version of this GIF image (version is extracted from header)
public static boolean isValid(InputStream binaryContent)
Checks whether specified stream is a valid GIF image
binaryContent
- Byte stream, that presumably contains a GIF imagepublic static boolean isValid(String contentInBase64)
Checks whether specified base64-encoded string is a valid GIF image
contentInBase64
- Content of the presumably GIF image in a form of
base64-encoded stringpublic final GifImage reduceToNewHeight(int targetHeightInPixels)
Creates and returns a new reduced GIF image, but with specified new reduced height and proportionally reduced width.
reduceToNewHeight
in class RasterImageResourceBase
targetHeightInPixels
- Height of the desired GIF image in pixels.
Should be strictly lesser than original height.