DRContentTrack.h

Overview

Interface to track objects used in filesystem creation.

Functions

DRAudioTrackCreate

Creates an audio track capable of burning RedBook CD audio from a file.

DRAudioTrackCreateWithURL

Creates an audio track capable of burning RedBook CD audio from a file.

DRFilesystemTrackCreate

Creates a filesystem track capable of burning a folder.

DRFilesystemTrackEstimateOverhead

Provides an estimate of the approximate size that should be reserved for directory structures on a disc.

Creates an audio track capable of burning RedBook CD audio from a file.

extern DRAudioTrackRef DRAudioTrackCreate( 
    const FSRef *audioFile) ;  

Parameters

audioFile

An FSRef referencing the file to write.

Return Value

A DRAudioTrack capable of burning the track.

Discussion

This function creates a track object configured and primed to output RedBook audio CD data. It accepts any file readable by QuickTime and extracts the audio data (if any) from the file, translating that into the correct format for output to the disc.

Availability

Introduced in Mac OS X v10.3.

Creates an audio track capable of burning RedBook CD audio from a file.

extern DRAudioTrackRef DRAudioTrackCreateWithURL( 
    CFURLRef audioFileURL) ;  

Parameters

audioFileURL

A file CFURL referencing the on-disk file to write.

Return Value

A DRAudioTrack capable of burning the track.

Discussion

This function creates a track object configured and primed to output RedBook audio CD data. It accepts any file readable by QuickTime and extracts the audio data (if any) from the file, translating that into the correct format for output to the disc.

Availability

Introduced in Mac OS X v10.3.

Creates a filesystem track capable of burning a folder.

extern DRFilesystemTrackRef DRFilesystemTrackCreate( 
    DRFolderRef rootFolder) ;  

Parameters

rootFolder

The root folder for the filesystem.

Return Value

A DRFilesystemTrack capable of burning the track.

Discussion

You can set the filesystem track's properties using the calls in DRCoreTrack.h - see also DRContentProperties.h for a list of settable track properties.

Availability

Introduced in Mac OS X v10.2

Provides an estimate of the approximate size that should be reserved for directory structures on a disc.

extern UInt64 DRFilesystemTrackEstimateOverhead( 
    UInt64 numBlocks, 
    UInt32 blockSize, 
    DRFilesystemMask fsMask) ;  

Parameters

numBlocks

The number of blocks on the disc.

blockSize

The size of blocks on the disc (usually 2048).

fsMask

The requested filesystem mask, or kDRFilesystemMaskDefault .

Return Value

The number of blocks needed for filesystem overhead on a typical disc of this size.

Discussion

This call provides a simple estimate of approximate overhead before any data has been specified, for situations where such information may be useful ahead of time. One such example is in Finder burning, when a disk image is created that is sized to fit a newly-inserted disc.

The result of this function is merely an estimate, and the actual number of blocks required may be lower or higher depending on the data to burn. For more accurate results, wait until the burn is ready to start, create a DRFilesystemTrack, and then call DRTrackEstimateLength If size returned by that function is greater than the actual space available, then the burn will not succeed: ask the user to remove some data and try the burn again.

Availability

Introduced in Mac OS X v10.3.

Typedefs

typedef DRTrackRef DRAudioTrackRef;  

Discussion

A DRAudioTrack is just a special DRTrack. The type ID of a DRAudioTrack is the same as the type ID of a DRTrack.

typedef DRTrackRef DRFilesystemTrackRef;  

Discussion

A DRFilesystemTrack is just a special DRTrack. The type ID of a DRFilesystemTrack is the same as the type ID of a DRTrack.

Did this document help you? Yes: Tell us what works for you. It’s good, but: Report typos, inaccuracies, and so forth. It wasn’t helpful: Tell us what would have helped.

Last Updated: 2008-04-01