Package com.tagtraum.audiokern

Class StandardAudioArtwork

java.lang.Object

com.tagtraum.audiokern.StandardAudioArtwork

All Implemented Interfaces:

AudioArtwork

public class StandardAudioArtwork
extends Object
implements AudioArtwork

Standard AudioArtwork.

Author:

Hendrik Schreiber

Nested Class Summary

Nested classes/interfaces inherited from interface com.tagtraum.audiokern.AudioArtwork

AudioArtwork.Kind

Constructor Summary

Constructors

Constructor	Description
StandardAudioArtwork(AudioArtwork audioArtwork, AudioArtwork.Kind kind)	Creates a copy of the given artwork while allowing to change the kind.
StandardAudioArtwork(Image image, AudioArtwork.Kind kind)	Create an AudioArtwork from the given image.
StandardAudioArtwork(File imageFile, AudioArtwork.Kind kind)	Create an AudioArtwork from the given file.
StandardAudioArtwork(InputStream in, AudioArtwork.Kind kind, URI uri)	Create an AudioArtwork from the given stream.

Method Summary

Modifier and Type	Method	Description
static AudioArtwork	create(URL imageURL, AudioArtwork.Kind kind)	Creates an AudioArtwork.
static AudioArtwork	createLazily(URL imageURL, AudioArtwork.Kind kind)	Creates an AudioArtwork object without actually loading the image.
boolean	equals(Object o)
Image	getImage()	Image object.
byte[]	getImageData()	Encoded image data.
AudioArtwork.Kind	getKind()	Kind of artwork.
String	getMimeType()	Mime type.
URI	getURI()	URI of this artwork.
static String	getUserAgent()
int	hashCode()
static boolean	isKindSupportedByAudioFileFormat(AudioFileFormat fileFormat)	Indicates, whether different AudioArtwork.Kinds of artwork are supported by a AudioFileFormat.
static void	setUserAgent(String userAgent)
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.tagtraum.audiokern.AudioArtwork

freeResources

Constructor Detail

StandardAudioArtwork

public StandardAudioArtwork(AudioArtwork audioArtwork,
                            AudioArtwork.Kind kind)

Creates a copy of the given artwork while allowing to change the kind.

Parameters:

audioArtwork - artwork

kind - new kind

StandardAudioArtwork

public StandardAudioArtwork(Image image,
                            AudioArtwork.Kind kind)

Create an AudioArtwork from the given image.

Parameters:

image - image

kind - kind of artwork

StandardAudioArtwork

public StandardAudioArtwork(InputStream in,
                            AudioArtwork.Kind kind,
                            URI uri)
                     throws IOException

Create an AudioArtwork from the given stream.

Parameters:

in - stream

kind - kind of artwork

Throws:

IOException - if the image file cannot be parsed or does not exist

StandardAudioArtwork

public StandardAudioArtwork(File imageFile,
                            AudioArtwork.Kind kind)
                     throws IOException

Create an AudioArtwork from the given file.

Parameters:

imageFile - image file

kind - kind of artwork

Throws:

IOException - if the image file cannot be parsed or does not exist

Method Detail

getUserAgent

public static String getUserAgent()

setUserAgent

public static void setUserAgent(String userAgent)

create

public static AudioArtwork create(URL imageURL,
                                  AudioArtwork.Kind kind)
                           throws IOException

Creates an AudioArtwork.

Parameters:

imageURL - imageURL

kind - kind of artwork the URL contains

Returns:

artwork

Throws:

IOException

createLazily

public static AudioArtwork createLazily(URL imageURL,
                                        AudioArtwork.Kind kind)

Creates an AudioArtwork object without actually loading the image. The image itself is only loaded, once it is accessed.

Parameters:

imageURL - imageURL

kind - kind of artwork the URL contains

Returns:

lazy artwork

getImage

public Image getImage()

Description copied from interface: AudioArtwork

Image object.

Specified by:

getImage in interface AudioArtwork

Returns:

image

getImageData

public byte[] getImageData()

Description copied from interface: AudioArtwork

Encoded image data. Image data that looks exactly like the data usually stored in a file. This means, for a PNG image, this method will return the PNG encoded data.

Specified by:

getImageData in interface AudioArtwork

Returns:

encoded image data

getMimeType

public String getMimeType()

Description copied from interface: AudioArtwork

Mime type. Usually something like image/jpeg.

Specified by:

getMimeType in interface AudioArtwork

Returns:

mime type, if known. Otherwise null

getKind

public AudioArtwork.Kind getKind()

Description copied from interface: AudioArtwork

Kind of artwork.

Specified by:

getKind in interface AudioArtwork

Returns:

kind

getURI

public URI getURI()

Description copied from interface: AudioArtwork

URI of this artwork. May be null, if not available.

Specified by:

getURI in interface AudioArtwork

Returns:

uri or null

isKindSupportedByAudioFileFormat

public static boolean isKindSupportedByAudioFileFormat(AudioFileFormat fileFormat)

Indicates, whether different AudioArtwork.Kinds of artwork are supported by a AudioFileFormat.

Parameters:

fileFormat - file format

Returns:

true, if different kinds are supported

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object