CDTrack Class Reference

The Track interface allows you to specify the track type, the pre-gap length, the track indexes and the post-gap length for a track. More...

Public Member Functions
	CDTrack ()
	Constructor.

Properties
Int32	End [get, set]
	Gets/Sets the track end, in blocks, relative to the session start.
IList< Int32 >	Indexes [get]
	Represents a collection of CD track indexes.
String	Isrc [get, set]
	Gets/Sets the International Standard Recording Code (ISRC).
Int32	Length [get]
	Gets the track length without the pre-gap and the post-gap.
IList< CDMode >	Modes [get]
	Gets the list of CD modes that are defined for the track.
Int32	PostgapEnd [get, set]
	Gets/Sets the end of the track post-gap, in blocks, relative to the session start.
Int32	PregapStart [get, set]
	Gets/Sets the track pre-gap, in blocks, relative to the session start.
Int32	Start [get, set]
	Gets/Sets the start of the user area of a CD Track, in blocks, relative to the session start.
Int32	TotalLength [get]
	Gets the length of the track including the pre-gap and the post-gap.
TrackType	Type [get, set]
	Gets/Sets the track type.

Detailed Description

The Track interface allows you to specify the track type, the pre-gap length, the track indexes and the post-gap length for a track.

Property Documentation

End

Int32 End

getset

Gets/Sets the track end, in blocks, relative to the session start.

This is the address of the last block of the user area of a CD track

After the user area follows the post-gap area. Setting this value to a value different that the post-gap end creates an index marker at the offset specified with the blocks parameter.

<para>For maximum flexibility there is no validation of the track start, track end, pre-gap start, post-gap end, and index markers when this property is set. 
The application is responsible for setting the track and the session parameters correctly. </para>

AudioCD begins writing only when the following condition is validated: pregap start <= start <= end <= postgap end.

DataDisc: to create a track with zero length set the track start and track pregap to 0 and the track end and track postgap to -1.

Indexes

IList<Int32> Indexes

get

Represents a collection of CD track indexes.

Up to 98 indexes per CD track may be specified. The CD index position is in blocks and is relative to the track start.

Isrc

String Isrc

getset

Gets/Sets the International Standard Recording Code (ISRC).

Returns empty string if the track does not have ISRC.

If no ISRC is used, the ISRC should be set to an empty string or NULL. If a track has no ISRC, it is not written on the disc.

Length

Int32 Length

get

Gets the track length without the pre-gap and the post-gap.

It is the same as (end - start + 1).

To create a track with zero length set the track start and track pregap to 0 and the track end and track postgap to -1.

Modes

IList<CDMode> Modes

get

Gets the list of CD modes that are defined for the track.

See also

CDMode

PostgapEnd

Int32 PostgapEnd

getset

Gets/Sets the end of the track post-gap, in blocks, relative to the session start.

This is the address of the last block of a CD track. For the last track this is also the last block of the CD session.

The default value for the post-gap end is the track end, which means there will not be a post-gap.

This method does not update any track indexes.

For maximum flexibility there is no validation of the track start, track end, pre-gap start, post-gap end, and index markers when this property is set. The application is responsible for setting the track and the session parameters correctly.

AudioCD begins writing only when the following condition is validated: pregap start <= start <= end <= postgap end.

DataDisc: to create a track with zero length set the track start and track pregap to 0 and the track end and track postgap to -1.

PregapStart

Int32 PregapStart

getset

Gets/Sets the track pre-gap, in blocks, relative to the session start.

The default pre-gap start is 0, which means there will not be any pre-gap written.

The first track always has a pre-gap and it is 2 sec. (150 blocks) longer than the one specified in CDTrack ( Start - PregapStart ). These 150 blocks are written as zeros at the very beginning of the user area and precede the custom pre-gap specified in CDTrack. The Audio CD standard mandates that the first track must have a pre-gap of 2-3 sec.

<para>While PrimoBurner guarantees the minimum pre-gap of 2 sec. at the beginning of the session it does not restrict it to the maximum of 3 sec.
This way it is possible to place an arbitrary audio content in the pre-gap of the first track.
Such layout creates an Audio CD with the so called "hidden track" because normally the only way to play it is by manual rewinding before the start of track #1.
Warning: Specifying the first track pre-gap to be longer than 3 sec. (Start - PregapStart > 75) violates the Audio CD standard.
Some computer drives are known to have problems recognizing such Audio CDs.</para>

<para>The pre-gap start cannot be greater than the length of the track.</para>

<para>For maximum flexibility there is no validation of the track start, track end, pre-gap start, post-gap end, and index markers when this property is set. 
The application is responsible for setting the track and the session parameters correctly. </para>

AudioCD begins writing only when the following condition is validated: pregap start <= start <= end <= postgap end.

DataDisc: to create a track with zero length set the track start and track pregap to 0 and the track end and track postgap to -1.

Start

Int32 Start

getset

Gets/Sets the start of the user area of a CD Track, in blocks, relative to the session start.

The track start must be greater or equal to the start of the track pre-gap.

For maximum flexibility there is no validation of the track start, track end, pre-gap start, post-gap end, and index markers when this property is set. The application is responsible for setting the track and the session parameters correctly.

AudioCD begins writing only when the following condition is validated: pregap start <= start <= end <= postgap end.

<para>DataDisc: to create a track with zero length set the track start and track pregap to 0 and the track end and track postgap to -1.</para>

TotalLength

Int32 TotalLength

get

Gets the length of the track including the pre-gap and the post-gap.

It is the same as (post-gap - pre-gap + 1)

To create a track with zero length set the track start and track pregap to 0 and the track end and track postgap to -1.

Type

TrackType Type

getset

Gets/Sets the track type.

See also

TrackType