Video Components Reference for QuickTime

Framework
Frameworks/QuickTime.framework
Declared in
MacTypes.h
QuickTimeComponents.h
Quickdraw.h

Overview

Video digitizer components convert video input into digitized color images that are compatible with the graphics system of a computer.

Functions by Task

Controlling Analog Video

Controlling Color

Controlling Compressed Source Devices

Controlling Digitization

Controlling the Video Output Display Mode

Controlling Video Output

Finding Components Associated With a Video Output

Getting Information About Video Digitizer Components

Registering the Name of Video Output Software

Saving and Restoring Component Configurations

Selecting an Input Source

Selectively Displaying Video

Setting Source Characteristics

Setting Video Destinations

Video Clipping

Video Digitizer Utilities

Supporting Functions

Functions

Callbacks

Data Types

DigitizerInfo

Contains information about the capabilities and current status of a video digitizer component.

struct DigitizerInfo {
   short       vdigType;
   long        inputCapabilityFlags;
   long        outputCapabilityFlags;
   long        inputCurrentFlags;
   long        outputCurrentFlags;
   short       slot;
   GDHandle    gdh;
   GDHandle    maskgdh;
   short       minDestHeight;
   short       minDestWidth;
   short       maxDestHeight;
   short       maxDestWidth;
   short       blendLevels;
   long        reserved;
};
Fields
vdigType

Constant (see below) that specifies the type of video digitizer component. See these constants:

  • vdTypeBasic

  • vdTypeAlpha

  • vdTypeMask

  • vdTypeKey

inputCapabilityFlags

Constant (see below) that specifies the capabilities of the video digitizer component with respect to the input video signal. See these constants:

  • digiInDoesNTSC

  • digiInDoesPAL

  • digiInDoesSECAM

  • digiInDoesGenLock

  • digiInDoesComposite

  • digiInDoesComponent

  • digiInVTR_Broadcast

  • digiInDoesColor

  • digiInDoesBW

outputCapabilityFlags

Constant (see below) that specifies the capabilities of the video digitizer component with respect to the output digitized video information. See these constants:

  • digiOutDoes1

  • digiOutDoes2

  • digiOutDoes4

  • digiOutDoes8

  • digiOutDoes16

  • digiOutDoes32

  • digiOutDoesDither

  • digiOutDoesStretch

  • digiOutDoesShrink

  • digiOutDoesMask

  • digiOutDoesDouble

  • digiOutDoesQuad

  • digiOutDoesQuarter

  • digiOutDoesSixteenth

  • digiOutDoesRotate

  • digiOutDoesHorizFlip

  • digiOutDoesVertFlip

  • digiOutDoesSkew

  • digiOutDoesBlend

  • digiOutDoesWarp

  • digiOutDoesHWPlayThru

  • digiOutDoesILUT

  • digiOutDoesKeyColor

  • digiOutDoesAsyncGrabs

  • digiOutDoesUnreadableScreenBits

  • digiOutDoesCompress

  • digiOutDoesCompressOnly

  • digiOutDoesPlayThruDuringCompress

inputCurrentFlags

Specifies the current status of the video digitizer with respect to the input video signal. Video digitizer components report their current input status by returning a flags field that contains 1 bit for each of the applicable inputCapabilityFlags constants (see below), plus additional inputCurrentFlags constants (see below) as appropriate. The digitizer component sets these flags to reflect its current status. When reporting input status, for example, a video digitizer component sets the digiInDoesGenLock flag to 1 whenever the digitizer component is deriving its time signal from the input video. When reporting its input capabilities, the digitizer component sets this flag to 1 to indicate that it can derive its timing from the input video. See these constants:

  • digiInSignalLock

outputCurrentFlags

Specifies the current status of the video digitizer with respect to the output video signal. Video digitizer components report their current output status by returning a flags field that contains 1 bit for each of the applicable outputCapabilityFlags constants (see below)

slot

Identifies the slot that contains the video digitizer interface card.

gdh

Contains a handle to the graphics device that defines the screen to which the digitized data is to be written. Set this field to NIL if your application is not constrained to a particular graphics device.

maskgdh

Contains a handle to the graphics device that contains the mask plane. This field is used only by digitizers that clip by means of mask planes.

minDestHeight

Indicates the smallest height value the digitizer component can accommodate in its destination.

minDestWidth

Indicates the smallest width value the digitizer component can accommodate in its destination.

maxDestHeight

Indicates the largest height value the digitizer component can accommodate in its destination.

