reflow comments in modules/webgl

third_party/WebKit/Source/modules/webgl/WebGL2RenderingContextBase.cpp

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #include "modules/webgl/WebGL2RenderingContextBase.h"
 
 #include "bindings/modules/v8/WebGLAny.h"
 #include "core/frame/ImageBitmap.h"
 #include "core/html/HTMLCanvasElement.h"
 #include "core/html/HTMLImageElement.h"
@@ skipping 455 matching lines @@
   if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
     contextGL()->FramebufferTextureLayer(target, GL_DEPTH_ATTACHMENT,
                                          objectOrZero(texture), level, layer);
     contextGL()->FramebufferTextureLayer(target, GL_STENCIL_ATTACHMENT,
                                          objectOrZero(texture), level, layer);
   } else {
     contextGL()->FramebufferTextureLayer(target, attachment,
                                          objectOrZero(texture), level, layer);
   }
   if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
-    // On ES3, DEPTH_STENCIL_ATTACHMENT is like an alias for DEPTH_ATTACHMENT + STENCIL_ATTACHMENT.
-    // We divide it here so in WebGLFramebuffer, we don't have to handle DEPTH_STENCIL_ATTACHMENT in WebGL 2.
+    // On ES3, DEPTH_STENCIL_ATTACHMENT is like an alias for DEPTH_ATTACHMENT +
+    // STENCIL_ATTACHMENT.  We divide it here so in WebGLFramebuffer, we don't
+    // have to handle DEPTH_STENCIL_ATTACHMENT in WebGL 2.
     framebufferBinding->setAttachmentForBoundFramebuffer(
         target, GL_DEPTH_ATTACHMENT, textarget, texture, level, layer);
     framebufferBinding->setAttachmentForBoundFramebuffer(
         target, GL_STENCIL_ATTACHMENT, textarget, texture, level, layer);
   } else {
     framebufferBinding->setAttachmentForBoundFramebuffer(
         target, attachment, textarget, texture, level, layer);
   }
   applyStencilTest();
 }
