libs-back/Source/opal/OpalGState.m

/*
   OpalGState.m

   Copyright (C) 2013 Free Software Foundation, Inc.

   Author: Ivan Vucica <ivan@vucica.net>
   Date: June 2013

   This file is part of GNUstep.

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with this library; see the file COPYING.LIB.
   If not, see <http://www.gnu.org/licenses/> or write to the
   Free Software Foundation, 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
*/

#import <CoreGraphics/CoreGraphics.h>
#import <AppKit/NSGraphics.h> // NS*ColorSpace
#import <AppKit/NSAffineTransform.h>
#import <AppKit/NSBezierPath.h>
#import "opal/OpalGState.h"
#import "opal/OpalSurface.h"
#import "opal/OpalFontInfo.h"

#define CGCTX [self CGContext]

static inline NSString * _CGRectRepr(CGRect rect)
{
  return [NSString stringWithFormat: @"(%g,%g,%g,%g)",
          rect.origin.x, rect.origin.y,
          rect.size.width, rect.size.height];
}

static inline CGRect _CGRectFromNSRect(NSRect nsrect)
{
  return CGRectMake(nsrect.origin.x, nsrect.origin.y,
                    nsrect.size.width, nsrect.size.height);
}

static inline NSPoint _NSPointFromCGPoint(CGPoint cgpoint)
{
  return NSMakePoint(cgpoint.x, cgpoint.y);
}

@implementation OpalGState

- (id)copyWithZone: (NSZone *)zone
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  OpalGState * theCopy = (OpalGState *) [super copyWithZone: zone];
  CGContextRef cgctx = CGCTX;

  [_opalSurface retain];
  if (cgctx)
    {
      theCopy->_opGState = OPContextCopyGState(cgctx);
    }
  return theCopy;
}

- (void) setOffset: (NSPoint)theOffset
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - %g %g", self, [self class], __PRETTY_FUNCTION__, theOffset.x, theOffset.y);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      OPContextSetCairoDeviceOffset(cgctx, -theOffset.x,
          theOffset.y - [_opalSurface size].height);
    }
  [super setOffset: theOffset];
}

@end

@implementation OpalGState (Ops)

- (void) DPSsetalpha: (CGFloat)a
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - alpha %g", self, [self class], __PRETTY_FUNCTION__, a);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextSetAlpha(cgctx, a);
    }
  [super DPSsetalpha: a];
}

- (void) DPSsetgray: (CGFloat)gray
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  const CGFloat alpha = 1.0; // TODO: is this correct?
  if (cgctx)
    {
      CGContextSetGrayStrokeColor(cgctx, gray, alpha);
      CGContextSetGrayFillColor(cgctx, gray, alpha);
    }
  [super DPSsetgray: gray];
}

- (void) DPSsetrgbcolor: (CGFloat)r : (CGFloat)g : (CGFloat)b
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  const CGFloat alpha = 1.0; // TODO: is this correct?
  if (cgctx)
    {
      CGContextSetRGBStrokeColor(cgctx, r, g, b, alpha);
      CGContextSetRGBFillColor(cgctx, r, g, b, alpha);
    }
  [super DPSsetrgbcolor: r : g : b];
}

- (void) DPSsetcmykcolor: (CGFloat)c : (CGFloat)m : (CGFloat)y : (CGFloat)k
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  const CGFloat alpha = 1.0; // TODO: is this correct?
  if (cgctx)
    {
      CGContextSetCMYKFillColor(cgctx, c, m, y, k, alpha);
      CGContextSetCMYKStrokeColor(cgctx, c, m, y, k, alpha);
    }
  [super DPSsetcmykcolor: c : m : y : k];
}


- (void) DPSshow: (const char *)s
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextSaveGState(cgctx);
      CGContextSetRGBFillColor(cgctx, 0, 1, 0, 1);
      CGContextFillRect(cgctx, CGRectMake(0, 0, strlen(s) * 12, 12));
      CGContextRestoreGState(cgctx);
    }
}

- (void) GSShowText: (const char *)s  : (size_t) length
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextSaveGState(cgctx);
      CGContextSetRGBFillColor(cgctx, 0, 1, 0, 1);
      CGContextFillRect(cgctx, CGRectMake(0, 0, length * 12, 12));
      CGContextRestoreGState(cgctx);
      // TODO: implement!
    }
}

