Mac Developer Library

Developer

DRContentTrack.h Reference

Options
Deployment Target:

On This Page

DRContentTrack.h Reference

Interface to track objects used in filesystem creation.

Included Headers

  • <CoreFoundation/CoreFoundation.h>

  • <DiscRecording/DRCoreTrack.h>

  • <DiscRecording/DRContentFolder.h>

  • <DiscRecording/DRContentProperties.h>

  • <AvailabilityMacros.h>

Functions

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

    Declaration

    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.

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

    Declaration

    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.

  • Creates a filesystem track capable of burning a folder.

    Declaration

    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.

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

    Declaration

    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.

Data Types

See the Overview section above for header-level documentation.

  • Declaration

    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.

    Import Statement

  • Declaration

    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.

    Import Statement