1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/cocoa/dc.mm
4 // Author: David Elliott
8 // Copyright: (c) 2003 David Elliott
9 // Licence: wxWidgets licence
10 /////////////////////////////////////////////////////////////////////////////
12 #include "wx/wxprec.h"
18 #include "wx/math.h" //math constants
21 #include "wx/cocoa/autorelease.h"
22 #include "wx/cocoa/string.h"
24 #import <AppKit/NSBezierPath.h>
25 #import <AppKit/NSTextStorage.h>
26 #import <AppKit/NSLayoutManager.h>
27 #import <AppKit/NSTextContainer.h>
28 #import <AppKit/NSGraphicsContext.h>
29 #import <AppKit/NSAffineTransform.h>
30 #import <AppKit/NSColor.h>
31 #import <AppKit/NSTypesetter.h>
32 #import <AppKit/NSImage.h>
34 #include "wx/listimpl.cpp"
35 WX_DEFINE_LIST(wxCocoaDCStack);
37 IMPLEMENT_ABSTRACT_CLASS(wxDC, wxObject)
38 WX_NSTextStorage wxDC::sm_cocoaNSTextStorage = nil;
39 WX_NSLayoutManager wxDC::sm_cocoaNSLayoutManager = nil;
40 WX_NSTextContainer wxDC::sm_cocoaNSTextContainer = nil;
41 wxCocoaDCStack wxDC::sm_cocoaDCStack;
43 inline void CocoaSetPenForNSBezierPath(wxPen &pen, NSBezierPath *bezpath)
45 [pen.GetNSColor() set];
46 const CGFloat *pattern;
47 [bezpath setLineDash:pattern count:pen.GetCocoaLineDash(&pattern) phase:0.0];
48 [bezpath setLineWidth:pen.GetWidth()];
52 [bezpath setLineJoinStyle:NSBevelLineJoinStyle];
55 [bezpath setLineJoinStyle:NSRoundLineJoinStyle];
58 [bezpath setLineJoinStyle:NSMiterLineJoinStyle];
64 [bezpath setLineCapStyle:NSRoundLineCapStyle];
66 case wxCAP_PROJECTING:
67 [bezpath setLineCapStyle:NSSquareLineCapStyle];
70 [bezpath setLineCapStyle:NSButtLineCapStyle];
75 void wxDC::CocoaInitializeTextSystem()
77 wxASSERT_MSG(!sm_cocoaNSTextStorage && !sm_cocoaNSLayoutManager && !sm_cocoaNSTextContainer,wxT("Text system already initalized! BAD PROGRAMMER!"));
79 sm_cocoaNSTextStorage = [[NSTextStorage alloc] init];
81 sm_cocoaNSLayoutManager = [[NSLayoutManager alloc] init];
82 [sm_cocoaNSTextStorage addLayoutManager:sm_cocoaNSLayoutManager];
83 // NSTextStorage retains NSLayoutManager, but so do we
84 // [sm_cocoaNSLayoutManager release]; [sm_cocoaNSLayoutManager retain];
86 // NOTE: initWithContainerSize is the designated initializer, but the
87 // Apple CircleView sample gets away with just calling init, which
88 // is all we really need for our purposes.
89 sm_cocoaNSTextContainer = [[NSTextContainer alloc] init];
90 [sm_cocoaNSLayoutManager addTextContainer:sm_cocoaNSTextContainer];
91 // NSLayoutManager retains NSTextContainer, but so do we
92 // [sm_cocoaNSTextContainer release]; [sm_cocoaNSTextContainer retain];
95 void wxDC::CocoaShutdownTextSystem()
97 [sm_cocoaNSTextContainer release]; sm_cocoaNSTextContainer = nil;
98 [sm_cocoaNSLayoutManager release]; sm_cocoaNSLayoutManager = nil;
99 [sm_cocoaNSTextStorage release]; sm_cocoaNSTextStorage = nil;
102 void wxDC::CocoaUnwindStackAndLoseFocus()
104 wxCocoaDCStack::compatibility_iterator ourNode=sm_cocoaDCStack.Find(this);
107 wxCocoaDCStack::compatibility_iterator node=sm_cocoaDCStack.GetFirst();
108 for(;node!=ourNode; node=sm_cocoaDCStack.GetFirst())
110 wxDC *dc = node->GetData();
113 if(!dc->CocoaUnlockFocus())
115 wxFAIL_MSG(wxT("Unable to unlock focus on higher-level DC!"));
117 sm_cocoaDCStack.Erase(node);
119 wxASSERT(node==ourNode);
120 wxASSERT(ourNode->GetData() == this);
121 ourNode->GetData()->CocoaUnlockFocus();
122 sm_cocoaDCStack.Erase(ourNode);
126 bool wxDC::CocoaUnwindStackAndTakeFocus()
128 wxCocoaDCStack::compatibility_iterator node=sm_cocoaDCStack.GetFirst();
129 for(;node;node = sm_cocoaDCStack.GetFirst())
131 wxDC *dc = node->GetData();
133 // If we're on the stack, then it's unwound enough and we have focus
136 // If unable to unlockFocus (e.g. wxPaintDC) stop here
137 if(!dc->CocoaUnlockFocus())
139 sm_cocoaDCStack.Erase(node);
141 return CocoaLockFocus();
146 m_cocoaWxToBoundsTransform = nil;
147 m_pen = *wxBLACK_PEN;
152 [m_cocoaWxToBoundsTransform release];
155 bool wxDC::CocoaLockFocus()
160 bool wxDC::CocoaUnlockFocus()
165 /*static*/ WX_NSAffineTransform wxDC::CocoaGetWxToBoundsTransform(bool isFlipped, float height)
167 NSAffineTransform *transform = nil;
168 // This transform flips the graphics since wxDC uses top-left origin
171 // The transform is auto released
172 transform = [NSAffineTransform transform];
174 y' = 0x + -1y + window's height
176 NSAffineTransformStruct matrix = {
181 [transform setTransformStruct: matrix];
186 void wxDC::CocoaApplyTransformations()
188 [m_cocoaWxToBoundsTransform concat];
189 // TODO: Apply device/logical/user position/scaling transformations
192 void wxDC::CocoaUnapplyTransformations()
194 // NOTE: You *must* call this with focus held.
195 // Undo all transforms so we're back in true Cocoa coords with
196 // no scaling or flipping.
197 NSAffineTransform *invertTransform;
198 invertTransform = [m_cocoaWxToBoundsTransform copy];
199 [invertTransform invert];
200 [invertTransform concat];
201 [invertTransform release];
204 bool wxDC::CocoaGetBounds(void *rectData)
206 // We don't know what we are so we can't return anything.
210 void wxDC::DoDrawRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height)
212 wxAutoNSAutoreleasePool pool;
213 if(!CocoaTakeFocus()) return;
214 NSBezierPath *bezpath = [NSBezierPath bezierPathWithRect:NSMakeRect(x,y,width,height)];
215 CocoaSetPenForNSBezierPath(m_pen,bezpath);
217 [m_brush.GetNSColor() set];
221 void wxDC::DoDrawLine(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2)
223 wxAutoNSAutoreleasePool pool;
224 if(!CocoaTakeFocus()) return;
225 NSBezierPath *bezpath = [NSBezierPath bezierPath];
226 [bezpath moveToPoint:NSMakePoint(x1,y1)];
227 [bezpath lineToPoint:NSMakePoint(x2,y2)];
229 CocoaSetPenForNSBezierPath(m_pen,bezpath);
233 void wxDC::DoGetTextExtent(const wxString& text, wxCoord *x, wxCoord *y, wxCoord *descent, wxCoord *externalLeading, const wxFont *theFont) const
235 wxAutoNSAutoreleasePool pool;
236 // FIXME: Cache this so it can be used for DoDrawText
237 wxASSERT_MSG(sm_cocoaNSTextStorage && sm_cocoaNSLayoutManager && sm_cocoaNSTextContainer, wxT("Text system has not been initialized. BAD PROGRAMMER!"));
238 NSAttributedString *attributedString = [[NSAttributedString alloc]
239 initWithString:wxNSStringWithWxString(text.c_str())];
240 [sm_cocoaNSTextStorage setAttributedString:attributedString];
241 [attributedString release];
243 NSRange glyphRange = [sm_cocoaNSLayoutManager glyphRangeForTextContainer:sm_cocoaNSTextContainer];
244 NSRect usedRect = [sm_cocoaNSLayoutManager usedRectForTextContainer:sm_cocoaNSTextContainer];
246 *x=(int)usedRect.size.width;
248 *y=(int)usedRect.size.height;
255 void wxDC::DoDrawText(const wxString& text, wxCoord x, wxCoord y)
257 wxAutoNSAutoreleasePool pool;
258 if(!CocoaTakeFocus()) return;
259 wxASSERT_MSG(sm_cocoaNSTextStorage && sm_cocoaNSLayoutManager && sm_cocoaNSTextContainer, wxT("Text system has not been initialized. BAD PROGRAMMER!"));
260 NSAttributedString *attributedString = [[NSAttributedString alloc]
261 initWithString:wxNSStringWithWxString(text.c_str())];
262 [sm_cocoaNSTextStorage setAttributedString:attributedString];
263 [attributedString release];
265 // Set the color (and later font) attributes
266 NSColor *fgColor = m_textForegroundColour.GetNSColor();
267 NSColor *bgColor = m_textBackgroundColour.GetNSColor();
269 fgColor = [NSColor clearColor];
271 bgColor = [NSColor clearColor];
272 NSDictionary *attrDict = [[NSDictionary alloc] initWithObjectsAndKeys:
273 fgColor, NSForegroundColorAttributeName,
274 bgColor, NSBackgroundColorAttributeName,
276 [sm_cocoaNSTextStorage addAttributes: attrDict range:NSMakeRange(0,[sm_cocoaNSTextStorage length])];
279 NSRange glyphRange = [sm_cocoaNSLayoutManager glyphRangeForTextContainer:sm_cocoaNSTextContainer];
280 NSRect usedRect = [sm_cocoaNSLayoutManager usedRectForTextContainer:sm_cocoaNSTextContainer];
281 // NOTE: We'll crash trying to get the location of glyphAtIndex:0 if
282 // there is no length or we don't start at zero
283 if(!glyphRange.length)
285 wxASSERT_MSG(glyphRange.location==0,wxT("glyphRange must begin at zero"));
287 NSAffineTransform *transform = [NSAffineTransform transform];
288 [transform translateXBy:x yBy:y];
290 NSAffineTransform *flipTransform = [NSAffineTransform transform];
292 y' = 0x + -1y + window's height
294 NSAffineTransformStruct matrix = {
297 , 0, usedRect.size.height
299 [flipTransform setTransformStruct: matrix];
301 NSGraphicsContext *context = [NSGraphicsContext currentContext];
302 [context saveGraphicsState];
304 [flipTransform concat];
306 // Draw+fill a rectangle so we can see where the shit is supposed to be.
307 wxLogTrace(wxTRACE_COCOA,wxT("(%f,%f) (%fx%f)"),usedRect.origin.x,usedRect.origin.y,usedRect.size.width,usedRect.size.height);
308 NSBezierPath *bezpath = [NSBezierPath bezierPathWithRect:NSMakeRect(0,0,usedRect.size.width,usedRect.size.height)];
309 [[NSColor blackColor] set];
311 [[NSColor blueColor] set];
315 NSPoint layoutLocation = [sm_cocoaNSLayoutManager locationForGlyphAtIndex:0];
316 layoutLocation.x = 0.0;
317 layoutLocation.y *= -1.0;
319 // Save the location as is for underlining
320 NSPoint underlineLocation = layoutLocation;
322 // Offset the location by the baseline for drawing the glyphs.
323 layoutLocation.y += [[sm_cocoaNSLayoutManager typesetter] baselineOffsetInLayoutManager:sm_cocoaNSLayoutManager glyphIndex:0];
325 if(m_backgroundMode==wxSOLID)
326 [sm_cocoaNSLayoutManager drawBackgroundForGlyphRange:glyphRange atPoint:NSZeroPoint];
327 [sm_cocoaNSLayoutManager drawGlyphsForGlyphRange:glyphRange atPoint:layoutLocation];
329 int underlineStyle = GetFont().GetUnderlined() ? NSUnderlineStyleSingle : NSUnderlineStyleNone;
330 NSRange lineGlyphRange;
331 NSRect lineRect = [sm_cocoaNSLayoutManager lineFragmentRectForGlyphAtIndex:0 effectiveRange:&lineGlyphRange];
333 [sm_cocoaNSLayoutManager underlineGlyphRange:glyphRange underlineType:underlineStyle
334 lineFragmentRect:lineRect lineFragmentGlyphRange:lineGlyphRange
335 containerOrigin:underlineLocation];
337 [context restoreGraphicsState];
340 ///////////////////////////////////////////////////////////////////////////
341 // cut here, the rest is stubs
342 ///////////////////////////////////////////////////////////////////////////
344 //-----------------------------------------------------------------------------
346 //-----------------------------------------------------------------------------
348 void wxDC::DoDrawIcon( const wxIcon &WXUNUSED(icon), int WXUNUSED(x), int WXUNUSED(y) )
352 void wxDC::DoDrawPoint( int x, int y )
356 void wxDC::DoDrawPolygon( int, wxPoint *, int, int, int)
360 void wxDC::DoDrawLines( int, wxPoint *, int, int )
364 int wxDC::GetDepth() const
369 wxSize wxDC::GetPPI() const
374 bool wxDC::CanGetTextExtent() const
379 wxCoord wxDC::GetCharHeight() const
384 wxCoord wxDC::GetCharWidth() const
389 bool wxDC::CanDrawBitmap() const
394 bool wxDC::DoGetPixel(wxCoord x, wxCoord y, wxColour *col) const
399 void wxDC::DoDrawArc(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2, wxCoord xc, wxCoord yc)
403 void wxDC::SetFont(const wxFont& font)
408 void wxDC::SetPen(const wxPen& pen)
413 void wxDC::SetBrush(const wxBrush& brush)
418 void wxDC::DoSetClippingRegionAsRegion(const wxRegion& region)
422 void wxDC::DoSetClippingRegion(wxCoord x, wxCoord y, wxCoord width, wxCoord height)
426 void wxDC::DestroyClippingRegion()
430 void wxDC::DoDrawRoundedRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height, double radius)
434 void wxDC::DoDrawRotatedText(const wxString& text, wxCoord x, wxCoord y, double angle)
438 void wxDC::DoDrawEllipticArc(wxCoord x, wxCoord y, wxCoord w, wxCoord h, double sa, double ea)
442 void wxDC::DoDrawEllipse(wxCoord x, wxCoord y, wxCoord width, wxCoord height)
446 void wxDC::DoDrawBitmap(const wxBitmap &bmp, wxCoord x, wxCoord y, bool useMask)
448 wxAutoNSAutoreleasePool pool;
449 if(!CocoaTakeFocus()) return;
454 // Draw a rect so we can see where it's supposed to be
455 wxLogTrace(wxTRACE_COCOA,wxT("image at (%d,%d) size %dx%d"),x,y,bmp.GetWidth(),bmp.GetHeight());
456 NSBezierPath *bezpath = [NSBezierPath bezierPathWithRect:NSMakeRect(x,y,bmp.GetWidth(),bmp.GetHeight())];
457 [[NSColor blackColor] set];
459 [[NSColor blueColor] set];
463 NSAffineTransform *transform = [NSAffineTransform transform];
464 [transform translateXBy:x yBy:y];
466 NSAffineTransform *flipTransform = [NSAffineTransform transform];
468 y' = 0x + -1y + window's height
470 NSAffineTransformStruct matrix = {
475 [flipTransform setTransformStruct: matrix];
477 NSGraphicsContext *context = [NSGraphicsContext currentContext];
478 [context saveGraphicsState];
480 [flipTransform concat];
482 NSImage *nsimage = [bmp.GetNSImage(useMask) retain];
484 [nsimage drawAtPoint: NSMakePoint(0,0)
485 fromRect: NSMakeRect(0.0,0.0,bmp.GetWidth(),bmp.GetHeight())
486 operation: NSCompositeSourceOver
490 [context restoreGraphicsState];
493 bool wxDC::DoFloodFill(wxCoord x, wxCoord y, const wxColour& col, int style)
498 void wxDC::DoCrossHair(wxCoord x, wxCoord y)
503 bool wxDC::DoBlit(wxCoord xdest, wxCoord ydest, wxCoord width, wxCoord height, wxDC *source, wxCoord xsrc, wxCoord ysrc, int rop, bool useMask , wxCoord xsrcMask, wxCoord ysrcMask)
505 if(!CocoaTakeFocus()) return false;
506 if(!source) return false;
507 return source->CocoaDoBlitOnFocusedDC(xdest,ydest,width,height,
508 xsrc, ysrc, rop, useMask, xsrcMask, ysrcMask);
511 bool wxDC::CocoaDoBlitOnFocusedDC(wxCoord xdest, wxCoord ydest,
512 wxCoord width, wxCoord height, wxCoord xsrc, wxCoord ysrc,
513 int logicalFunc, bool useMask, wxCoord xsrcMask, wxCoord ysrcMask)
518 void wxDC::DoGetSize( int* width, int* height ) const
520 *width = m_maxX-m_minX;
521 *height = m_maxY-m_minY;
524 void wxDC::DoGetSizeMM( int* width, int* height ) const
531 void wxDC::SetTextForeground( const wxColour &col )
534 m_textForegroundColour = col;
537 void wxDC::SetTextBackground( const wxColour &col )
540 m_textBackgroundColour = col;
545 if(!CocoaTakeFocus()) return;
548 if(!CocoaGetBounds(&boundsRect)) return;
550 NSGraphicsContext *context = [NSGraphicsContext currentContext];
551 [context saveGraphicsState];
553 // Undo all transforms so when we draw our bounds rect we
554 // really overwrite our bounds rect.
555 CocoaUnapplyTransformations();
557 [m_backgroundBrush.GetNSColor() set];
558 [NSBezierPath fillRect:boundsRect];
560 [context restoreGraphicsState];
563 void wxDC::SetBackground(const wxBrush& brush)
565 m_backgroundBrush = brush;
568 void wxDC::SetPalette(const wxPalette&)
572 void wxDC::SetLogicalFunction(int)
577 void wxDC::SetMapMode( int mode )
591 SetLogicalScale( 1.0, 1.0 );
594 if (mode != wxMM_TEXT)
599 void wxDC::SetUserScale( double x, double y )
601 // allow negative ? -> no
604 ComputeScaleAndOrigin();
607 void wxDC::SetLogicalScale( double x, double y )
612 ComputeScaleAndOrigin();
615 void wxDC::SetLogicalOrigin( wxCoord x, wxCoord y )
617 m_logicalOriginX = x * m_signX; // is this still correct ?
618 m_logicalOriginY = y * m_signY;
619 ComputeScaleAndOrigin();
622 void wxDC::SetDeviceOrigin( wxCoord x, wxCoord y )
624 ComputeScaleAndOrigin();
627 void wxDC::SetAxisOrientation( bool xLeftRight, bool yBottomUp )
629 m_signX = (xLeftRight ? 1 : -1);
630 m_signY = (yBottomUp ? -1 : 1);
631 ComputeScaleAndOrigin();
634 void wxDC::ComputeScaleAndOrigin(void)
636 // CMB: copy scale to see if it changes
637 double origScaleX = m_scaleX;
638 double origScaleY = m_scaleY;
640 m_scaleX = m_logicalScaleX * m_userScaleX;
641 m_scaleY = m_logicalScaleY * m_userScaleY;
643 // CMB: if scale has changed call SetPen to recalulate the line width
644 if (m_scaleX != origScaleX || m_scaleY != origScaleY)
646 // this is a bit artificial, but we need to force wxDC to think
647 // the pen has changed
648 const wxPen* pen = & GetPen();