Mac Developer Library

Developer

QTKit Framework Reference QTDataReference Class Reference

Options
Deployment Target:

On This Page
Language:

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.

Inheritance


Conforms To


Import Statement


import QTKit @import QTKit;

Availability


Available in OS X v10.3 and later.
  • Creates a QTDataReference object of type type initialized with data from dataRef.

    Declaration

    Objective-C

    + (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.

    Import Statement

    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

    Objective-C

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

    Parameters

    dataRefData

    The NSData object with data referenced data.

    type

    The type initialized with data.

    Import Statement

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTDataReference object for the file fileName.

    Declaration

    Objective-C

    + (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.

    Import Statement

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTDataReference object for the URL url.

    Declaration

    Objective-C

    + (id)dataReferenceWithReferenceToURL:(NSURL *)url

    Parameters

    url

    The URL for the QTDataReference object.

    Import Statement

    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

    Objective-C

    + (id)dataReferenceWithReferenceToData:(NSData *)data

    Parameters

    data

    The data for the QTDataReference object.

    Import Statement

    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

    Objective-C

    + (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.

    Import Statement

    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

    Objective-C

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

    Import Statement

    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

    Objective-C

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

    Discussion

    The QTDataReference is of type dataRefType.

    Import Statement

    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

    Objective-C

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

    Import Statement

    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

    Objective-C

    - (id)initWithReferenceToURL:(NSURL *)url

    Import Statement

    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

    Objective-C

    - (id)initWithReferenceToData:(NSData *)data

    Import Statement

    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

    Objective-C

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

    Import Statement

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • dataRef dataRef (OS X v10.9)

    Returns the QuickTime data reference associated with a QTDataReference object.

    Declaration

    Objective-C

    - (Handle)dataRef

    Import Statement

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • dataRefData dataRefData (OS X v10.9)

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

    Declaration

    Objective-C

    - (NSData *)dataRefData

    Import Statement

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • dataRefType dataRefType (OS X v10.9)

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

    Declaration

    Objective-C

    - (NSString *)dataRefType

    Import Statement

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

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

    Declaration

    Objective-C

    - (NSString *)referenceFile

    Discussion

    For some QTDataReference objects, this name may be NIL.

    Import Statement

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • referenceURL referenceURL (OS X v10.9)

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

    Declaration

    Objective-C

    - (NSURL *)referenceURL

    Discussion

    For some QTDataReference objects, this URL may be NIL.

    Import Statement

    Availability

    Available in OS X v10.3 and later.

    Deprecated in 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

    Objective-C

    - (NSData *)referenceData

    Discussion

    For some QTDataReference objects, this may be NIL.

    Import Statement

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • name name (OS X v10.9)

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

    Declaration

    Objective-C

    - (NSString *)name

    Import Statement

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • MIMEType MIMEType (OS X v10.9)

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

    Declaration

    Objective-C

    - (NSString *)MIMEType

    Import Statement

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • setDataRef: setDataRef: (OS X v10.9)

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

    Declaration

    Objective-C

    - (void)setDataRef:(Handle)dataRef

    Discussion

    The previous data reference data is disposed of.

    Import Statement

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

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

    Declaration

    Objective-C

    - (void)setDataRefType:(NSString *)type

    Import Statement

    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

    Objective-C

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

    Constants

    • QTDataReferenceTypeFile

      QTDataReferenceTypeFile

      The file type for a QTDataReference object.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTDataReferenceTypeHandle

      QTDataReferenceTypeHandle

      The handle type for a QTDataReference object.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTDataReferenceTypePointer

      QTDataReferenceTypePointer

      The pointer type for a QTDataReference object.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTDataReferenceTypeResource

      QTDataReferenceTypeResource

      The resource type for a QTDataReference object.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTDataReferenceTypeURL

      QTDataReferenceTypeURL

      The URL type for a QTDataReference object.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    Import Statement