/* 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 nsViewportInfo_h___ #define nsViewportInfo_h___ #include #include "mozilla/Attributes.h" #include "Units.h" /** * Default values for the nsViewportInfo class. */ static const mozilla::LayoutDeviceToScreenScale kViewportMinScale(0.25f); static const mozilla::LayoutDeviceToScreenScale kViewportMaxScale(10.0f); static const mozilla::CSSIntSize kViewportMinSize(200, 40); static const mozilla::CSSIntSize kViewportMaxSize(10000, 10000); /** * Information retrieved from the tag. See * Document::GetViewportInfo for more information on this functionality. */ class MOZ_STACK_CLASS nsViewportInfo { public: enum class AutoSizeFlag { AutoSize, FixedSize, }; enum class AutoScaleFlag { AutoScale, FixedScale, }; enum class ZoomFlag { AllowZoom, DisallowZoom, }; nsViewportInfo(const mozilla::ScreenIntSize& aDisplaySize, const mozilla::CSSToScreenScale& aDefaultZoom, ZoomFlag aZoomFlag) : mDefaultZoom(aDefaultZoom), mDefaultZoomValid(true), mAutoSize(true), mAllowZoom(aZoomFlag == ZoomFlag::AllowZoom) { mSize = mozilla::ScreenSize(aDisplaySize) / mDefaultZoom; mozilla::CSSToLayoutDeviceScale pixelRatio(1.0f); mMinZoom = pixelRatio * kViewportMinScale; mMaxZoom = pixelRatio * kViewportMaxScale; ConstrainViewportValues(); } nsViewportInfo(const mozilla::CSSToScreenScale& aDefaultZoom, const mozilla::CSSToScreenScale& aMinZoom, const mozilla::CSSToScreenScale& aMaxZoom, const mozilla::CSSSize& aSize, AutoSizeFlag aAutoSizeFlag, AutoScaleFlag aAutoScaleFlag, ZoomFlag aZoomFlag) : mDefaultZoom(aDefaultZoom), mMinZoom(aMinZoom), mMaxZoom(aMaxZoom), mSize(aSize), mDefaultZoomValid(aAutoScaleFlag != AutoScaleFlag::AutoScale), mAutoSize(aAutoSizeFlag == AutoSizeFlag::AutoSize), mAllowZoom(aZoomFlag == ZoomFlag::AllowZoom) { ConstrainViewportValues(); } bool IsDefaultZoomValid() const { return mDefaultZoomValid; } mozilla::CSSToScreenScale GetDefaultZoom() const { return mDefaultZoom; } mozilla::CSSToScreenScale GetMinZoom() const { return mMinZoom; } mozilla::CSSToScreenScale GetMaxZoom() const { return mMaxZoom; } mozilla::CSSSize GetSize() const { return mSize; } bool IsAutoSizeEnabled() const { return mAutoSize; } bool IsZoomAllowed() const { return mAllowZoom; } enum { Auto = -1, ExtendToZoom = -2, DeviceSize = -3, // for device-width or device-height }; // MIN/MAX computations where one of the arguments is auto resolve to the // other argument. For instance, MIN(0.25, auto) = 0.25, and // MAX(5, auto) = 5. // https://drafts.csswg.org/css-device-adapt/#constraining-defs static const float& Max(const float& aA, const float& aB); static const float& Min(const float& aA, const float& aB); private: /** * Constrain the viewport calculations from the * Document::GetViewportInfo() function in order to always return * sane minimum/maximum values. */ void ConstrainViewportValues(); // Default zoom indicates the level at which the display is 'zoomed in' // initially for the user, upon loading of the page. mozilla::CSSToScreenScale mDefaultZoom; // The minimum zoom level permitted by the page. mozilla::CSSToScreenScale mMinZoom; // The maximum zoom level permitted by the page. mozilla::CSSToScreenScale mMaxZoom; // The size of the viewport, specified by the tag. mozilla::CSSSize mSize; // If the default zoom was specified and was between the min and max // zoom values. // FIXME: Bug 1504362 - Unify this and mDefaultZoom into // Maybe. bool mDefaultZoomValid; // Whether or not we should automatically size the viewport to the device's // width. This is true if the document has been optimized for mobile, and // the width property of a specified tag is either // not specified, or is set to the special value 'device-width'. bool mAutoSize; // Whether or not the user can zoom in and out on the page. Default is true. bool mAllowZoom; }; #endif