- (void) GSSetFont: (GSFontInfo *)fontref
{
  const CGFloat * matrix;
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  [super GSSetFont: fontref];

  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGFontRef opalFont = (CGFontRef)[((OpalFontInfo *)fontref)->_faceInfo fontFace];
      CGContextSetFont(cgctx, opalFont);
      CGContextSetFontSize(cgctx, 1);
      matrix = [fontref matrix];
      CGAffineTransform cgAT = CGAffineTransformMake(matrix[0], matrix[1],
                                                 matrix[2], matrix[3],
                                                 matrix[4], matrix[5]);
      CGContextSetTextMatrix(cgctx, cgAT);
    }
}

- (void) GSShowGlyphsWithAdvances: (const NSGlyph *)glyphs : (const NSSize *)advances : (size_t) length
{
  size_t i;
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);

  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      // NSGlyph = unsigned int, CGGlyph = unsigned short
      CGGlyph cgglyphs[length];

      for (i = 0; i < length; i++)
        {
          cgglyphs[i] = glyphs[i];
        }

      CGPoint pt = CGContextGetPathCurrentPoint(cgctx);
      // FIXME: why * 0.66?
      pt.y += [self->font defaultLineHeightForFont] * 0.66;
      CGContextSetTextPosition(cgctx, pt.x, pt.y);
      CGContextShowGlyphsWithAdvances(cgctx, cgglyphs, (const CGSize *)advances,
                                      length);
    }
}

- (NSPoint) currentPoint
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGPoint pt = CGContextGetPathCurrentPoint(cgctx);
      return _NSPointFromCGPoint(pt);
    }
  else
    {
      return NSZeroPoint;
    }
}

- (void) DPSsetdash: (const CGFloat*)pat
                   : (NSInteger)size
                   : (CGFloat)dashOffset
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);

  if (!pat && size != 0)
    {
      NSLog(@"%s: null 'pat' passed with size %d. Fixing by setting size to 0.", pat, (int)size);
      size = 0;
      // TODO: looking at opal, it does not seem to have a tolerance for
      // pat=NULL although CGContextSetLineDash() explicitly specifies that
      // as a possible argument
    }
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextSetLineDash(cgctx, dashOffset, pat, size);
    }
}

- (void) DPSsetlinecap: (int)linecap
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);

  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      // TODO: ensure match of linecap constants between Opal and DPS
      CGContextSetLineCap(cgctx, linecap);
    }
}

- (void) DPSsetlinejoin: (int)linejoin
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextSetLineJoin(cgctx, linejoin);
    }
}

- (void) DPSsetlinewidth: (CGFloat) width
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextSetLineWidth(cgctx, width);
    }
}

- (void) DPSsetmiterlimit: (CGFloat)miterlimit
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextSetMiterLimit(cgctx, miterlimit);
    }
}

- (void) DPSsetstrokeadjust: (int) b
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);

  // TODO: Opal doesn't implement this private API of Core Graphics
}

/* Matrix operations */
- (void)DPSconcat: (const CGFloat *)m
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - %g %g %g %g %g %g", self,
              [self class], __PRETTY_FUNCTION__,
              m[0], m[1], m[2], m[3], m[4], m[5]);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextConcatCTM(cgctx,
                         CGAffineTransformMake(m[0], m[1], m[2],
                                               m[3], m[4], m[5]));
    }
  [super DPSconcat: m];
}

- (void)DPSinitmatrix
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      OPContextSetIdentityCTM(cgctx);
    }
  [super DPSinitmatrix];
}

- (void)DPSrotate: (CGFloat)angle
{
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextRotateCTM(cgctx, angle);
    }
  [super DPSrotate: angle];
}

- (void)DPSscale: (CGFloat)x
                : (CGFloat)y
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - %g %g", self, [self class], __PRETTY_FUNCTION__, x, y);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextScaleCTM(cgctx, x, y);
    }
  [super DPSscale: x : y];
}

- (void)DPStranslate: (CGFloat)x
                    : (CGFloat)y
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - x %g y %g", self, [self class], __PRETTY_FUNCTION__, x, y);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextTranslateCTM(cgctx, x, y);
    }
  [super DPStranslate: x: y];
}

