author Cristian Tuns <>
Fri, 24 Sep 2021 14:42:22 -0400
changeset 593147 0b4005ebc9776ff43d99d1427c1a1fd2e14d9a44
parent 449035 66eb1f485c1a3ea81372758bc92292c9428b17cd
permissions -rw-r--r--
Backed out changeset dd075a074e45 (bug 1730518) for causing content crashes (bug 1732479). CLOSED TREE

/* -*- Mode: C++; tab-width: 20; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at */


#include "mozilla/Attributes.h"

#include "mozilla/gfx/2D.h"
#include "mozilla/gfx/BorrowedContext.h"
#include "mozilla/RefPtr.h"

class gfxQuartzNativeDrawing {
  typedef mozilla::gfx::DrawTarget DrawTarget;
  typedef mozilla::gfx::Rect Rect;

  /* Create native Quartz drawing for a rectangle bounded by
   * nativeRect.
   * Typical usage looks like:
   *   gfxQuartzNativeDrawing nativeDraw(ctx, nativeRect);
   *   CGContextRef cgContext = nativeDraw.BeginNativeDrawing();
   *   if (!cgContext)
   *     return NS_ERROR_FAILURE;
   *     ... call Quartz operations on CGContextRef to draw to nativeRect ...
   *   nativeDraw.EndNativeDrawing();
   * aNativeRect is the size of the surface (in Quartz/Cocoa points) that
   * will be created _if_ the gfxQuartzNativeDrawing decides to create a new
   * surface and CGContext for its drawing operations, which it then
   * composites into the target DrawTarget.
   * (Note that aNativeRect will be ignored if the gfxQuartzNativeDrawing
   * uses the target DrawTarget directly.)
   * The optional aBackingScale parameter is a scaling factor that will be
   * applied when creating and rendering into such a temporary surface.
  gfxQuartzNativeDrawing(DrawTarget& aDrawTarget, const Rect& aNativeRect);

  /* Returns a CGContextRef which may be used for native drawing.  This
   * CGContextRef is valid until EndNativeDrawing is called; if it is used
   * for drawing after that time, the result is undefined. */
  CGContextRef BeginNativeDrawing();

  /* Marks the end of native drawing */
  void EndNativeDrawing();

  // don't allow copying via construction or assignment
  gfxQuartzNativeDrawing(const gfxQuartzNativeDrawing&) = delete;
  const gfxQuartzNativeDrawing& operator=(const gfxQuartzNativeDrawing&) =

  // Final destination context
  RefPtr<DrawTarget> mDrawTarget;
  RefPtr<DrawTarget> mTempDrawTarget;
  mozilla::gfx::BorrowedCGContext mBorrowedContext;
  mozilla::gfx::Rect mNativeRect;

  // saved state
  CGContextRef mCGContext;