summaryrefslogtreecommitdiffstats
path: root/gfx/layers/ipc/PLayer.ipdl
diff options
context:
space:
mode:
authorMatt A. Tobin <mattatobin@localhost.localdomain>2018-02-02 04:16:08 -0500
committerMatt A. Tobin <mattatobin@localhost.localdomain>2018-02-02 04:16:08 -0500
commit5f8de423f190bbb79a62f804151bc24824fa32d8 (patch)
tree10027f336435511475e392454359edea8e25895d /gfx/layers/ipc/PLayer.ipdl
parent49ee0794b5d912db1f95dce6eb52d781dc210db5 (diff)
downloadUXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar
UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.gz
UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.lz
UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.xz
UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.zip
Add m-esr52 at 52.6.0
Diffstat (limited to 'gfx/layers/ipc/PLayer.ipdl')
-rw-r--r--gfx/layers/ipc/PLayer.ipdl39
1 files changed, 39 insertions, 0 deletions
diff --git a/gfx/layers/ipc/PLayer.ipdl b/gfx/layers/ipc/PLayer.ipdl
new file mode 100644
index 000000000..4a46b56d6
--- /dev/null
+++ b/gfx/layers/ipc/PLayer.ipdl
@@ -0,0 +1,39 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+ * vim: sw=2 ts=8 et :
+ */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+include protocol PLayerTransaction;
+
+namespace mozilla {
+namespace layers {
+
+/**
+ * PLayer represents a layer shared across thread contexts.
+ */
+
+async protocol PLayer {
+ manager PLayerTransaction;
+
+ /**
+ * OWNERSHIP MODEL
+ *
+ * Roughly speaking, the child side "actually owns" a Layer. This
+ * is because the parent side is the "shadow"; when the child
+ * releases a Layer, the parent's shadow is no longer meaningful.
+ *
+ * To implement this model, the concrete PLayerParent keeps a
+ * strong ref to its Layer, so the Layer's lifetime is bound to
+ * the PLayerParent's. Then, when the Layer's refcount hits 0 on
+ * the child side, we send __delete__() from the child to parent.
+ * The parent then releases its Layer, which results in the Layer
+ * being deleted "soon" (usually immediately).
+ */
+parent:
+ async __delete__();
+};
+
+} // layers
+} // mozilla