- (NSAffineTransform *) GSCurrentCTM
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);

  return [super GSCurrentCTM];

  /*
  CGAffineTransform cgCTM = CGContextGetCTM(CGCTX);
  NSAffineTransform * affineTransform = [NSAffineTransform transform];

  // This depends on CGAffineTransform and NSAffineTransformStruct having
  // the same in-memory layout.
  // Here's an elementary check if that is true.
  // We should probably check this in -back's "configure" script.
  assert(sizeof(CGAffineTransform) == sizeof(NSAffineTransformStruct));

  NSAffineTransformStruct nsCTM = *(NSAffineTransformStruct *)&cgCTM;
  [affineTransform setTransformStruct: nsCTM];

  return affineTransform;
  */
}

- (void) GSSetCTM: (NSAffineTransform *)newCTM
{
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      // This depends on CGAffineTransform and NSAffineTransformStruct having
      // the same in-memory layout.
      // Here's an elementary check if that is true.
      // We should probably check this in -back's "configure" script.
      assert(sizeof(CGAffineTransform) == sizeof(NSAffineTransformStruct));
      NSAffineTransformStruct nsAT = [newCTM transformStruct];
      CGAffineTransform cgAT = *(CGAffineTransform *)&nsAT;

      OPContextSetIdentityCTM(cgctx);
      CGContextConcatCTM(cgctx, cgAT);
    }

  [super GSSetCTM: newCTM];
}

- (void) GSConcatCTM: (NSAffineTransform *)newCTM
{
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      assert(sizeof(CGAffineTransform) == sizeof(NSAffineTransformStruct));
      NSAffineTransformStruct nsAT = [newCTM transformStruct];
      CGAffineTransform cgAT = *(CGAffineTransform *)&nsAT;

      CGContextConcatCTM(cgctx, cgAT);
    }

  [super GSConcatCTM: newCTM];
}


// MARK: Path operations
// MARK: -

- (void) DPSarc: (CGFloat)x : (CGFloat)y : (CGFloat)r : (CGFloat)angle1 : (CGFloat)angle2
{
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextAddArc(cgctx, x, y, r, angle1, angle2, YES);
    }
  [super DPSarc: x : y : r : angle1 : angle2];
}

- (void) DPSarcn: (CGFloat)x : (CGFloat)y : (CGFloat)r : (CGFloat)angle1 : (CGFloat)angle2
{
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextAddArc(cgctx, x, y, r, angle1, angle2, NO);
    }
  [super DPSarcn: x : y : r : angle1 : angle2];
}

- (void)DPSarct: (CGFloat)x1 : (CGFloat)y1 : (CGFloat)x2 : (CGFloat)y2 : (CGFloat)r
{
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextAddArcToPoint(cgctx, x1, y1, x1, y2, r);
    }
  [super DPSarct: x1 : y1 : x2 : y2 : r];
}

- (void) DPSclip
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextClip(cgctx);
    }
  [super DPSnewpath];
}

- (void)DPSclosepath
{
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextClosePath(cgctx);
    }
  [super DPSclosepath];
}

- (void)DPScurveto: (CGFloat)x1 : (CGFloat)y1 : (CGFloat)x2 : (CGFloat)y2
                  : (CGFloat)x3 : (CGFloat)y3
{
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextAddCurveToPoint(cgctx, x1, y1, x2, y2, x3, y3);
    }
  [super DPScurveto: x1 : y1 : x2 : y2 : x3 : y3];
}

- (void) DPSeoclip
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextEOClip(cgctx);
    }
  [super DPSnewpath];
}

- (void) DPSeofill
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextEOFillPath(cgctx);
    }
  [super DPSnewpath];
}

- (void) DPSfill
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextFillPath(cgctx);
    }
  [super DPSnewpath];
}

- (void) DPSinitclip
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      OPContextResetClip(cgctx);
    }
}

- (void) DPSlineto: (CGFloat) x
                  : (CGFloat) y
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - %g %g", self, [self class], __PRETTY_FUNCTION__, x, y);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextAddLineToPoint(cgctx, x, y);
    }
  [super DPSlineto: x : y];
}