maxDestWidth

Indicates the largest width value the digitizer component can accommodate in its destination.

blendLevels

Specifies the number of blend levels the video digitizer component supports.

reserved

Reserved. Set this field to 0.

Discussion

Your application can retrieve information about the capabilities and current status of a video digitizer component. You call VDGetDigitizerInfo to retrieve all this information from a video digitizer component. In response, the component formats a DigitizerInfo structure. The contents of this structure fully define the capabilities and current status of the video digitizer component.

See also VDGetDigitizerInfo.

Declared In
QuickTimeComponents.h

GrafPort

Defines a complete drawing environment for black-and-white graphics operations.

struct GrafPort {
   short         device;
   BitMap        portBits;
   Rect          portRect;
   RgnHandle     visRgn;
   RgnHandle     clipRgn;
   Pattern       bkPat;
   Pattern       fillPat;
   Point         pnLoc;
   Point         pnSize;
   short         pnMode;
   Pattern       pnPat;
   short         pnVis;
   short         txFont;
   StyleField    txFace;
   short         txMode;
   short         txSize;
   Fixed         spExtra;
   long          fgColor;
   long          bkColor;
   short         colrBit;
   short         patStretch;
   Handle        picSave;
   Handle        rgnSave;
   Handle        polySave;
   QDProcsPtr    grafProcs;
};
Fields
device

See CGrafPort.

portBits

See CGrafPort. In a GrafPort structure, this field contains a complete 14-byte BitMap structure. In a CGrafPort structure, this field is partly replaced by the 4-byte portPixMap field, which contains a handle to a PixMap structure. In what would be the rowBytes field of the BitMap structure, a CGrafPort structure has a 2-byte portVersion field in which the two high bits are always set to 1. QuickTime uses these bits to distinguish CGrafPort records from GrafPort records, in which the two high bits of the rowBytes field are always 0. Following the portBits field in the CGrafPort structure are the portVersion and grafVars fields. The grafVars field contains a handle to a GrafVars structure; this handle is not included in the GrafPort structure. For information about the GrafVars structure, see Inside Macintosh: Imaging With QuickDraw.

portRect

See CGrafPort.

visRgn

See CGrafPort.

clipRgn

See CGrafPort.

bkPat

In a GrafPort structure, the bkPat, pnPat, and fillPat fields hold 8-byte bit patterns. In a CGrafPort structure, these fields are partly replaced by three 4-byte handles to pixel patterns. The resulting 12 bytes of additional space in the CGrafPort structure are taken up by the rgbFgColor and rgbBkColor fields, which contain 6-byte RGBColor structures specifying the optimal foreground and background colors for the color graphics port. Note that the closest matching available colors, which QuickTime actually uses to render the foreground and background, are stored in the fgColor and bkColor fields of the CGrafPort structure.

fillPat

See the bkPat field (above).

pnLoc

See CGrafPort.

pnSize

See CGrafPort.

pnMode

See CGrafPort.

pnPat

See the bkPat field (above).

pnVis

See CGrafPort.

txFont

See CGrafPort.

txFace

The character style of the text, with values from the set defined by the Style type, which includes such styles as bold, italic, and shaded. You can apply stylistic variations either alone or in combination. This field is initially set to plain text.

txMode

See CGrafPort.

txSize

See CGrafPort.

spExtra

See CGrafPort.

fgColor

See CGrafPort.

bkColor

See CGrafPort.

colrBit

See CGrafPort.

patStretch

See CGrafPort.

picSave

See CGrafPort.

rgnSave

See CGrafPort.

polySave

See CGrafPort.

grafProcs

See CGrafPort. In a GrafPort structure, you can supply this field with a pointer to a QDProcs structure; in a CGrafPort structure, you provide this field with a pointer to a CQDProcs structure.

Discussion

See CGrafPort.

Version Notes

The GrafPort structure has been largely superseded by the CGrafPort structure, which defines a full color environment. The two structures are the same size; QuickTime distinguishes between them by examining the portBits field.

Declared In
QuickTimeComponents.h

GrafPtr

Represents a type used by the Video Components API.

typedef GrafPort * GrafPtr;
Availability
  • Available in OS X v10.0 and later.
Declared In
Quickdraw.h

QTVideoOutputComponent

Represents a type used by the Video Components API.

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

RectPtr

Represents a type used by the Video Components API.

typedef Rect * RectPtr;
Availability
  • Available in OS X v10.0 and later.
