ReadMe.txt

TrackBall
=========
 
DESCRIPTION:
 
"TrackBall" is a Cocoa sample application that demonstrates how to create your own custom Cocoa control.
This is structured as a demo for use in the session "Building a Custom Control for your Cocoa Applicaton (125)" for WWDC 2007.
 
It is designed to show you what you need to do to develop a fully featured Cocoa control based on the NSControl class.
It involves implementing behaviors such as drawing, mouse and scroll wheel tracking, text editing, as well as accessibility.
 
Listed below is a portion of the class methods TrackBall overrides to achieve its custom behavior:
 
To construct the proper cell for NSControl:
+ (Class)cellClass;
 
To control how key strokes are managed.  This allows for arrow keys for rotation. If the option key is depressed, we rotate about the Z axis.
Tab changes the focused portion. and enter/return begin editing a text field:
- (void)keyDown:(NSEvent*)event;
 
To determine whether we support click-through:
- (BOOL)acceptsFirstMouse:(NSEvent*)event;
 
To prevent the trackBallView, or any of the subviews from gaining focus:
- (NSView *)nextKeyView;
 
To support animating of the three coordinates:
+ (id)defaultAnimationForKey:(NSString*)key;
 
To support a custom appearance:
- (void)drawRect:(NSRect)rect;
 
To support mouse and scroll wheel behaviors:
- (void)scrollWheel:(NSEvent*)event;
- (void)mouseDragged:(NSEvent*)event;
- (void)mouseDown:(NSEvent*)event;
 
To support text editing via NSTextDelegate:
- (void)textDidEndEditing:(NSNotification*)notification;
- (BOOL)textShouldEndEditing:(NSText*)textObject;
 
To control the NSCell's appearance:
- (void)setBackgroundStyle:(NSBackgroundStyle)backgroundStyle;
 
USING THE SAMPLE:
 
Simply build and run the sample using Xcode.  Use the track ball control to move around the panoramic image.
To view external panoramic images, use the Image -> Open menu item and choose external spherical panoramic images.
 
 
=======================================================================================================
BUILD REQUIREMENTS
 
Xcode 3.2, Mac OS X 10.6 or later
 
=======================================================================================================
RUNTIME REQUIREMENTS
 
Mac OS X 10.6 Snow Leopard or later
 
 
=======================================================================================================
CHANGES FROM PREVIOUS VERSIONS
 
Version 1.1
- Project update for Xcode 4.
- Application quits when the window is closed.
- Updated code related to validating cell input.
- Updated code for opening files.
Version 1.0
- First release.
 
 
=======================================================================================================
Copyright (C) 2011 Apple Inc. All rights reserved.