- (void) DPSmoveto: (CGFloat) x
                  : (CGFloat) y
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - %g %g", self, [self class], __PRETTY_FUNCTION__, x, y);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextMoveToPoint(cgctx, x, y);
    }
  [super DPSmoveto: x : y];
}

- (void)DPSnewpath
{
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextBeginPath(cgctx);
    }
  [super DPSnewpath];
}

- (void)DPSrcurveto: (CGFloat)x1 : (CGFloat)y1 : (CGFloat)x2 : (CGFloat)y2
                   : (CGFloat)x3 : (CGFloat)y3
{
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGFloat x, y;

      [self DPScurrentpoint: &x : &y];
      x1 += x;
      y1 += y;
      x2 += x;
      y2 += y;
      x3 += x;
      y3 += y;
      CGContextAddCurveToPoint(cgctx, x1, y1, x2, y2, x3, y3);
    }
  [super DPSrcurveto: x1 : y1 : x2 : y2 : x3 : y3];
}

- (void) DPSrectclip: (CGFloat)x : (CGFloat)y : (CGFloat)w : (CGFloat)h
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - %g %g %g %g", self, [self class], __PRETTY_FUNCTION__, x, y, w, h);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextClipToRect(cgctx, CGRectMake(x, y, w, h));
    }
}

- (void) DPSrectfill: (CGFloat)x : (CGFloat)y : (CGFloat)w : (CGFloat)h
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - rect %g %g %g %g", self, [self class], __PRETTY_FUNCTION__, x, y, w, h);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextFillRect(cgctx, CGRectMake(x, y, w, h));
    }
}

- (void) DPSrectstroke: (CGFloat)x : (CGFloat)y : (CGFloat)w : (CGFloat)h
{
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextStrokeRect(cgctx, CGRectMake(x, y, w, h));
    }
}

- (void) DPSrlineto: (CGFloat) x
                   : (CGFloat) y
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - %g %g", self, [self class], __PRETTY_FUNCTION__, x, y);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGFloat x2, y2;

      [self DPScurrentpoint: &x2 : &y2];
      x2 += x;
      y2 += y;
      CGContextAddLineToPoint(cgctx, x, y);
    }
  [super DPSrlineto: x : y];
}

- (void) DPSrmoveto: (CGFloat) x
                   : (CGFloat) y
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - %g %g", self, [self class], __PRETTY_FUNCTION__, x, y);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGFloat x2, y2;

      [self DPScurrentpoint: &x2 : &y2];
      x2 += x;
      y2 += y;
      CGContextMoveToPoint(cgctx, x2, y2);
    }
  [super DPSrmoveto: x : y];
}

- (void) DPSstroke
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextStrokePath(cgctx);
    }
  [super DPSnewpath];
}

- (void) GSSendBezierPath: (NSBezierPath *)newpath
{
  NSInteger count = [newpath elementCount];
  NSInteger i;
  SEL elmsel = @selector(elementAtIndex:associatedPoints:);
  NSBezierPathElement (*elmidx)(id, SEL, NSInteger, NSPoint*) =
    (NSBezierPathElement (*)(id, SEL, NSInteger, NSPoint*))[newpath methodForSelector: elmsel];

  [super GSSendBezierPath: newpath];
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextBeginPath(cgctx);
      for (i = 0; i < count; i++)
        {
          NSBezierPathElement type;
          NSPoint points[3];

          type = (NSBezierPathElement)(*elmidx)(newpath, elmsel, i, points);
          switch(type)
            {
            case NSMoveToBezierPathElement:
              CGContextMoveToPoint(cgctx, points[0].x, points[0].y);
              break;
            case NSLineToBezierPathElement:
              CGContextAddLineToPoint(cgctx, points[0].x, points[0].y);
              break;
            case NSCurveToBezierPathElement:
              CGContextAddCurveToPoint(cgctx, points[0].x, points[0].y,
                                       points[1].x, points[1].y,
                                       points[2].x, points[2].y);
              break;
            case NSClosePathBezierPathElement:
              CGContextClosePath(cgctx);
              break;
            default:
              break;
            }
        }
    }
}

- (NSDictionary *) GSReadRect: (NSRect)r
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  return nil;
}

