summaryrefslogtreecommitdiffstats
path: root/webkit/glue/plugins/pepper_plugin_object.h
blob: e31c1b10aad19bfbf0d3c4b9c6c58f683074f3b2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
// Copyright (c) 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 WEBKIT_GLUE_PLUGINS_PEPPER_PLUGIN_OBJECT_H_
#define WEBKIT_GLUE_PLUGINS_PEPPER_PLUGIN_OBJECT_H_

#include <string>

#include "base/basictypes.h"

struct PP_Var;
struct PPP_Class_Deprecated;
typedef struct NPObject NPObject;
typedef struct _NPVariant NPVariant;

namespace pepper {

class PluginModule;

class PluginObject {
 public:
  virtual ~PluginObject();

  // Allocates a new PluginObject and returns it as a PP_Var with a
  // refcount of 1.
  static PP_Var Create(PluginModule* module,
                       const PPP_Class_Deprecated* ppp_class,
                       void* ppp_class_data);

  PluginModule* module() const { return module_; }

  const PPP_Class_Deprecated* ppp_class() { return ppp_class_; }
  void* ppp_class_data() { return ppp_class_data_; };

  NPObject* GetNPObject() const;

  // Returns true if the given var is an object implemented by the same plugin
  // that owns the var object, and that the class matches. If it matches,
  // returns true and places the class data into |*ppp_class_data| (which can
  // optionally be NULL if no class data is desired).
  static bool IsInstanceOf(NPObject* np_object,
                           const PPP_Class_Deprecated* ppp_class,
                           void** ppp_class_data);

  // Converts the given NPObject to the corresponding ObjectVar.
  //
  // The given NPObject must be one corresponding to a PluginObject or this
  // will crash. If the object is a PluginObject but the plugin has gone
  // away (the object could still be alive because of a reference from JS),
  // then the return value will be NULL.
  static PluginObject* FromNPObject(NPObject* object);

  // Allocates a plugin wrapper object and returns it as an NPObject. This is
  // used internally only.
  static NPObject* AllocateObjectWrapper();

 private:
  struct NPObjectWrapper;

  // This object must be created using the CreateObject function of the which
  // will set up the correct NPObject.
  //
  // The NPObjectWrapper (an NPObject) should already have the reference
  // incremented on it, and this class will take ownership of that reference.
  PluginObject(PluginModule* module,
               NPObjectWrapper* object_wrapper,
               const PPP_Class_Deprecated* ppp_class,
               void* ppp_class_data);

  PluginModule* module_;

  // Holds a pointer to the NPObject wrapper backing the var. This class
  // derives from NPObject and we hold a reference to it, so it must be
  // refcounted. When the type is not an object, this value will be NULL.
  //
  // We don't actually own this pointer, it's the NPObject that actually
  // owns us.
  NPObjectWrapper* object_wrapper_;

  const PPP_Class_Deprecated* ppp_class_;
  void* ppp_class_data_;

  DISALLOW_COPY_AND_ASSIGN(PluginObject);
};

}  // namespace pepper

#endif  // WEBKIT_GLUE_PLUGINS_PEPPER_PLUGIN_OBJECT_H_