Mac Developer Library

Developer

DRContentTrack.h Reference

Options
Deployment Target:

On This Page
Language:

DRContentTrack.h Reference

Inheritance


Not Applicable

Conforms To


Not Applicable

Import Statement


Swift

import DiscRecording

Objective-C

@import DiscRecording;

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

    Swift

    func DRAudioTrackCreate(_ audioFile: UnsafePointer<FSRef>) -> Unmanaged<DRAudioTrack>!

    Objective-C

    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.

    Import Statement

    Objective-C

    @import DiscRecording;

    Swift

    import DiscRecording

    Availability

    Available in OS X v10.3 and later.

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

    Declaration

    Swift

    func DRAudioTrackCreateWithURL(_ audioFileURL: CFURL!) -> Unmanaged<DRAudioTrack>!

    Objective-C

    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.

    Import Statement

    Objective-C

    @import DiscRecording;

    Swift

    import DiscRecording

    Availability

    Available in OS X v10.3 and later.

  • Creates a filesystem track capable of burning a folder.

    Declaration

    Swift

    func DRFilesystemTrackCreate(_ rootFolder: DRFolder!) -> Unmanaged<DRFilesystemTrack>!

    Objective-C

    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.

    Import Statement

    Objective-C

    @import DiscRecording;

    Swift

    import DiscRecording

    Availability

    Available in OS X v10.2 and later.

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

    Declaration

    Swift

    func DRFilesystemTrackEstimateOverhead(_ numBlocks: UInt64, _ blockSize: UInt32, _ fsMask: DRFilesystemMask) -> UInt64

    Objective-C

    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.

    Import Statement

    Objective-C

    @import DiscRecording;

    Swift

    import DiscRecording

    Availability

    Available in OS X v10.3 and later.

Data Types

See the Overview section above for header-level documentation.

  • Declaration

    Swift

    typealias DRAudioTrackRef = DRAudioTrack

    Objective-C

    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

    Objective-C

    @import DiscRecording;

    Swift

    import DiscRecording

    Availability

    Available in OS X v10.3 and later.

  • Declaration

    Swift

    typealias DRFilesystemTrackRef = DRFilesystemTrack

    Objective-C

    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

    Objective-C

    @import DiscRecording;

    Swift

    import DiscRecording

    Availability

    Available in OS X v10.2 and later.