Source/QuartzUtils.h
author Jens Alfke <jens@mooseyard.com>
Thu Jul 03 17:44:30 2008 -0700 (2008-07-03)
changeset 10 6c78cc6bd7a6
parent 9 a59acc683080
child 11 436cbdf56810
permissions -rw-r--r--
Lots of reworking. Completed support for game history, including Turn class. Changed Game API around quite a bit.
jens@0
     1
/*  This code is based on Apple's "GeekGameBoard" sample code, version 1.0.
jens@0
     2
    http://developer.apple.com/samplecode/GeekGameBoard/
jens@0
     3
    Copyright © 2007 Apple Inc. Copyright © 2008 Jens Alfke. All Rights Reserved.
jens@0
     4
jens@0
     5
    Redistribution and use in source and binary forms, with or without modification, are permitted
jens@0
     6
    provided that the following conditions are met:
jens@0
     7
jens@0
     8
    * Redistributions of source code must retain the above copyright notice, this list of conditions
jens@0
     9
      and the following disclaimer.
jens@0
    10
    * Redistributions in binary form must reproduce the above copyright notice, this list of
jens@0
    11
      conditions and the following disclaimer in the documentation and/or other materials provided
jens@0
    12
      with the distribution.
jens@0
    13
jens@0
    14
    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
jens@0
    15
    IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
jens@0
    16
    FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRI-
jens@0
    17
    BUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
jens@0
    18
    (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
jens@0
    19
    PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
jens@0
    20
    CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 
jens@0
    21
    THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
jens@0
    22
*/
jens@1
    23
#import "GGBLayer.h"
jens@0
    24
jens@0
    25
jens@0
    26
/** Constants for various commonly used colors. */
jens@0
    27
extern CGColorRef kBlackColor, kWhiteColor, 
jens@0
    28
                  kTranslucentGrayColor, kTranslucentLightGrayColor, 
jens@10
    29
                  kTranslucentWhiteColor, kAlmostInvisibleWhiteColor,
jens@0
    30
                  kHighlightColor;
jens@0
    31
jens@8
    32
#if TARGET_OS_IPHONE
jens@1
    33
// These don't exist on iPhone, so I implement them:
jens@1
    34
CGColorRef CreateGray(CGFloat gray, CGFloat alpha);
jens@1
    35
CGColorRef CreateRGB(CGFloat red, CGFloat green, CGFloat blue, CGFloat alpha);
jens@1
    36
#else
jens@1
    37
#define CreateGray  CGColorCreateGenericGray
jens@1
    38
#define CreateRGB   CGColorCreateGenericRGB
jens@1
    39
#endif
jens@1
    40
jens@0
    41
jens@0
    42
/** Loads an image or pattern file into a CGImage or CGPattern.
jens@0
    43
    If the name begins with "/", it's interpreted as an absolute filesystem path.
jens@0
    44
    Otherwise, it's the name of a resource that's looked up in the app bundle.
jens@0
    45
    The image must exist, or an assertion-failure exception will be raised!
jens@0
    46
    Loaded images/patterns are cached in memory, so subsequent calls with the same name
jens@0
    47
    are very fast.
jens@0
    48
    The caller must NOT release the result, since it's retained in the cache. */
jens@0
    49
CGImageRef GetCGImageNamed( NSString *name );
jens@0
    50
CGColorRef GetCGPatternNamed( NSString *name );
jens@0
    51
jens@8
    52
#if ! TARGET_OS_IPHONE
jens@0
    53
/** Loads image data from the pasteboard into a CGImage. */
jens@0
    54
CGImageRef GetCGImageFromPasteboard( NSPasteboard *pb );
jens@1
    55
#endif
jens@0
    56
jens@9
    57
CGImageRef CreateScaledImage( CGImageRef srcImage, CGFloat scale );
jens@9
    58
CGImageRef GetScaledImageNamed( NSString *imageName, CGFloat scale );
jens@9
    59
jens@0
    60
/** Creates a CGPattern from a CGImage. Caller must release it. */
jens@0
    61
CGPatternRef CreateImagePattern( CGImageRef image );
jens@0
    62
jens@0
    63
/** Creates a CGColor that draws the given CGImage as a pattern. Caller must release it. */
jens@0
    64
CGColorRef CreatePatternColor( CGImageRef image );
jens@0
    65
jens@0
    66
/** Returns the alpha value of a single pixel in a CGImage, scaled to a particular size. */
jens@0
    67
float GetPixelAlpha( CGImageRef image, CGSize imageSize, CGPoint pt );
jens@0
    68
jens@0
    69
/** Returns the center point of a CGRect. */
jens@0
    70
static inline CGPoint GetCGRectCenter( CGRect rect ) {
jens@0
    71
    return CGPointMake(CGRectGetMidX(rect),CGRectGetMidY(rect));
jens@1
    72
}
jens@1
    73
jens@1
    74
void AddRoundRect( CGContextRef ctx, CGRect rect, CGFloat radius );