DRBurn(PropertyConvenienceMethods) Class Reference

Declared in

Overview

This category on DRBurn defines methods that make setting and retrieving the various DRBurn properties easier.

Tasks

Miscellaneous

Instance Methods

appendable

Indicates if the burn is appendable.

- (BOOL) appendable;
Return Value

A BOOL indicating if the burn is appendable.

Discussion

When a burn completes, it can mark the disc so that no more data can be written to it. This creates a closed or non-appendable disc (which is the most compatible with audio CD players). If this method returns NO, then the disc will be marked as closed and no data can be appended to it. A return value of YES indicates further burns can be appended to the disc.

completionAction

Returns the action to be performed at the end of the burn.

- (NSString*) completionAction;
Return Value

An NSString

requestedBurnSpeed

Returns the speed at which this burn will attempt to write data.

- (float) requestedBurnSpeed;
Return Value

A float indicating the speed the burn should run at in kilobytes per second.

Discussion

The actual speed also depends on the capabilities of the bus the device is on, the maximum speed of the device itself, and the media used.

setAppendable:

Sets the burn to be appendable or non-appendable.

- (void) setAppendable:(BOOL)appendable;
Parameters
appendable

A BOOL indicating if the burn is appendable. Passing in YES indicates further burns can be appended to the disc, while passing in NO, marks the disc as closed and no data can be appended to it.

Discussion

When a burn completes, it can mark the disc so that no more data can be written to it. This creates a closed or non-appendable disc (which is the most compatible with audio CD players).

setCompletionAction:

Sets the action to be performed at the end of the burn.

- (void) setCompletionAction:(NSString*)action;
Parameters
action

An NSString for the action to perform.

setRequestedBurnSpeed:

Sets the speed at which the burn will be attempted to be performed at

- (void) setRequestedBurnSpeed:(float)speed;
Parameters
speed

The speed that the burn should run at in kilobytes per second.

Discussion

The actual speed also depends on the capabilities of the bus the device is on, the maximum speed of the device itself, and the media used.

setVerifyDisc:

Sets the burn to verify or not verify the disc.

- (void) setVerifyDisc:(BOOL)verify;
Parameters
verify

A BOOL indicating if the disc is to be verified. Passing in YES (the default) indicates that the data written to disc will be verified against the source data once the burn complete. Passing in NO indicates that no verification will take place.

verifyDisc

Indicates if the resulting disc will be verified.

- (BOOL) verifyDisc;
Return Value

A BOOL indicating if the disc will be verified.

Discussion

After data is written to disc, the data can be verified. The verification process will read the data on the disc back into memory and compare it to the data originally used to write to disc. The type of verification is determined by a track property on a track-by-track basis. See the DRTrack documentation for more information on verification types.