@@ skipping 10 matching lines @@
     synthesizeGLError(GL_INVALID_ENUM, "getInternalformatParameter",
                       "invalid target");
     return ScriptValue::createNull(scriptState);
   }
 
   switch (internalformat) {
     // Renderbuffer doesn't support unsized internal formats,
     // though GL_RGB and GL_RGBA are color-renderable.
     case GL_RGB:
     case GL_RGBA:
-    // Multisampling is not supported for signed and unsigned integer internal formats.
+    // Multisampling is not supported for signed and unsigned integer internal
+    // formats.
     case GL_R8UI:
     case GL_R8I:
     case GL_R16UI:
     case GL_R16I:
     case GL_R32UI:
     case GL_R32I:
     case GL_RG8UI:
     case GL_RG8I:
     case GL_RG16UI:
     case GL_RG16I:
@@ skipping 71 matching lines @@
     GLenum target,
     Vector<GLenum>& attachments) {
   if (!validateFramebufferTarget(target)) {
     synthesizeGLError(GL_INVALID_ENUM, functionName, "invalid target");
     return false;
   }
 
   WebGLFramebuffer* framebufferBinding = getFramebufferBinding(target);
   ASSERT(framebufferBinding || drawingBuffer());
   if (!framebufferBinding) {
-    // For the default framebuffer
-    // Translate GL_COLOR/GL_DEPTH/GL_STENCIL, because the default framebuffer of WebGL is not fb 0, it is an internal fbo
+    // For the default framebuffer, translate GL_COLOR/GL_DEPTH/GL_STENCIL.
+    // The default framebuffer of WebGL is not fb 0, it is an internal fbo.
     for (size_t i = 0; i < attachments.size(); ++i) {
       switch (attachments[i]) {
         case GL_COLOR:
           attachments[i] = GL_COLOR_ATTACHMENT0;
           break;
         case GL_DEPTH:
           attachments[i] = GL_DEPTH_ATTACHMENT;
           break;
         case GL_STENCIL:
           attachments[i] = GL_STENCIL_ATTACHMENT;
@@ skipping 187 matching lines @@
   const char* reason = "framebuffer incomplete";
   WebGLFramebuffer* framebuffer = getReadFramebufferBinding();
   if (framebuffer &&
       framebuffer->checkDepthStencilStatus(&reason) !=
           GL_FRAMEBUFFER_COMPLETE) {
     synthesizeGLError(GL_INVALID_FRAMEBUFFER_OPERATION, "readPixels", reason);
     return;
   }
 
   long long size = buffer->getSize() - offset;
-  // If size is negative, or size is not large enough to store pixels, those cases
-  // are handled by validateReadPixelsFuncParameters to generate INVALID_OPERATION.
+  // If size is negative, or size is not large enough to store pixels, those
+  // cases are handled by validateReadPixelsFuncParameters to generate
+  // INVALID_OPERATION.
   if (!validateReadPixelsFuncParameters(width, height, format, type, nullptr,
                                         size))
     return;
 
   clearIfComposited();
 
   {
     ScopedDrawingBufferBinder binder(drawingBuffer(), framebuffer);
     contextGL()->ReadPixels(x, y, width, height, format, type,
                             reinterpret_cast<void*>(offset));
@@ skipping 1526 matching lines @@
   if (!m_framebufferBinding) {
     if (n != 1) {
       synthesizeGLError(GL_INVALID_OPERATION, "drawBuffers",
                         "the number of buffers is not 1");
       return;
     }
     if (bufs[0] != GL_BACK && bufs[0] != GL_NONE) {
       synthesizeGLError(GL_INVALID_OPERATION, "drawBuffers", "BACK or NONE");
       return;
     }
-    // Because the backbuffer is simulated on all current WebKit ports, we need to change BACK to COLOR_ATTACHMENT0.
+    // Because the backbuffer is simulated on all current WebKit ports, we need
+    // to change BACK to COLOR_ATTACHMENT0.
     GLenum value = (bufs[0] == GL_BACK) ? GL_COLOR_ATTACHMENT0 : GL_NONE;
     contextGL()->DrawBuffersEXT(1, &value);
     setBackDrawBuffer(bufs[0]);
   } else {
     if (n > maxDrawBuffers()) {
       synthesizeGLError(GL_INVALID_VALUE, "drawBuffers",
                         "more than max draw buffers");
       return;
     }
     for (GLsizei i = 0; i < n; ++i) {
@@ skipping 1760 matching lines @@
   if (isContextLost() ||
       !validateGetFramebufferAttachmentParameterFunc(kFunctionName, target,
                                                      attachment))
     return ScriptValue::createNull(scriptState);
 
   WebGLFramebuffer* framebufferBinding = getFramebufferBinding(target);
   ASSERT(!framebufferBinding || framebufferBinding->object());
 
   // Default framebuffer (an internal fbo)
   if (!framebufferBinding) {
-    // We can use creationAttributes() because in WebGL 2, they are required to be honored.
+    // We can use creationAttributes() because in WebGL 2, they are required to
+    // be honored.
     bool hasDepth = creationAttributes().depth();
     bool hasStencil = creationAttributes().stencil();
     bool hasAlpha = creationAttributes().alpha();
     bool missingImage = (attachment == GL_DEPTH && !hasDepth) ||
                         (attachment == GL_STENCIL && !hasStencil);
     if (missingImage) {
       switch (pname) {
         case GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE:
           return WebGLAny(scriptState, GL_NONE);
         default:
@@ skipping 340 matching lines @@
   params.skipPixels = m_unpackSkipPixels;
   params.skipRows = m_unpackSkipRows;
   if (dimension == Tex3D) {
     params.imageHeight = m_unpackImageHeight;
     params.skipImages = m_unpackSkipImages;
   }
   return params;
 }
 
 }  // namespace blink