jens@0: /*  This code is based on Apple's "GeekGameBoard" sample code, version 1.0.
jens@0:     http://developer.apple.com/samplecode/GeekGameBoard/
jens@0:     Copyright © 2007 Apple Inc. Copyright © 2008 Jens Alfke. All Rights Reserved.
jens@0: 
jens@0:     Redistribution and use in source and binary forms, with or without modification, are permitted
jens@0:     provided that the following conditions are met:
jens@0: 
jens@0:     * Redistributions of source code must retain the above copyright notice, this list of conditions
jens@0:       and the following disclaimer.
jens@0:     * Redistributions in binary form must reproduce the above copyright notice, this list of
jens@0:       conditions and the following disclaimer in the documentation and/or other materials provided
jens@0:       with the distribution.
jens@0: 
jens@0:     THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
jens@0:     IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
jens@0:     FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRI-
jens@0:     BUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
jens@0:     (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
jens@0:     PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
jens@0:     CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 
jens@0:     THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
jens@0: */
jens@1: #import "GGBLayer.h"
jens@0: 
jens@0: 
jens@0: /** Constants for various commonly used colors. */
jens@0: extern CGColorRef kBlackColor, kWhiteColor, 
jens@0:                   kTranslucentGrayColor, kTranslucentLightGrayColor, 
jens@10:                   kTranslucentWhiteColor, kAlmostInvisibleWhiteColor,
jens@0:                   kHighlightColor;
jens@0: 
jens@8: #if TARGET_OS_IPHONE
jens@1: // These don't exist on iPhone, so I implement them:
jens@1: CGColorRef CreateGray(CGFloat gray, CGFloat alpha);
jens@1: CGColorRef CreateRGB(CGFloat red, CGFloat green, CGFloat blue, CGFloat alpha);
jens@1: #else
jens@1: #define CreateGray  CGColorCreateGenericGray
jens@1: #define CreateRGB   CGColorCreateGenericRGB
jens@1: #endif
jens@1: 
jens@0: 
jens@0: /** Loads an image or pattern file into a CGImage or CGPattern.
jens@0:     If the name begins with "/", it's interpreted as an absolute filesystem path.
jens@0:     Otherwise, it's the name of a resource that's looked up in the app bundle.
jens@0:     The image must exist, or an assertion-failure exception will be raised!
jens@0:     Loaded images/patterns are cached in memory, so subsequent calls with the same name
jens@0:     are very fast.
jens@0:     The caller must NOT release the result, since it's retained in the cache. */
jens@0: CGImageRef GetCGImageNamed( NSString *name );
jens@0: CGColorRef GetCGPatternNamed( NSString *name );
jens@0: 
jens@8: #if ! TARGET_OS_IPHONE
jens@11: /** Is it possible to read a CGImage from this pasteboard? */
jens@11: BOOL CanGetCGImageFromPasteboard( NSPasteboard *pb );
jens@0: /** Loads image data from the pasteboard into a CGImage. */
jens@11: CGImageRef GetCGImageFromPasteboard( NSPasteboard *pb, id<NSDraggingInfo>dragInfo );
jens@1: #endif
jens@0: 
jens@9: CGImageRef CreateScaledImage( CGImageRef srcImage, CGFloat scale );
jens@9: CGImageRef GetScaledImageNamed( NSString *imageName, CGFloat scale );
jens@9: 
jens@0: /** Creates a CGPattern from a CGImage. Caller must release it. */
jens@0: CGPatternRef CreateImagePattern( CGImageRef image );
jens@0: 
jens@0: /** Creates a CGColor that draws the given CGImage as a pattern. Caller must release it. */
jens@0: CGColorRef CreatePatternColor( CGImageRef image );
jens@0: 
jens@0: /** Returns the alpha value of a single pixel in a CGImage, scaled to a particular size. */
jens@0: float GetPixelAlpha( CGImageRef image, CGSize imageSize, CGPoint pt );
jens@0: 
jens@0: /** Returns the center point of a CGRect. */
jens@0: static inline CGPoint GetCGRectCenter( CGRect rect ) {
jens@0:     return CGPointMake(CGRectGetMidX(rect),CGRectGetMidY(rect));
jens@1: }
jens@1: 
jens@1: void AddRoundRect( CGContextRef ctx, CGRect rect, CGFloat radius );