Mac Developer Library

Developer

DRBurn Class Reference

Options
Deployment Target:

On This Page
Language:

DRBurn

Handles the process of burning a CD or DVD disc. More...

Inheritance


Conforms To


Import Statement


import DiscRecording @import DiscRecording;

Availability


Available in OS X v10.2 and later.
  • Stops the burn.

    Declaration

    Swift

    func abort()

    Objective-C

    - (void)abort

    Discussion

    When this method returns the burn might not actually be fully stopped but it has been cancelled and only cleanup is going on. If a burn has not completed writing data to disc, you just made a coaster.

    Typically this method is only used as a result of the user hitting a cancel/stop button somewhere in the user interface.

    Import Statement

    import DiscRecording

    Availability

    Available in OS X v10.2 and later.

  • Returns the device being used for the burn.

    Declaration

    Swift

    func device() -> DRDevice!

    Objective-C

    - (DRDevice *)device

    Return Value

    The DRDevice the burn will use.

    Import Statement

    import DiscRecording

    Availability

    Available in OS X v10.2 and later.

  • Initializes the burn object.

    Declaration

    Swift

    init!(device device: DRDevice!)

    Objective-C

    - (id)initWithDevice:(DRDevice *)device

    Parameters

    device

    Device to use for the burn

    Return Value

    A DRBurn object.

    Discussion

    Once a burn is initialized with this method, the object is ready to write data to the disc.

    Import Statement

    import DiscRecording

    Availability

    Available in OS X v10.2 and later.

  • Returns the properties dictionary of the burn.

    Declaration

    Swift

    func properties() -> [NSObject : AnyObject]!

    Objective-C

    - (NSDictionary *)properties

    Return Value

    An NSDictionary containing the properties of the burn.

    Import Statement

    import DiscRecording

    Availability

    Available in OS X v10.2 and later.

  • Sets the properties dictionary of the burn.

    Declaration

    Swift

    func setProperties(_ properties: [NSObject : AnyObject]!)

    Objective-C

    - (void)setProperties:(NSDictionary *)properties

    Parameters

    properties

    NSDictionary of the properties to set.

    Import Statement

    import DiscRecording

    Availability

    Available in OS X v10.2 and later.

  • Returns a dictionary describing the status of the burn.

    Declaration

    Swift

    func status() -> [NSObject : AnyObject]!

    Objective-C

    - (NSDictionary *)status

    Return Value

    An NSDictionary reporting the status of the burn.

    Discussion

    The same dictionary is returned through the DRBurnStatusChangedNotification notification

    Import Statement

    import DiscRecording

    Availability

    Available in OS X v10.2 and later.

  • Begin the process of burning a disc layout.

    Declaration

    Swift

    func writeLayout(_ layout: AnyObject!)

    Objective-C

    - (void)writeLayout:(id)layout

    Parameters

    layout

    The data to be burned to disc.

    There are three configurations of the object passed in:

    1. For a multi-session burn, layout must be a valid NSArray containing one or more NSArrays, each of which contains one or more valid DRTrack in DRTrack Class Reference objects.

    2. For a single-session multi-track burn, layout must be a valid NSArray containing one or more valid DRTrack in DRTrack Class Reference objects.

    3. For a single-session single-track burn, layout must be a valid DRTrack in DRTrack Class Reference object.

    If none of these configurations are met or the leaf values contained in layout are not valid DRTrack in DRTrack Class Reference objects, an exception is thrown.

    Discussion

    This method only begins the burning process. Once the burn has been started, control returns to the caller and it is up to the caller to monitor the progress of the burn (by listening for DRBurnStatusChangedNotification or polling status ) to know when the burn completes (either successfully or with an error).

    Import Statement

    import DiscRecording

    Availability

    Available in OS X v10.2 and later.

  • Creates an autoreleased burn object.

    Declaration

    Swift

    init!(forDevice device: DRDevice!) -> DRBurn

    Objective-C

    + (DRBurn *)burnForDevice:(DRDevice *)device

    Parameters

    device

    Device to use for the burn

    Return Value

    An autoreleased DRBurn object.

    Discussion

    Once a burn is created with this method, the object is ready to write data to the disc.

    Import Statement

    import DiscRecording

    Availability

    Available in OS X v10.2 and later.