metadata.go

/*
This is a package for reading, writing and inspecting media files. In
order to operate on media, call NewManager() and then use the manager
functions to determine capabilities and manage media files and devices.
*/
package media

import "image"

// Metadata is a key/value pair which can be used to describe a media object
// or other metadata. The value can be retrieved as a string value,
// data, or other type. If the value is a byte slice, then it can also
// be retrieved as an image (for artwork)
type Metadata interface {
	// Return the metadata key
	Key() string

	// Return the value as a string. Returns the mimetype
	// if the value is a byte slice, and the mimetype can be
	// detected.
	Value() string

	// Returns the value as a byte slice
	Bytes() []byte

	// Returns the value as an image
	Image() image.Image

	// Returns the value as an interface
	Any() any
}