mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-30 05:35:31 +00:00
406 lines
17 KiB
C++
406 lines
17 KiB
C++
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* ***** BEGIN LICENSE BLOCK *****
|
|
* Version: MPL 1.1/GPL 2.0/LGPL 2.1
|
|
*
|
|
* The contents of this file are subject to the Mozilla Public License Version
|
|
* 1.1 (the "License"); you may not use this file except in compliance with
|
|
* the License. You may obtain a copy of the License at
|
|
* http://www.mozilla.org/MPL/
|
|
*
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|
* for the specific language governing rights and limitations under the
|
|
* License.
|
|
*
|
|
* The Original Code is mozilla.org code.
|
|
*
|
|
* The Initial Developer of the Original Code is
|
|
* Netscape Communications Corporation.
|
|
* Portions created by the Initial Developer are Copyright (C) 1998
|
|
* the Initial Developer. All Rights Reserved.
|
|
*
|
|
* Contributor(s):
|
|
*
|
|
* Alternatively, the contents of this file may be used under the terms of
|
|
* either of the GNU General Public License Version 2 or later (the "GPL"),
|
|
* or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
|
|
* in which case the provisions of the GPL or the LGPL are applicable instead
|
|
* of those above. If you wish to allow use of your version of this file only
|
|
* under the terms of either the GPL or the LGPL, and not to allow others to
|
|
* use your version of this file under the terms of the MPL, indicate your
|
|
* decision by deleting the provisions above and replace them with the notice
|
|
* and other provisions required by the GPL or the LGPL. If you do not delete
|
|
* the provisions above, a recipient may use your version of this file under
|
|
* the terms of any one of the MPL, the GPL or the LGPL.
|
|
*
|
|
* ***** END LICENSE BLOCK ***** */
|
|
|
|
/* utility functions for drawing borders and backgrounds */
|
|
|
|
#ifndef nsCSSRendering_h___
|
|
#define nsCSSRendering_h___
|
|
|
|
#include "nsIRenderingContext.h"
|
|
struct nsPoint;
|
|
class nsStyleContext;
|
|
class nsPresContext;
|
|
|
|
class nsCSSRendering {
|
|
public:
|
|
/**
|
|
* Render the border for an element using css rendering rules
|
|
* for borders. aSkipSides is a bitmask of the sides to skip
|
|
* when rendering. If 0 then no sides are skipped.
|
|
*
|
|
* Both aDirtyRect and aBorderArea are in the local coordinate space
|
|
* of aForFrame
|
|
*/
|
|
static void PaintBorder(nsPresContext* aPresContext,
|
|
nsIRenderingContext& aRenderingContext,
|
|
nsIFrame* aForFrame,
|
|
const nsRect& aDirtyRect,
|
|
const nsRect& aBorderArea,
|
|
const nsStyleBorder& aBorderStyle,
|
|
nsStyleContext* aStyleContext,
|
|
PRIntn aSkipSides,
|
|
nsRect* aGap = 0,
|
|
nscoord aHardBorderSize = 0,
|
|
PRBool aShouldIgnoreRounded = PR_FALSE);
|
|
|
|
/**
|
|
* Render the outline for an element using css rendering rules
|
|
* for borders. aSkipSides is a bitmask of the sides to skip
|
|
* when rendering. If 0 then no sides are skipped.
|
|
*
|
|
* Both aDirtyRect and aBorderArea are in the local coordinate space
|
|
* of aForFrame
|
|
*/
|
|
static void PaintOutline(nsPresContext* aPresContext,
|
|
nsIRenderingContext& aRenderingContext,
|
|
nsIFrame* aForFrame,
|
|
const nsRect& aDirtyRect,
|
|
const nsRect& aBorderArea,
|
|
const nsStyleBorder& aBorderStyle,
|
|
const nsStyleOutline& aOutlineStyle,
|
|
nsStyleContext* aStyleContext,
|
|
PRIntn aSkipSides,
|
|
nsRect* aGap = 0);
|
|
|
|
/**
|
|
* Just like PaintBorder, but takes as input a list of border segments
|
|
* rather than a single border style. Useful for any object that needs to
|
|
* draw a border where an edge is not necessarily homogenous.
|
|
* Render the border for an element using css rendering rules
|
|
* for borders. aSkipSides is a bitmask of the sides to skip
|
|
* when rendering. If 0 then no sides are skipped.
|
|
*
|
|
* Both aDirtyRect and aBorderArea are in the local coordinate space
|
|
* of aForFrame
|
|
*/
|
|
static void PaintBorderEdges(nsPresContext* aPresContext,
|
|
nsIRenderingContext& aRenderingContext,
|
|
nsIFrame* aForFrame,
|
|
const nsRect& aDirtyRect,
|
|
const nsRect& aBorderArea,
|
|
nsBorderEdges * aBorderEdges,
|
|
nsStyleContext* aStyleContext,
|
|
PRIntn aSkipSides,
|
|
nsRect* aGap = 0);
|
|
|
|
|
|
/**
|
|
* Fill in an nsStyleBackground to be used to paint the background for
|
|
* an element. The nsStyleBackground should first be initialized
|
|
* using the pres context. This applies the rules for propagating
|
|
* backgrounds between BODY, the root element, and the canvas.
|
|
* @return PR_TRUE if there is some meaningful background.
|
|
*/
|
|
static PRBool FindBackground(nsPresContext* aPresContext,
|
|
nsIFrame* aForFrame,
|
|
const nsStyleBackground** aBackground,
|
|
PRBool* aIsCanvas);
|
|
|
|
/**
|
|
* Find a non-transparent background, for various table-related and
|
|
* HR-related backwards-compatibility hacks. Be very hesitant if
|
|
* you're considering calling this function -- it's usually not what
|
|
* you want.
|
|
*/
|
|
static const nsStyleBackground*
|
|
FindNonTransparentBackground(nsStyleContext* aContext,
|
|
PRBool aStartAtParent = PR_FALSE);
|
|
|
|
/**
|
|
* Render the background for an element using css rendering rules
|
|
* for backgrounds.
|
|
*
|
|
* Both aDirtyRect and aBorderArea are in the local coordinate space
|
|
* of aForFrame
|
|
*/
|
|
static void PaintBackground(nsPresContext* aPresContext,
|
|
nsIRenderingContext& aRenderingContext,
|
|
nsIFrame* aForFrame,
|
|
const nsRect& aDirtyRect,
|
|
const nsRect& aBorderArea,
|
|
const nsStyleBorder& aBorder,
|
|
const nsStylePadding& aPadding,
|
|
PRBool aUsePrintSettings,
|
|
nsRect* aBGClipRect = nsnull);
|
|
|
|
/**
|
|
* Same as |PaintBackground|, except using the provided style context
|
|
* (which short-circuits the code that ensures that the root element's
|
|
* background is drawn on the canvas.
|
|
*/
|
|
static void PaintBackgroundWithSC(nsPresContext* aPresContext,
|
|
nsIRenderingContext& aRenderingContext,
|
|
nsIFrame* aForFrame,
|
|
const nsRect& aDirtyRect,
|
|
const nsRect& aBorderArea,
|
|
const nsStyleBackground& aColor,
|
|
const nsStyleBorder& aBorder,
|
|
const nsStylePadding& aPadding,
|
|
PRBool aUsePrintSettings = PR_FALSE,
|
|
nsRect* aBGClipRect = nsnull);
|
|
|
|
/**
|
|
* Called by the presShell when painting is finished, so we can clear our
|
|
* inline background data cache.
|
|
*/
|
|
static void DidPaint();
|
|
|
|
|
|
static void DrawDashedSides(PRIntn startSide,
|
|
nsIRenderingContext& aContext,
|
|
const nsRect& aDirtyRect,
|
|
const PRUint8 borderStyles[],
|
|
const nscolor borderColors[],
|
|
const nsRect& borderOutside,
|
|
const nsRect& borderInside,
|
|
PRIntn aSkipSides,
|
|
nsRect* aGap);
|
|
|
|
static void DrawDashedSides(PRIntn startSide,
|
|
nsIRenderingContext& aContext,
|
|
const nsRect& aDirtyRect,
|
|
const nsStyleColor* aColorStyle,
|
|
const nsStyleBorder* aBorderStyle,
|
|
const nsStyleOutline* aOutlineStyle,
|
|
PRBool aDoOutline,
|
|
const nsRect& borderOutside,
|
|
const nsRect& borderInside,
|
|
PRIntn aSkipSides,
|
|
nsRect* aGap);
|
|
|
|
/** draw the dashed segements of a segmented border */
|
|
//XXX: boy is it annoying that we have 3 methods to draw dashed sides!
|
|
// they clearly can be factored.
|
|
static void DrawDashedSegments(nsIRenderingContext& aContext,
|
|
const nsRect& aBounds,
|
|
nsBorderEdges * aBorderEdges,
|
|
PRIntn aSkipSides,
|
|
nsRect* aGap);
|
|
|
|
// Draw a border segment in the table collapsing border model without beveling corners
|
|
static void DrawTableBorderSegment(nsIRenderingContext& aContext,
|
|
PRUint8 aBorderStyle,
|
|
nscolor aBorderColor,
|
|
const nsStyleBackground* aBGColor,
|
|
const nsRect& aBorderRect,
|
|
float aPixelsToTwips,
|
|
PRUint8 aStartBevelSide = 0,
|
|
nscoord aStartBevelOffset = 0,
|
|
PRUint8 aEndBevelSide = 0,
|
|
nscoord aEndBevelOffset = 0);
|
|
/**
|
|
* transform a color to a color that will show up on a printer if needed
|
|
* aMapColor - color to evaluate
|
|
* aIsPrinter - Is this a printing device
|
|
* return - the transformed color
|
|
*/
|
|
static nscolor TransformColor(nscolor aMapColor,PRBool aNoBackGround);
|
|
|
|
protected:
|
|
/**
|
|
* Render the border for an element using css rendering rules
|
|
* for borders. aSkipSides is a bitmask of the sides to skip
|
|
* when rendering. If 0 then no sides are skipped.
|
|
* Both aDirtyRect and aBorderArea are in the local coordinate space
|
|
* of aForFrame
|
|
*/
|
|
static void PaintRoundedBorder(nsPresContext* aPresContext,
|
|
nsIRenderingContext& aRenderingContext,
|
|
nsIFrame* aForFrame,
|
|
const nsRect& aDirtyRect,
|
|
const nsRect& aBorderArea,
|
|
const nsStyleBorder* aBorderStyle,
|
|
const nsStyleOutline* aOutlineStyle,
|
|
nsStyleContext* aStyleContext,
|
|
PRIntn aSkipSides,
|
|
PRInt16 aBorderRadius[4],nsRect* aGap = 0,
|
|
PRBool aIsOutline=PR_FALSE);
|
|
|
|
static void RenderSide(nsFloatPoint aPoints[],nsIRenderingContext& aRenderingContext,
|
|
const nsStyleBorder* aBorderStyle,const nsStyleOutline* aOutlineStyle,nsStyleContext* aStyleContext,
|
|
PRUint8 aSide,nsMargin &aBorThick,nscoord aTwipsPerPixel,
|
|
PRBool aIsOutline=PR_FALSE);
|
|
|
|
static void PaintBackgroundColor(nsPresContext* aPresContext,
|
|
nsIRenderingContext& aRenderingContext,
|
|
nsIFrame* aForFrame,
|
|
const nsRect& aBgClipArea,
|
|
const nsStyleBackground& aColor,
|
|
const nsStyleBorder& aBorder,
|
|
const nsStylePadding& aPadding,
|
|
PRBool aCanPaintNonWhite);
|
|
|
|
static void PaintRoundedBackground(nsPresContext* aPresContext,
|
|
nsIRenderingContext& aRenderingContext,
|
|
nsIFrame* aForFrame,
|
|
const nsRect& aBorderArea,
|
|
const nsStyleBackground& aColor,
|
|
const nsStyleBorder& aBorder,
|
|
PRInt16 aTheRadius[4],
|
|
PRBool aCanPaintNonWhite);
|
|
|
|
static nscolor MakeBevelColor(PRIntn whichSide, PRUint8 style,
|
|
nscolor aBackgroundColor,
|
|
nscolor aBorderColor);
|
|
|
|
static PRIntn MakeSide(nsPoint aPoints[],
|
|
nsIRenderingContext& aContext,
|
|
PRIntn whichSide,
|
|
const nsRect& outside, const nsRect& inside,
|
|
PRIntn aSkipSides,
|
|
PRIntn borderPart, float borderFrac,
|
|
nscoord twipsPerPixel);
|
|
|
|
static void DrawSide(nsIRenderingContext& aContext,
|
|
PRIntn whichSide,
|
|
const PRUint8 borderStyle,
|
|
const nscolor borderColor,
|
|
const nscolor aBackgroundColor,
|
|
const nsRect& borderOutside,
|
|
const nsRect& borderInside,
|
|
PRIntn aSkipSides,
|
|
nscoord twipsPerPixel,
|
|
nsRect* aGap = 0);
|
|
|
|
|
|
static void DrawCompositeSide(nsIRenderingContext& aContext,
|
|
PRIntn aWhichSide,
|
|
nsBorderColors* aCompositeColors,
|
|
const nsRect& aOuterRect,
|
|
const nsRect& aInnerRect,
|
|
PRInt16* aBorderRadii,
|
|
nscoord aTwipsPerPixel,
|
|
nsRect* aGap);
|
|
|
|
static void DrawLine (nsIRenderingContext& aContext,
|
|
nscoord aX1, nscoord aY1, nscoord aX2, nscoord aY2,
|
|
nsRect* aGap);
|
|
|
|
static void FillPolygon (nsIRenderingContext& aContext,
|
|
const nsPoint aPoints[],
|
|
PRInt32 aNumPoints,
|
|
nsRect* aGap);
|
|
|
|
};
|
|
|
|
|
|
|
|
/** ---------------------------------------------------
|
|
* Class QBCurve, a quadratic bezier curve, used to implement the rounded rectangles
|
|
* @update 3/26/99 dwc
|
|
*/
|
|
class QBCurve
|
|
{
|
|
|
|
public:
|
|
nsFloatPoint mAnc1;
|
|
nsFloatPoint mCon;
|
|
nsFloatPoint mAnc2;
|
|
|
|
QBCurve() {mAnc1.x=0;mAnc1.y=0;mCon=mAnc2=mAnc1;}
|
|
void SetControls(nsFloatPoint &aAnc1,nsFloatPoint &aCon,nsFloatPoint &aAnc2) { mAnc1 = aAnc1; mCon = aCon; mAnc2 = aAnc2;}
|
|
void SetPoints(float a1x,float a1y,float acx,float acy,float a2x,float a2y) {mAnc1.MoveTo(a1x,a1y),mCon.MoveTo(acx,acy),mAnc2.MoveTo(a2x,a2y);}
|
|
|
|
/** ---------------------------------------------------
|
|
* Divide a Quadratic curve into line segments if it is not smaller than a certain size
|
|
* else it is so small that it can be approximated by 2 lineto calls
|
|
* @param aRenderingContext -- The RenderingContext to use to draw with
|
|
* @param aPointArray[] -- A list of points we can put line calls into instead of drawing. If null, lines are drawn
|
|
* @param aCurInex -- a pointer to an Integer that tells were to put the points into the array, incremented when finished
|
|
* @update 3/26/99 dwc
|
|
*/
|
|
void SubDivide(nsIRenderingContext *aRenderingContext,nsPoint aPointArray[],PRInt32 *aCurIndex);
|
|
|
|
/** ---------------------------------------------------
|
|
* Divide a Quadratic Bezier curve at the mid-point
|
|
* @update 3/26/99 dwc
|
|
* @param aCurve1 -- Curve 1 as a result of the division
|
|
* @param aCurve2 -- Curve 2 as a result of the division
|
|
*/
|
|
void MidPointDivide(QBCurve *A,QBCurve *B);
|
|
};
|
|
|
|
|
|
/** ---------------------------------------------------
|
|
* Class RoundedRect, A class to encapsulate all the rounded rect functionality,
|
|
* which are based on the QBCurve
|
|
* @update 4/13/99 dwc
|
|
*/
|
|
class RoundedRect
|
|
{
|
|
|
|
public:
|
|
PRInt32 mRoundness[4];
|
|
|
|
PRBool mDoRound;
|
|
|
|
PRInt32 mLeft;
|
|
PRInt32 mRight;
|
|
PRInt32 mTop;
|
|
PRInt32 mBottom;
|
|
|
|
/**
|
|
* Construct a rounded rectangle object
|
|
* @update 4/19/99
|
|
*/
|
|
void RoundRect() {mRoundness[0]=0;}
|
|
|
|
/**
|
|
* Set the curves boundaries and then break it up into the curve pieces for rendering
|
|
* @update 4/13/99 dwc
|
|
* @param aLeft -- Left side of bounding box
|
|
* @param aTop -- Top side of bounding box
|
|
* @param aWidth -- Width of bounding box
|
|
* @param aHeight -- Height of bounding box
|
|
* @param aRadius -- radius for the rounding
|
|
*/
|
|
void Set(nscoord aLeft,nscoord aTop,PRInt32 aWidth,PRInt32 aHeight,PRInt16 aRadius[4],PRInt16 aNumTwipPerPix);
|
|
|
|
|
|
/**
|
|
* Calculate the inset of a curve based on a border
|
|
* @update 4/13/99 dwc
|
|
* @param aLeft -- Left side of bounding box
|
|
* @param aTop -- Top side of bounding box
|
|
*/
|
|
void CalcInsetCurves(QBCurve &aULCurve,QBCurve &aURCurve,QBCurve &aLLCurve,QBCurve &aLRCurve,nsMargin &aBorder);
|
|
|
|
/** ---------------------------------------------------
|
|
* set the passed in curves to the rounded borders of the rectangle
|
|
* @update 4/13/99 dwc
|
|
* @param aULCurve -- upperleft curve
|
|
* @param aURCurve -- upperright curve
|
|
* @param aLRCurve -- lowerright curve
|
|
* @param aLLCurve -- lowerleft curve
|
|
*/
|
|
void GetRoundedBorders(QBCurve &aULCurve,QBCurve &aURCurve,QBCurve &aLLCurve,QBCurve &aLRCurve);
|
|
|
|
};
|
|
|
|
|
|
#endif /* nsCSSRendering_h___ */
|