Rewrap comments to 80 columns in Source/platform/graphics/.

third_party/WebKit/Source/platform/graphics/GraphicsContext.h

 /*
  * Copyright (C) 2003, 2006, 2007, 2008, 2009 Apple Inc. All rights reserved.
  * Copyright (C) 2008-2009 Torch Mobile, Inc.
  * Copyright (C) 2013 Google 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.
@@ skipping 52 matching lines @@
 class PaintController;
 class Path;
 
 class PLATFORM_EXPORT GraphicsContext {
   WTF_MAKE_NONCOPYABLE(GraphicsContext);
   USING_FAST_MALLOC(GraphicsContext);
 
  public:
   enum DisabledMode {
     NothingDisabled = 0,  // Run as normal.
-    FullyDisabled =
-        1  // Do absolutely minimal work to remove the cost of the context from performance tests.
+    FullyDisabled = 1     // Do absolutely minimal work to remove the cost of
+                          // the context from performance tests.
   };
 
   explicit GraphicsContext(PaintController&,
                            DisabledMode = NothingDisabled,
                            SkMetaData* = 0);
 
   ~GraphicsContext();
 
   SkCanvas* canvas() { return m_canvas; }
   const SkCanvas* canvas() const { return m_canvas; }
@@ skipping 122 matching lines @@
                       const FloatSize& repeatSpacing = FloatSize());
   void drawTiledImage(Image*,
                       const FloatRect& destRect,
                       const FloatRect& srcRect,
                       const FloatSize& tileScaleFactor,
                       Image::TileRule hRule = Image::StretchTile,
                       Image::TileRule vRule = Image::StretchTile,
                       SkXfermode::Mode = SkXfermode::kSrcOver_Mode);
 
   // These methods write to the canvas.
-  // Also drawLine(const IntPoint& point1, const IntPoint& point2) and fillRoundedRect
+  // Also drawLine(const IntPoint& point1, const IntPoint& point2) and
+  // fillRoundedRect().
   void drawOval(const SkRect&, const SkPaint&);
   void drawPath(const SkPath&, const SkPaint&);
   void drawRect(const SkRect&, const SkPaint&);
   void drawRRect(const SkRRect&, const SkPaint&);
 
   void clip(const IntRect& rect) { clipRect(rect); }
   void clip(const FloatRect& rect) { clipRect(rect); }
   void clipRoundedRect(const FloatRoundedRect&,
                        SkRegion::Op = SkRegion::kIntersect_Op,
                        AntiAliasingMode = AntiAliased);
@@ skipping 36 matching lines @@
 
   void drawLineForText(const FloatPoint&, float width, bool printing);
   enum DocumentMarkerLineStyle {
     DocumentMarkerSpellingLineStyle,
     DocumentMarkerGrammarLineStyle
   };
   void drawLineForDocumentMarker(const FloatPoint&,
                                  float width,
                                  DocumentMarkerLineStyle);
 
-  // beginLayer()/endLayer() behaves like save()/restore() for CTM and clip states.
-  // Apply SkXfermode::Mode when the layer is composited on the backdrop (i.e. endLayer()).
+  // beginLayer()/endLayer() behave like save()/restore() for CTM and clip
+  // states. Apply SkXfermode::Mode when the layer is composited on the backdrop
+  // (i.e. endLayer()).
   void beginLayer(float opacity = 1.0f,
                   SkXfermode::Mode = SkXfermode::kSrcOver_Mode,
                   const FloatRect* = 0,
                   ColorFilter = ColorFilterNone,
                   sk_sp<SkImageFilter> = nullptr);
   void endLayer();
 
-  // Instead of being dispatched to the active canvas, draw commands following beginRecording()
-  // are stored in a display list that can be replayed at a later time. Pass in the bounding
-  // rectangle for the content in the list.
+  // Instead of being dispatched to the active canvas, draw commands following
+  // beginRecording() are stored in a display list that can be replayed at a
+  // later time. Pass in the bounding rectangle for the content in the list.
   void beginRecording(const FloatRect&);
-  // Returns a picture with any recorded draw commands since the prerequisite call to
-  // beginRecording().  The picture is guaranteed to be non-null (but not necessarily non-empty),
-  // even when the context is disabled.
+
+  // Returns a picture with any recorded draw commands since the prerequisite
+  // call to beginRecording().  The picture is guaranteed to be non-null (but
+  // not necessarily non-empty), even when the context is disabled.
   sk_sp<SkPicture> endRecording();
 
   void setShadow(const FloatSize& offset,
                  float blur,
                  const Color&,
                  DrawLooperBuilder::ShadowTransformMode =
                      DrawLooperBuilder::ShadowRespectsTransforms,
                  DrawLooperBuilder::ShadowAlphaMode =
                      DrawLooperBuilder::ShadowRespectsAlpha,
                  ShadowMode = DrawShadowAndForeground);
@@ skipping 35 matching lines @@
   void translate(float x, float y);
   // ---------- End transformation methods -----------------
 
   SkFilterQuality computeFilterQuality(Image*,
                                        const FloatRect& dest,
                                        const FloatRect& src) const;
 
   // Sets target URL of a clickable area.
   void setURLForRect(const KURL&, const IntRect&);
 
-  // Sets destination of a URL fragment (in a URL pointing to the same web page) of a clickable area.
-  // When the area is clicked, the page should be scrolled to the location set by setURLDestinationLocation()
-  // for the destination whose name equals the fragment.
+  // Sets the destination of a clickable area of a URL fragment (in a URL
+  // pointing to the same web page). When the area is clicked, the page should
+  // be scrolled to the location set by setURLDestinationLocation() for the
+  // destination whose name is |name|.
   void setURLFragmentForRect(const String& name, const IntRect&);
 
   // Sets location of a URL destination (a.k.a. anchor) in the page.
   void setURLDestinationLocation(const String& name, const IntPoint&);
 
   static void adjustLineToPixelBoundaries(FloatPoint& p1,
                                           FloatPoint& p2,
                                           float strokeWidth,
                                           StrokeStyle);
 
   static int focusRingOutsetExtent(int offset, int width) {
-    // Unlike normal outlines (whole width is outside of the offset), focus rings are drawn with the
-    // center of the path aligned with the offset, so only half of the width is outside of the offset.
+    // Unlike normal outlines (whole width is outside of the offset), focus
+    // rings are drawn with the center of the path aligned with the offset, so
+    // only half of the width is outside of the offset.
     return focusRingOffset(offset) + (focusRingWidth(width) + 1) / 2;
   }
 
 #if OS(MACOSX)
   static int focusRingWidth(int width) { return width; }
 #else
   static int focusRingWidth(int width) { return 1; }
 #endif
 
 #if DCHECK_IS_ON()
@@ skipping 61 matching lines @@
                                const FloatRoundedRect& roundedHoleRect,
                                const Color&);
 
   const SkMetaData& metaData() const { return m_metaData; }
 
   // null indicates painting is contextDisabled. Never delete this object.
   SkCanvas* m_canvas;
 
   PaintController& m_paintController;
 
-  // Paint states stack. Enables local drawing state change with save()/restore() calls.
-  // This state controls the appearance of drawn content.
+  // Paint states stack. The state controls the appearance of drawn content, so
+  // this stack enables local drawing state changes with save()/restore() calls.
   // We do not delete from this stack to avoid memory churn.
   Vector<std::unique_ptr<GraphicsContextState>> m_paintStateStack;
+
   // Current index on the stack. May not be the last thing on the stack.
   unsigned m_paintStateIndex;
+
   // Raw pointer to the current state.
   GraphicsContextState* m_paintState;
 
   SkPictureRecorder m_pictureRecorder;
 
   SkMetaData m_metaData;
 
 #if DCHECK_IS_ON()
   unsigned m_layerCount;
   bool m_disableDestructionChecks;
   bool m_inDrawingRecorder;
 #endif
 
   const DisabledMode m_disabledState;
 
   float m_deviceScaleFactor;
 
   unsigned m_printing : 1;
   unsigned m_hasMetaData : 1;
 };
 
 }  // namespace blink
 
 #endif  // GraphicsContext_h