Component Creation Reference for QuickTime

Framework
Frameworks/QuickTime.framework
Declared in
Movies.h
QuickTimeComponents.h

Overview

APIs are provided to help developer create new components that import and export data to and from QuickTime movies, including managing movie previews.

Functions by Task

Compressing Image Sequences

Compressing Still Images

Configuring Movie Data Export Components

Configuring Movie Data Import Components

Creating a Compression Graphics World

Creating Previews

Displaying Previews

Displaying the Standard Image-Compression Dialog Box

Exporting Movie Data

Exporting Text

Getting Default Settings for an Image or a Sequence

Handling Preview Events

Importing MIDI Files

Importing Movie Data

Managing the Time

Movie Functions

Positioning Dialog Boxes and Rectangles

Specifying a Test Image

Tween Component Requirements

Using Callback Functions

Working With Image or Sequence Settings

Working With The Idle Manager

Working With the Timecode Media Handler

Supporting Functions

Functions

Callbacks

MovieExportGetDataProc

Defines a data source for an export operation.

typedef OSErr (*MovieExportGetDataProcPtr) (void *refCon, MovieExportGetDataParams *params);

If you name your function MyMovieExportGetDataProc, you would declare it this way:

OSErr MyMovieExportGetDataProc (
   void                        *refCon,
   MovieExportGetDataParams    *params );

Parameters
refCon

Contains the value passed to MovieExportAddDataSource in the refCon parameter

params

The sample request is made through a MovieExportGetDataParams structure.

Return Value

See Error Codes. Your callback should return noErr if there is no error.

Discussion

This callback is passed to MovieExportAddDataSource to define a new data source for an export operation. The function is used by the exporting application to request source media data to be used in the export operation. For example, in a video export operation, frames of video data (either compressed or uncompressed) are provided. In a sound export operation, buffers of audio (either compressed or uncompressed) are provided.

Special Considerations

The data pointed to by dataPtr must remain valid until the next call to this function. The MovieExportGetDataProc callback is responsible for allocating and disposing of the memory associated with this data pointer.

Declared In
QuickTimeComponents.h

MovieExportGetPropertyProc

Returns parameters that determine the appropriate format for movie export data.

typedef OSErr (*MovieExportGetPropertyProcPtr) (void *refcon, long trackID, OSType propertyType, void *propertyValue);

If you name your function MyMovieExportGetPropertyProc, you would declare it this way:

OSErr MyMovieExportGetPropertyProc (
   void      *refcon,
   long      trackID,
   OSType    propertyType,
   void      *propertyValue );

Parameters
refcon

Contains the value passed to MovieExportAddDataSource in the refCon parameter.

trackID

Specifies the value returned from MovieExportAddDataSource.

propertyType

Contains a pointer to the location of the requested property information.

propertyValue

Specifies the property being requested (see below). See these constants:

Return Value

See Error Codes. Your callback should return noErr if there is no error. If this function doesn't have a setting for a requested property, it should return an error.

Discussion

This function is passed to MovieExportAddDataSource to define a new data source for an export operation. For example, a video export operation may call this function to determine the dimensions of the destination video track. The export component provides a default value for the property based on the source data format. For example, if no values for video track width and height properties were provided by the callback function, the dimensions of the source data would be used.

Declared In
QuickTimeComponents.h

SCModalFilterProc

Filter routine called when a user event occurs in a sequence compression modal dialog box.

typedef Boolean (*SCModalFilterProcPtr) (DialogPtr theDialog, EventRecord *theEvent, short *itemHit, long refcon);

If you name your function MySCModalFilterProc, you would declare it this way:

Boolean MySCModalFilterProc (
   DialogPtr      theDialog,
   EventRecord    *theEvent,
   short          *itemHit,
   long           refcon );

Parameters
theDialog

A pointer to a dialog box.

theEvent

A pointer to an EventRecord structure that defines a user event.

itemHit

A pointer to an item ID number in the dialog box.

refcon

