---

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 filenames 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:

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

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

Parameters

dataRef

The data reference stored as a handle in a QTDataReference object.

type

The type of initialized data from a data reference.

Discussion

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:

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

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

Parameters

dataRefData

The NSData object with data referenced data.

type

The type initialized with data.

Availability

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

Declared In

QTDataReference.h

dataReferenceWithReferenceToData:

Creates a QTDataReference object for the data block data.

+ (id)dataReferenceWithReferenceToData:(NSData *)data

Parameters

data

The data for the QTDataReference object.

Availability

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

Declared In

QTDataReference.h

dataReferenceWithReferenceToData:name:MIMEType:

Creates a QTDataReference object for the data block data.

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

Parameters

data

The data of the QTDataReference object.

name

The name of the QTDataReference object.

MIMEType

The MIME type for the data reference.

Discussion

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:

Creates a QTDataReference object for the file fileName.

+ (id)dataReferenceWithReferenceToFile:(NSString *)fileName

Parameters

fileName

The file name for a full path for a file.

Discussion

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:

Creates a QTDataReference object for the URL url.

+ (id)dataReferenceWithReferenceToURL:(NSURL *)url

Parameters

url

The URL for the QTDataReference object.

Availability

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

Declared In

QTDataReference.h

Instance Methods

dataRef

Returns the QuickTime data reference associated with a QTDataReference object.

- (Handle)dataRef

Availability

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

Declared In

QTDataReference.h

dataRefData

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

- (NSData *)dataRefData

Availability

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

Declared In

QTDataReference.h

dataRefType

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

- (NSString *)dataRefType

Availability

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

Declared In

QTDataReference.h

initWithDataRef:type:

Initializes a newly created QTDataReference object with data from dataRef.

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

Discussion

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:

Initializes a newly created QTDataReference object with data from dataRefData.

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

Discussion

The QTDataReference is of type dataRefType.

Availability

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

Declared In

QTDataReference.h

initWithReferenceToData:

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

- (id)initWithReferenceToData:(NSData *)data

Availability

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

Declared In

QTDataReference.h

initWithReferenceToData:name:MIMEType:

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

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

Discussion

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:

Initializes a newly created QTDataReference object for the file fileName.

- (id)initWithReferenceToFile:(NSString *)fileName

Parameters

fileName

The file name for the file.

Discussion

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:

Initializes a newly created QTDataReference object for the URL url.

- (id)initWithReferenceToURL:(NSURL *)url

Availability

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

Declared In

QTDataReference.h

MIMEType

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

- (NSString *)MIMEType

Availability

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

Declared In

QTDataReference.h

name

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

- (NSString *)name

Availability

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

Declared In

QTDataReference.h

referenceData

Returns the reference data of a QTDataReference object, that is, the NSData object passed to initWithReferenceToData or initWithReferenceToData:name:MIMEType.

- (NSData *)referenceData

Discussion

For some QTDataReference objects, this may be NIL.

Availability

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

Declared In

QTDataReference.h

referenceFile

Returns the file name of the data reference associated with a QTDataReference object.

- (NSString *)referenceFile

Discussion

For some QTDataReference objects, this name may be NIL.

Availability

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

Declared In

QTDataReference.h

referenceURL

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

- (NSURL *)referenceURL

Discussion

For some QTDataReference objects, this URL may be NIL.

Availability

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

Declared In

QTDataReference.h

setDataRef:

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

- (void)setDataRef:(Handle)dataRef

Discussion

The previous data reference data is disposed of.

Availability

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

Declared In

QTDataReference.h

setDataRefType:

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

- (void)setDataRefType:(NSString *)type

Availability

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

Declared In

QTDataReference.h

Constants

Data Reference Types

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

NSString * const QTDataReferenceTypeFile;
NSString * const QTDataReferenceTypeHandle;
NSString * const QTDataReferenceTypePointer;
NSString * const QTDataReferenceTypeResource;
NSString * const QTDataReferenceTypeURL;

Constants

QTDataReferenceTypeFile

The file type for a QTDataReference object.

Available in Mac OS X v10.3 and later.

Declared in QTDataReference.h.

QTDataReferenceTypeHandle

The handle type for a QTDataReference object.

Available in Mac OS X v10.3 and later.

Declared in QTDataReference.h.

QTDataReferenceTypePointer

The pointer type for a QTDataReference object.

Available in Mac OS X v10.3 and later.

Declared in QTDataReference.h.

QTDataReferenceTypeResource

The resource type for a QTDataReference object.

Available in Mac OS X v10.3 and later.

Declared in QTDataReference.h.

QTDataReferenceTypeURL

The URL type for a QTDataReference object.

Available in Mac OS X v10.3 and later.

Declared in QTDataReference.h.

---