summaryrefslogtreecommitdiffstats
path: root/layout/generic/nsPageSequenceFrame.h
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 19:33:14 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 19:33:14 +0000
commit36d22d82aa202bb199967e9512281e9a53db42c9 (patch)
tree105e8c98ddea1c1e4784a60a5a6410fa416be2de /layout/generic/nsPageSequenceFrame.h
parentInitial commit. (diff)
downloadfirefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.tar.xz
firefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.zip
Adding upstream version 115.7.0esr.upstream/115.7.0esrupstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r--layout/generic/nsPageSequenceFrame.h191
1 files changed, 191 insertions, 0 deletions
diff --git a/layout/generic/nsPageSequenceFrame.h b/layout/generic/nsPageSequenceFrame.h
new file mode 100644
index 0000000000..06293192b0
--- /dev/null
+++ b/layout/generic/nsPageSequenceFrame.h
@@ -0,0 +1,191 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=8 sts=2 et sw=2 tw=80: */
+/* 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 nsPageSequenceFrame_h___
+#define nsPageSequenceFrame_h___
+
+#include "mozilla/Attributes.h"
+#include "mozilla/UniquePtr.h"
+#include "nsContainerFrame.h"
+#include "nsIPrintSettings.h"
+
+namespace mozilla {
+
+class PresShell;
+class PrintedSheetFrame;
+
+namespace dom {
+
+class HTMLCanvasElement;
+
+} // namespace dom
+} // namespace mozilla
+
+//-----------------------------------------------
+// This class is used to manage some static data about the layout
+// characteristics of our various "Pages Per Sheet" options.
+struct nsPagesPerSheetInfo {
+ static const nsPagesPerSheetInfo& LookupInfo(int32_t aPPS);
+
+ uint16_t mNumPages;
+
+ // This is the larger of the row-count vs. column-count for this layout
+ // (if they aren't the same). We'll aim to stack this number of pages
+ // in the sheet's longer axis.
+ uint16_t mLargerNumTracks;
+};
+
+/**
+ * This class maintains various shared data that is used by printing-related
+ * frames. The nsPageSequenceFrame strongly owns an instance of this class,
+ * which lives for as long as the nsPageSequenceFrame does.
+ */
+class nsSharedPageData {
+ public:
+ nsString mDateTimeStr;
+ nsString mPageNumFormat;
+ nsString mPageNumAndTotalsFormat;
+ nsString mDocTitle;
+ nsString mDocURL;
+ nsFont mHeadFootFont;
+
+ // Total number of pages (populated by PrintedSheetFrame when it determines
+ // that it's reflowed the final page):
+ int32_t mRawNumPages = 0;
+
+ // If there's more than one page-range, then its components are stored here
+ // as pairs of (start,end). They're stored in the order provided (not
+ // necessarily in ascending order).
+ nsTArray<int32_t> mPageRanges;
+
+ // Margin for headers and footers; it defaults to 4/100 of an inch on UNIX
+ // and 0 elsewhere; I think it has to do with some inconsistency in page size
+ // computations
+ nsMargin mEdgePaperMargin;
+
+ nsCOMPtr<nsIPrintSettings> mPrintSettings;
+
+ // The scaling ratio we need to apply to make all pages fit horizontally. It's
+ // the minimum "ComputedWidth / OverflowWidth" ratio of all page content
+ // frames that overflowed. It's 1.0 if none overflowed horizontally.
+ float mShrinkToFitRatio = 1.0f;
+
+ // Lazy getter, to look up our pages-per-sheet info based on mPrintSettings
+ // (if it's available). The result is stored in our mPagesPerSheetInfo
+ // member-var to speed up subsequent lookups.
+ // This API is infallible; in failure cases, it just returns the info struct
+ // that corresponds to 1 page per sheet.
+ const nsPagesPerSheetInfo* PagesPerSheetInfo();
+
+ private:
+ const nsPagesPerSheetInfo* mPagesPerSheetInfo = nullptr;
+};
+
+// Page sequence frame class. Manages a series of pages, in paginated mode.
+// (Strictly speaking, this frame's direct children are PrintedSheetFrame
+// instances, and each of those will usually contain one nsPageFrame, depending
+// on the "pages-per-sheet" setting and whether the print operation is
+// restricted to a custom page range.)
+class nsPageSequenceFrame final : public nsContainerFrame {
+ using LogicalSize = mozilla::LogicalSize;
+
+ public:
+ friend nsPageSequenceFrame* NS_NewPageSequenceFrame(
+ mozilla::PresShell* aPresShell, ComputedStyle* aStyle);
+
+ NS_DECL_QUERYFRAME
+ NS_DECL_FRAMEARENA_HELPERS(nsPageSequenceFrame)
+
+ // nsIFrame
+ void Reflow(nsPresContext* aPresContext, ReflowOutput& aReflowOutput,
+ const ReflowInput& aReflowInput,
+ nsReflowStatus& aStatus) override;
+
+ void BuildDisplayList(nsDisplayListBuilder* aBuilder,
+ const nsDisplayListSet& aLists) override;
+
+ // For Shrink To Fit
+ float GetSTFPercent() const { return mPageData->mShrinkToFitRatio; }
+
+ // Gets the final print preview scale that we're applying to the previewed
+ // sheets of paper.
+ float GetPrintPreviewScale() const;
+
+ // Async Printing
+ nsresult StartPrint(nsPresContext* aPresContext,
+ nsIPrintSettings* aPrintSettings,
+ const nsAString& aDocTitle, const nsAString& aDocURL);
+ nsresult PrePrintNextSheet(nsITimerCallback* aCallback, bool* aDone);
+ nsresult PrintNextSheet();
+ void ResetPrintCanvasList();
+
+ uint32_t GetCurrentSheetIdx() const { return mCurrentSheetIdx; }
+
+ int32_t GetRawNumPages() const { return mPageData->mRawNumPages; }
+
+ uint32_t GetPagesInFirstSheet() const;
+
+ nsresult DoPageEnd();
+
+ ComputeTransformFunction GetTransformGetter() const override;
+
+#ifdef DEBUG_FRAME_DUMP
+ nsresult GetFrameName(nsAString& aResult) const override;
+#endif
+
+ protected:
+ nsPageSequenceFrame(ComputedStyle*, nsPresContext*);
+ virtual ~nsPageSequenceFrame();
+
+ void SetPageNumberFormat(const char* aPropName, const char* aDefPropVal,
+ bool aPageNumOnly);
+
+ // SharedPageData Helper methods
+ void SetDateTimeStr(const nsAString& aDateTimeStr);
+ void SetPageNumberFormat(const nsAString& aFormatStr, bool aForPageNumOnly);
+
+ // Print scaling is applied in this function.
+ void PopulateReflowOutput(ReflowOutput&, const ReflowInput&);
+
+ // Helper function to compute the offset needed to center a child
+ // page-frame's margin-box inside our content-box.
+ nscoord ComputeCenteringMargin(nscoord aContainerContentBoxWidth,
+ nscoord aChildPaddingBoxWidth,
+ const nsMargin& aChildPhysicalMargin);
+
+ mozilla::PrintedSheetFrame* GetCurrentSheetFrame();
+
+ nsSize mSize;
+
+ // These next two LogicalSize members are used when we're in print-preview to
+ // ensure that each previewed sheet will fit in the print-preview scrollport:
+ // -------
+
+ // Each component of this LogicalSize represents the maximum length of all
+ // our print-previewed sheets in that axis, plus a little extra for the
+ // print-preview margin. Note that this LogicalSize doesn't necessarily
+ // correspond to any one particular sheet's size (especially if our sheets
+ // have different sizes), since the components are tracked independently such
+ // that we end up storing the maximum in each dimension.
+ LogicalSize mMaxSheetSize;
+ // The size of the scrollport where we're print-previewing sheets.
+ LogicalSize mScrollportSize;
+
+ // Data shared by all the nsPageFrames:
+ mozilla::UniquePtr<nsSharedPageData> mPageData;
+
+ // The zero-based index of the PrintedSheetFrame child that is being printed
+ // (or about-to-be-printed), in an async print operation.
+ // This is an index into our PrincipalChildList, effectively.
+ uint32_t mCurrentSheetIdx = 0;
+
+ nsTArray<RefPtr<mozilla::dom::HTMLCanvasElement> > mCurrentCanvasList;
+
+ bool mCalledBeginPage;
+
+ bool mCurrentCanvasListSetup;
+};
+
+#endif /* nsPageSequenceFrame_h___ */