Contents

Introduction to Core Video Programming Guide

Describes Core Video concepts and how to obtain and manipulate video frames using the Core Video API.

What Is Core Video?

Core Video is a new pipeline model for digital video in OS X. Partitioning the processing into discrete steps makes it simpler for developers to access and manipulate individual frames without having to worry about translating between data types (QuickTime, OpenGL, and so on) or display synchronization issues.

Core Video is comparable to the Core Image and Core Audio technologies.

Core Video is available in:

OS X v10.4 and later

OS X v10.3 when QuickTime 7.0 or later is installed

For best results, you should use Core Video functionality only on computers that support hardware graphics acceleration (that is, Quartz Extreme).

Who Should Read This Document?

The audience for this document is any Carbon or Cocoa developer who wants a greater degree of control in manipulating video images. Developers should be familiar with digital video and OpenGL as well as multithreaded programming.

Core Video is necessary only if you want to manipulate individual video frames. For example, the following types of video processing would require Core Video:

Color correction or other filtering, such as provided by Core Image filters

Physical transforms of the video images (such as warping, or mapping onto a surface)

Adding video to an OpenGL scene

Adding additional information to frames, such as a visible timecode

Compositing multiple video streams

If you don’t need this level of sophistication (for example, if you only want to display video in your applications), you should use the simplified movie players such as HIMovieView (in Carbon) or QTKit (in Cocoa) to display video. You can also apply effects to video using Quartz Composer.

Organization of This Document

This document is organized into the following chapters:

Core Video Concepts describes the Core Video pipeline model and explains the key concepts necessary to use the Core Video API.

Core Video Tasks shows how to use Core Video to obtain and manipulate individual video frames.

See Also

Apple offers the following additional resources in the ADC Reference library that complement the Core Video Programming Guide :

OpenGL Programming Guide for Mac provides information on GL textures and CGL graphics contexts.

Core Image Programming Guide contains information about how to create Core Image filters, which you can apply to video frames.

In addition, the OpenGL website ( http://www.opengl.org ) is the primary source for information about the OpenGL API.

Next

Copyright © 2004, 2007 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2007-04-03