gecko-dev/gfx/thebes/PrintTargetSkPDF.h
Jonathan Watt 07bafd2423 Bug 1833244 p1. Create infrastructure to pass page dimensions to PrintTarget::BeginPage. r=dholbert,geckoview-reviewers,jonalmeida
OS print drivers/devices know nothing about page dimensions unless we tell
them. Previously, the physical page dimensions (including orientation) have
always been the same, so communicating their dimensions once at the start of
a print has been enough. In preparation for supporting different "physical"
page dimensions (in the immediate future only different page orientations) when
we save to PDF, we need to have the infrastructure to pass dimensions through
on a page-by-page basis. This patch adds that.

None of the PrintTarget subclasses do anything with this extra information yet,
but in a follow-up patch PrintTargetPDF will use this information to create
PDFs with mixed page orientations.

Differential Revision: https://phabricator.services.mozilla.com/D179423
2023-07-10 14:26:12 +00:00

71 lines
2.3 KiB
C++

/* -*- 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 http://mozilla.org/MPL/2.0/. */
#ifndef MOZILLA_GFX_PRINTTARGETSKPDF_H
#define MOZILLA_GFX_PRINTTARGETSKPDF_H
#include "mozilla/UniquePtr.h"
#include "nsCOMPtr.h"
#include "PrintTarget.h"
#include "skia/include/core/SkCanvas.h"
#include "skia/include/docs/SkPDFDocument.h"
#include "skia/include/core/SkStream.h"
namespace mozilla {
namespace gfx {
/**
* Skia PDF printing target.
*/
class PrintTargetSkPDF final : public PrintTarget {
public:
// The returned PrintTargetSkPDF keeps a raw pointer to the passed SkWStream
// but does not own it. Callers are responsible for ensuring that passed
// stream outlives the returned PrintTarget.
static already_AddRefed<PrintTargetSkPDF> CreateOrNull(
UniquePtr<SkWStream> aStream, const IntSize& aSizeInPoints);
nsresult BeginPrinting(const nsAString& aTitle,
const nsAString& aPrintToFileName, int32_t aStartPage,
int32_t aEndPage) override;
nsresult EndPrinting() override;
void Finish() override;
nsresult BeginPage(const IntSize& aSizeInPoints) override;
nsresult EndPage() override;
already_AddRefed<DrawTarget> MakeDrawTarget(
const IntSize& aSize, DrawEventRecorder* aRecorder = nullptr) final;
already_AddRefed<DrawTarget> GetReferenceDrawTarget() final;
private:
PrintTargetSkPDF(const IntSize& aSize, UniquePtr<SkWStream> aStream);
virtual ~PrintTargetSkPDF();
// Do not hand out references to this object. It holds a non-owning
// reference to mOStreame, so must not outlive mOStream.
sk_sp<SkDocument> mPDFDoc;
// The stream that the SkDocument outputs to.
UniquePtr<SkWStream> mOStream;
// The current page's SkCanvas and its wrapping DrawTarget:
// Canvas is owned by mPDFDoc, which handles its deletion.
SkCanvas* mPageCanvas;
RefPtr<DrawTarget> mPageDT;
// Members needed to provide a reference DrawTarget:
sk_sp<SkDocument> mRefPDFDoc;
// Canvas owned by mRefPDFDoc, which handles its deletion.
SkCanvas* mRefCanvas;
SkDynamicMemoryWStream mRefOStream;
};
} // namespace gfx
} // namespace mozilla
#endif /* MOZILLA_GFX_PRINTTARGETSKPDF_H */