Index: third_party/npapi/bindings/npruntime.h |
diff --git a/third_party/npapi/bindings/npruntime.h b/third_party/npapi/bindings/npruntime.h |
deleted file mode 100644 |
index 9f7848c639ed2ef35809554f751b0360ab7b4972..0000000000000000000000000000000000000000 |
--- a/third_party/npapi/bindings/npruntime.h |
+++ /dev/null |
@@ -1,397 +0,0 @@ |
-/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ |
-/* |
- * Copyright (c) 2004, Apple Computer, Inc. and The Mozilla Foundation. |
- * All rights reserved. |
- * |
- * Redistribution and use in source and binary forms, with or without |
- * modification, are permitted provided that the following conditions are |
- * met: |
- * |
- * 1. Redistributions of source code must retain the above copyright |
- * notice, this list of conditions and the following disclaimer. |
- * 2. Redistributions in binary form must reproduce the above copyright |
- * notice, this list of conditions and the following disclaimer in the |
- * documentation and/or other materials provided with the distribution. |
- * 3. Neither the names of Apple Computer, Inc. ("Apple") or The Mozilla |
- * Foundation ("Mozilla") nor the names of their contributors may be used |
- * to endorse or promote products derived from this software without |
- * specific prior written permission. |
- * |
- * THIS SOFTWARE IS PROVIDED BY APPLE, MOZILLA AND THEIR CONTRIBUTORS "AS |
- * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED |
- * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A |
- * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE, MOZILLA OR |
- * THEIR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED |
- * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR |
- * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF |
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING |
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS |
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
- * |
- */ |
-#ifndef _NP_RUNTIME_H_ |
-#define _NP_RUNTIME_H_ |
- |
-// BEGIN GOOGLE MODIFICATIONS |
-#include "npapi.h" |
-// END GOOGLE MODIFICATIONS |
- |
-#ifdef __cplusplus |
-extern "C" { |
-#endif |
- |
-#include "nptypes.h" |
- |
-/* |
- This API is used to facilitate binding code written in C to script |
- objects. The API in this header does not assume the presence of a |
- user agent. That is, it can be used to bind C code to scripting |
- environments outside of the context of a user agent. |
- |
- However, the normal use of the this API is in the context of a |
- scripting environment running in a browser or other user agent. |
- In particular it is used to support the extended Netscape |
- script-ability API for plugins (NP-SAP). NP-SAP is an extension |
- of the Netscape plugin API. As such we have adopted the use of |
- the "NP" prefix for this API. |
- |
- The following NP{N|P}Variables were added to the Netscape plugin |
- API (in npapi.h): |
- |
- NPNVWindowNPObject |
- NPNVPluginElementNPObject |
- NPPVpluginScriptableNPObject |
- |
- These variables are exposed through NPN_GetValue() and |
- NPP_GetValue() (respectively) and are used to establish the |
- initial binding between the user agent and native code. The DOM |
- objects in the user agent can be examined and manipulated using |
- the NPN_ functions that operate on NPObjects described in this |
- header. |
- |
- To the extent possible the assumptions about the scripting |
- language used by the scripting environment have been minimized. |
-*/ |
- |
-#define NP_BEGIN_MACRO do { |
-#define NP_END_MACRO } while (0) |
- |
-/* |
- Objects (non-primitive data) passed between 'C' and script is |
- always wrapped in an NPObject. The 'interface' of an NPObject is |
- described by an NPClass. |
-*/ |
-typedef struct NPObject NPObject; |
-typedef struct NPClass NPClass; |
- |
-typedef char NPUTF8; |
-typedef struct _NPString { |
- const NPUTF8 *UTF8Characters; |
- uint32_t UTF8Length; |
-} NPString; |
- |
-typedef enum { |
- NPVariantType_Void, |
- NPVariantType_Null, |
- NPVariantType_Bool, |
- NPVariantType_Int32, |
- NPVariantType_Double, |
- NPVariantType_String, |
- NPVariantType_Object |
-} NPVariantType; |
- |
-typedef struct _NPVariant { |
- NPVariantType type; |
- union { |
- bool boolValue; |
- int32_t intValue; |
- double doubleValue; |
- NPString stringValue; |
- NPObject *objectValue; |
- } value; |
-} NPVariant; |
- |
-/* |
- NPN_ReleaseVariantValue is called on all 'out' parameters |
- references. Specifically it is to be called on variants that own |
- their value, as is the case with all non-const NPVariant* |
- arguments after a successful call to any methods (except this one) |
- in this API. |
- |
- After calling NPN_ReleaseVariantValue, the type of the variant |
- will be NPVariantType_Void. |
-*/ |
-void NPN_ReleaseVariantValue(NPVariant *variant); |
- |
-#define NPVARIANT_IS_VOID(_v) ((_v).type == NPVariantType_Void) |
-#define NPVARIANT_IS_NULL(_v) ((_v).type == NPVariantType_Null) |
-#define NPVARIANT_IS_BOOLEAN(_v) ((_v).type == NPVariantType_Bool) |
-#define NPVARIANT_IS_INT32(_v) ((_v).type == NPVariantType_Int32) |
-#define NPVARIANT_IS_DOUBLE(_v) ((_v).type == NPVariantType_Double) |
-#define NPVARIANT_IS_STRING(_v) ((_v).type == NPVariantType_String) |
-#define NPVARIANT_IS_OBJECT(_v) ((_v).type == NPVariantType_Object) |
- |
-#define NPVARIANT_TO_BOOLEAN(_v) ((_v).value.boolValue) |
-#define NPVARIANT_TO_INT32(_v) ((_v).value.intValue) |
-#define NPVARIANT_TO_DOUBLE(_v) ((_v).value.doubleValue) |
-#define NPVARIANT_TO_STRING(_v) ((_v).value.stringValue) |
-#define NPVARIANT_TO_OBJECT(_v) ((_v).value.objectValue) |
- |
-#define VOID_TO_NPVARIANT(_v) \ |
-NP_BEGIN_MACRO \ |
- (_v).type = NPVariantType_Void; \ |
- (_v).value.objectValue = NULL; \ |
-NP_END_MACRO |
- |
-#define NULL_TO_NPVARIANT(_v) \ |
-NP_BEGIN_MACRO \ |
- (_v).type = NPVariantType_Null; \ |
- (_v).value.objectValue = NULL; \ |
-NP_END_MACRO |
- |
-#define BOOLEAN_TO_NPVARIANT(_val, _v) \ |
-NP_BEGIN_MACRO \ |
- (_v).type = NPVariantType_Bool; \ |
- (_v).value.boolValue = !!(_val); \ |
-NP_END_MACRO |
- |
-#define INT32_TO_NPVARIANT(_val, _v) \ |
-NP_BEGIN_MACRO \ |
- (_v).type = NPVariantType_Int32; \ |
- (_v).value.intValue = _val; \ |
-NP_END_MACRO |
- |
-#define DOUBLE_TO_NPVARIANT(_val, _v) \ |
-NP_BEGIN_MACRO \ |
- (_v).type = NPVariantType_Double; \ |
- (_v).value.doubleValue = _val; \ |
-NP_END_MACRO |
- |
-#define STRINGZ_TO_NPVARIANT(_val, _v) \ |
-NP_BEGIN_MACRO \ |
- (_v).type = NPVariantType_String; \ |
- NPString str = { _val, (uint32_t)(strlen(_val)) }; \ |
- (_v).value.stringValue = str; \ |
-NP_END_MACRO |
- |
-#define STRINGN_TO_NPVARIANT(_val, _len, _v) \ |
-NP_BEGIN_MACRO \ |
- (_v).type = NPVariantType_String; \ |
- NPString str = { _val, (uint32_t)(_len) }; \ |
- (_v).value.stringValue = str; \ |
-NP_END_MACRO |
- |
-#define OBJECT_TO_NPVARIANT(_val, _v) \ |
-NP_BEGIN_MACRO \ |
- (_v).type = NPVariantType_Object; \ |
- (_v).value.objectValue = _val; \ |
-NP_END_MACRO |
- |
- |
-/* |
- Type mappings (JavaScript types have been used for illustration |
- purposes): |
- |
- JavaScript to C (NPVariant with type:) |
- undefined NPVariantType_Void |
- null NPVariantType_Null |
- Boolean NPVariantType_Bool |
- Number NPVariantType_Double or NPVariantType_Int32 |
- String NPVariantType_String |
- Object NPVariantType_Object |
- |
- C (NPVariant with type:) to JavaScript |
- NPVariantType_Void undefined |
- NPVariantType_Null null |
- NPVariantType_Bool Boolean |
- NPVariantType_Int32 Number |
- NPVariantType_Double Number |
- NPVariantType_String String |
- NPVariantType_Object Object |
-*/ |
- |
-typedef void *NPIdentifier; |
- |
-/* |
- NPObjects have methods and properties. Methods and properties are |
- identified with NPIdentifiers. These identifiers may be reflected |
- in script. NPIdentifiers can be either strings or integers, IOW, |
- methods and properties can be identified by either strings or |
- integers (i.e. foo["bar"] vs foo[1]). NPIdentifiers can be |
- compared using ==. In case of any errors, the requested |
- NPIdentifier(s) will be NULL. NPIdentifier lifetime is controlled |
- by the browser. Plugins do not need to worry about memory management |
- with regards to NPIdentifiers. |
-*/ |
-NPIdentifier NPN_GetStringIdentifier(const NPUTF8 *name); |
-void NPN_GetStringIdentifiers(const NPUTF8 **names, int32_t nameCount, |
- NPIdentifier *identifiers); |
-NPIdentifier NPN_GetIntIdentifier(int32_t intid); |
-bool NPN_IdentifierIsString(NPIdentifier identifier); |
- |
-/* |
- The NPUTF8 returned from NPN_UTF8FromIdentifier SHOULD be freed. |
-*/ |
-NPUTF8 *NPN_UTF8FromIdentifier(NPIdentifier identifier); |
- |
-/* |
- Get the integer represented by identifier. If identifier is not an |
- integer identifier, the behaviour is undefined. |
-*/ |
-int32_t NPN_IntFromIdentifier(NPIdentifier identifier); |
- |
-/* |
- NPObject behavior is implemented using the following set of |
- callback functions. |
- |
- The NPVariant *result argument of these functions (where |
- applicable) should be released using NPN_ReleaseVariantValue(). |
-*/ |
-typedef NPObject *(*NPAllocateFunctionPtr)(NPP npp, NPClass *aClass); |
-typedef void (*NPDeallocateFunctionPtr)(NPObject *npobj); |
-typedef void (*NPInvalidateFunctionPtr)(NPObject *npobj); |
-typedef bool (*NPHasMethodFunctionPtr)(NPObject *npobj, NPIdentifier name); |
-typedef bool (*NPInvokeFunctionPtr)(NPObject *npobj, NPIdentifier name, |
- const NPVariant *args, uint32_t argCount, |
- NPVariant *result); |
-typedef bool (*NPInvokeDefaultFunctionPtr)(NPObject *npobj, |
- const NPVariant *args, |
- uint32_t argCount, |
- NPVariant *result); |
-typedef bool (*NPHasPropertyFunctionPtr)(NPObject *npobj, NPIdentifier name); |
-typedef bool (*NPGetPropertyFunctionPtr)(NPObject *npobj, NPIdentifier name, |
- NPVariant *result); |
-typedef bool (*NPSetPropertyFunctionPtr)(NPObject *npobj, NPIdentifier name, |
- const NPVariant *value); |
-typedef bool (*NPRemovePropertyFunctionPtr)(NPObject *npobj, |
- NPIdentifier name); |
-typedef bool (*NPEnumerationFunctionPtr)(NPObject *npobj, NPIdentifier **value, |
- uint32_t *count); |
-typedef bool (*NPConstructFunctionPtr)(NPObject *npobj, |
- const NPVariant *args, |
- uint32_t argCount, |
- NPVariant *result); |
- |
-/* |
- NPObjects returned by create, retain, invoke, and getProperty pass |
- a reference count to the caller. That is, the callee adds a |
- reference count which passes to the caller. It is the caller's |
- responsibility to release the returned object. |
- |
- NPInvokeFunctionPtr function may return 0 to indicate a void |
- result. |
- |
- NPInvalidateFunctionPtr is called by the scripting environment |
- when the native code is shutdown. Any attempt to message a |
- NPObject instance after the invalidate callback has been |
- called will result in undefined behavior, even if the native code |
- is still retaining those NPObject instances. (The runtime |
- will typically return immediately, with 0 or NULL, from an attempt |
- to dispatch to a NPObject, but this behavior should not be |
- depended upon.) |
- |
- The NPEnumerationFunctionPtr function may pass an array of |
- NPIdentifiers back to the caller. The callee allocs the memory of |
- the array using NPN_MemAlloc(), and it's the caller's responsibility |
- to release it using NPN_MemFree(). |
-*/ |
-struct NPClass |
-{ |
- uint32_t structVersion; |
- NPAllocateFunctionPtr allocate; |
- NPDeallocateFunctionPtr deallocate; |
- NPInvalidateFunctionPtr invalidate; |
- NPHasMethodFunctionPtr hasMethod; |
- NPInvokeFunctionPtr invoke; |
- NPInvokeDefaultFunctionPtr invokeDefault; |
- NPHasPropertyFunctionPtr hasProperty; |
- NPGetPropertyFunctionPtr getProperty; |
- NPSetPropertyFunctionPtr setProperty; |
- NPRemovePropertyFunctionPtr removeProperty; |
- NPEnumerationFunctionPtr enumerate; |
- NPConstructFunctionPtr construct; |
-}; |
- |
-#define NP_CLASS_STRUCT_VERSION 3 |
- |
-#define NP_CLASS_STRUCT_VERSION_ENUM 2 |
-#define NP_CLASS_STRUCT_VERSION_CTOR 3 |
- |
-#define NP_CLASS_STRUCT_VERSION_HAS_ENUM(npclass) \ |
- ((npclass)->structVersion >= NP_CLASS_STRUCT_VERSION_ENUM) |
- |
-#define NP_CLASS_STRUCT_VERSION_HAS_CTOR(npclass) \ |
- ((npclass)->structVersion >= NP_CLASS_STRUCT_VERSION_CTOR) |
- |
-struct NPObject { |
- NPClass *_class; |
- uint32_t referenceCount; |
- /* |
- * Additional space may be allocated here by types of NPObjects |
- */ |
-}; |
- |
-/* |
- If the class has an allocate function, NPN_CreateObject invokes |
- that function, otherwise a NPObject is allocated and |
- returned. This method will initialize the referenceCount member of |
- the NPObject to 1. |
-*/ |
-NPObject *NPN_CreateObject(NPP npp, NPClass *aClass); |
- |
-/* |
- Increment the NPObject's reference count. |
-*/ |
-NPObject *NPN_RetainObject(NPObject *npobj); |
- |
-/* |
- Decremented the NPObject's reference count. If the reference |
- count goes to zero, the class's destroy function is invoke if |
- specified, otherwise the object is freed directly. |
-*/ |
-void NPN_ReleaseObject(NPObject *npobj); |
- |
-/* |
- Functions to access script objects represented by NPObject. |
- |
- Calls to script objects are synchronous. If a function returns a |
- value, it will be supplied via the result NPVariant |
- argument. Successful calls will return true, false will be |
- returned in case of an error. |
- |
- Calls made from plugin code to script must be made from the thread |
- on which the plugin was initialized. |
-*/ |
- |
-bool NPN_Invoke(NPP npp, NPObject *npobj, NPIdentifier methodName, |
- const NPVariant *args, uint32_t argCount, NPVariant *result); |
-bool NPN_InvokeDefault(NPP npp, NPObject *npobj, const NPVariant *args, |
- uint32_t argCount, NPVariant *result); |
-bool NPN_Evaluate(NPP npp, NPObject *npobj, NPString *script, |
- NPVariant *result); |
-bool NPN_GetProperty(NPP npp, NPObject *npobj, NPIdentifier propertyName, |
- NPVariant *result); |
-bool NPN_SetProperty(NPP npp, NPObject *npobj, NPIdentifier propertyName, |
- const NPVariant *value); |
-bool NPN_RemoveProperty(NPP npp, NPObject *npobj, NPIdentifier propertyName); |
-bool NPN_HasProperty(NPP npp, NPObject *npobj, NPIdentifier propertyName); |
-bool NPN_HasMethod(NPP npp, NPObject *npobj, NPIdentifier methodName); |
-bool NPN_Enumerate(NPP npp, NPObject *npobj, NPIdentifier **identifier, |
- uint32_t *count); |
-bool NPN_Construct(NPP npp, NPObject *npobj, const NPVariant *args, |
- uint32_t argCount, NPVariant *result); |
- |
-/* |
- NPN_SetException may be called to trigger a script exception upon |
- return from entry points into NPObjects. Typical usage: |
- |
- NPN_SetException (npobj, message); |
-*/ |
-void NPN_SetException(NPObject *npobj, const NPUTF8 *message); |
- |
-#ifdef __cplusplus |
-} |
-#endif |
- |
-#endif |