Source/QuartzUtils.h
author snej@snej.local
Tue Mar 10 22:36:23 2009 -0700 (2009-03-10)
changeset 27 b0affce7beb1
parent 10 6c78cc6bd7a6
permissions -rw-r--r--
Fixed some problems reported by the CLANG static analyzer.
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@11
    53
/** Is it possible to read a CGImage from this pasteboard? */
jens@11
    54
BOOL CanGetCGImageFromPasteboard( NSPasteboard *pb );
jens@0
    55
/** Loads image data from the pasteboard into a CGImage. */
jens@11
    56
CGImageRef GetCGImageFromPasteboard( NSPasteboard *pb, id<NSDraggingInfo>dragInfo );
jens@1
    57
#endif
jens@0
    58
jens@9
    59
CGImageRef CreateScaledImage( CGImageRef srcImage, CGFloat scale );
jens@9
    60
CGImageRef GetScaledImageNamed( NSString *imageName, CGFloat scale );
jens@9
    61
jens@0
    62
/** Creates a CGPattern from a CGImage. Caller must release it. */
jens@0
    63
CGPatternRef CreateImagePattern( CGImageRef image );
jens@0
    64
jens@0
    65
/** Creates a CGColor that draws the given CGImage as a pattern. Caller must release it. */
jens@0
    66
CGColorRef CreatePatternColor( CGImageRef image );
jens@0
    67
jens@0
    68
/** Returns the alpha value of a single pixel in a CGImage, scaled to a particular size. */
jens@0
    69
float GetPixelAlpha( CGImageRef image, CGSize imageSize, CGPoint pt );
jens@0
    70
jens@0
    71
/** Returns the center point of a CGRect. */
jens@0
    72
static inline CGPoint GetCGRectCenter( CGRect rect ) {
jens@0
    73
    return CGPointMake(CGRectGetMidX(rect),CGRectGetMidY(rect));
jens@1
    74
}
jens@1
    75
jens@1
    76
void AddRoundRect( CGContextRef ctx, CGRect rect, CGFloat radius );