---

QTDataReference Class Reference

Overview

A QTDataReference object is a representation of a QuickTime data reference which specifies the location of a QuickTime movie or some media data. You can create QTDataReference objects that refer to data stored in files accessed using file names or URLs, or in memory accessed using handles, pointers, or NSData objects.

Tasks

Creating a QTDataReference

• + dataReferenceWithDataRef:type:
• + dataReferenceWithDataRefData:type:
• + dataReferenceWithReferenceToFile:
• + dataReferenceWithReferenceToURL:
• + dataReferenceWithReferenceToData:
• + dataReferenceWithReferenceToData:name:MIMEType:

Initializing a QTDataReference

• – initWithDataRef:type:
• – initWithDataRefData:type:
• – initWithReferenceToFile:
• – initWithReferenceToURL:
• – initWithReferenceToData:
• – initWithReferenceToData:name:MIMEType:

Getting and Setting Data Reference Information

• – dataRef
• – dataRefData
• – dataRefType
• – referenceFile
• – referenceURL
• – referenceData
• – name
• – MIMEType
• – setDataRef:
• – setDataRefType:

Class Methods

dataReferenceWithDataRef:type:

+ (id)dataReferenceWithDataRef:(Handle)dataRef type:(NSString *)type

Discussion

Creates a QTDataReference object of type type initialized with data from dataRef. You can use this call to convert an existing QuickTime data reference (stored as a handle) into a QTDataReference.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

dataReferenceWithDataRefData:type:

+ (id)dataReferenceWithDataRefData:(NSData *)dataRefData type:(NSString *)type

Discussion

Creates a QTDataReference object of type type initialized with data from dataRefData.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

dataReferenceWithReferenceToData:

+ (id)dataReferenceWithReferenceToData:(NSData *)data

Discussion

Creates a QTDataReference object for the data block data.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

dataReferenceWithReferenceToData:name:MIMEType:

+ (id)dataReferenceWithReferenceToData:(NSData *)data name:(NSString *)name MIMEType:(NSString *)MIMEType

Discussion

Creates a QTDataReference object for the data block data; this data reference has two data reference extensions, a filenaming extension and a MIME type extension.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

dataReferenceWithReferenceToFile:

+ (id)dataReferenceWithReferenceToFile:(NSString *)fileName

Discussion

Creates a QTDataReference object for the file fileName. The fileName is assumed to be a full path name for a file.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

dataReferenceWithReferenceToURL:

+ (id)dataReferenceWithReferenceToURL:(NSURL *)url

Discussion

Creates a QTDataReference object for the URL url.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

Instance Methods

dataRef

- (Handle)dataRef

Discussion

Returns the QuickTime data reference associated with a QTDataReference object.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

dataRefData

- (NSData *)dataRefData

Discussion

Returns the QuickTime data reference data associated with a QTDataReference object, stored in an NSData object.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

dataRefType

- (NSString *)dataRefType

Discussion

Returns the type of the data reference associated with a QTDataReference object.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

initWithDataRef:type:

- (id)initWithDataRef:(Handle)dataRef type:(NSString *)type

Discussion

Initializes a newly created QTDataReference object with data from dataRef; the QTDataReference is of type dataRefType. You can use this call to convert an existing QuickTime data reference (stored as a handle) into a QTDataReference.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

initWithDataRefData:type:

- (id)initWithDataRefData:(NSData *)dataRefData type:(NSString *)type

Discussion

Initializes a newly created QTDataReference object with data from dataRefData; the QTDataReference is of type dataRefType.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

initWithReferenceToData:

- (id)initWithReferenceToData:(NSData *)data

Discussion

Initializes a newly created QTDataReference object for the data block data.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

initWithReferenceToData:name:MIMEType:

- (id)initWithReferenceToData:(NSData *)data name:(NSString *)name MIMEType:(NSString *)MIMEType

Discussion

Initializes a newly created QTDataReference object for the data block data; this data reference has two data reference extensions, a filenaming extension and a MIME type extension.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

initWithReferenceToFile:

- (id)initWithReferenceToFile:(NSString *)fileName

Discussion

Initializes a newly created QTDataReference object for the file fileName. The fileName is assumed to be a full path name for a file.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

initWithReferenceToURL:

- (id)initWithReferenceToURL:(NSURL *)url

Discussion

Initializes a newly created QTDataReference object for the URL url.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

MIMEType

- (NSString *)MIMEType

Discussion

Returns the type in a MIME type extension associated with a QTDataReference object.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

name

- (NSString *)name

Discussion

Returns the name in a filenaming extension associated with a QTDataReference object

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

referenceData

- (NSData *)referenceData

Discussion

Returns the reference data of a QTDataReference object, that is, the NSData object passed to initWithReferenceToData or initWithReferenceToData:name:MIMEType. For some QTDataReference objects, this may be NIL.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

referenceFile

- (NSString *)referenceFile

Discussion

Returns the file name of the data reference associated with a QTDataReference object. For some QTDataReference objects, this name may be NIL.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

referenceURL

- (NSURL *)referenceURL

Discussion

Returns the URL of the data reference associated with a QTDataReference object. For some QTDataReference objects, this URL may be NIL.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

setDataRef:

- (void)setDataRef:(Handle)dataRef

Discussion

Sets the data reference data of a QTDataReference object to dataRef. The previous data reference data is disposed of.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

setDataRefType:

- (void)setDataRefType:(NSString *)type

Discussion

Sets the data reference type of a QTDataReference object to type.

Availability

• Available in Mac OS X v10.3 and later.

Declared In

QTDataReference.h

Constants

The following constants are Cocoa identifiers for the basic data reference types. One of these types would be returned, for instance, by this method: - (NString *) dataRefType.

---