Comments on: NSImage Templates http://www.proppe.org/blog/2007/12/01/nsimage-templates/ Mon, 21 Sep 2009 02:25:18 -0600 http://wordpress.org/?v=2.8.5 hourly 1 By: Gunnar Proppé http://www.proppe.org/blog/2007/12/01/nsimage-templates/comment-page-1/#comment-1139 Gunnar Proppé Sat, 18 Oct 2008 17:51:04 +0000 http://www.proppe.org/blog/2007/12/01/nsimage-templates/#comment-1139 @ken Thanks for the detailed info. It would be neat if a color tint could be added as an attribute to template images so you could get those more sophisticated effects on images other than black, but I understand it's part of the new(ish) aesthetic. @ken Thanks for the detailed info. It would be neat if a color tint could be added as an attribute to template images so you could get those more sophisticated effects on images other than black, but I understand it’s part of the new(ish) aesthetic.

]]> By: ken http://www.proppe.org/blog/2007/12/01/nsimage-templates/comment-page-1/#comment-1142 ken Sat, 18 Oct 2008 15:50:32 +0000 http://www.proppe.org/blog/2007/12/01/nsimage-templates/#comment-1142 The most complete documentation at the moment is in the AppKit release notes. http://developer.apple.com/releasenotes/Cocoa/AppKit.html#NSImageTemplate Here's how the naming convention works (from the relnotes): 'To mark an image as a template, call -[NSImage setTemplate:]. As a convenience, in applications linked on or after 10.5, any image read off of disk via -[NSImage imageNamed:] whose name ends in @"Template" will be marked as a template as it is created. This makes it easy to use template images in Interface Builder. Just make sure your image filenames end in "Template".' and yep, a template defined to be a mask, no color. If you want to use a red image, don't mark it as a template. 'This is extended in Leopard with a new metadata property, -[NSImage isTemplate]. An image is a 'template' if it is a black and clear mask that should not be presented to the user directly, but always processed into a final form. It's similar to a glyph in a font. If a cell is given a template image, it can perform much more sophisticated effects than usual, similar to those done with text. The image can be dark most of the time, white in a selected table view row, and engraved or embossed the same way text is.' The most complete documentation at the moment is in the AppKit release notes.

http://developer.apple.com/releasenotes/Cocoa/AppKit.html#NSImageTemplate

Here’s how the naming convention works (from the relnotes):

‘To mark an image as a template, call -[NSImage setTemplate:]. As a convenience, in applications linked on or after 10.5, any image read off of disk via -[NSImage imageNamed:] whose name ends in @”Template” will be marked as a template as it is created. This makes it easy to use template images in Interface Builder. Just make sure your image filenames end in “Template”.’

and yep, a template defined to be a mask, no color. If you want to use a red image, don’t mark it as a template.

‘This is extended in Leopard with a new metadata property, -[NSImage isTemplate]. An image is a ‘template’ if it is a black and clear mask that should not be presented to the user directly, but always processed into a final form. It’s similar to a glyph in a font. If a cell is given a template image, it can perform much more sophisticated effects than usual, similar to those done with text. The image can be dark most of the time, white in a selected table view row, and engraved or embossed the same way text is.’

]]> By: Gunnar Proppé http://www.proppe.org/blog/2007/12/01/nsimage-templates/comment-page-1/#comment-1141 Gunnar Proppé Sat, 18 Oct 2008 04:29:50 +0000 http://www.proppe.org/blog/2007/12/01/nsimage-templates/#comment-1141 @Jordy/Jediknil Thanks for pointing that out. Coincidentally I just was looking at the NSImage docs yesterday and noticed that method. @Jordy/Jediknil Thanks for pointing that out. Coincidentally I just was looking at the NSImage docs yesterday and noticed that method.

]]> By: Jordy/Jediknil http://www.proppe.org/blog/2007/12/01/nsimage-templates/comment-page-1/#comment-1140 Jordy/Jediknil Fri, 17 Oct 2008 16:44:55 +0000 http://www.proppe.org/blog/2007/12/01/nsimage-templates/#comment-1140 The "name ending in 'Template'" rule isn't the only way this works; there's also the -setTemplate: method to do this for you. However, it seems that if the name ends in "Template" then -setTemplate: will be called automagically. The “name ending in ‘Template’” rule isn’t the only way this works; there’s also the -setTemplate: method to do this for you. However, it seems that if the name ends in “Template” then -setTemplate: will be called automagically.

]]>