DRBurn(PropertyConvenienceMethods)

Overview

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

Methods

-appendable

Indicates if the burn is appendable.

-completionAction

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

-requestedBurnSpeed

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

-setAppendable:

Sets the burn to be appendable or non-appendable.

-setCompletionAction:

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

-setRequestedBurnSpeed:

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

-setVerifyDisc:

Sets the burn to verify or not verify the disc.

-verifyDisc

Indicates if the resulting disc will be verified.

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.

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

- (NSString*) completionAction; 

Return Value

An NSString

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.

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).

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.

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.

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.

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.

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