Declared In
MacTypes.h

VDCompressionListHandle

Represents a type used by the Video Components API.

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

VDCompressionListPtr

Represents a type used by the Video Components API.

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

VDGammaRecord

Holds a gamma table.

struct VDGammaRecord {
   Ptr    csGTable;
};
Fields
csGTable

A pointer to a gamma table.

Declared In
QuickTimeComponents.h

VDGamRecPtr

Represents a type used by the Video Components API.

typedef VDGammaRecord * VDGamRecPtr;
Availability
  • Available in OS X v10.0 and later.
Declared In
Quickdraw.h

VdigBufferRecListHandle

Represents a type used by the Video Components API.

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

VdigBufferRecListPtr

Represents a type used by the Video Components API.

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

VideoDigitizerComponent

Represents a type used by the Video Components API.

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

VideoDigitizerError

Represents a type used by the Video Components API.

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

Constants

compositeIn

Constants grouped with compositeIn.

enum {
   compositeIn                   = 0,    /* input is composite format */
   sVideoIn                      = 1,    /* input is sVideo format */
   rgbComponentIn                = 2,    /* input is rgb component format */
   rgbComponentSyncIn            = 3,    /* input is rgb component format (sync on green?)*/
   yuvComponentIn                = 4,    /* input is yuv component format */
   yuvComponentSyncIn            = 5,    /* input is yuv component format (sync on green?) */
   tvTunerIn                     = 6,
   sdiIn                         = 7
};
Declared In
QuickTimeComponents.h

Video Digitizer Capabilities

Flags that indicate the input and output capabilities of a video digitizer.

enum {
   digiInDoesNTSC                = 1L << 0, /* digitizer supports NTSC input format */
   digiInDoesPAL                 = 1L << 1, /* digitizer supports PAL input format */
   digiInDoesSECAM               = 1L << 2, /* digitizer supports SECAM input format */
   digiInDoesGenLock             = 1L << 7, /* digitizer does genlock */
   digiInDoesComposite           = 1L << 8, /* digitizer supports composite input type */
   digiInDoesSVideo              = 1L << 9, /* digitizer supports S-Video input type */
   digiInDoesComponent           = 1L << 10, /* digitizer supports component = rgb,
   input type */
   digiInVTR_Broadcast           = 1L << 11, /* digitizer can differentiate between the two */
   digiInDoesColor               = 1L << 12, /* digitizer supports color */
   digiInDoesBW                  = 1L << 13, /* digitizer supports black & white */
   /* Digitizer Input Current Flags = these are valid only during active operating conditions,
   */
   digiInSignalLock              = 1L << 31 /* digitizer detects input signal is locked,
   this bit = horiz lock || vertical lock */
};
enum {
   digiOutDoes1                  = 1L << 0, /* digitizer supports 1 bit pixels */
   digiOutDoes2                  = 1L << 1, /* digitizer supports 2 bit pixels */
   digiOutDoes4                  = 1L << 2, /* digitizer supports 4 bit pixels */
   digiOutDoes8                  = 1L << 3, /* digitizer supports 8 bit pixels */
   digiOutDoes16                 = 1L << 4, /* digitizer supports 16 bit pixels */
   digiOutDoes32                 = 1L << 5, /* digitizer supports 32 bit pixels */
   digiOutDoesDither             = 1L << 6, /* digitizer dithers in indexed modes */
   digiOutDoesStretch            = 1L << 7, /* digitizer can arbitrarily stretch */
   digiOutDoesShrink             = 1L << 8, /* digitizer can arbitrarily shrink */
   digiOutDoesMask               = 1L << 9, /* digitizer can mask to clipping regions */
   digiOutDoesDouble             = 1L << 11, /* digitizer can stretch to exactly double size */
   digiOutDoesQuad               = 1L << 12, /* digitizer can stretch exactly quadruple size */
   digiOutDoesQuarter            = 1L << 13, /* digitizer can shrink to exactly quarter size */
   digiOutDoesSixteenth          = 1L << 14, /* digitizer can shrink to exactly sixteenth size */
   digiOutDoesRotate             = 1L << 15, /* digitizer supports rotate transformations */
   digiOutDoesHorizFlip          = 1L << 16, /* digitizer supports horizontal flips Sx < 0 */
   digiOutDoesVertFlip           = 1L << 17, /* digitizer supports vertical flips Sy < 0 */
   digiOutDoesSkew               = 1L << 18, /* digitizer supports skew = shear,
twist,
   */
   digiOutDoesBlend              = 1L << 19,
   digiOutDoesWarp               = 1L << 20,
   digiOutDoesHW_DMA             = 1L << 21, /* digitizer not constrained to local device */
   digiOutDoesHWPlayThru         = 1L << 22, /* digitizer doesn't need time to play thru */
   digiOutDoesILUT               = 1L << 23, /* digitizer does inverse LUT for index modes */
   digiOutDoesKeyColor           = 1L << 24, /* digitizer does key color functions too */
   digiOutDoesAsyncGrabs         = 1L << 25, /* digitizer supports async grabs */
   digiOutDoesUnreadableScreenBits = 1L << 26, /* playthru doesn't generate readable bits on screen*/
   digiOutDoesCompress           = 1L << 27, /* supports alternate output data types */
   digiOutDoesCompressOnly       = 1L << 28, /* can't provide raw frames anywhere */
   digiOutDoesPlayThruDuringCompress = 1L << 29, /* digi can do playthru while providing compressed data */
   digiOutDoesCompressPartiallyVisible = 1L << 30, /* digi doesn't need all bits visible on screen to do hardware compress */
   digiOutDoesNotNeedCopyOfCompressData = 1L << 31 /* digi doesn't need any bufferization when providing compressed data */
};
Constants
digiInDoesNTSC