- (void) DPSimage: (NSAffineTransform *)matrix
                 : (NSInteger)pixelsWide
		 : (NSInteger)pixelsHigh
                 : (NSInteger)bitsPerSample // is this used correctly ?
		 : (NSInteger)samplesPerPixel // < unused
                 : (NSInteger)bitsPerPixel
		 : (NSInteger)bytesPerRow
                 : (BOOL)isPlanar // < unused
		 : (BOOL)hasAlpha
                 : (NSString *)colorSpaceName
		 : (const unsigned char *const[5])data
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  NSDebugLLog(@"OpalGState", @"         %s - %@ - cgctx %@", __PRETTY_FUNCTION__, _opalSurface, [self CGContext]);
  NSDebugLLog(@"OpalGState", @"Bits per component : bitspersample = %d", bitsPerSample);
  NSDebugLLog(@"OpalGState", @"Bits per pixel     : bitsperpixel = %d", bitsPerPixel);
  NSDebugLLog(@"OpalGState", @"                   : samplesperpixel = %d", samplesPerPixel);
  NSDebugLLog(@"OpalGState", @"tf: %@ x %@", matrix, [self GSCurrentCTM]);

  // TODO:
  // We may want to normalize colorspace names between Opal and -gui,
  // to avoid this conversion?
  if ([colorSpaceName isEqualToString: NSCalibratedRGBColorSpace])
    colorSpaceName = kCGColorSpaceGenericRGB; // SRGB?
  else if ([colorSpaceName isEqualToString: NSDeviceRGBColorSpace])
    colorSpaceName = kCGColorSpaceGenericRGB;
  else if ([colorSpaceName isEqualToString: NSCalibratedWhiteColorSpace])
    colorSpaceName = kCGColorSpaceGenericGray;
  else if ([colorSpaceName isEqualToString: NSDeviceWhiteColorSpace])
    colorSpaceName = kCGColorSpaceGenericGray;
  else
    {
      NSLog(@"Opal backend: Unhandled colorspace: %@", colorSpaceName);
      return;
    }

  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      // This depends on CGAffineTransform and NSAffineTransformStruct having
      // the same in-memory layout.
      // Here's an elementary check if that is true.
      // We should probably check this in -back's "configure" script.
      assert(sizeof(CGAffineTransform) == sizeof(NSAffineTransformStruct));
      NSAffineTransformStruct nsAT = [matrix transformStruct];
      CGAffineTransform cgAT = *(CGAffineTransform *)&nsAT;

      CGContextSaveGState(cgctx);
      CGContextConcatCTM(cgctx, cgAT);

      CGColorSpaceRef colorSpace = CGColorSpaceCreateWithName(colorSpaceName);
      NSData *nsData = [NSData dataWithBytesNoCopy: (void*)*data
                                            length: pixelsHigh * bytesPerRow
                                      freeWhenDone: NO];
      CGDataProviderRef dataProvider = CGDataProviderCreateWithCFData(nsData);
      CGImageRef img = CGImageCreate(pixelsWide, pixelsHigh, bitsPerSample,
                                     bitsPerPixel, bytesPerRow, colorSpace,
                                     kCGBitmapByteOrder32Big | (hasAlpha ? kCGImageAlphaPremultipliedLast : 0),
                                     dataProvider,
                                     NULL, /* const CGFloat decode[] is what? */
                                     false, /* shouldInterpolate? */
                                     kCGRenderingIntentDefault );
      if (img != nil)
        {
          CGContextDrawImage(cgctx, CGRectMake(0, 0, pixelsWide, pixelsHigh), img);
        }

      CGImageRelease(img);
      CGDataProviderRelease(dataProvider);
      CGColorSpaceRelease(colorSpace);
      CGContextRestoreGState(cgctx);
    }
}

