Rewrap comments to 80 columns in platform/graphics/{compositing,cpu,gpu,skia}/.

third_party/WebKit/Source/platform/graphics/gpu/DrawingBuffer.h

 /*
  * Copyright (c) 2010, 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:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 51 matching lines @@
 
 namespace blink {
 class Extensions3DUtil;
 class ImageBuffer;
 class StaticBitmapImage;
 class WebExternalBitmap;
 class WebExternalTextureLayer;
 class WebGraphicsContext3DProvider;
 class WebLayer;
 
-// Manages a rendering target (framebuffer + attachment) for a canvas.  Can publish its rendering
-// results to a WebLayer for compositing.
+// Manages a rendering target (framebuffer + attachment) for a canvas.  Can
+// publish its rendering results to a WebLayer for compositing.
 class PLATFORM_EXPORT DrawingBuffer
     : public NON_EXPORTED_BASE(cc::TextureLayerClient),
       public RefCounted<DrawingBuffer> {
   WTF_MAKE_NONCOPYABLE(DrawingBuffer);
 
  public:
   enum PreserveDrawingBuffer {
     Preserve,
     Discard,
   };
@@ skipping 18 matching lines @@
       PreserveDrawingBuffer,
       WebGLVersion,
       ChromiumImageUsage);
   static void forceNextDrawingBufferCreationToFail();
 
   ~DrawingBuffer() override;
 
   // Destruction will be completed after all mailboxes are released.
   void beginDestruction();
 
-  // Issues a glClear() on all framebuffers associated with this DrawingBuffer. The caller is responsible for
-  // making the context current and setting the clear values and masks. Modifies the framebuffer binding.
+  // Issues a glClear() on all framebuffers associated with this DrawingBuffer.
+  // The caller is responsible for making the context current and setting the
+  // clear values and masks. Modifies the framebuffer binding.
   void clearFramebuffers(GLbitfield clearMask);
 
-  // Indicates whether the DrawingBuffer internally allocated a packed depth-stencil renderbuffer
-  // in the situation where the end user only asked for a depth buffer. In this case, we need to
-  // upgrade clears of the depth buffer to clears of the depth and stencil buffers in order to
-  // avoid performance problems on some GPUs.
+  // Indicates whether the DrawingBuffer internally allocated a packed
+  // depth-stencil renderbuffer in the situation where the end user only asked
+  // for a depth buffer. In this case, we need to upgrade clears of the depth
+  // buffer to clears of the depth and stencil buffers in order to avoid
+  // performance problems on some GPUs.
   bool hasImplicitStencilBuffer() const { return m_hasImplicitStencilBuffer; }
   bool hasDepthBuffer() const { return !!m_depthStencilBuffer; }
   bool hasStencilBuffer() const { return !!m_depthStencilBuffer; }
 
-  // Given the desired buffer size, provides the largest dimensions that will fit in the pixel budget.
+  // Given the desired buffer size, provides the largest dimensions that will
+  // fit in the pixel budget.
   static IntSize adjustSize(const IntSize& desiredSize,
                             const IntSize& curSize,
                             int maxTextureSize);
 
   // Resizes (or allocates if necessary) all buffers attached to the default
   // framebuffer. Returns whether the operation was successful. Leaves GL
   // bindings dirtied.
   bool reset(const IntSize&);
 
   // Bind the default framebuffer to |target|. |target| must be
   // GL_FRAMEBUFFER, GL_READ_FRAMEBUFFER, or GL_DRAW_FRAMEBUFFER.
   void bind(GLenum target);
   IntSize size() const { return m_size; }
 
-  // Copies the multisample color buffer to the normal color buffer and leaves m_fbo bound.
+  // Copies the multisample color buffer to the normal color buffer and leaves
+  // m_fbo bound.
   void commit();
 
   // commit should copy the full multisample buffer, and not respect the
   // current scissor bounds. Track the state of the scissor test so that it
   // can be disabled during calls to commit.
   void setScissorEnabled(bool scissorEnabled) {
     m_scissorEnabled = scissorEnabled;
   }
 
   // The DrawingBuffer needs to track the texture bound to texture unit 0.
@@ skipping 39 matching lines @@
   void setColorMask(GLboolean* colorMask) {
     memcpy(m_colorMask, colorMask, 4 * sizeof(GLboolean));
   }
 
   // The DrawingBuffer needs to track the currently bound renderbuffer so it
   // restore the binding when needed.
   void setRenderbufferBinding(GLuint renderbuffer) {
     m_renderbufferBinding = renderbuffer;
   }
 
-  // Track the currently active texture unit. Texture unit 0 is used as host for a scratch
-  // texture.
+  // Track the currently active texture unit. Texture unit 0 is used as host for
+  // a scratch texture.
   void setActiveTextureUnit(GLint textureUnit) {
     m_activeTextureUnit = textureUnit;
   }
 
   bool multisample() const;
 
   GLuint framebuffer() const;
 
   bool discardFramebufferSupported() const {
     return m_discardFramebufferSupported;
@@ skipping 18 matching lines @@
   WebLayer* platformLayer();
 
   gpu::gles2::GLES2Interface* contextGL();
   WebGraphicsContext3DProvider* contextProvider();
 
   // cc::TextureLayerClient implementation.
   bool PrepareTextureMailbox(
       cc::TextureMailbox* outMailbox,
       std::unique_ptr<cc::SingleReleaseCallback>* outReleaseCallback) override;
 
-  // Returns a StaticBitmapImage backed by a texture containing the/ current contents of
-  // the front buffer. This is done without any pixel copies. The texture in the ImageBitmap
-  // is from the active ContextProvider on the DrawingBuffer.
+  // Returns a StaticBitmapImage backed by a texture containing the current
+  // contents of the front buffer. This is done without any pixel copies. The
+  // texture in the ImageBitmap is from the active ContextProvider on the
+  // DrawingBuffer.
   PassRefPtr<StaticBitmapImage> transferToStaticBitmapImage();
 
   // Destroys the TEXTURE_2D binding for the owned context
   bool copyToPlatformTexture(gpu::gles2::GLES2Interface*,
                              GLuint texture,
                              GLenum internalFormat,
                              GLenum destType,
                              GLint level,
                              bool premultiplyAlpha,
                              bool flipY,
@@ skipping 30 matching lines @@
                 bool wantAlphaChannel,
                 bool premultipliedAlpha,
                 PreserveDrawingBuffer,
                 WebGLVersion,
                 bool wantsDepth,
                 bool wantsStencil,
                 ChromiumImageUsage);
 
   bool initialize(const IntSize&, bool useMultisampling);
 
-  // Shared memory bitmaps that were released by the compositor and can be used again by this DrawingBuffer.
+  // Shared memory bitmaps that were released by the compositor and can be used
+  // again by this DrawingBuffer.
   struct RecycledBitmap {
     std::unique_ptr<cc::SharedBitmap> bitmap;
     IntSize size;
   };
   Vector<RecycledBitmap> m_recycledBitmaps;
 
  private:
   // All parameters necessary to generate the texture that will be passed to
   // prepareMailbox.
   struct TextureParameters {
@@ skipping 64 matching lines @@
 
   void clearPlatformLayer();
 
   PassRefPtr<MailboxInfo> takeRecycledMailbox();
   PassRefPtr<MailboxInfo> createNewMailbox(const TextureInfo&);
   void deleteMailbox(const gpu::Mailbox&, const gpu::SyncToken&);
   void freeRecycledMailboxes();
 
   std::unique_ptr<cc::SharedBitmap> createOrRecycleBitmap();
 
-  // Updates the current size of the buffer, ensuring that s_currentResourceUsePixels is updated.
+  // Updates the current size of the buffer, ensuring that
+  // s_currentResourceUsePixels is updated.
   void setSize(const IntSize& size);
 
   // This is the order of bytes to use when doing a readback.
   enum ReadbackOrder { ReadbackRGBA, ReadbackSkia };
 
   // Helper function which does a readback from the currently-bound
   // framebuffer into a buffer of a certain size with 4-byte pixels.
   void readBackFramebuffer(unsigned char* pixels,
                            int width,
                            int height,
                            ReadbackOrder,
                            WebGLImageConversion::AlphaOp);
 
   // Helper function to flip a bitmap vertically.
   void flipVertically(uint8_t* data, int width, int height);
 
-  // Allocate a storage texture if possible. Otherwise, allocate a regular texture.
+  // Allocate a storage texture if possible. Otherwise, allocate a regular
+  // texture.
   void allocateConditionallyImmutableTexture(GLenum target,
                                              GLenum internalformat,
                                              GLsizei width,
                                              GLsizei height,
                                              GLint border,
                                              GLenum format,
                                              GLenum type);
-  // Allocate buffer storage to be sent to compositor using either texImage2D or CHROMIUM_image based on available support.
+  // Allocate buffer storage to be sent to compositor using either texImage2D or
+  // CHROMIUM_image based on available support.
   void deleteChromiumImageForTexture(TextureInfo*);
 
   // If RGB emulation is required, then the CHROMIUM image's alpha channel
   // must be immediately cleared after it is bound to a texture. Nothing
   // should be allowed to change the alpha channel after this.
   void clearChromiumImageAlpha(const TextureInfo&);
 
   // Tries to create a CHROMIUM_image backed texture if
   // RuntimeEnabledFeatures::webGLImageChromiumEnabled() is true. On failure,
   // or if the flag is false, creates a default texture.
@@ skipping 63 matching lines @@
 
   // When wantExplicitResolve() returns false, the target of all draw and
   // read operations. When wantExplicitResolve() returns true, the target of
   // all read operations. A swap is performed by exchanging |m_colorBuffer|
   // with |m_frontColorBuffer|.
   GLuint m_fbo = 0;
 
   // All information about the texture storage for |m_fbo|.
   TextureInfo m_colorBuffer;
 
-  // True if our contents have been modified since the last presentation of this buffer.
+  // True if our contents have been modified since the last presentation of this
+  // buffer.
   bool m_contentsChanged = true;
 
-  // True if commit() has been called since the last time markContentsChanged() had been called.
+  // True if commit() has been called since the last time markContentsChanged()
+  // had been called.
   bool m_contentsChangeCommitted = false;
   bool m_bufferClearNeeded = false;
 
   // Whether the client wants a depth or stencil buffer.
   const bool m_wantDepth;
   const bool m_wantStencil;
 
   enum AntialiasingMode {
     None,
     MSAAImplicitResolve,
@@ skipping 18 matching lines @@
     RecycledMailbox(const gpu::Mailbox& mailbox,
                     const gpu::SyncToken& syncToken)
         : mailbox(mailbox), syncToken(syncToken) {}
 
     gpu::Mailbox mailbox;
     gpu::SyncToken syncToken;
 
    private:
     WTF_MAKE_NONCOPYABLE(RecycledMailbox);
   };
-  // Mailboxes that were released by the compositor can be used again by this DrawingBuffer.
+  // Mailboxes that were released by the compositor can be used again by this
+  // DrawingBuffer.
   Deque<RefPtr<RecycledMailbox>> m_recycledMailboxQueue;
 
   // If the width and height of the Canvas's backing store don't
   // match those that we were given in the most recent call to
   // reshape(), then we need an intermediate bitmap to read back the
   // frame buffer into. This seems to happen when CSS styles are
   // used to resize the Canvas.
   SkBitmap m_resizingBitmap;
 
   // Used to flip a bitmap vertically.
   Vector<uint8_t> m_scanline;
 
-  // In the case of OffscreenCanvas, we do not want to enable the WebGLImageChromium flag,
-  // so we replace all the RuntimeEnabledFeatures::webGLImageChromiumEnabled() call with
-  // shouldUseChromiumImage() call, and set m_chromiumImageUsage to DisallowChromiumImage
-  // in the case of OffscreenCanvas.
+  // In the case of OffscreenCanvas, we do not want to enable the
+  // WebGLImageChromium flag, so we replace all the
+  // RuntimeEnabledFeatures::webGLImageChromiumEnabled() call with
+  // shouldUseChromiumImage() calls, and set m_chromiumImageUsage to
+  // DisallowChromiumImage in the case of OffscreenCanvas.
   ChromiumImageUsage m_chromiumImageUsage;
   bool shouldUseChromiumImage();
 };
 
 }  // namespace blink
 
 #endif  // DrawingBuffer_h