mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-02 07:05:24 +00:00
77 lines
2.7 KiB
C++
77 lines
2.7 KiB
C++
/* -*- Mode: C++; tab-width: 20; indent-tabs-mode: nil; c-basic-offset: 4 -*-
|
|
* 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 http://mozilla.org/MPL/2.0/. */
|
|
|
|
#ifndef _GFXQUARTZNATIVEDRAWING_H_
|
|
#define _GFXQUARTZNATIVEDRAWING_H_
|
|
|
|
#include "mozilla/Attributes.h"
|
|
|
|
#include "gfxContext.h"
|
|
#include "gfxQuartzSurface.h"
|
|
#include "mozilla/gfx/BorrowedContext.h"
|
|
|
|
class gfxQuartzNativeDrawing {
|
|
public:
|
|
|
|
/* 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 gfxContext.
|
|
*
|
|
* (Note that aNativeRect will be ignored if the gfxQuartzNativeDrawing
|
|
* uses the target gfxContext directly.)
|
|
*
|
|
* The optional aBackingScale parameter is a scaling factor that will be
|
|
* applied when creating and rendering into such a temporary surface.
|
|
*/
|
|
gfxQuartzNativeDrawing(gfxContext *ctx,
|
|
const gfxRect& aNativeRect,
|
|
gfxFloat aBackingScale = 1.0f);
|
|
|
|
/* 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();
|
|
|
|
private:
|
|
// don't allow copying via construction or assignment
|
|
gfxQuartzNativeDrawing(const gfxQuartzNativeDrawing&) MOZ_DELETE;
|
|
const gfxQuartzNativeDrawing& operator=(const gfxQuartzNativeDrawing&) MOZ_DELETE;
|
|
|
|
|
|
// Final destination context
|
|
nsRefPtr<gfxContext> mContext;
|
|
mozilla::RefPtr<mozilla::gfx::DrawTarget> mDrawTarget;
|
|
mozilla::gfx::BorrowedCGContext mBorrowedContext;
|
|
// context that draws to mQuartzSurface; can be different from mContext
|
|
// if mContext is not drawing to Quartz
|
|
nsRefPtr<gfxContext> mSurfaceContext;
|
|
gfxRect mNativeRect;
|
|
gfxFloat mBackingScale;
|
|
|
|
// saved state
|
|
nsRefPtr<gfxQuartzSurface> mQuartzSurface;
|
|
CGContextRef mCGContext;
|
|
};
|
|
|
|
#endif
|