Source/QuartzUtils.h
author Jens Alfke <jens@mooseyard.com>
Mon Mar 10 17:32:04 2008 -0700 (2008-03-10)
changeset 2 7b0441db81e5
parent 0 e9f7ba4718e1
child 8 45c82a071aca
permissions -rw-r--r--
Oops, needed to fix an #include
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@0
    29
                  kAlmostInvisibleWhiteColor,
jens@0
    30
                  kHighlightColor;
jens@0
    31
jens@1
    32
#if TARGET_OS_ASPEN
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
/** Moves a layer from one superlayer to another, without changing its position onscreen. */
jens@0
    43
void ChangeSuperlayer( CALayer *layer, CALayer *newSuperlayer, int index );
jens@0
    44
jens@0
    45
/** Removes a layer from its superlayer without any fade-out animation. */
jens@0
    46
void RemoveImmediately( CALayer *layer );
jens@0
    47
jens@0
    48
jens@0
    49
/** Loads an image or pattern file into a CGImage or CGPattern.
jens@0
    50
    If the name begins with "/", it's interpreted as an absolute filesystem path.
jens@0
    51
    Otherwise, it's the name of a resource that's looked up in the app bundle.
jens@0
    52
    The image must exist, or an assertion-failure exception will be raised!
jens@0
    53
    Loaded images/patterns are cached in memory, so subsequent calls with the same name
jens@0
    54
    are very fast.
jens@0
    55
    The caller must NOT release the result, since it's retained in the cache. */
jens@0
    56
CGImageRef GetCGImageNamed( NSString *name );
jens@0
    57
CGColorRef GetCGPatternNamed( NSString *name );
jens@0
    58
jens@1
    59
#if ! TARGET_OS_ASPEN
jens@0
    60
/** Loads image data from the pasteboard into a CGImage. */
jens@0
    61
CGImageRef GetCGImageFromPasteboard( NSPasteboard *pb );
jens@1
    62
#endif
jens@0
    63
jens@0
    64
/** Creates a CGPattern from a CGImage. Caller must release it. */
jens@0
    65
CGPatternRef CreateImagePattern( CGImageRef image );
jens@0
    66
jens@0
    67
/** Creates a CGColor that draws the given CGImage as a pattern. Caller must release it. */
jens@0
    68
CGColorRef CreatePatternColor( CGImageRef image );
jens@0
    69
jens@0
    70
/** Returns the alpha value of a single pixel in a CGImage, scaled to a particular size. */
jens@0
    71
float GetPixelAlpha( CGImageRef image, CGSize imageSize, CGPoint pt );
jens@0
    72
jens@0
    73
/** Returns the center point of a CGRect. */
jens@0
    74
static inline CGPoint GetCGRectCenter( CGRect rect ) {
jens@0
    75
    return CGPointMake(CGRectGetMidX(rect),CGRectGetMidY(rect));
jens@1
    76
}
jens@1
    77
jens@1
    78
void AddRoundRect( CGContextRef ctx, CGRect rect, CGFloat radius );