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, static_cast<CGFloat>(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);
348 // ----------------------------------------------------------------------------
350 // ----------------------------------------------------------------------------
354 WXWindow wxOSXGetMainWindow()
356 return [NSApp mainWindow];
360 // ----------------------------------------------------------------------------
362 // ----------------------------------------------------------------------------
366 WX_UIImage wxOSXGetUIImageFromCGImage( CGImageRef image )
368 UIImage *newImage = [UIImage imageWithCGImage:image];
369 [newImage autorelease];
373 wxBitmap wxOSXCreateSystemBitmap(const wxString& name, const wxString &client, const wxSize& size)
376 // unfortunately this only accesses images in the app bundle, not the system wide globals
377 wxCFStringRef cfname(name);
378 return wxBitmap( [[UIImage imageNamed:cfname.AsNSString()] CGImage] );
388 wxBitmap wxOSXCreateSystemBitmap(const wxString& name, const wxString &WXUNUSED(client), const wxSize& WXUNUSED(size))
390 wxCFStringRef cfname(name);
391 wxCFRef<CGImageRef> image( wxOSXCreateCGImageFromNSImage([NSImage imageNamed:cfname.AsNSString()]) );
392 return wxBitmap( image );
395 // From "Cocoa Drawing Guide:Working with Images"
396 WX_NSImage wxOSXGetNSImageFromCGImage( CGImageRef image )
398 NSRect imageRect = NSMakeRect(0.0, 0.0, 0.0, 0.0);
400 // Get the image dimensions.
401 imageRect.size.height = CGImageGetHeight(image);
402 imageRect.size.width = CGImageGetWidth(image);
404 // Create a new image to receive the Quartz image data.
405 NSImage *newImage = [[NSImage alloc] initWithSize:imageRect.size];
406 [newImage lockFocus];
408 // Get the Quartz context and draw.
409 CGContextRef imageContext = (CGContextRef) [[NSGraphicsContext currentContext] graphicsPort];
410 CGContextDrawImage( imageContext, *(CGRect*)&imageRect, image );
411 [newImage unlockFocus];
414 // Create a bitmap rep from the image...
415 NSBitmapImageRep *bitmapRep = [[NSBitmapImageRep alloc] initWithCGImage:cgImage];
416 // Create an NSImage and add the bitmap rep to it...
417 NSImage *image = [[NSImage alloc] init];
418 [image addRepresentation:bitmapRep];
421 [newImage autorelease];
425 CGImageRef wxOSXCreateCGImageFromNSImage( WX_NSImage nsimage )
427 // based on http://www.mail-archive.com/cocoa-dev@lists.apple.com/msg18065.html
429 CGImageRef image = NULL;
432 NSSize imageSize = [nsimage size];
433 CGContextRef context = CGBitmapContextCreate(NULL, imageSize.width, imageSize.height, 8, 0, wxMacGetGenericRGBColorSpace(), kCGImageAlphaPremultipliedFirst);
434 NSGraphicsContext *nsGraphicsContext = [NSGraphicsContext graphicsContextWithGraphicsPort:context flipped:NO];
435 [NSGraphicsContext saveGraphicsState];
436 [NSGraphicsContext setCurrentContext:nsGraphicsContext];
437 [[NSColor whiteColor] setFill];
438 NSRectFill(NSMakeRect(0.0, 0.0, imageSize.width, imageSize.height));
439 [nsimage drawAtPoint:NSZeroPoint fromRect:NSZeroRect operation:NSCompositeCopy fraction:1.0];
440 [NSGraphicsContext setCurrentContext:nsGraphicsContext];
441 image = CGBitmapContextCreateImage(context);
447 // ----------------------------------------------------------------------------
449 // ----------------------------------------------------------------------------
451 // copied from cursor.mm
453 static NSCursor* wxGetStockCursor( short sIndex )
455 ClassicCursor* pCursor = &gMacCursors[sIndex];
457 //Classic mac cursors are 1bps 16x16 black and white with a
458 //identical mask that is 1 for on and 0 for off
459 NSImage *theImage = [[NSImage alloc] initWithSize:NSMakeSize(16.0,16.0)];
461 //NSCursor takes an NSImage takes a number of Representations - here
462 //we need only one for the raw data
463 NSBitmapImageRep *theRep = [[NSBitmapImageRep alloc]
464 initWithBitmapDataPlanes: NULL // Tell Cocoa to allocate the planes for us.
465 pixelsWide: 16 // All classic cursors are 16x16
467 bitsPerSample: 1 // All classic cursors are bitmaps with bitmasks
468 samplesPerPixel: 2 // Sample 0:image 1:mask
469 hasAlpha: YES // Identify last sample as a mask
470 isPlanar: YES // Use a separate array for each sample
471 colorSpaceName: NSCalibratedWhiteColorSpace // 0.0=black 1.0=white
472 bytesPerRow: 2 // Rows in each plane are on 2-byte boundaries (no pad)
473 bitsPerPixel: 1]; // same as bitsPerSample since data is planar
475 // Ensure that Cocoa allocated 2 and only 2 of the 5 possible planes
476 unsigned char *planes[5];
477 [theRep getBitmapDataPlanes:planes];
478 wxASSERT(planes[0] != NULL);
479 wxASSERT(planes[1] != NULL);
480 wxASSERT(planes[2] == NULL);
481 wxASSERT(planes[3] == NULL);
482 wxASSERT(planes[4] == NULL);
484 // NOTE1: The Cursor's bits field is white=0 black=1.. thus the bitwise-not
485 // Why not use NSCalibratedBlackColorSpace? Because that reverses the
486 // sense of the alpha (mask) plane.
487 // NOTE2: The mask data is 0=off 1=on
488 // NOTE3: Cocoa asks for "premultiplied" color planes. Since we have a
489 // 1-bit color plane and a 1-bit alpha plane we can just do a bitwise-and
490 // on the two. The original cursor bitmaps have 0 (white actually) for
491 // any masked-off pixels. Therefore every masked-off pixel would be wrong
492 // since we bit-flip all of the picture bits. In practice, Cocoa doesn't
493 // seem to care, but we are following the documentation.
495 // Fill in the color (black/white) plane
496 for(int i=0; i<16; ++i)
498 planes[0][2*i ] = (~pCursor->bits[i] & pCursor->mask[i]) >> 8 & 0xff;
499 planes[0][2*i+1] = (~pCursor->bits[i] & pCursor->mask[i]) & 0xff;
501 // Fill in the alpha (i.e. mask) plane
502 for(int i=0; i<16; ++i)
504 planes[1][2*i ] = pCursor->mask[i] >> 8 & 0xff;
505 planes[1][2*i+1] = pCursor->mask[i] & 0xff;
508 //add the representation (data) to the image
509 [theImage addRepresentation:theRep];
511 //create the new cursor
512 NSCursor* theCursor = [[NSCursor alloc] initWithImage:theImage
513 hotSpot:NSMakePoint(pCursor->hotspot[1], pCursor->hotspot[0])
516 //do the usual cleanups
520 //return the new cursor
524 WX_NSCursor wxMacCocoaCreateStockCursor( int cursor_type )
526 WX_NSCursor cursor = nil;
529 case wxCURSOR_COPY_ARROW:
530 cursor = [[NSCursor arrowCursor] retain];
535 // an arrow should be displayed by the system when things are running
536 // according to the HIG
537 // cursor = [[NSCursor arrowCursor] retain];
538 // but for crossplatform compatibility we display a watch cursor
539 cursor = wxGetStockCursor(kwxCursorWatch);
543 cursor = [[NSCursor IBeamCursor] retain];
547 cursor = [[NSCursor crosshairCursor] retain];
550 case wxCURSOR_SIZENWSE:
551 cursor = wxGetStockCursor(kwxCursorSizeNWSE);
554 case wxCURSOR_SIZENESW:
555 cursor = wxGetStockCursor(kwxCursorSizeNESW);
558 case wxCURSOR_SIZEWE:
559 cursor = [[NSCursor resizeLeftRightCursor] retain];
562 case wxCURSOR_SIZENS:
563 cursor = [[NSCursor resizeUpDownCursor] retain];
566 case wxCURSOR_SIZING:
567 cursor = wxGetStockCursor(kwxCursorSize);
571 cursor = [[NSCursor pointingHandCursor] retain];
574 case wxCURSOR_BULLSEYE:
575 cursor = wxGetStockCursor(kwxCursorBullseye);
578 case wxCURSOR_PENCIL:
579 cursor = wxGetStockCursor(kwxCursorPencil);
582 case wxCURSOR_MAGNIFIER:
583 cursor = wxGetStockCursor(kwxCursorMagnifier);
586 case wxCURSOR_NO_ENTRY:
587 cursor = wxGetStockCursor(kwxCursorNoEntry);
590 case wxCURSOR_PAINT_BRUSH:
591 cursor = wxGetStockCursor(kwxCursorPaintBrush);
594 case wxCURSOR_POINT_LEFT:
595 cursor = wxGetStockCursor(kwxCursorPointLeft);
598 case wxCURSOR_POINT_RIGHT:
599 cursor = wxGetStockCursor(kwxCursorPointRight);
602 case wxCURSOR_QUESTION_ARROW:
603 cursor = wxGetStockCursor(kwxCursorQuestionArrow);
607 cursor = wxGetStockCursor(kwxCursorBlank);
610 case wxCURSOR_RIGHT_ARROW:
611 cursor = wxGetStockCursor(kwxCursorRightArrow);
614 case wxCURSOR_SPRAYCAN:
615 cursor = wxGetStockCursor(kwxCursorRoller);
618 case wxCURSOR_OPEN_HAND:
619 cursor = [[NSCursor openHandCursor] retain];
622 case wxCURSOR_CLOSED_HAND:
623 cursor = [[NSCursor closedHandCursor] retain];
628 case wxCURSOR_LEFT_BUTTON:
629 case wxCURSOR_RIGHT_BUTTON:
630 case wxCURSOR_MIDDLE_BUTTON:
632 cursor = [[NSCursor arrowCursor] retain];
638 // C-based style wrapper routines around NSCursor
639 WX_NSCursor wxMacCocoaCreateCursorFromCGImage( CGImageRef cgImageRef, float hotSpotX, float hotSpotY )
641 static BOOL firstTime = YES;
645 // 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
646 [[[NSWindow alloc] init] release];
650 NSImage *nsImage = wxOSXGetNSImageFromCGImage( cgImageRef );
651 NSCursor *cursor = [[NSCursor alloc] initWithImage:nsImage hotSpot:NSMakePoint( hotSpotX, hotSpotY )];
656 void wxMacCocoaSetCursor( WX_NSCursor cursor )
661 void wxMacCocoaHideCursor()
666 void wxMacCocoaShowCursor()