### CocoaDVDPlayer ###

DESCRIPTION

===========

The CocoaDVDPlayer sample project demonstrates how to play DVD-Video media in a Cocoa application using DVD Playback Services, the API for the DVD Playback framework introduced in OS X v10.3. The project builds an application with a full set of controls and a resizable video window that maintains the correct aspect ratio. Other features include bookmarks, multiple viewing angles, and a playback timer. The project also shows how to register for and handle DVD events, and how to implement error-handling.

Features

Video window:

    • Resizable with real-time scaling

    • Small/Normal/Maximum sizes

    • Two aspect ratios, standard (4:3) and wide screen (16:9)

Control window:

    • Audio volume slider

    • Bookmarks

    • Elapsed or remaining playback time

    • Next Angle button (for titles with multiple viewing angles)

    • Open Media Folder menu item

    • Play/Pause/Stop/Eject buttons

    • Previous Scene and Next Scene buttons

    • Scan Forward and Scan Reverse (4x) buttons

    • Title and scene information

    • Go to Menu button

BUILDING THE APPLICATION

========================

If you want to use the Xcode project that comes with the sample, install Xcode 4.4 or later on a system running OS X v10.8 or later. 

USING THE APPLICATION

=====================

To run this version of CocoaDVDPlayer, you need a system with OS X v10.8 or later, an Apple-supplied DVD drive, and display hardware that supports DVD playback.

The DVDPlayback framework can only be used by a single client at a time. If CocoaDVDPlayer is already active and the user inserts a DVD, the user will be presented with an alert when the DVD Player application launches and finds that the framework is already in use. The best approach is to insert the DVD, quit DVD Player when it launches, and then run CocoaDVDPlayer.

There's another reason why this approach is best. If a DVD drive has never been used and you insert a DVD, the region code for the drive must be initialized. CocoaDVDPlayer does not know how to set region codes, but DVD Player does. DVD Player cannot set the drive region code, however, if the framework is already in use.

To use CocoaDVDPlayer, follow these steps:

1. Before launching CocoaDVDPlayer, Insert a DVD-Video disc in the DVD drive. Apple's DVD Player application automatically launches and opens the DVD. 

2. If prompted to do so, use DVD Player to set the drive region code.

3. Quit DVD Player.

4. Launch CocoaDVDPlayer. CocoaDVDPlayer writes status and error messages to the console as it runs.

5. Display the File menu and verify that media is open. The menu item should read "Close Media Folder". 

Now you're ready to play the DVD media on the disc.

Note that if you launch CocoaDVDPlayer using the Xcode debugger, the application terminates when it calls the DVDInitialize function to start a playback session. This is a security feature to protect the decryption code in the DVD Playback framework.

CHANGES FROM PREVIOUS VERSIONS

==============================

Version 1.0 - First release.

Version 1.1 - Updated for OS X 10.5. Switched from deprecated QuickDraw-based functions to Core Graphics-based functions.

Version 1.2 - Updated for OS X 10.7 and Xcode 4.3. Turned off debugging in scheme editor so app would run.

Version 1.3 - Updated for OS X 10.8 and Xcode 4.4. Switched from deprecated FSRef-based API to URL-based API. 

Copyright (C) 2009-2012 Apple Inc. All rights reserved.