A reference constant that the client code supplies to your callback. You can use this reference to point to a data structure containing any information your callback needs.

Return Value

Return TRUE if the event was handled, FALSE otherwise.

Declared In
QuickTimeComponents.h

SCModalHookProc

Called whenever the user selects an item in the dialog box.

typedef short (*SCModalHookProcPtr) (DialogPtr theDialog, short itemHit, void *params, long refcon);

If you name your function MySCModalHookProc, you would declare it this way:

short MySCModalHookProc (
   DialogPtr    theDialog,
   short        itemHit,
   void         *params,
   long         refcon );

Parameters
theDialog

A pointer to a dialog box.

itemHit

A pointer to an item ID number in the dialog box.

params

A pointer to your data area.

refcon

A reference constant that the client code supplies to your callback.

Return Value

Return TRUE if the event was handled, FALSE otherwise.

Discussion

You can use this callback to customize the operation of the standard image-compression dialog box. For example, you might want to support a custom button that activates a secondary dialog box. Another possibility would be to provide additional validation support when the user clicks OK.

Declared In
QuickTimeComponents.h

Data Types

GraphicImageMovieImportComponent

Represents a type used by the Movie Components API.

typedef ComponentInstance GraphicImageMovieImportComponent;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

HandlerError

Represents a type used by the Movie Components API.

typedef ComponentResult HandlerError;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
Movies.h

MovieExportComponent

Represents a type used by the Movie Components API.

typedef ComponentInstance MovieExportComponent;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

MovieExportGetDataUPP

Represents a type used by the Movie Components API.

typedef STACK_UPP_TYPE(MovieExportGetDataProcPtr) MovieExportGetDataUPP;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

MovieExportGetPropertyUPP

Represents a type used by the Movie Components API.

typedef STACK_UPP_TYPE(MovieExportGetPropertyProcPtr) MovieExportGetPropertyUPP;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

MovieImportComponent

Represents a type used by the Movie Components API.

typedef ComponentInstance MovieImportComponent;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

pnotComponent

Represents a type used by the Movie Components API.

typedef ComponentInstance pnotComponent;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

SCModalFilterUPP

Represents a type used by the Movie Components API.

typedef STACK_UPP_TYPE(SCModalFilterProcPtr) SCModalFilterUPP;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

SCModalHookUPP

Represents a type used by the Movie Components API.

typedef STACK_UPP_TYPE(SCModalHookProcPtr) SCModalHookUPP;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

SCParams

Provides data for the SCGetCompressionExtended function.

struct SCParams {
   long              flags;
   CodecType         theCodecType;
   CodecComponent    theCodec;
   CodecQ            spatialQuality;
   CodecQ            temporalQuality;
   short             depth;
   Fixed             frameRate;
   long              keyFrameRate;
   long              reserved1;
   long              reserved2;
};
Fields
flags

Flags (see below). See these constants:

  • scGetCompression

  • scShowMotionSettings

  • scSettingsChangedItem

theCodecType

A compressor type; see Codec Identifiers.

theCodec

An instance of a compressor component, obtained by calling OpenComponent or OpenDefaultComponent.

spatialQuality

Constants (see below) that determine image spatial quality. See these constants:

  • codecMinQuality

  • codecLowQuality

  • codecNormalQuality

  • codecHighQuality

  • codecMaxQuality

  • codecLosslessQuality

temporalQuality

Constants (see below) that determine image temporal quality.

depth

Image data depth.

frameRate

The frame rate.

keyFrameRate

The key frame rate.

reserved1

Reserved.

reserved2

Reserved.

Discussion

See also SCGetCompressionExtended.

Declared In
QuickTimeComponents.h

TCTextOptions

Holds text font and style information.

struct TCTextOptions {
   short       txFont;
   short       txFace;
   short       txSize;
   short       pad;
   RGBColor    foreColor;
   RGBColor    backColor;
};
Fields
txFont

Specifies the number of the font.

txFace

