Class ThumbnailExtractor

Definition

Namespace:

Tizen.Multimedia.Util

Assembly:

Tizen.Multimedia.Util.dll

Provides the ability to extract the thumbnail from media files.

public static class ThumbnailExtractor

Inheritance

object

ThumbnailExtractor

Methods

Extract(string, string)

Extracts the thumbnail for the given media with the specified path and size. The generated thumbnail will be saved in resultThumbnailPath.

Declaration

public static void Extract(string path, string resultThumbnailPath)

Parameters

Type	Name	Description
string	path	The path of the media file to extract the thumbnail.
string	resultThumbnailPath	The path to save the generated thumbnail.

Remarks

The size of resultThumbnailPath image will be 320x240.
If the size of path has different ratio with 320x240 (approximately 1.33:1),
thumbnail is generated in a way to keep the ratio of path, which is based on short axis of path.
For example, if the size of path is 900x500 (1.8:1), the size of resultThumbnailPath is 432x240(1.8:1).
To set the size different from 320x240, please use Extract(string, Size, string).

If you want to access internal storage, you should add privilege http://tizen.org/privilege/mediastorage.
If you want to access external storage, you should add privilege http://tizen.org/privilege/externalstorage.

Exceptions

Type	Condition
System.ArgumentException	path or resultThumbnailPath is invalid.
System.ArgumentNullException	path or resultThumbnailPath is null.
System.IO.FileNotFoundException	path does not exist.
System.InvalidOperationException	An internal error occurs.
FileFormatException	The specified file is not supported.
System.UnauthorizedAccessException	The caller has no required privilege.

Extract(string, Size, string)

Extracts the thumbnail for the given media with the specified path and size. The generated thumbnail will be saved in resultThumbnailPath.

Declaration

public static void Extract(string path, Size size, string resultThumbnailPath)

Parameters

Type	Name	Description
string	path	The path of the media file to extract the thumbnail.
Size	size	The size of the thumbnail.
string	resultThumbnailPath	The path to save the generated thumbnail.

Remarks

The size of resultThumbnailPath image will be size.
But, if the size of path has different ratio with size,
thumbnail will be generated in a way to keep the ratio of path, which based on short axis of path.
For example, if the size of path is 900x500 (1.8:1) and size is 320x240,
the size of resultThumbnailPath is 432x240(1.8:1).

If you want to access internal storage, you should add privilege http://tizen.org/privilege/mediastorage.
If you want to access external storage, you should add privilege http://tizen.org/privilege/externalstorage.

Exceptions

Type	Condition
System.ArgumentException	path or resultThumbnailPath is invalid.
System.ArgumentNullException	path or resultThumbnailPath is null.
System.IO.FileNotFoundException	path does not exist.
System.InvalidOperationException	An internal error occurs.
System.ArgumentOutOfRangeException	The width or the height of size is less than or equal to zero.
FileFormatException	The specified file is not supported.
System.UnauthorizedAccessException	The caller has no required privilege.

Extract(string, Size)

Extracts the thumbnail for the given media with the specified path and size. The generated thumbnail will be returned in ThumbnailExtractionResult.

Declaration

public static ThumbnailExtractionResult Extract(string path, Size size)

Parameters

Type	Name	Description
string	path	The path of the media file to extract the thumbnail.
Size	size	The size of the thumbnail.

Returns

Type	Description
ThumbnailExtractionResult	The result of extracting operation.

Remarks

The size of generated thumbnail will be size.
But, if the size of path has different ratio with size,
thumbnail will be generated in a way to keep the ratio of path, which based on short axis of path.
For example, if the size of path is 900x500 (1.8:1)) and size is 320x240,
the size of generated thumbnail is 432x240(1.8:1).

If you want to access internal storage, you should add privilege http://tizen.org/privilege/mediastorage.
If you want to access external storage, you should add privilege http://tizen.org/privilege/externalstorage.

Exceptions

Type	Condition
System.ArgumentNullException	path is null.
System.IO.FileNotFoundException	path does not exist.
System.InvalidOperationException	An internal error occurs.
System.ArgumentOutOfRangeException	The width or the height of size is less than or equal to zero.
FileFormatException	The specified file is not supported.
System.UnauthorizedAccessException	The caller has no required privilege.

Extract(string)

Extracts the thumbnail for the given media with the specified path and size. The generated thumbnail will be returned in ThumbnailExtractionResult.

Declaration

public static ThumbnailExtractionResult Extract(string path)

Parameters

Type	Name	Description
string	path	The path of the media file to extract the thumbnail.

Returns

Type	Description
ThumbnailExtractionResult	The result of extracting operation.

Remarks