The video digitizer supports National Television System Committee (NTSC) format input video signals. This flag is set to 1 if the digitizer component supports NTSC video.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiInDoesPAL

The video digitizer component supports Phase Alternation Line (PAL) format input video signals. This flag is set to 1 if the digitizer component supports PAL video.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiInDoesSECAM

The video digitizer component supports Systeme Electronique Couleur avec Memoire (SECAM) format input video signals. This flag is set to 1 if the digitizer component supports SECAM video.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiInDoesGenLock

The video digitizer component supports genlock; that is, the digitizer can derive its timing from an external time base. This flag is set to 1 if the digitizer component supports genlock.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiInDoesComposite

The video digitizer component supports composite input video. This flag is set to 1 if the digitizer component supports composite input.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiInDoesComponent

The video digitizer component supports RGB input video. This flag is set to 1 if the digitizer component supports RGB input.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiInVTR_Broadcast

The video digitizer component can distinguish between an input signal that emanates from a videotape player and a broadcast signal. This flag is set to 1 if the digitizer component can differentiate between the two different signal types.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiInDoesColor

The video digitizer component supports color input. This flag is set to 1 if the digitizer component can accept color input.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiInDoesBW

The video digitizer component supports grayscale input. This flag is set to 1 if the digitizer component can accept grayscale input.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiInSignalLock

The video digitizer component is locked onto the input signal. If this flag is set to 1, the digitizer component detects either vertical or horizontal signal lock.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoes1

The video digitizer component can work with pixel maps that contain 1-bit pixels. If this flag is set to 1, then the digitizer component can write images that contain 1-bit pixels. If this flag is set to 0, then the digitizer component cannot handle such images.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoes2

The video digitizer component can work with pixel maps that contain 2-bit pixels. If this flag is set to 1, then the digitizer component can write images that contain 2-bit pixels. If this flag is set to 0, then the digitizer component cannot handle such images.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoes4

The video digitizer component can work with pixel maps that contain 4-bit pixels. If this flag is set to 1, then the digitizer component can write images that contain 4-bit pixels. If this flag is set to 0, then the digitizer component cannot handle such images.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoes8

The video digitizer component can work with pixel maps that contain 8-bit pixels. If this flag is set to 1, then the digitizer component can write images that contain 8-bit pixels. If this flag is set to 0, then the digitizer component cannot handle such images.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoes16

The video digitizer component can work with pixel maps that contain 16-bit pixels. If this flag is set to 1, then the digitizer component can write images that contain 16-bit pixels. If this flag is set to 0, then the digitizer component cannot handle such images.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoes32

The video digitizer component can work with pixel maps that contain 32-bit pixels. If this flag is set to 1, then the digitizer component can write images that contain 32-bit pixels. If this flag is set to 0, then the digitizer component cannot handle such images.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesDither

The video digitizer component supports dithering. If this flag is set to 1, the component supports dithering of colors. If this flag is set to 0, the digitizer component does not support dithering.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesStretch

The video digitizer component can stretch images to arbitrary sizes. If this flag is set to 1, the digitizer component can stretch images. If this flag is set to 0, the digitizer component does not support stretching.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesShrink

The video digitizer component can shrink images to arbitrary sizes. If this flag is set to 1, the digitizer component can shrink images. If this flag is set to 0, the digitizer component does not support shrinking.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesMask

The video digitizer component can handle clipping regions. If this flag is set to 1, the digitizer component can mask to an arbitrary clipping region. If this flag is set to 0, the digitizer component does not support clipping regions.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesDouble

The video digitizer component supports stretching to quadruple size when displaying the output video. The parameters for the stretch operation are specified in the matrix structure for the request; the component modifies the scaling attributes of the matrix (see the chapter "Movie Toolbox" in Inside Macintosh: QuickTime for information about transformation matrices). If this flag is set to 1, the digitizer component can stretch an image to exactly four times its original size, up to the maximum size specified by the maxDestHeight and maxDestWidth fields in the digitizer information structure. If this flag is set to 0, the digitizer component does not support stretching to quadruple size.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesQuad

The video digitizer component supports stretching an image to 16 times its original size when displaying the output video. The parameters for the stretch operation are specified in the matrix structure for the request; the component modifies the scaling attributes of the matrix (see the chapter "Movie Toolbox" in Inside Macintosh: QuickTime for information about transformation matrices). If this flag is set to 1, the digitizer component can stretch an image to exactly 16 times its original size, up to the maximum size specified by the maxDestHeight and maxDestWidth fields in the digitizer information structure. If this flag is set to 0, the digitizer component does not support this capability.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesQuarter

The video digitizer component can shrink an image to one-quarter of its original size when displaying the output video. The parameters for the shrink operation are specified in the matrix structure for the request; the component modifies the scaling attributes of the matrix (see the chapter "Movie Toolbox" in Inside Macintosh: QuickTime for information about transformation matrices). If this flag is set to 1, the digitizer component can shrink an image to exactly one-quarter of its original size, down to the minimum size specified by the minDestHeight and minDestWidth fields in the digitizer information structure. If this flag is set to 0, the digitizer component does not support this capability.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesSixteenth

The video digitizer component can shrink an image to 1/16 of its original size when displaying the output video. The parameters for the shrink operation are specified in the matrix structure for the request; the digitizer component modifies the scaling attributes of the matrix (see the chapter "Movie Toolbox" in Inside Macintosh: QuickTime for information about transformation matrices). If this flag is set to 1, the digitizer component can shrink an image to exactly 1/16 of its original size, down to the minimum size specified by the minDestHeight and minDestWidth fields in the digitizer information structure. If this flag is set to 0, the digitizer component does not support this capability.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesRotate

The video digitizer component can rotate an image when displaying the output video. The parameters for the rotation are specified in the matrix structure for an operation. If this flag is set to 1, the digitizer component can rotate the image. If this flag is set to 0, the digitizer component cannot rotate the resulting image.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesHorizFlip

The video digitizer component can flip an image horizontally when displaying the output video. The parameters for the horizontal flip are specified in the matrix structure for an operation. If this flag is set to 1, the digitizer component can flip the image. If this flag is set to 0, the digitizer component cannot flip the resulting image.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesVertFlip

The video digitizer component can flip an image vertically when displaying the output video. The parameters for the vertical flip are specified in the matrix structure for an operation. If this flag is set to 1, the digitizer component can flip the image. If this flag is set to 0, the digitizer component cannot flip the resulting image.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesSkew

The video digitizer component can skew an image when displaying the output video. Skewing an image distorts it linearly along only a single axis; for example, drawing a rectangular image into a parallelogram-shaped region. The parameters for the skew operation are specified in the matrix structure for the request. If this flag is set to 1, the digitizer component can skew an image. If this flag is set to 0, the digitizer component does not support this capability.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesBlend

The video digitizer component can blend the resulting image with a matte when displaying the output video. The matte is provided by the application by defining either an alpha channel or a mask plane. If this flag is set to 1, the digitizer component can blend. If this flag is set to 0, the digitizer component does not support this capability.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesWarp

The video digitizer component can warp an image when displaying the output video. Warping an image distorts it along one or more axes, perhaps nonlinearly, in effect "bending" the result region. The parameters for the warp operation are specified in the matrix structure for the request. If this flag is set to 1, the digitizer component can warp an image. If this flag is set to 0, the digitizer component does not support this capability.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesHWPlayThru

The video digitizer component does not need idle time in order to display its video. If this flag is set to 1, your application does not need to grant processor time to the digitizer component at normal display speeds.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesILUT

