reflow comments in core/layout/compositing,core/observer

third_party/WebKit/Source/core/layout/compositing/PaintLayerCompositor.h

 /*
  * Copyright (C) 2009 Apple Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
@@ skipping 60 matching lines @@
 
 class CORE_EXPORT PaintLayerCompositor final : public GraphicsLayerClient {
   USING_FAST_MALLOC(PaintLayerCompositor);
 
  public:
   explicit PaintLayerCompositor(LayoutView&);
   ~PaintLayerCompositor() override;
 
   void updateIfNeededRecursive();
 
-  // Return true if this LayoutView is in "compositing mode" (i.e. has one or more
-  // composited Layers)
+  // Return true if this LayoutView is in "compositing mode" (i.e. has one or
+  // more composited Layers)
   bool inCompositingMode() const;
   // FIXME: Replace all callers with inCompositingMode and remove this function.
   bool staleInCompositingMode() const;
-  // This will make a compositing layer at the root automatically, and hook up to
-  // the native view/window system.
+  // This will make a compositing layer at the root automatically, and hook up
+  // to the native view/window system.
   void setCompositingModeEnabled(bool);
 
   // Returns true if the accelerated compositing is enabled
   bool hasAcceleratedCompositing() const { return m_hasAcceleratedCompositing; }
 
   bool preferCompositingToLCDTextEnabled() const;
 
   bool rootShouldAlwaysComposite() const;
 
   // Copy the accelerated compositing related flags from Settings
   void updateAcceleratedCompositingSettings();
 
-  // Used to indicate that a compositing update will be needed for the next frame that gets drawn.
+  // Used to indicate that a compositing update will be needed for the next
+  // frame that gets drawn.
   void setNeedsCompositingUpdate(CompositingUpdateType);
 
   void didLayout();
 
-  // Whether layer's compositedLayerMapping needs a GraphicsLayer to clip z-order children of the given Layer.
+  // Whether layer's compositedLayerMapping needs a GraphicsLayer to clip
+  // z-order children of the given Layer.
   bool clipsCompositingDescendants(const PaintLayer*) const;
 
   // Whether the given layer needs an extra 'contents' layer.
   bool needsContentsCompositingLayer(const PaintLayer*) const;
 
   bool supportsFixedRootBackgroundCompositing() const;
   bool needsFixedRootBackgroundLayer(const PaintLayer*) const;
   GraphicsLayer* fixedRootBackgroundLayer() const;
   void setNeedsUpdateFixedBackground() { m_needsUpdateFixedBackground = true; }
 
-  // Issue paint invalidations of the appropriate layers when the given Layer starts or stops being composited.
+  // Issue paint invalidations of the appropriate layers when the given Layer
+  // starts or stops being composited.
   void paintInvalidationOnCompositingChange(PaintLayer*);
 
   void fullyInvalidatePaint();
 
   PaintLayer* rootLayer() const;
   GraphicsLayer* rootGraphicsLayer() const;
   GraphicsLayer* frameScrollLayer() const;
   GraphicsLayer* scrollLayer() const;
   GraphicsLayer* containerLayer() const;
   GraphicsLayer* rootContentLayer() const;
@@ skipping 15 matching lines @@
   // expand/shrink its clipping layer in response to top controls and have
   // the result be visible.
   void updateClippingOnCompositorLayers();
 
   void setIsInWindow(bool);
 
   static PaintLayerCompositor* frameContentsCompositor(LayoutPart*);
   // Return true if the layers changed.
   static bool attachFrameContentLayersToIframeLayer(LayoutPart*);
 
-  // Update the geometry of the layers used for clipping and scrolling in frames.
+  // Update the geometry of the layers used for clipping and scrolling in
+  // frames.
   void frameViewDidChangeLocation(const IntPoint& contentsOffset);
   void frameViewDidChangeSize();
   void frameViewDidScroll();
   void frameViewScrollbarsExistenceDidChange();
   void rootFixedBackgroundsChanged();
 
   bool scrollingLayerDidChange(PaintLayer*);
 
   std::unique_ptr<JSONObject> layerTreeAsJSON(LayerTreeFlags) const;
 
@@ skipping 17 matching lines @@
   }
   void setNeedsUpdateDescendantDependentFlags() {
     m_needsUpdateDescendantDependentFlags = true;
   }
 
   void updatePotentialCompositingReasonsFromStyle(PaintLayer*);
 
   // Whether the layer could ever be composited.
   bool canBeComposited(const PaintLayer*) const;
 
-  // FIXME: Move allocateOrClearCompositedLayerMapping to CompositingLayerAssigner once we've fixed
+  // FIXME: Move allocateOrClearCompositedLayerMapping to
+  // CompositingLayerAssigner once we've fixed

[eae, 2016/10/05 19:53:01]

Rewrap at 80 col.

[Nico, 2016/10/05 19:58:15]

Whoops, thanks! Done.

   // the compositing chicken/egg issues.
   bool allocateOrClearCompositedLayerMapping(
       PaintLayer*,
       CompositingStateTransitionType compositedLayerUpdate);
 
   void updateDirectCompositingReasons(PaintLayer*);
 
   bool inOverlayFullscreenVideo() const { return m_inOverlayFullscreenVideo; }
 
  private:
@@ skipping 33 matching lines @@
   ScrollingCoordinator* scrollingCoordinator() const;
 
   void enableCompositingModeIfNeeded();
 
   bool requiresHorizontalScrollbarLayer() const;
   bool requiresVerticalScrollbarLayer() const;
   bool requiresScrollCornerLayer() const;
 
   void applyOverlayFullscreenVideoAdjustmentIfNeeded();
 
-  // Checks the given graphics layer against the compositor's horizontal and vertical scrollbar
-  // graphics layers, returning the associated Scrollbar instance if any, else nullptr.
+  // Checks the given graphics layer against the compositor's horizontal and
+  // vertical scrollbar graphics layers, returning the associated Scrollbar
+  // instance if any, else nullptr.
   Scrollbar* graphicsLayerToScrollbar(const GraphicsLayer*) const;
 
   LayoutView& m_layoutView;
   std::unique_ptr<GraphicsLayer> m_rootContentLayer;
 
   CompositingReasonFinder m_compositingReasonFinder;
 
   CompositingUpdateType m_pendingUpdateType;
 
   bool m_hasAcceleratedCompositing;
@@ skipping 23 matching lines @@
 
   // Layers for overflow controls
   std::unique_ptr<GraphicsLayer> m_layerForHorizontalScrollbar;
   std::unique_ptr<GraphicsLayer> m_layerForVerticalScrollbar;
   std::unique_ptr<GraphicsLayer> m_layerForScrollCorner;
 };
 
 }  // namespace blink
 
 #endif  // PaintLayerCompositor_h