- (void) compositeGState: (OpalGState *)source
                fromRect: (NSRect)srcRect
                 toPoint: (NSPoint)destPoint
                      op: (NSCompositingOperation)op
                fraction: (CGFloat)delta
           destCGContext: (CGContextRef) destCGContext
{
  // NOTE: This method seems to need to paint to X11 context, too.

  NSDebugLLog(@"OpalGState", @"%p (%@): %s - from %@ of gstate %p (cgctx %p) to %@ of %p (cgctx %p)", self, [self class], __PRETTY_FUNCTION__, NSStringFromRect(srcRect), source, [source CGContext], NSStringFromPoint(destPoint), self, [self CGContext]);

  NSSize ssize = [source->_opalSurface size];
  srcRect = [source rectInMatrixSpace: srcRect];
  destPoint = [self pointInMatrixSpace: destPoint];

  srcRect.origin.y = ssize.height-srcRect.origin.y-srcRect.size.height;

  CGRect srcCGRect = _CGRectFromNSRect(srcRect);
  CGRect destCGRect = CGRectMake(destPoint.x, destPoint.y,
                                 srcRect.size.width, srcRect.size.height);
  NSDebugLLog(@"OpalGState", @"Source cgctx: %p, self: %p - from %@ to %@ with ctm %@", [source CGContext], self, _CGRectRepr(srcCGRect), _CGRectRepr(destCGRect), [self GSCurrentCTM]);
  // FIXME: this presumes that the backing CGContext of 'source' is
  // an OpalSurface with a backing CGBitmapContext
  CGImageRef backingImage = CGBitmapContextCreateImage([source CGContext]);
  CGImageRef subImage = CGImageCreateWithImageInRect(backingImage, srcCGRect);

  CGContextSaveGState(destCGContext);
  OPContextSetIdentityCTM(destCGContext);
  OPContextSetCairoDeviceOffset(destCGContext, 0, 0);

  // TODO: this ignores op
  // TODO: this ignores delta
  CGContextDrawImage(destCGContext, destCGRect, subImage);

  OPContextSetCairoDeviceOffset(CGCTX, -offset.x,
      offset.y - [_opalSurface size].height);

  CGContextRestoreGState(destCGContext);

  CGImageRelease(subImage);
  CGImageRelease(backingImage);
}

- (void) compositeGState: (OpalGState *)source
                fromRect: (NSRect)srcRect
                 toPoint: (NSPoint)destPoint
                      op: (NSCompositingOperation)op
                fraction: (CGFloat)delta
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef destContexts[2] = { [_opalSurface backingCGContext], [_opalSurface x11CGContext] };

  /* x11 context needs to have correct ctm applied */
  CGContextSaveGState([_opalSurface x11CGContext]);
  OPContextSetIdentityCTM([_opalSurface x11CGContext]);
  CGContextConcatCTM([_opalSurface x11CGContext], CGContextGetCTM([_opalSurface backingCGContext]));

  int i;
  for (i = 0; i < 1; i++) // not drawing into x11cgctx after all.
    {
      CGContextRef ctx = destContexts[i];

      [self compositeGState: source
                   fromRect: srcRect
                    toPoint: destPoint
                         op: op
                   fraction: delta
              destCGContext: ctx];
    }

  /* restore x11 context's previous state */
  CGContextRestoreGState([_opalSurface x11CGContext]);
}

/** Unlike -compositeGState, -drawGSstate fully respects the AppKit CTM but
doesn't support to use the receiver cairo target as the source. */
/* This method is required if -[OpalContext supportsDrawGState] returns YES */
- (void) drawGState: (OpalGState *)source
           fromRect: (NSRect)srcRect
            toPoint: (NSPoint)destPoint
                 op: (NSCompositingOperation)op
           fraction: (CGFloat)delta
      destCGContext: (CGContextRef)destCGContext
{
  // TODO: CairoGState has a lot more complex implementation.
  // For now, we'll just call compositeGState and live
  // with the fact that CTM is not respected.

  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);

  CGRect srcCGRect = CGRectMake(srcRect.origin.x, srcRect.origin.y,
                                srcRect.size.width, srcRect.size.height);
  CGRect destCGRect = CGRectMake(destPoint.x, destPoint.y,
                                 srcRect.size.width, srcRect.size.height);
  CGImageRef backingImage = CGBitmapContextCreateImage([source CGContext]);
  CGImageRef subImage = CGImageCreateWithImageInRect(backingImage, srcCGRect);
  // TODO: this ignores op
  // TODO: this ignores delta
  CGContextDrawImage(destCGContext, destCGRect, subImage);
  CGImageRelease(subImage);
  CGImageRelease(backingImage);
}