The size of generated thumbnail will be 320x240.
If the size of path has different ratio from 320x240 (approximately 1.33:1),
thumbnail is generated in a way to keep the ratio of path, which is based on short axis of path.
For example, if the size of path is 900x500 (1.8:1), the size of generated thumbnail is 432x240(1.8:1).
To set the size different from 320x240, please use Extract(string, Size).

If you want to access internal storage, you should add privilege http://tizen.org/privilege/mediastorage.
If you want to access external storage, you should add privilege http://tizen.org/privilege/externalstorage.

Exceptions

Type	Condition
System.ArgumentNullException	path is null.
System.IO.FileNotFoundException	path does not exist.
System.InvalidOperationException	An internal error occurs.
FileFormatException	The specified file is not supported.
System.UnauthorizedAccessException	The caller has no required privilege.

ExtractAsync(string, CancellationToken)

Extracts the thumbnail for the given media with the specified path.

Declaration

[Obsolete("Deprecated since API10; Will be removed in API12. Please use Extract instead.")]
public static Task<ThumbnailExtractionResult> ExtractAsync(string path, CancellationToken cancellationToken)

Parameters

Type	Name	Description
string	path	The path of the media file to extract the thumbnail.
System.Threading.CancellationToken	cancellationToken	The token to stop the operation.

Returns

Type	Description
System.Threading.Tasks.Task<TResult><ThumbnailExtractionResult>	A task that represents the asynchronous extracting operation.

Remarks

The size of the thumbnail will be the default size(320x240).

Exceptions

Type	Condition
System.ArgumentNullException	path is null.
System.IO.FileNotFoundException	path does not exist.
System.InvalidOperationException	An internal error occurs.
System.UnauthorizedAccessException	The caller does not have required privilege for accessing the path.
FileFormatException	The specified file is not supported.

ExtractAsync(string, Size, CancellationToken)

Extracts the thumbnail for the given media with the specified path and size.

Declaration

[Obsolete("Deprecated since API10; Will be removed in API12. Please use Extract instead.")]
public static Task<ThumbnailExtractionResult> ExtractAsync(string path, Size size, CancellationToken cancellationToken)

Parameters

Type	Name	Description
string	path	The path of the media file to extract the thumbnail.
Size	size	The size of the thumbnail.
System.Threading.CancellationToken	cancellationToken	The token to stop the operation.

Returns

Type	Description
System.Threading.Tasks.Task<TResult><ThumbnailExtractionResult>	A task that represents the asynchronous extracting operation.

Remarks

If the width is not a multiple of 8, it can be changed by the inner process.
The width will be a multiple of 8 greater than the set value.

Exceptions

Type	Condition
System.ArgumentNullException	path is null.
System.IO.FileNotFoundException	path does not exist.
System.InvalidOperationException	An internal error occurs.
System.UnauthorizedAccessException	The caller does not have required privilege for accessing the path.
System.ArgumentOutOfRangeException	The width or the height of size is less than or equal to zero.
FileFormatException	The specified file is not supported.

ExtractAsync(string, Size)

Extracts the thumbnail for the given media with the specified path and size.

Declaration

[Obsolete("Deprecated since API10; Will be removed in API12. Please use Extract instead.")]
public static Task<ThumbnailExtractionResult> ExtractAsync(string path, Size size)

Parameters

Type	Name	Description
string	path	The path of the media file to extract the thumbnail.
Size	size	The size of the thumbnail.

Returns

Type	Description
System.Threading.Tasks.Task<TResult><ThumbnailExtractionResult>	A task that represents the asynchronous extracting operation.

Remarks

If the width is not a multiple of 8, it can be changed by the inner process.
The width will be a multiple of 8 greater than the set value.

Exceptions

Type	Condition
System.ArgumentNullException	path is null.
System.IO.FileNotFoundException	path does not exist.
System.InvalidOperationException	An internal error occurs.
System.UnauthorizedAccessException	The caller does not have required privilege for accessing the path.
System.ArgumentOutOfRangeException	The width or the height of size is less than or equal to zero.
FileFormatException	The specified file is not supported.

ExtractAsync(string)

Extracts the thumbnail for the given media with the specified path.

Declaration

[Obsolete("Deprecated since API10; Will be removed in API12. Please use Extract instead.")]
public static Task<ThumbnailExtractionResult> ExtractAsync(string path)

Parameters

Type	Name	Description
string	path	The path of the media file to extract the thumbnail.

Returns

Type	Description
System.Threading.Tasks.Task<TResult><ThumbnailExtractionResult>	A task that represents the asynchronous extracting operation.

Remarks

The size of the thumbnail will be the default size (320x240).

Exceptions

Type	Condition
System.ArgumentNullException	path is null.
System.IO.FileNotFoundException	path does not exist.
System.InvalidOperationException	An internal error occurs.
System.UnauthorizedAccessException	The caller does not have required privilege for accessing the path.
FileFormatException	The specified file is not supported.