<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "QuickTime File Format",
  "identifier" : "/documentation/quicktime-file-format/Movie_media_sample",
  "metadataVersion" : "0.1.0",
  "role" : "Atom",
  "symbol" : {
    "kind" : "Atom",
    "modules" : [
      "QuickTime File Format"
    ],
    "preciseIdentifier" : "__docc_universal_symbol_reference_$Movie_media_sample"
  },
  "title" : "Movie media sample"
}
-->

# Movie media sample

Each sample in the movie media is a QuickTime atom container.

## Overview

All root-level atoms and their contents are enumerated in the following list. Note that the contents of all atoms are stored in big-endian format.

## Topics

### Data fields

[`kMovieMediaDataReference`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaDataReference)

A data reference type and a data reference.

[`kMovieMediaDefaultDataReferenceID`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaDefaultDataReferenceID)

An identifier for the data reference to use when instantiating the embedded movie for this sample.

[`kMovieMediaAutoPlay`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaAutoPlay)

A Boolean that indicates whether or not the embedded movie starts playing immediately after  instantiation.

[`kMovieMediaLoop`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaLoop)

An 8-byte unsigned integer that indicates how the embedded movie should loop.

[`kMovieMediaUseMIMEType`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaUseMIMEType)

Text (not a C string or a pascal string) that indicates the MIME type of the movie import component that should be used to instantiate this media.

[`kMovieMediaTitle`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaTitle)

Currently unused.

[`kMovieMediaAltText`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaAltText)

Text (not a C string or a pascal string) that is displayed to the user when the embedded movie is being instantiated or if the embedded movie cannot be instantiated.

[`kMovieMediaClipBegin`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaClipBegin)

A record that indicates the time of the embedded movie to use.

[`kMovieMediaClipDuration`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaClipDuration)

A record that indicates the duration of the embedded movie to use.

[`kMovieMediaEnableFrameStepping`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaEnableFrameStepping)

A Boolean that indicates whether the embedded movie should be considered when performing step operations.

[`kMovieMediaBackgroundColor`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaBackgroundColor)

A color that is used for filling the background when the movie is being instantiated or when it fails to instantiate.

[`kMovieMediaRegionAtom`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaRegionAtom)

A number of atoms, which describe how the Movie Media Handler should resize the embedded movie.

[`kMovieMediaRectangleAtom`](/documentation/quicktime-file-format/Movie_media_sample/kMovieMediaRectangleAtom)

Four atoms that define a rectangle.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)