1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/osx/carbon/utilscocoa.mm
3 // Purpose: various cocoa mixin utility functions
4 // Author: Stefan Csomor
8 // Copyright: (c) Stefan Csomor
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 #include "wx/wxprec.h"
15 #include "wx/object.h"
18 #if wxOSX_USE_COCOA_OR_CARBON
19 #include <Cocoa/Cocoa.h>
21 #import <UIKit/UIKit.h>
25 #include "wx/osx/private.h"
28 #include "wx/fontutil.h"
31 #include "wx/cocoa/string.h"
39 bool cocoaLoaded = NSApplicationLoad();
40 wxASSERT_MSG(cocoaLoaded,wxT("Couldn't load Cocoa in Carbon Environment")) ;
45 wxMacAutoreleasePool::wxMacAutoreleasePool()
47 m_pool = [[NSAutoreleasePool alloc] init];
50 wxMacAutoreleasePool::~wxMacAutoreleasePool()
52 [(NSAutoreleasePool*)m_pool release];
59 CGContextRef wxOSXGetContextFromCurrentContext()
61 CGContextRef context = (CGContextRef)[[NSGraphicsContext currentContext]
66 bool wxOSXLockFocus( WXWidget view)
68 return [view lockFocusIfCanDraw];
71 void wxOSXUnlockFocus( WXWidget view)
80 CGContextRef wxOSXGetContextFromCurrentContext()
82 CGContextRef context = UIGraphicsGetCurrentContext();
88 // ----------------------------------------------------------------------------
90 // ----------------------------------------------------------------------------
92 void wxMacCocoaRelease( void* obj )
94 [(NSObject*)obj release];
97 void wxMacCocoaAutorelease( void* obj )
99 [(NSObject*)obj autorelease];
102 void* wxMacCocoaRetain( void* obj )
104 [(NSObject*)obj retain];
108 // ----------------------------------------------------------------------------
110 // ----------------------------------------------------------------------------
113 wxFont::wxFont(WX_NSFont nsfont)
116 wxNativeFontInfo info;
117 SetNativeInfoFromNSFont(nsfont, &info);
121 void wxFont::SetNativeInfoFromNSFont(WX_NSFont theFont, wxNativeFontInfo* info)
123 if ( info->m_faceName.empty())
125 //Get more information about the user's chosen font
126 NSFontTraitMask theTraits = [[NSFontManager sharedFontManager] traitsOfFont:theFont];
127 int theFontWeight = [[NSFontManager sharedFontManager] weightOfFont:theFont];
129 wxFontFamily fontFamily = wxFONTFAMILY_DEFAULT;
130 //Set the wx font to the appropriate data
131 if(theTraits & NSFixedPitchFontMask)
132 fontFamily = wxFONTFAMILY_TELETYPE;
134 wxFontStyle fontstyle = wxFONTSTYLE_NORMAL;
135 wxFontWeight fontweight = wxFONTWEIGHT_NORMAL;
136 bool underlined = false;
138 int size = (int) ([theFont pointSize]+0.5);
140 if ( theFontWeight >= 9 )
141 fontweight = wxFONTWEIGHT_BOLD ;
142 else if ( theFontWeight < 5 )
143 fontweight = wxFONTWEIGHT_LIGHT;
145 fontweight = wxFONTWEIGHT_NORMAL ;
147 if ( theTraits & NSItalicFontMask )
148 fontstyle = wxFONTSTYLE_ITALIC ;
150 info->Init(size,fontFamily,fontstyle,fontweight,underlined,
151 wxStringWithNSString([theFont familyName]), wxFONTENCODING_DEFAULT);
156 WX_NSFont wxFont::OSXCreateNSFont(wxOSXSystemFont font, wxNativeFontInfo* info)
158 NSFont* nsfont = nil;
161 case wxOSX_SYSTEM_FONT_NORMAL:
162 nsfont = [NSFont systemFontOfSize:[NSFont systemFontSize]];
164 case wxOSX_SYSTEM_FONT_BOLD:
165 nsfont = [NSFont boldSystemFontOfSize:[NSFont systemFontSize]];
167 case wxOSX_SYSTEM_FONT_SMALL:
168 nsfont = [NSFont systemFontOfSize:[NSFont smallSystemFontSize]];
170 case wxOSX_SYSTEM_FONT_SMALL_BOLD:
171 nsfont = [NSFont boldSystemFontOfSize:[NSFont smallSystemFontSize]];
173 case wxOSX_SYSTEM_FONT_MINI:
174 nsfont = [NSFont systemFontOfSize:
175 [NSFont systemFontSizeForControlSize:NSMiniControlSize]];
177 case wxOSX_SYSTEM_FONT_MINI_BOLD:
178 nsfont = [NSFont boldSystemFontOfSize:
179 [NSFont systemFontSizeForControlSize:NSMiniControlSize]];
181 case wxOSX_SYSTEM_FONT_LABELS:
182 nsfont = [NSFont labelFontOfSize:[NSFont labelFontSize]];
184 case wxOSX_SYSTEM_FONT_VIEWS:
185 nsfont = [NSFont controlContentFontOfSize:0];
191 SetNativeInfoFromNSFont(nsfont, info);
195 static inline double DegToRad(double deg) { return (deg * M_PI) / 180.0; }
196 static const NSAffineTransformStruct kSlantNSTransformStruct = { 1, 0, tan(DegToRad(11)), 1, 0, 0 };
198 WX_NSFont wxFont::OSXCreateNSFont(const wxNativeFontInfo* info)
202 NSFontTraitMask traits = 0;
203 if (info->m_weight == wxFONTWEIGHT_BOLD)
205 traits |= NSBoldFontMask;
208 else if (info->m_weight == wxFONTWEIGHT_LIGHT)
211 if (info->m_style == wxFONTSTYLE_ITALIC || info->m_style == wxFONTSTYLE_SLANT)
212 traits |= NSItalicFontMask;
214 nsFont = [[NSFontManager sharedFontManager] fontWithFamily:wxCFStringRef(info->m_faceName).AsNSString()
215 traits:traits weight:weight size:info->m_pointSize];
219 NSFontTraitMask remainingTraits = traits;
220 nsFont = [[NSFontManager sharedFontManager] fontWithFamily:wxCFStringRef(info->m_faceName).AsNSString()
221 traits:0 weight:5 size:info->m_pointSize];
224 if ( info->m_weight == wxFONTWEIGHT_BOLD )
226 nsFont = [NSFont boldSystemFontOfSize:info->m_pointSize];
227 remainingTraits &= ~NSBoldFontMask;
230 nsFont = [NSFont systemFontOfSize:info->m_pointSize];
233 // fallback - if in doubt, let go of the bold attribute
234 if ( nsFont && (remainingTraits & NSItalicFontMask) )
236 NSFont* nsFontWithTraits = nil;
237 if ( remainingTraits & NSBoldFontMask)
239 nsFontWithTraits = [[NSFontManager sharedFontManager] convertFont:nsFont toHaveTrait:NSBoldFontMask];
240 if ( nsFontWithTraits == nil )
242 nsFontWithTraits = [[NSFontManager sharedFontManager] convertFont:nsFont toHaveTrait:NSItalicFontMask];
243 if ( nsFontWithTraits != nil )
244 remainingTraits &= ~NSItalicFontMask;
248 remainingTraits &= ~NSBoldFontMask;
251 // the code below causes crashes, because fontDescriptorWithMatrix is not returning a valid font descriptor
252 // it adds a NSCTFontMatrixAttribute as well which cannot be disposed of correctly by the autorelease pool
253 // so at the moment we have to disable this and cannot synthesize italic fonts if they are not available on the system
255 if ( remainingTraits & NSItalicFontMask )
257 if ( nsFontWithTraits == nil )
258 nsFontWithTraits = nsFont;
260 NSAffineTransform* transform = [NSAffineTransform transform];
261 [transform setTransformStruct:kSlantNSTransformStruct];
262 [transform scaleBy:info->m_pointSize];
263 NSFontDescriptor* italicDesc = [[nsFontWithTraits fontDescriptor] fontDescriptorWithMatrix:transform];
264 if ( italicDesc != nil )
266 NSFont* f = [NSFont fontWithDescriptor:italicDesc size:(CGFloat)(info->m_pointSize)];
268 nsFontWithTraits = f;
272 if ( nsFontWithTraits != nil )
273 nsFont = nsFontWithTraits;
277 wxASSERT_MSG(nsFont != nil,wxT("Couldn't create nsFont")) ;
278 wxMacCocoaRetain(nsFont);
286 WX_UIFont wxFont::OSXCreateUIFont(wxOSXSystemFont font, wxNativeFontInfo* info)
291 case wxOSX_SYSTEM_FONT_NORMAL:
292 uifont = [UIFont systemFontOfSize:[UIFont systemFontSize]];
294 case wxOSX_SYSTEM_FONT_BOLD:
295 uifont = [UIFont boldSystemFontOfSize:[UIFont systemFontSize]];
297 case wxOSX_SYSTEM_FONT_MINI:
298 case wxOSX_SYSTEM_FONT_SMALL:
299 uifont = [UIFont systemFontOfSize:[UIFont smallSystemFontSize]];
301 case wxOSX_SYSTEM_FONT_MINI_BOLD:
302 case wxOSX_SYSTEM_FONT_SMALL_BOLD:
303 uifont = [UIFont boldSystemFontOfSize:[UIFont smallSystemFontSize]];
305 case wxOSX_SYSTEM_FONT_VIEWS:
306 case wxOSX_SYSTEM_FONT_LABELS:
307 uifont = [UIFont systemFontOfSize:[UIFont labelFontSize]];
313 if ( info->m_faceName.empty())
315 wxFontStyle fontstyle = wxFONTSTYLE_NORMAL;
316 wxFontWeight fontweight = wxFONTWEIGHT_NORMAL;
317 bool underlined = false;
319 int size = (int) ([uifont pointSize]+0.5);
321 NSFontSymbolicTraits traits = [desc symbolicTraits];
323 if ( traits & NSFontBoldTrait )
324 fontweight = wxFONTWEIGHT_BOLD ;
326 fontweight = wxFONTWEIGHT_NORMAL ;
327 if ( traits & NSFontItalicTrait )
328 fontstyle = wxFONTSTYLE_ITALIC ;
330 wxCFStringRef fontname( wxCFRetain([uifont familyName]) );
331 info->Init(size,wxFONTFAMILY_DEFAULT,fontstyle,fontweight,underlined,
332 fontname.AsString(), wxFONTENCODING_DEFAULT);
338 WX_UIFont wxFont::OSXCreateUIFont(const wxNativeFontInfo* info)
341 uiFont = [UIFont fontWithName:wxCFStringRef(info->m_faceName).AsNSString() size:info->m_pointSize];
342 wxMacCocoaRetain(uiFont);
347 // ----------------------------------------------------------------------------
349 // ----------------------------------------------------------------------------
353 WX_UIImage wxOSXGetUIImageFromCGImage( CGImageRef image )
355 UIImage *newImage = [UIImage imageWithCGImage:image];
356 [newImage autorelease];
360 wxBitmap wxOSXCreateSystemBitmap(const wxString& name, const wxString &client, const wxSize& size)
363 // unfortunately this only accesses images in the app bundle, not the system wide globals
364 wxCFStringRef cfname(name);
365 return wxBitmap( [[UIImage imageNamed:cfname.AsNSString()] CGImage] );
375 wxBitmap wxOSXCreateSystemBitmap(const wxString& name, const wxString &WXUNUSED(client), const wxSize& WXUNUSED(size))
377 wxCFStringRef cfname(name);
378 wxCFRef<CGImageRef> image( wxOSXCreateCGImageFromNSImage([NSImage imageNamed:cfname.AsNSString()]) );
379 return wxBitmap( image );
382 // From "Cocoa Drawing Guide:Working with Images"
383 WX_NSImage wxOSXGetNSImageFromCGImage( CGImageRef image )
385 NSRect imageRect = NSMakeRect(0.0, 0.0, 0.0, 0.0);
387 // Get the image dimensions.
388 imageRect.size.height = CGImageGetHeight(image);
389 imageRect.size.width = CGImageGetWidth(image);
391 // Create a new image to receive the Quartz image data.
392 NSImage *newImage = [[NSImage alloc] initWithSize:imageRect.size];
393 [newImage lockFocus];
395 // Get the Quartz context and draw.
396 CGContextRef imageContext = (CGContextRef) [[NSGraphicsContext currentContext] graphicsPort];
397 CGContextDrawImage( imageContext, *(CGRect*)&imageRect, image );
398 [newImage unlockFocus];
401 // Create a bitmap rep from the image...
402 NSBitmapImageRep *bitmapRep = [[NSBitmapImageRep alloc] initWithCGImage:cgImage];
403 // Create an NSImage and add the bitmap rep to it...
404 NSImage *image = [[NSImage alloc] init];
405 [image addRepresentation:bitmapRep];
408 [newImage autorelease];
412 CGImageRef wxOSXCreateCGImageFromNSImage( WX_NSImage nsimage )
414 // based on http://www.mail-archive.com/cocoa-dev@lists.apple.com/msg18065.html
416 CGImageRef image = NULL;
419 NSSize imageSize = [nsimage size];
420 CGContextRef context = CGBitmapContextCreate(NULL, imageSize.width, imageSize.height, 8, 0, wxMacGetGenericRGBColorSpace(), kCGImageAlphaPremultipliedFirst);
421 NSGraphicsContext *nsGraphicsContext = [NSGraphicsContext graphicsContextWithGraphicsPort:context flipped:NO];
422 [NSGraphicsContext saveGraphicsState];
423 [NSGraphicsContext setCurrentContext:nsGraphicsContext];
424 [[NSColor whiteColor] setFill];
425 NSRectFill(NSMakeRect(0.0, 0.0, imageSize.width, imageSize.height));
426 [nsimage drawAtPoint:NSZeroPoint fromRect:NSZeroRect operation:NSCompositeCopy fraction:1.0];
427 [NSGraphicsContext setCurrentContext:nsGraphicsContext];
428 image = CGBitmapContextCreateImage(context);
434 // ----------------------------------------------------------------------------
436 // ----------------------------------------------------------------------------
438 // copied from cursor.mm
440 static NSCursor* wxGetStockCursor( short sIndex )
442 ClassicCursor* pCursor = &gMacCursors[sIndex];
444 //Classic mac cursors are 1bps 16x16 black and white with a
445 //identical mask that is 1 for on and 0 for off
446 NSImage *theImage = [[NSImage alloc] initWithSize:NSMakeSize(16.0,16.0)];
448 //NSCursor takes an NSImage takes a number of Representations - here
449 //we need only one for the raw data
450 NSBitmapImageRep *theRep = [[NSBitmapImageRep alloc]
451 initWithBitmapDataPlanes: NULL // Tell Cocoa to allocate the planes for us.
452 pixelsWide: 16 // All classic cursors are 16x16
454 bitsPerSample: 1 // All classic cursors are bitmaps with bitmasks
455 samplesPerPixel: 2 // Sample 0:image 1:mask
456 hasAlpha: YES // Identify last sample as a mask
457 isPlanar: YES // Use a separate array for each sample
458 colorSpaceName: NSCalibratedWhiteColorSpace // 0.0=black 1.0=white
459 bytesPerRow: 2 // Rows in each plane are on 2-byte boundaries (no pad)
460 bitsPerPixel: 1]; // same as bitsPerSample since data is planar
462 // Ensure that Cocoa allocated 2 and only 2 of the 5 possible planes
463 unsigned char *planes[5];
464 [theRep getBitmapDataPlanes:planes];
465 wxASSERT(planes[0] != NULL);
466 wxASSERT(planes[1] != NULL);
467 wxASSERT(planes[2] == NULL);
468 wxASSERT(planes[3] == NULL);
469 wxASSERT(planes[4] == NULL);
471 // NOTE1: The Cursor's bits field is white=0 black=1.. thus the bitwise-not
472 // Why not use NSCalibratedBlackColorSpace? Because that reverses the
473 // sense of the alpha (mask) plane.
474 // NOTE2: The mask data is 0=off 1=on
475 // NOTE3: Cocoa asks for "premultiplied" color planes. Since we have a
476 // 1-bit color plane and a 1-bit alpha plane we can just do a bitwise-and
477 // on the two. The original cursor bitmaps have 0 (white actually) for
478 // any masked-off pixels. Therefore every masked-off pixel would be wrong
479 // since we bit-flip all of the picture bits. In practice, Cocoa doesn't
480 // seem to care, but we are following the documentation.
482 // Fill in the color (black/white) plane
483 for(int i=0; i<16; ++i)
485 planes[0][2*i ] = (~pCursor->bits[i] & pCursor->mask[i]) >> 8 & 0xff;
486 planes[0][2*i+1] = (~pCursor->bits[i] & pCursor->mask[i]) & 0xff;
488 // Fill in the alpha (i.e. mask) plane
489 for(int i=0; i<16; ++i)
491 planes[1][2*i ] = pCursor->mask[i] >> 8 & 0xff;
492 planes[1][2*i+1] = pCursor->mask[i] & 0xff;
495 //add the representation (data) to the image
496 [theImage addRepresentation:theRep];
498 //create the new cursor
499 NSCursor* theCursor = [[NSCursor alloc] initWithImage:theImage
500 hotSpot:NSMakePoint(pCursor->hotspot[1], pCursor->hotspot[0])
503 //do the usual cleanups
507 //return the new cursor
511 WX_NSCursor wxMacCocoaCreateStockCursor( int cursor_type )
513 WX_NSCursor cursor = nil;
516 case wxCURSOR_COPY_ARROW:
517 cursor = [[NSCursor arrowCursor] retain];
522 // an arrow should be displayed by the system when things are running
523 // according to the HIG
524 // cursor = [[NSCursor arrowCursor] retain];
525 // but for crossplatform compatibility we display a watch cursor
526 cursor = wxGetStockCursor(kwxCursorWatch);
530 cursor = [[NSCursor IBeamCursor] retain];
534 cursor = [[NSCursor crosshairCursor] retain];
537 case wxCURSOR_SIZENWSE:
538 cursor = wxGetStockCursor(kwxCursorSizeNWSE);
541 case wxCURSOR_SIZENESW:
542 cursor = wxGetStockCursor(kwxCursorSizeNESW);
545 case wxCURSOR_SIZEWE:
546 cursor = [[NSCursor resizeLeftRightCursor] retain];
549 case wxCURSOR_SIZENS:
550 cursor = [[NSCursor resizeUpDownCursor] retain];
553 case wxCURSOR_SIZING:
554 cursor = wxGetStockCursor(kwxCursorSize);
558 cursor = [[NSCursor pointingHandCursor] retain];
561 case wxCURSOR_BULLSEYE:
562 cursor = wxGetStockCursor(kwxCursorBullseye);
565 case wxCURSOR_PENCIL:
566 cursor = wxGetStockCursor(kwxCursorPencil);
569 case wxCURSOR_MAGNIFIER:
570 cursor = wxGetStockCursor(kwxCursorMagnifier);
573 case wxCURSOR_NO_ENTRY:
574 cursor = wxGetStockCursor(kwxCursorNoEntry);
577 case wxCURSOR_PAINT_BRUSH:
578 cursor = wxGetStockCursor(kwxCursorPaintBrush);
581 case wxCURSOR_POINT_LEFT:
582 cursor = wxGetStockCursor(kwxCursorPointLeft);
585 case wxCURSOR_POINT_RIGHT:
586 cursor = wxGetStockCursor(kwxCursorPointRight);
589 case wxCURSOR_QUESTION_ARROW:
590 cursor = wxGetStockCursor(kwxCursorQuestionArrow);
594 cursor = wxGetStockCursor(kwxCursorBlank);
597 case wxCURSOR_RIGHT_ARROW:
598 cursor = wxGetStockCursor(kwxCursorRightArrow);
601 case wxCURSOR_SPRAYCAN:
602 cursor = wxGetStockCursor(kwxCursorRoller);
605 case wxCURSOR_OPEN_HAND:
606 cursor = [[NSCursor openHandCursor] retain];
609 case wxCURSOR_CLOSED_HAND:
610 cursor = [[NSCursor closedHandCursor] retain];
615 case wxCURSOR_LEFT_BUTTON:
616 case wxCURSOR_RIGHT_BUTTON:
617 case wxCURSOR_MIDDLE_BUTTON:
619 cursor = [[NSCursor arrowCursor] retain];
625 // C-based style wrapper routines around NSCursor
626 WX_NSCursor wxMacCocoaCreateCursorFromCGImage( CGImageRef cgImageRef, float hotSpotX, float hotSpotY )
628 static BOOL firstTime = YES;
632 // Must first call [[[NSWindow alloc] init] release] to get the NSWindow machinery set up so that NSCursor can use a window to cache the cursor image
633 [[[NSWindow alloc] init] release];
637 NSImage *nsImage = wxOSXGetNSImageFromCGImage( cgImageRef );
638 NSCursor *cursor = [[NSCursor alloc] initWithImage:nsImage hotSpot:NSMakePoint( hotSpotX, hotSpotY )];
643 void wxMacCocoaSetCursor( WX_NSCursor cursor )
648 void wxMacCocoaHideCursor()
653 void wxMacCocoaShowCursor()