Specifies the font's style (bold, italic, and so on).

txSize

Specifies the font's size.

pad

Unused field to make structure long-word aligned.

foreColor

Specifies the foreground color.

backColor

Specifies the background color.

Declared In
QuickTimeComponents.h

TCTextOptionsPtr

Represents a type used by the Movie Components API.

typedef TCTextOptions * TCTextOptionsPtr;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

TextDisplayData

Contains formatting information for a text sample.

struct TextDisplayData {
   long         displayFlags;
   long         textJustification;
   RGBColor     bgColor;
   Rect         textBox;
   short        beginHilite;
   short        endHilite;
   RGBColor     hiliteColor;
   Boolean      doHiliteColor;
   SInt8        filler;
   TimeValue    scrollDelayDur;
   Point        dropShadowOffset;
   short        dropShadowTransparency;
};
Fields
displayFlags

Contains flags (see below) that represent the values of text descriptors. See these constants:

  • dfDontDisplay

  • dfDontAutoScale

  • dfClipToTextBox

  • dfShrinkTextBoxToFit

  • dfScrollIn

  • dfScrollOut

  • dfHorizScroll

  • dfReverseScroll

textJustification

Contains constants (see below) that specify the alignment of the text in the text box. Possible values are teFlushDefault, teCenter, teFlushRight, and teFlushLeft. For more information on text alignment and the text justification constants, see the "TextEdit" chapter of Inside Macintosh: Text. See these constants:

bgColor

Specifies the background color of the rectangle specified by the textBox field. The background color is specified as an RGB color value.

textBox

Specifies the rectangle of the text box.

beginHilite

Specifies the one-based index of the first character in the sample to highlight.

endHilite

Specifies the one-based index of the last character in the sample to highlight.

doHiliteColor

Specifies whether to use the color specified by the hiliteColor field for highlighting. If the value of this field is TRUE, the highlight color is used for highlighting. If the value of this field is FALSE, reverse video is used for highlighting.

filler

Reserved.

scrollDelayDur

Specifies a scroll delay. The scroll delay is specified as the number of units of delay in the text track's time scale. For example, if the time scale is 600, a scroll delay of 600 causes the sample text to be delayed one second. In order for this field to take effect, scrolling must be enabled.

dropShadowOffset

Specifies an offset for the drop shadow. For example, if the point specified is (3,4), the drop shadow is offset 3 pixels to the right and 4 pixels down. In order for this field to take effect, drop shadowing must be enabled.

dropShadowTransparency

Specifies the intensity of the drop shadow as a value between 0 and 255. In order for this field to take effect, drop shadowing must be enabled.

Discussion

When the text export component exports a text sample, it uses the information in this structure to generate the appropriate text descriptors for the sample. Likewise, when the text import component imports a text sample, it sets the appropriate fields in this structure based on the sample's text descriptors.

See also TextExportGetDisplayData.

Declared In
QuickTimeComponents.h

TextExportComponent

Represents a type used by the Movie Components API.

typedef ComponentInstance TextExportComponent;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

TimeCodeDef

Contains timecode format information.

struct TimeCodeDef {
   long         flags;
   TimeScale    fTimeScale;
   TimeValue    frameDuration;
   UInt8        numFrames;
   UInt8        padding;
};
Fields
flags

Contains flags (see below) that provide timecode format information. See these constants:

  • tcDropFrame

  • tc24HourMax

  • tcNegTimesOK

  • tcCounter

fTimeScale

Contains the time scale for interpreting the frameDuration field. This field indicates the number of time units per second.

frameDuration

Specifies how long each frame lasts, in the units defined by the fTimeScale field.

numFrames

Indicates the number of frames stored per second. In the case of timecodes that are interpreted as counters, this field indicates the number of frames stored per timer "tick."

padding

Unused.

Declared In
QuickTimeComponents.h

TimeCodeDescriptionHandle

Represents a type used by the Movie Components API.