The video digitizer component supports inverse lookup tables for indexed color modes. If this flag is set to 1, the digitizer component uses inverse lookup tables when appropriate.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesKeyColor

The video digitizer component supports clipping by means of key colors. If this flag is set to 1, the digitizer component can clip to a region defined by a key color.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesAsyncGrabs

The video digitizer component can operate asynchronously. If this flag is set to 1, your application can use the VDSetupBuffers and VDGrabOneFrameAsync functions (described on page 0-669 and page 0-671, respectively).

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesUnreadableScreenBits

The video digitizer may place pixels on the screen that cannot be used when compressing images.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesCompress

The video digitizer component supports compressed source devices. These devices provide compressed data directly, without having to use the Image Compression Manager. See "Controlling Compressed Source Devices" beginning on page 0-657 for more information about the functions that applications can use to work with compressed source devices.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesCompressOnly

The video digitizer component only provides compressed image data; the component cannot provide displayable data. This flag only applies to digitizers that support compressed source devices.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

digiOutDoesPlayThruDuringCompress

The video digitizer component can draw images on the screen at the same time that it is delivering compressed image data. This flag only applies to digitizers that support compressed source devices.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

Declared In
QuickTimeComponents.h

currentIn

Constants grouped with currentIn.

enum {
   ntscIn                        = 0,    /* current input format */
   currentIn                     = 0,    /* ntsc input format */
   palIn                         = 1,    /* pal input format */
   secamIn                       = 2,    /* secam input format */
   ntscReallyIn                  = 3     /* ntsc input format */
};
Declared In
QuickTimeComponents.h

VDGetDeviceNameAndFlags Values

Constants passed to VDGetDeviceNameAndFlags.

enum {
   vdDeviceFlagShowInputsAsDevices = (1 << 0), /* Tell the Panel to promote Inputs to Devices*/
   vdDeviceFlagHideDevice        = (1 << 1) /* Omit this Device entirely from the list*/
};
Declared In
QuickTimeComponents.h

vdFlagCaptureAlwaysUseTimeBase

Constants grouped with vdFlagCaptureAlwaysUseTimeBase.

enum {
   vdFlagCaptureStarting         = (1 << 0), /* Capture is about to start; allocate bandwidth */
   vdFlagCaptureStopping         = (1 << 1), /* Capture is about to stop; stop queuing frames*/
   vdFlagCaptureIsForPreview     = (1 << 2), /* Capture is just to screen for preview purposes*/
   vdFlagCaptureIsForRecord      = (1 << 3), /* Capture is going to be recorded*/
   vdFlagCaptureLowLatency       = (1 << 4), /* Fresh frames are more important than delivering every frame - don't queue too much*/
   vdFlagCaptureAlwaysUseTimeBase = (1 << 5), /* Use the timebase for every frame; don't worry about making durations uniform*/
   vdFlagCaptureSetSettingsBegin = (1 << 6), /* A series of calls are about to be made to restore settings.*/
   vdFlagCaptureSetSettingsEnd   = (1 << 7) /* Finished restoring settings; any set calls after this are from the app or UI*/
};
Declared In
QuickTimeComponents.h

VDSetPlayThruOnOff Values

Constants passed to VDSetPlayThruOnOff.

enum {
   vdPlayThruOff                 = 0,
   vdPlayThruOn                  = 1
};
Declared In
QuickTimeComponents.h

VdigType Values

Constants passed to VdigType.

enum {
   vdTypeBasic                   = 0,    /* basic,
   no clipping */
   vdTypeAlpha                   = 1,    /* supports clipping with alpha channel */
   vdTypeMask                    = 2,    /* supports clipping with mask plane */
   vdTypeKey                     = 3     /* supports clipping with key color(s) */
};
Constants
vdTypeBasic

Basic video digitizer; does not support any clipping.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

vdTypeAlpha

Supports clipping by means of an alpha channel.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

vdTypeMask

Supports clipping by means of a mask plane.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in QuickTimeComponents.h.

Declared In
QuickTimeComponents.h

VDSetFieldPreference Values

Constants passed to VDSetFieldPreference.

enum {
   vdUseAnyField                 = 0,    /* Digitizers choice on field use */
   vdUseOddField                 = 1,    /* Use odd field for half size vert and smaller */
   vdUseEvenField                = 2     /* Use even field for half size vert and smaller */
};
Declared In
QuickTimeComponents.h