/* |
File: ImageBrowserCell.m |
Abstract: |
Abstract: IKImageBrowserView is a view that can display and browse a |
large amount of images and movies. This sample code demonstrates |
how to use the view in a Cocoa Application. |
|
Version: 1.1 |
|
Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple |
Inc. ("Apple") in consideration of your agreement to the following |
terms, and your use, installation, modification or redistribution of |
this Apple software constitutes acceptance of these terms. If you do |
not agree with these terms, please do not use, install, modify or |
redistribute this Apple software. |
|
In consideration of your agreement to abide by the following terms, and |
subject to these terms, Apple grants you a personal, non-exclusive |
license, under Apple's copyrights in this original Apple software (the |
"Apple Software"), to use, reproduce, modify and redistribute the Apple |
Software, with or without modifications, in source and/or binary forms; |
provided that if you redistribute the Apple Software in its entirety and |
without modifications, you must retain this notice and the following |
text and disclaimers in all such redistributions of the Apple Software. |
Neither the name, trademarks, service marks or logos of Apple Inc. may |
be used to endorse or promote products derived from the Apple Software |
without specific prior written permission from Apple. Except as |
expressly stated in this notice, no other rights or licenses, express or |
implied, are granted by Apple herein, including but not limited to any |
patent rights that may be infringed by your derivative works or by other |
works in which the Apple Software may be incorporated. |
|
The Apple Software is provided by Apple on an "AS IS" basis. APPLE |
MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION |
THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS |
FOR A PARTICULAR PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND |
OPERATION ALONE OR IN COMBINATION WITH YOUR PRODUCTS. |
|
IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL |
OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, |
MODIFICATION AND/OR DISTRIBUTION OF THE APPLE SOFTWARE, HOWEVER CAUSED |
AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE), |
STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN ADVISED OF THE |
POSSIBILITY OF SUCH DAMAGE. |
|
Copyright (C) 2013 Apple Inc. All Rights Reserved. |
|
*/ |
|
#import "ImageBrowserCell.h" |
|
//--------------------------------------------------------------------------------- |
// setBundleImageOnLayer |
// |
// utilty function that creates, and sets the image (from the bundle) on the layer |
//--------------------------------------------------------------------------------- |
static void setBundleImageOnLayer(CALayer *layer, CFStringRef imageName) |
{ |
CGImageRef image = NULL; |
NSString *path = [[NSBundle mainBundle] pathForResource:[(NSString *)imageName stringByDeletingPathExtension] ofType:[(NSString *)imageName pathExtension]]; |
if (!path) { |
return; |
} |
|
CGImageSourceRef imageSource = CGImageSourceCreateWithURL((CFURLRef)[NSURL fileURLWithPath:path], NULL); |
if (!imageSource) { |
return; |
} |
|
image = CGImageSourceCreateImageAtIndex(imageSource, 0, NULL); |
if (!image) { |
CFRelease(imageSource); |
return; |
} |
|
[layer setContents:(id)image]; |
|
CFRelease(imageSource); |
CFRelease(image); |
} |
|
|
@implementation ImageBrowserCell |
|
//--------------------------------------------------------------------------------- |
// layerForType: |
// |
// provides the layers for the given types |
//--------------------------------------------------------------------------------- |
- (CALayer *) layerForType:(NSString*) type |
{ |
CGColorRef color; |
|
//retrieve some usefull rects |
NSRect frame = [self frame]; |
NSRect imageFrame = [self imageFrame]; |
NSRect relativeImageFrame = NSMakeRect(imageFrame.origin.x - frame.origin.x, imageFrame.origin.y - frame.origin.y, imageFrame.size.width, imageFrame.size.height); |
|
/* place holder layer */ |
if(type == IKImageBrowserCellPlaceHolderLayer){ |
//create a place holder layer |
CALayer *layer = [CALayer layer]; |
layer.frame = CGRectMake(0, 0, frame.size.width, frame.size.height); |
|
CALayer *placeHolderLayer = [CALayer layer]; |
placeHolderLayer.frame = *(CGRect*) &relativeImageFrame; |
|
float fillComponents[4] = {1.0, 1.0, 1.0, 0.3}; |
float strokeComponents[4] = {1.0, 1.0, 1.0, 0.9}; |
CGColorSpaceRef colorSpace = CGColorSpaceCreateDeviceRGB(); |
|
//set a background color |
color = CGColorCreate(colorSpace, fillComponents); |
[placeHolderLayer setBackgroundColor:color]; |
CFRelease(color); |
|
//set a stroke color |
color = CGColorCreate(colorSpace, strokeComponents); |
[placeHolderLayer setBorderColor:color]; |
CFRelease(color); |
|
[placeHolderLayer setBorderWidth:2.0]; |
[placeHolderLayer setCornerRadius:10]; |
CFRelease(colorSpace); |
|
[layer addSublayer:placeHolderLayer]; |
|
return layer; |
} |
|
/* foreground layer */ |
if(type == IKImageBrowserCellForegroundLayer){ |
//no foreground layer on place holders |
if([self cellState] != IKImageStateReady) |
return nil; |
|
//create a foreground layer that will contain several childs layer |
CALayer *layer = [CALayer layer]; |
layer.frame = CGRectMake(0, 0, frame.size.width, frame.size.height); |
|
NSRect imageContainerFrame = [self imageContainerFrame]; |
NSRect relativeImageContainerFrame = NSMakeRect(imageContainerFrame.origin.x - frame.origin.x, imageContainerFrame.origin.y - frame.origin.y, imageContainerFrame.size.width, imageContainerFrame.size.height); |
|
//add a glossy overlay |
CALayer *glossyLayer = [CALayer layer]; |
glossyLayer.frame = *(CGRect*) &relativeImageContainerFrame; |
setBundleImageOnLayer(glossyLayer, CFSTR("glossy.png")); |
[layer addSublayer:glossyLayer]; |
|
//add a pin icon |
CALayer *pinLayer = [CALayer layer]; |
setBundleImageOnLayer(pinLayer, CFSTR("pin.tiff")); |
pinLayer.frame = CGRectMake((frame.size.width/2)-5, frame.size.height - 17, 24, 30); |
[layer addSublayer:pinLayer]; |
|
return layer; |
} |
|
/* selection layer */ |
if(type == IKImageBrowserCellSelectionLayer){ |
|
//create a selection layer |
CALayer *selectionLayer = [CALayer layer]; |
selectionLayer.frame = CGRectMake(0, 0, frame.size.width, frame.size.height); |
|
float fillComponents[4] = {1.0, 0, 0.5, 0.3}; |
float strokeComponents[4] = {1.0, 0.0, 0.5, 1.0}; |
|
//set a background color |
CGColorSpaceRef colorSpace = CGColorSpaceCreateDeviceRGB(); |
color = CGColorCreate(colorSpace, fillComponents); |
[selectionLayer setBackgroundColor:color]; |
CFRelease(color); |
|
//set a border color |
color = CGColorCreate(colorSpace, strokeComponents); |
CFRelease(colorSpace); |
[selectionLayer setBorderColor:color]; |
CFRelease(color); |
|
[selectionLayer setBorderWidth:2.0]; |
[selectionLayer setCornerRadius:5]; |
|
return selectionLayer; |
} |
|
/* background layer */ |
if(type == IKImageBrowserCellBackgroundLayer){ |
//no background layer on place holders |
if([self cellState] != IKImageStateReady) |
return nil; |
|
CALayer *layer = [CALayer layer]; |
layer.frame = CGRectMake(0, 0, frame.size.width, frame.size.height); |
|
NSRect backgroundRect = NSMakeRect(0, 0, frame.size.width, frame.size.height); |
|
CALayer *photoBackgroundLayer = [CALayer layer]; |
photoBackgroundLayer.frame = *(CGRect*) &backgroundRect; |
|
float fillComponents[4] = {0.95, 0.95, 0.95, 1.0}; |
float strokeComponents[4] = {0.2, 0.2, 0.2, 0.5}; |
|
CGColorSpaceRef colorSpace = CGColorSpaceCreateDeviceRGB(); |
|
color = CGColorCreate(colorSpace, fillComponents); |
[photoBackgroundLayer setBackgroundColor:color]; |
CFRelease(color); |
|
color = CGColorCreate(colorSpace, strokeComponents); |
[photoBackgroundLayer setBorderColor:color]; |
CFRelease(color); |
|
[photoBackgroundLayer setBorderWidth:1.0]; |
[photoBackgroundLayer setShadowOpacity:0.5]; |
[photoBackgroundLayer setCornerRadius:3]; |
|
CFRelease(colorSpace); |
|
[layer addSublayer:photoBackgroundLayer]; |
|
return layer; |
} |
|
return nil; |
} |
|
//--------------------------------------------------------------------------------- |
// imageFrame |
// |
// define where the image should be drawn |
//--------------------------------------------------------------------------------- |
- (NSRect) imageFrame |
{ |
//get default imageFrame and aspect ratio |
NSRect imageFrame = [super imageFrame]; |
|
if(imageFrame.size.height == 0 || imageFrame.size.width == 0) return NSZeroRect; |
|
float aspectRatio = imageFrame.size.width / imageFrame.size.height; |
|
// compute the rectangle included in container with a margin of at least 10 pixel at the bottom, 5 pixel at the top and keep a correct aspect ratio |
NSRect container = [self imageContainerFrame]; |
container = NSInsetRect(container, 8, 8); |
|
if(container.size.height <= 0) return NSZeroRect; |
|
float containerAspectRatio = container.size.width / container.size.height; |
|
if(containerAspectRatio > aspectRatio){ |
imageFrame.size.height = container.size.height; |
imageFrame.origin.y = container.origin.y; |
imageFrame.size.width = imageFrame.size.height * aspectRatio; |
imageFrame.origin.x = container.origin.x + (container.size.width - imageFrame.size.width)*0.5; |
} |
else{ |
imageFrame.size.width = container.size.width; |
imageFrame.origin.x = container.origin.x; |
imageFrame.size.height = imageFrame.size.width / aspectRatio; |
imageFrame.origin.y = container.origin.y + container.size.height - imageFrame.size.height; |
} |
|
//round it |
imageFrame.origin.x = floorf(imageFrame.origin.x); |
imageFrame.origin.y = floorf(imageFrame.origin.y); |
imageFrame.size.width = ceilf(imageFrame.size.width); |
imageFrame.size.height = ceilf(imageFrame.size.height); |
|
return imageFrame; |
} |
|
//--------------------------------------------------------------------------------- |
// imageContainerFrame |
// |
// override the default image container frame |
//--------------------------------------------------------------------------------- |
- (NSRect) imageContainerFrame |
{ |
NSRect container = [super frame]; |
|
//make the image container 15 pixels up |
container.origin.y += 15; |
container.size.height -= 15; |
|
return container; |
} |
|
//--------------------------------------------------------------------------------- |
// titleFrame |
// |
// override the default frame for the title |
//--------------------------------------------------------------------------------- |
- (NSRect) titleFrame |
{ |
//get the default frame for the title |
NSRect titleFrame = [super titleFrame]; |
|
//move the title inside the 'photo' background image |
NSRect container = [self frame]; |
titleFrame.origin.y = container.origin.y + 3; |
|
//make sure the title has a 7px margin with the left/right borders |
float margin = titleFrame.origin.x - (container.origin.x + 7); |
if(margin < 0) |
titleFrame = NSInsetRect(titleFrame, -margin, 0); |
|
return titleFrame; |
} |
|
//--------------------------------------------------------------------------------- |
// selectionFrame |
// |
// make the selection frame a little bit larger than the default one |
//--------------------------------------------------------------------------------- |
- (NSRect) selectionFrame |
{ |
return NSInsetRect([self frame], -5, -5); |
} |
|
@end |