typedef TimeCodeDescriptionPtr * TimeCodeDescriptionHandle;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

TimeCodeDescriptionPtr

Represents a type used by the Movie Components API.

typedef TimeCodeDescription * TimeCodeDescriptionPtr;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

TimeCodeRecord

Interprets time information as both a time value (HH:MM:SS:FF) and a frame count.

union TimeCodeRecord {
   TimeCodeTime       t;
   TimeCodeCounter    c;
};
Fields
t

The timecode value interpreted as time in a TimeCodeTime structure.

c

The timecode value interpreted as a frame count in a TimeCodeCounter structure.

Discussion

When you use the timecode media handler to work with time values, the media handler uses TimeCodeRecord structures to store the time values. These structures allows you to interpret the time information as either a time value (HH:MM:SS:FF) or a counter value. Given a timecode definition, you can freely convert from frame numbers to time values and from time values to frame numbers. For a time value of 00:00:12:15 (HH:MM:SS:FF), you would obtain a frame number of 375 ( (12*30) +15).

See also TCFrameNumberToTimeCode, TCGetCurrentTimeCode, TCGetTimeCodeAtTime, TCTimeCodeToFrameNumber, and TCTimeCodeToString.

Declared In
QuickTimeComponents.h

TweenerComponent

Represents a type used by the Movie Components API.

typedef ComponentInstance TweenerComponent;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
QuickTimeComponents.h

TweenRecord

Passes information to your tween component's TweenDoTween method.

struct TweenRecord {
   long               version;
   QTAtomContainer    container;
   QTAtom             tweenAtom;
   QTAtom             dataAtom;
   Fixed              percent;
   TweenerDataUPP     dataProc;
   void *             private1;
   void *             private2;
};
Fields
version

The version number of this structure. This field is initialized to 0.

container

The atom container that contains the tween data.

tweenAtom

The atom for this tween entry's data in the container.

percent

The percentage by which to change the data.

dataProc

The procedure the tween component calls to send the tweened value to the receiving track.

private1

Reserved.

private2

Reserved.

Discussion

See also TweenerDataProc and TweenerDoTween.

Declared In
QuickTimeComponents.h

Constants

MIDIImportSetSettings Values

Constants passed to MIDIImportSetSettings.

enum {
   kMIDIImportSilenceBefore      = 1 << 0,
   kMIDIImportSilenceAfter       = 1 << 1,
   kMIDIImport20Playable         = 1 << 2,
   kMIDIImportWantLyrics         = 1 << 3
};
Declared In
QuickTimeComponents.h

TextExportSetSettings Values

Constants passed to TextExportSetSettings.

enum {
   kMovieExportTextOnly          = 0,
   kMovieExportAbsoluteTime      = 1,
   kMovieExportRelativeTime      = 2
};
Declared In
QuickTimeComponents.h

movieExportDuration

Constants grouped with movieExportDuration.

enum {
   movieExportUseConfiguredSettings = 'ucfg', /* pointer to Boolean*/
   movieExportWidth              = 'wdth', /* pointer to Fixed*/
   movieExportHeight             = 'hegt', /* pointer to Fixed*/
   movieExportDuration           = 'dura', /* pointer to TimeRecord*/
   movieExportVideoFilter        = 'iflt', /* pointer to QTAtomContainer*/
   movieExportTimeScale          = 'tmsc' /* pointer to TimeScale*/
};
Constants
movieExportWidth

A fixed integer that represents a video track's image width in pixels.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

movieExportHeight

A fixed integer that represents a video track's image height in pixels.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

movieExportDuration

The TimeRecord structure for the whole movie.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

movieExportVideoFilter

A pointer to a QTAtomContainer handle that references a video track's filter atom container.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

Declared In
QuickTimeComponents.h

MovieImportDataRef Values

Constants passed to MovieImportDataRef.