- (void) drawGState: (OpalGState *)source
           fromRect: (NSRect)srcRect
            toPoint: (NSPoint)destPoint
                 op: (NSCompositingOperation)op
           fraction: (CGFloat)delta
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGContextRef destContexts[2] = { [_opalSurface backingCGContext], [_opalSurface x11CGContext] };
  int i;

  for (i = 0; i < 1; i++)
    {
      CGContextRef ctx = destContexts[i];

      [self drawGState: source
              fromRect: srcRect
               toPoint: destPoint
                    op: op
              fraction: delta
         destCGContext: ctx];
    }
}

- (void) compositerect: (NSRect)aRect
                    op: (NSCompositingOperation)op
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - %@", self, [self class], __PRETTY_FUNCTION__, NSStringFromRect(aRect));
  CGContextRef cgctx = CGCTX;

  if (cgctx)
    {
      CGContextSaveGState(cgctx);
      OPContextSetIdentityCTM(cgctx);
      // FIXME: Set operator
      CGContextFillRect(cgctx,
                        CGRectMake(aRect.origin.x,
                                   [_opalSurface size].height -  aRect.origin.y,
                                   aRect.size.width, aRect.size.height));
      CGContextRestoreGState(cgctx);
    }
}

@end

// MARK: Initialization methods
// MARK: -

@implementation OpalGState (InitializationMethods)

- (void) DPSinitgraphics
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);

  [super DPSinitgraphics];
  [self DPSinitmatrix];
}

/* SOME NOTES:
   - GState approximates a cairo context: a drawing state.
   - Surface approximates a cairo surface: a place to draw things.

   - CGContext seems to be a mix of these two: surface + state.

   Should we unite these two somehow? Can we unite these two somehow?
   Possibly not. We still need to support bitmap contexts, pdf contexts
   etc which contain both state and contents.

   So, we will still need surfaces (containing CGContexts, hence including
   state) and GState as a wrapper around whatever context happens to be
   the current one.
 */

/**
  Makes the specified surface active in the current graphics state,
  ready for use. Also, sets the device offset to specified coordinates.
 **/
- (void) GSSetSurface: (OpalSurface *)opalSurface
                     : (int)x
                     : (int)y
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s - %@ %d %d", self, [self class], __PRETTY_FUNCTION__, opalSurface, x, y);

  ASSIGN(_opalSurface, opalSurface);
  [self setOffset: NSMakePoint(x, y)];
  [self DPSinitgraphics];
}

- (void) GSCurrentSurface: (OpalSurface **)surface
                         : (int *)x
                         : (int *)y
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);

  if (x)
    *x = offset.x;
  if (y)
    *y = offset.y;
  if (surface)
    {
      *surface = _opalSurface;
    }
}

@end

// MARK: Accessors
// MARK: -

@implementation OpalGState (Accessors)

- (CGContextRef) CGContext
{
  if (!_opalSurface)
    {
      NSDebugMLLog(@"OpalGState", @"No OpalSurface");
      return nil;
    }
  else
    {
      CGContextRef context = [_opalSurface CGContext];

      if (!context)
        {
          NSDebugMLLog(@"OpalGState", @"No OpalSurface CGContext");
          return nil;
        }
      return context;
    }
}

- (OPGStateRef) OPGState
{
  return _opGState;
}

- (void) setOPGState: (OPGStateRef)opGState
{
  ASSIGN(_opGState, opGState);
}

@end

// MARK: Non-required methods
// MARK: -
@implementation OpalGState (NonrequiredMethods)

- (void) DPSgsave
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  if (CGCTX)
    {
      CGContextSaveGState(CGCTX);
    }
}

- (void) DPSgrestore
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  if (CGCTX)
    {
      CGContextRestoreGState(CGCTX);
    }
}

@end

@implementation OpalGState (PatternColor)

- (void *) saveClip
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  CGRect * r = calloc(sizeof(CGRect), 1);
  *r = CGContextGetClipBoundingBox(CGCTX);
  return r;
}

- (void) restoreClip: (void *)savedClip
{
  NSDebugLLog(@"OpalGState", @"%p (%@): %s", self, [self class], __PRETTY_FUNCTION__);
  OPContextResetClip(CGCTX);
  CGContextClipToRect(CGCTX, *(CGRect *)savedClip);
  free(savedClip);
}

@end