Mailbox support for texture layers.

cc/texture_layer.h

 // Copyright 2010 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.
 
 #ifndef CC_TEXTURE_LAYER_H_
 #define CC_TEXTURE_LAYER_H_
 
+#include <string>
+
 #include "cc/cc_export.h"
 #include "cc/layer.h"
 
 namespace WebKit {
 class WebGraphicsContext3D;
 }
 
 namespace cc {
 
 class TextureLayerClient;
+class MailboxReleaseClient;
 
 // A Layer containing a the rendered output of a plugin instance.
 class CC_EXPORT TextureLayer : public Layer {
 public:
     // If this texture layer requires special preparation logic for each frame driven by
     // the compositor, pass in a non-nil client. Pass in a nil client pointer if texture updates
     // are driven by an external process.
     static scoped_refptr<TextureLayer> create(TextureLayerClient*);
 
+    // Used when mailbox names are specified instead of texture id's
+    static scoped_refptr<TextureLayer> createWithMailboxClient(MailboxReleaseClient*);

[danakj, 2012/12/20 02:16:19]

Instead of using a client, can we use a base::bind() callback on the
setTextureMailbox() method?

Then in the the webkit_bindings layer, we can hide the bind() stuff, if we need
to expose setTextureMailbox on the webkit api.

Because otherwise if the layer is deleted, how are we going to send the
notification?

We could, during commit, store the callback object (with the mailbox as a key)
on the impl thread somewhere. Then when we are done with it, we'll always have
the callback object available.

(even the impl layer may be gone by the time we get the ack from the parent
compositor, so it shouldn't stay on a layerImpl either, I think)

[alexst (slow to review), 2012/12/21 14:15:21]

I was thinking of trying this approach myself. New CL coming up with base::bind
callbacks. I think I like it better.

On 2012/12/20 02:16:19, danakj wrote:

+
     void clearClient() { m_client = 0; }
 
     virtual scoped_ptr<LayerImpl> createLayerImpl(LayerTreeImpl* treeImpl) OVERRIDE;
 
     // Sets whether this texture should be Y-flipped at draw time. Defaults to true.
     void setFlipped(bool);
 
     // Sets a UV transform to be used at draw time. Defaults to (0, 0, 1, 1).
     void setUVRect(const gfx::RectF&);
 
     // Sets an opacity value per vertex. It will be multiplied by the layer opacity value.
     void setVertexOpacity(float bottomLeft, float topLeft, float topRight, float bottomRight);
 
     // Sets whether the alpha channel is premultiplied or unpremultiplied. Defaults to true.
     void setPremultipliedAlpha(bool);
 
     // Sets whether this context should rate limit on damage to prevent too many frames from
     // being queued up before the compositor gets a chance to run. Requires a non-nil client.
     // Defaults to false.
     void setRateLimitContext(bool);
 
     // Code path for plugins which supply their own texture ID.
     void setTextureId(unsigned);
 
+    // Code path for plugins which supply their own texture ID.
+    void setTextureMailbox(const std::string&);
+
     void willModifyTexture();
 
     virtual void setNeedsDisplayRect(const gfx::RectF&) OVERRIDE;
 
     virtual void setLayerTreeHost(LayerTreeHost*) OVERRIDE;
     virtual bool drawsContent() const OVERRIDE;
     virtual void update(ResourceUpdateQueue&, const OcclusionTracker*, RenderingStats&) OVERRIDE;
     virtual void pushPropertiesTo(LayerImpl*) OVERRIDE;
     virtual bool blocksPendingCommit() const OVERRIDE;
 
 protected:
-    explicit TextureLayer(TextureLayerClient*);
+    TextureLayer(TextureLayerClient*, MailboxReleaseClient*);
     virtual ~TextureLayer();
 
 private:
     TextureLayerClient* m_client;
+    MailboxReleaseClient* m_mailboxClient;
 
     bool m_flipped;
     gfx::RectF m_uvRect;
     // [bottom left, top left, top right, bottom right]
     float m_vertexOpacity[4];
     bool m_premultipliedAlpha;
     bool m_rateLimitContext;
     bool m_contextLost;
     bool m_contentCommitted;
 
     unsigned m_textureId;
+    std::string m_mailboxName;
 };
 
 }
 #endif  // CC_TEXTURE_LAYER_H_