Class ImageDecoder

Definition

Namespace:
Tizen.Multimedia.Util
Assembly:
Tizen.Multimedia.Util.dll

This is a base class for image decoders.

public abstract class ImageDecoder : IDisposable
Inheritance
object
ImageDecoder
Derived
BmpDecoder
BmpDecoder
GifDecoder
GifDecoder
HeifDecoder
HeifDecoder
JpegDecoder
JpegDecoder
JpegXlDecoder
JpegXlDecoder
PngDecoder
PngDecoder
WebPDecoder
WebPDecoder
Implements
System.IDisposable

Properties

View Source

InputFormat

Gets the image format of this decoder.

Declaration
public ImageFormat InputFormat { get; }
Property Value
Type Description
ImageFormat

Methods

View Source

DecodeAsync(byte[])

Decodes an image from the buffer.

Declaration
public Task<IEnumerable<BitmapFrame>> DecodeAsync(byte[] inputBuffer)
Parameters
Type Name Description
byte[] inputBuffer

The image buffer from which to decode.
Returns
Type Description
System.Threading.Tasks.Task<TResult><System.Collections.Generic.IEnumerable<T><BitmapFrame>>

A task that represents the asynchronous decoding operation.
Remarks

Only Graphics Interchange Format(GIF) codec returns more than one frame.

Exceptions
Type Condition
System.ArgumentNullException

inputBuffer is null.
System.ArgumentException

inputBuffer is an empty array.
FileFormatException

The format of inputBuffer is not InputFormat.
System.ObjectDisposedException

The ImageDecoder has already been disposed of.
View Source

DecodeAsync(string)

Decodes an image from the specified file.

Declaration
public Task<IEnumerable<BitmapFrame>> DecodeAsync(string inputFilePath)
Parameters
Type Name Description
string inputFilePath

The input file path from which to decode.
Returns
Type Description
System.Threading.Tasks.Task<TResult><System.Collections.Generic.IEnumerable<T><BitmapFrame>>

A task that represents the asynchronous decoding operation.
Remarks

Only Graphics Interchange Format(GIF) codec returns more than one frame.

http://tizen.org/privilege/mediastorage is needed if inputFilePath is relevant to the media storage.
http://tizen.org/privilege/externalstorage is needed if inputFilePath is relevant to the external storage.

Exceptions
Type Condition
System.ArgumentNullException

inputFilePath is null.
System.ArgumentException

inputFilePath is an empty string.
-or-
inputFilePath is not a image file.
System.IO.FileNotFoundException

inputFilePath does not exists.
System.UnauthorizedAccessException

The caller does not have required permission to access the path.
FileFormatException

The format of inputFilePath is not InputFormat.
System.ObjectDisposedException

The ImageDecoder has already been disposed of.
View Source

Dispose()

Releases all resources used by the ImageDecoder.

Declaration
public void Dispose()
View Source

Dispose(bool)

Releases the unmanaged resources used by the ImageDecoder.

Declaration
protected virtual void Dispose(bool disposing)
Parameters
Type Name Description
bool disposing

true to release both managed and unmanaged resources; false to release only unmanaged resources.
View Source

SetColorSpace(ColorSpace)

Sets the color-space to decode into. The default is Rgba8888.

Declaration
public void SetColorSpace(ColorSpace colorSpace)
Parameters
Type Name Description
ColorSpace colorSpace

The value indicating color-space to decode into.
Exceptions
Type Condition
System.ArgumentException

colorSpace is invalid.
System.NotSupportedException

colorSpace is not supported by the decoder.
See Also

Implements

System.IDisposable