enum {
   movieImportCreateTrack        = 1,
   movieImportInParallel         = 2,
   movieImportMustUseTrack       = 4,
   movieImportWithIdle           = 16
};
enum {
   movieImportResultUsedMultipleTracks = 8,
   movieImportResultNeedIdles    = 32,
   movieImportResultComplete     = 64
};
Constants
movieImportResultNeedIdles

Undocumented

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

Declared In
QuickTimeComponents.h

Standard Compression Constants

Constants that represent constants for Standard Compression.

enum {
   /*
   * Indicates the client is ready to use the ICM compression session
   * API to perform compression operations. StdCompression disables
   * frame reordering and multi pass encoding if this flag is cleared.
   */
   scAllowEncodingWithCompressionSession = 1L << 8,
   /*
   * Indicates the client does not want the user to change the frame
   * reordering setting.
   */
   scDisableFrameReorderingItem  = 1L << 9,
   /*
   * Indicates the client does not want the user to change the multi
   * pass encoding setting
   */
   scDisableMultiPassEncodingItem = 1L << 10
};
enum {
   /*
   * Specifies if frame reordering can occur in encoding.
   */
   scVideoAllowFrameReorderingType = 'bfra', /* pointer to Boolean*/
   /*
   * The settings to control multi pass encoding.
   */
   scVideoMultiPassEncodingSettingsType = 'mpes' /* pointer to SCVideoMutiPassEncodingSettings struct*/
};
enum {
   scListEveryCodec              = 1L << 1,
   scAllowZeroFrameRate          = 1L << 2,
   scAllowZeroKeyFrameRate       = 1L << 3,
   scShowBestDepth               = 1L << 4,
   scUseMovableModal             = 1L << 5,
   scDisableFrameRateItem        = 1L << 6,
   scShowDataRateAsKilobits      = 1L << 7
};
enum {
   scOKItem                      = 1,
   scCancelItem                  = 2,
   scCustomItem                  = 3
};
enum {
   scPositionRect                = 2,
   scPositionDialog              = 3,
   scSetTestImagePictHandle      = 4,
   scSetTestImagePictFile        = 5,
   scSetTestImagePixMap          = 6,
   scGetBestDeviceRect           = 7,
   scRequestImageSettings        = 10,
   scCompressImage               = 11,
   scCompressPicture             = 12,
   scCompressPictureFile         = 13,
   scRequestSequenceSettings     = 14,
   scCompressSequenceBegin       = 15,
   scCompressSequenceFrame       = 16,
   scCompressSequenceEnd         = 17,
   scDefaultPictHandleSettings   = 18,
   scDefaultPictFileSettings     = 19,
   scDefaultPixMapSettings       = 20,
   scGetInfo                     = 21,
   scSetInfo                     = 22,
   scNewGWorld                   = 23
};
enum {
   scPreferCropping              = 1 << 0,
   scPreferScaling               = 1 << 1,
   scPreferScalingAndCropping    = scPreferScaling | scPreferCropping,
   scDontDetermineSettingsFromTestImage = 1 << 2
};
enum {
   scSpatialSettingsType         = 'sptl', /* pointer to SCSpatialSettings struct*/
   scTemporalSettingsType        = 'tprl', /* pointer to SCTemporalSettings struct*/
   scDataRateSettingsType        = 'drat', /* pointer to SCDataRateSettings struct*/
   scColorTableType              = 'clut', /* pointer to CTabHandle*/
   scProgressProcType            = 'prog', /* pointer to ProgressRecord struct*/
   scExtendedProcsType           = 'xprc', /* pointer to SCExtendedProcs struct*/
   scPreferenceFlagsType         = 'pref', /* pointer to long*/
   scSettingsStateType           = 'ssta', /* pointer to Handle*/
   scSequenceIDType              = 'sequ', /* pointer to ImageSequence*/
   scWindowPositionType          = 'wndw', /* pointer to Point*/
   scCodecFlagsType              = 'cflg', /* pointer to CodecFlags*/
   scCodecSettingsType           = 'cdec', /* pointer to Handle*/
   scForceKeyValueType           = 'ksim', /* pointer to long*/
   scCompressionListType         = 'ctyl', /* pointer to OSType Handle*/
   scCodecManufacturerType       = 'cmfr', /* pointer to OSType*/
   scAvailableCompressionListType = 'avai', /* pointer to OSType Handle*/
   scWindowOptionsType           = 'shee', /* pointer to SCWindowSettings struct*/
   scSoundVBRCompressionOK       = 'cvbr', /* pointer to Boolean*/
   scSoundSampleRateChangeOK     = 'rcok', /* pointer to Boolean*/
   scSoundCompressionType        = 'ssct', /* pointer to OSType*/
   scSoundSampleRateType         = 'ssrt', /* pointer to UnsignedFixed*/
   scSoundInputSampleRateType    = 'ssir', /* pointer to UnsignedFixed*/
   scSoundSampleSizeType         = 'ssss', /* pointer to short*/
   scSoundChannelCountType       = 'sscc' /* pointer to short*/
};
enum {
   scTestImageWidth              = 80,
   scTestImageHeight             = 80
};
enum {
   scUserCancelled               = 1
};
enum {
   scWindowRefKindCarbon         = 'carb' /* WindowRef*/
};
Constants
scVideoAllowFrameReorderingType

