Mac Developer Library

Developer

QTKit Framework Reference QTDataReference Class Reference

Options
Deployment Target:

On This Page

QTDataReference

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.

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

    Declaration

    + (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 OS X v10.3 and later.

    Deprecated in OS X v10.9.

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

    Declaration

    + (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 OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTDataReference object for the file fileName.

    Declaration

    + (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 OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTDataReference object for the URL url.

    Declaration

    + (id)dataReferenceWithReferenceToURL:(NSURL *)url

    Parameters

    url

    The URL for the QTDataReference object.

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTDataReference object for the data block data.

    Declaration

    + (id)dataReferenceWithReferenceToData:(NSData *)data

    Parameters

    data

    The data for the QTDataReference object.

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTDataReference object for the data block data.

    Declaration

    + (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 file-naming extension and a MIME type extension.

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Initializes a newly created QTDataReference object with data from dataRef.

    Declaration

    - (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 OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Initializes a newly created QTDataReference object with data from dataRefData.

    Declaration

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

    Discussion

    The QTDataReference is of type dataRefType.

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Initializes a newly created QTDataReference object for the file fileName.

    Declaration

    - (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 OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Initializes a newly created QTDataReference object for the URL url.

    Declaration

    - (id)initWithReferenceToURL:(NSURL *)url

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

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

    Declaration

    - (id)initWithReferenceToData:(NSData *)data

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

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

    Declaration

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

    Discussion

    This data reference has two data reference extensions: a file-naming extension and a MIME type extension.

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • - dataRef (OS X v10.9)

    Returns the QuickTime data reference associated with a QTDataReference object.

    Declaration

    - (Handle)dataRef

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • - dataRefData (OS X v10.9)

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

    Declaration

    - (NSData *)dataRefData

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • - dataRefType (OS X v10.9)

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

    Declaration

    - (NSString *)dataRefType

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • - referenceFile (OS X v10.9)

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

    Declaration

    - (NSString *)referenceFile

    Discussion

    For some QTDataReference objects, this name may be NIL.

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • - referenceURL (OS X v10.9)

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

    Declaration

    - (NSURL *)referenceURL

    Discussion

    For some QTDataReference objects, this URL may be NIL.

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • - referenceData (OS X v10.9)

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

    Declaration

    - (NSData *)referenceData

    Discussion

    For some QTDataReference objects, this may be NIL.

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • - name (OS X v10.9)

    Returns the name in a file-naming extension associated with a QTDataReference object.

    Declaration

    - (NSString *)name

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • - MIMEType (OS X v10.9)

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

    Declaration

    - (NSString *)MIMEType

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • - setDataRef: (OS X v10.9)

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

    Declaration

    - (void)setDataRef:(Handle)dataRef

    Discussion

    The previous data reference data is disposed of.

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • - setDataRefType: (OS X v10.9)

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

    Declaration

    - (void)setDataRefType:(NSString *)type

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

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

    Declaration

    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 OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTDataReferenceTypeHandle

      The handle type for a QTDataReference object.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTDataReferenceTypePointer

      The pointer type for a QTDataReference object.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTDataReferenceTypeResource

      The resource type for a QTDataReference object.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTDataReferenceTypeURL

      The URL type for a QTDataReference object.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.