cue

README

NAME
    cue is a cue parser implementation go-package.

AUTHORS
    Viacheslav Chumushuk <voice@root.ua>

COPYING
    This programm is released under the GNU General Public License version 3 or later, which is
    distributed in the COPYING file. You should have received a copy of the GNU General Public License along with
    this program.  If not, see <http://www.gnu.org/licenses/>.

Documentation

Overview

Package cue implement CUE-SHEET files parser. For CUE documentation see: http://digitalx.org/cue-sheet/syntax/

Some helper functions collection.

Index

• Constants
• type CueSheet
  • func Parse(reader io.Reader) (sheet *CueSheet, err error)
• type File
• type FileType
• type Index
• type Time
  • func (time *Time) Seconds() int
• type Track
• type TrackDataType
• type TrackFlag

Constants

const (
	// AUDIO – Audio/Music (2352)
	DataTypeAudio = iota
	// CDG – Karaoke CD+G (2448)
	DataTypeCdg
	// MODE1/2048 – CDROM Mode1 Data (cooked)
	DataTypeMode1_2048
	// MODE1/2352 – CDROM Mode1 Data (raw)
	DataTypeMode1_2352
	// MODE2/2336 – CDROM-XA Mode2 Data
	DataTypeMode2_2336
	// MODE2/2352 – CDROM-XA Mode2 Data
	DataTypeMode2_2352
	// CDI/2336 – CDI Mode2 Data
	DataTypeCdi_2336
	// CDI/2352 – CDI Mode2 Data
	DataTypeCdi_2352
)

const (
	// Digital copy permitted.
	TrackFlagDcp = iota
	// Four channel audio.
	TrackFlag4ch
	// Pre-emphasis enabled (audio tracks only).
	TrackFlagPre
	// Serial copy management system (not supported by all recorders).
	TrackFlagScms
)

Types

type CueSheet

type CueSheet struct {
	// Disc's media catalog number.
	Catalog string
	// Name of a perfomer for a CD-TEXT enhanced disc
	Performer string
	// Specify a title for a CD-TEXT enhanced disc.
	Title string
	// Specify songwriter for disc.
	Songwriter string
	// Comments in the CUE SHEET file.
	Comments []string
	// Name of the file that contains the encoded CD-TEXT information for the disc.
	CdTextFile string
	// Data/audio files descibed byt the cue-file.
	Files []File
}

Cue sheet file representation.

func Parse

func Parse(reader io.Reader) (sheet *CueSheet, err error)

Parse parses cue-sheet data (file) and returns filled CueSheet struct.

type File

type File struct {
	// Name (path) of the file.
	Name string
	// Type of the audio file.
	Type FileType
	// List of present tracks in the file.
	Tracks []Track
}

Audio file representation structure.

type FileType

type FileType int

Type of the audio file.

const (
	// Intel binary file (least significant byte first)
	FileTypeBinary FileType = iota
	// Motorola binary file (most significant byte first)
	FileTypeMotorola
	// Audio AIFF file
	FileTypeAiff
	// Audio WAVE file
	FileTypeWave
	// Audio MP3 file
	FileTypeMp3
)

type Index

type Index struct {
	// Index number.
	Number int
	// Index starting time.
	Time Time
}

Track index type

type Time

type Time struct {
	// Minutes.
	Min int
	// Minutes.
	Sec int
	// Frames.
	Frames int
}

Time point description type.

func (*Time) Seconds

func (time *Time) Seconds() int

Seconds returns length in seconds.

type Track

type Track struct {
	// Track number (1-99).
	Number int
	// Track datatype.
	DataType TrackDataType
	// Track title.
	Title string
	// Track preformer.
	Performer string
	// Songwriter.
	Songwriter string
	// Track decode flags.
	Flags []TrackFlag
	// Internetional Standaard Recording Code.
	Isrc string
	// Track indexes.
	Indexes []Index
	// Length of the track pregap.
	Pregap Time
	// Length of the track postgap.
	Postgap Time
}

type TrackDataType

type TrackDataType int

Track datatype.

type TrackFlag

type TrackFlag int

Additional decode information about track.