Module org.deepsymmetry.beatlink

Package org.deepsymmetry.beatlink.data

Class AlbumArt

java.lang.Object

org.deepsymmetry.beatlink.data.AlbumArt

@API(status=STABLE)
public class AlbumArt
extends Object

Represents album artwork associated with tracks loaded into players on a DJ Link network, and provides a convenience method for getting a buffered image for drawing the art.

Author:

James Elliott

Field Summary

Fields

Modifier and Type	Field	Description
DataReference	artReference	The unique artwork identifier that was used to request this album art.

Constructor Summary

Constructors

Constructor	Description
AlbumArt(DataReference artReference, File file)	Constructor used with a file downloaded via NFS by Crate Digger.
AlbumArt(DataReference artReference, ByteBuffer rawBytes)	Constructor usable by caching mechanism simply sets the immutable value fields.

Method Summary

Modifier and Type	Method	Description
BufferedImage	getImage()	Given the byte buffer containing album art, build an actual image from it for easy rendering.
ByteBuffer	getRawBytes()	Get the raw bytes of the artwork image as returned by the player.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

artReference

public final DataReference artReference

The unique artwork identifier that was used to request this album art. Even though it is not a track, the same pieces of information are used.

Constructor Detail

AlbumArt

@API(status=STABLE)
public AlbumArt(DataReference artReference,
                File file)
         throws IOException

Constructor used with a file downloaded via NFS by Crate Digger.

Parameters:

artReference - the unique database reference that was used to request this artwork

file - the file of image data as loaded from the player

Throws:

IOException - if there is a problem reading the file

AlbumArt

@API(status=STABLE)
public AlbumArt(DataReference artReference,
                ByteBuffer rawBytes)

Constructor usable by caching mechanism simply sets the immutable value fields.

Parameters:

artReference - the unique database reference that was used to request this artwork

rawBytes - the bytes of image data as loaded from the player or media export

Method Detail

getRawBytes

@API(status=STABLE)
public ByteBuffer getRawBytes()

Get the raw bytes of the artwork image as returned by the player.

Returns:

the bytes that make up the album art

getImage

@API(status=STABLE)
public BufferedImage getImage()

Given the byte buffer containing album art, build an actual image from it for easy rendering.

Returns:

the newly-created image, ready to be drawn

toString

public String toString()

Overrides:

toString in class Object