Advanced Search

Log In | Not a Member?

Contact ADC

< Previous PageNext Page > Hide TOC

New User Data APIs

QuickTime 6 introduces new UserData APIs that can be useful in copying information from one UserData container to another. The operation performed is controlled by a parameter to the APIs that describes one of two different copy rules or dispositions. While there is a routine to copy from one UserData container to another, there are also convenience APIs to copy metadata between the UserData containers at the Movie, Track and Media levels.

The currently supported copy rules are:

• kQTCopyUserDataReplace Delete all user data items from the destination UserData container and then add all source items to the destination.

• kQTCopyUserDataMerge Append all source items from the source UserData container to the destination UserData container. Does not delete items from the destination container.

CopyMovieUserData

Performs copying from the source Movie’s UserData to the destination Movie UserData.

   
OSErr CopyMovieUserData (Movie srcMovie,
   Movie dstMovie,
   OSType copyRule);

Parameters

srcMovie

Movie containing source UserData.

dstMovie

Movie containing destination UserData

copyRule

Specifies one of two different approaches to copying source metadata items to the destination container. The supported rules are:

kQTCopyUserDataReplace

kQTCopyUserDataMerge

Discussion

This routine performs copying from the source Movie’s UserData to the destination Movie UserData.

CopyMovieUserData is equivalent to the following:

CopyUserData(GetMovieUserData(srcMovie),

                GetMovieUserData(dstMovie),

                copyRule);

Introduced in QuickTime 6.

Availability

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

Declared In

C interface file: Movies.h

CopyTrackUserData

Performs copying from the source Track’s UserData to the destination Track’s UserData.

OSErr CopyTrackUserData (Track srcTrack,
   Track dstTrack,
   OSType copyRule);

Parameters

srcTrack

Track containing source UserData.

dstTrack

Track containing destination UserData.

copyRule

Specifies one of two different approaches to copying source metadata items to the destination container. The supported rules are:

kQTCopyUserDataReplace

kQTCopyUserDataMerge

Discussion

This routine performs copying from the source Track’s UserData to the destination Track’s UserData.

Introduced in QuickTime 6.

Availability

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

Declared In

C interface file: Movies.h

CopyMediaUserData

Performs copying from the source Media’s UserData to the destination Media’s UserData.

   
OSErr CopyMediaUserData (Media srcMedia,
Media dstMedia,
OSType copyRule);

Parameters

srcMedia

Media containing source UserData.

dstMedia

Media containing destination UserData.

copyRule

Specifies one of two different approaches to copying source metadata items to the destination container. The supported rules are:

kQTCopyUserDataReplace

kQTCopyUserDataMerge

Discussion

This routine performs copying from the source Media’s UserData to the destination Media’s UserData.

CopyMediaUserData is equivalent to the following:

    CopyUserData(GetMediaUserData(srcMedia),

                    GetMediaUserData(dstMedia),

                    copyRule);

Introduced in QuickTime 6.

Availability

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

Declared In

C interface file: Movies.h

CopyUserData

Copies metadata items from the source UserData container to the destination UserData container based on the rule specified.

   
OSErr CopyUserData (UserData srcUserData,
UserData dstUserData,
OSType copyRule);

Parameters

srcUserData

UserData container from which to copy metadata items.

dstUserData

UserData container to which to copy the metadata items.

copyRule

Specifies one of two different approaches to copying source metadata items to the destination container. The supported rules are:

kQTCopyUserDataReplace

kQTCopyUserDataMerge

Discussion

CopyUserData copies metadata items from the source UserData container to the destination UserData container based upon the rule specified. It can perform either total replacement of all destination items or merge items from the source into the destination container.

The API detects if the source and destination UserData containers are the same and does nothing in that case.

Introduced in QuickTime 6.

Availability

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

Declared In

C interface file: Movies.h

< Previous PageNext Page > Hide TOC

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.

	Get information on Apple products. Visit the Apple Store online or at retail locations. 1-800-MY-APPLE Copyright © 2007 Apple Inc. All rights reserved. | Terms of use | Privacy Notice