Add 'printing' flag to PaintInfo

Source/core/paint/PaintPhase.h

 /*
  * Copyright (C) 2000 Lars Knoll (knoll@kde.org)
  *           (C) 2000 Antti Koivisto (koivisto@kde.org)
  *           (C) 2000 Dirk Mueller (mueller@kde.org)
  *           (C) 2004 Allan Sandfeld Jensen (kde@carewolf.com)
  * Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009 Apple Inc. All rights reserved.
  * Copyright (C) 2009 Google Inc. All rights reserved.
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public
@@ skipping 39 matching lines @@
     PaintPhaseCollapsedTableBorders = 9,
     PaintPhaseTextClip = 10,
     PaintPhaseMask = 11,
     PaintPhaseClippingMask = 12,
     PaintPhaseMax = PaintPhaseClippingMask,
     // These values must be kept in sync with DisplayItem::Type and DisplayItem::typeAsDebugString().
 };
 
 enum PaintBehaviorFlags {
     PaintBehaviorNormal = 0,
-    // TODO(jchaffraix): Remove those 2 once we have migrated to GlobalPaintFlags.
+    // TODO(jchaffraix): Remove those 3 once we have migrated to GlobalPaintFlags.
     PaintBehaviorSelectionOnly = 1 << 0,
+    PaintBehaviorPrintAdaption = 1 << 1,
     PaintBehaviorFlattenCompositingLayers = 1 << 2,
     PaintBehaviorRenderingClipPathAsMask = 1 << 3,
     PaintBehaviorSkipRootBackground = 1 << 4,
     PaintBehaviorRootBackgroundOnly = 1 << 5
 };
 
 typedef unsigned PaintBehavior;
 
 // Those flags are meant as global tree operations. This means
 // that they should be constant for a paint phase.
 // TODO(jchaffraix): We should pass these as a const variable
 // during paint to ensure they are not modified.
 enum GlobalPaintFlag {
     GlobalPaintNormalPhase = 0,
     // Used when painting selection as part of a drag-image. This
     // flag disables a lot of the painting code and specifically
     // triggers a PaintPhaseSelection.
     GlobalPaintSelectionOnly = 1 << 0,
     // Used when painting a drag-image or printing in order to
     // ignore the hardware layers and paint the whole tree
     // into the topmost layer.
-    GlobalPaintFlattenCompositingLayers = 1 << 1
+    GlobalPaintFlattenCompositingLayers = 1 << 1,
+    // Used when printing in order to adapt the output to the medium, for
+    // instance by not painting shadows and selections on text, and add
+    // annotations for links.

[Julien - ping for review, 2015/07/15 17:14:25]

Not sure what 'annotation for links' represents.

[fs, 2015/07/15 18:25:58]

When I wrote this I was thinking about:

https://code.google.com/p/chromium/codesearch#chromium/src/third_party/WebKit...

(and the method below it.) Can you think of any term/formulation that would make
that more obvious to you? "(Hyper)Link metadata"?

+    GlobalPaintPrintAdaption = 1 << 2

[Julien - ping for review, 2015/07/15 17:14:25]

Not a huge fan of "print adaption" (first TIL that "adaption" is a word).

The adaption is what I find superfluous. It's really a GlobalPaintWhenPrinting
or something similar.

[fs, 2015/07/15 18:25:58]

"Adaption" (or adaptation for the longer word) seemed fitting long enough [1] in
my head to make me change from the more blunt GlobalPaintPrinting =). Would the
latter be ok enough?

[1] Since what it achieves is essentially an adap(ta)tion from screen media to
print media through various tweaks. 

 };
 
 typedef unsigned GlobalPaintFlags;
 
 // TODO(jchaffraix): This is a scaffolding as we roll in GlobalPaintFlags
 // as a replacement for PaintBehavior. Remove when it's fully done.
 inline PaintBehavior toPaintBehavior(GlobalPaintFlags flags)
 {
     PaintBehavior behavior = PaintBehaviorNormal;
     if (flags & GlobalPaintSelectionOnly)
         behavior |= PaintBehaviorSelectionOnly;
     if (flags & GlobalPaintFlattenCompositingLayers)
         behavior |= PaintBehaviorFlattenCompositingLayers;
+    if (flags & GlobalPaintPrintAdaption)
+        behavior |= PaintBehaviorPrintAdaption;
     return behavior;
 }
 inline GlobalPaintFlags toGlobalPaintFlags(PaintBehavior behavior)
 {
     GlobalPaintFlags flags = GlobalPaintNormalPhase;
     if (behavior & PaintBehaviorSelectionOnly)
         flags |= GlobalPaintSelectionOnly;
     if (behavior & PaintBehaviorFlattenCompositingLayers)
         flags |= GlobalPaintFlattenCompositingLayers;
+    if (behavior & PaintBehaviorPrintAdaption)
+        flags |= GlobalPaintPrintAdaption;
     return flags;
 }
 
 } // namespace blink
 
 #endif // PaintPhase_h