Pointer to Boolean.

Available in OS X v10.3 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scSpatialSettingsType

A video track's SCSpatialSettings structure.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scTemporalSettingsType

A video track's SCTemporalSettings structure.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scDataRateSettingsType

A video track's SCDataRateSettings structure.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scCodecSettingsType

Pointer to Handle.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scForceKeyValueType

Pointer to long.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scCodecManufacturerType

Pointer to OSType.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scAvailableCompressionListType

Pointer to OSType Handle.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scWindowOptionsType

Pointer to SCWindowSettings struct.

Available in OS X v10.3 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scSoundVBRCompressionOK

Pointer to Boolean.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scSoundSampleRateChangeOK

Pointer to Boolean.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scSoundCompressionType

A sound track's compression type constant; see Codec Identifiers.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scSoundSampleRateType

An UnsignedFixed value that represents a sound track's sampling rate.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scSoundInputSampleRateType

Pointer to UnsignedFixed.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scSoundSampleSizeType

A short integer that represents a sound track's sample size.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scSoundChannelCountType

A short integer that represents a sound track's channel count.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

Declared In
QuickTimeComponents.h

SCSetCompressFlags Values

Constants passed to SCSetCompressFlags.

enum {
   scCompressFlagIgnoreIdenticalFrames = 1
};
Declared In
QuickTimeComponents.h

SCParams Values

Constants passed to SCParams.

enum {
   scGetCompression              = 1,
   scShowMotionSettings          = 1L << 0,
   scSettingsChangedItem         = -1
};
Constants
scGetCompression

Undocumented

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

scShowMotionSettings

Undocumented

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

Declared In
QuickTimeComponents.h

TCSetTimeCodeFlags Values

Constants passed to TCSetTimeCodeFlags.

enum {
   tcdfShowTimeCode              = 1 << 0
};
Declared In
QuickTimeComponents.h

TimeCodeDef Values

Constants passed to TimeCodeDef.

enum {
   tcDropFrame                   = 1 << 0,
   tc24HourMax                   = 1 << 1,
   tcNegTimesOK                  = 1 << 2,
   tcCounter                     = 1 << 3
};
Constants
tcDropFrame

Indicates that the timecode drops frames occasionally to stay in synchronization. Some timecodes run at other than a whole number of frames per second. For example, NTSC video runs at 29.97 frames per second. In order to resynchronize between the timecode rate and a 30 frames-per-second playback rate, the timecode drops a frame at a predictable time (in much the same way that leap years keep the calendar synchronized).

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

tc24HourMax

Indicates that the timecode values return to 0 at 24 hours.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

tcNegTimesOK

Indicates that the timecode supports negative time values.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

Declared In
QuickTimeComponents.h