android_npapi.h revision 56074874733a95498646a3fc575ef62fd9218f58
18e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/* 25536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger * Copyright 2009, The Android Open Source Project 38e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 48e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * Redistribution and use in source and binary forms, with or without 58e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * modification, are permitted provided that the following conditions 68e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * are met: 78e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * * Redistributions of source code must retain the above copyright 88e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * notice, this list of conditions and the following disclaimer. 98e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * * Redistributions in binary form must reproduce the above copyright 108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * notice, this list of conditions and the following disclaimer in the 118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * documentation and/or other materials provided with the distribution. 128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS'' AND ANY 148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 163298a7d84b96ade73c6b170671711a8f2792ae59Steve Block * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY 218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/* Defines the android-specific types and functions as part of npapi 27a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project In particular, defines the window and event types that are passed to 298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project NPN_GetValue, NPP_SetWindow and NPP_HandleEvent. 30a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project To minimize what native libraries the plugin links against, some 328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project functionality is provided via function-ptrs (e.g. time, sound) 338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#ifndef android_npapi_H 368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define android_npapi_H 378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#include <stdint.h> 398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#include "npapi.h" 418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/////////////////////////////////////////////////////////////////////////////// 438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// General types 448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPBitmapFormats { 468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUnknown_ANPBitmapFormat = 0, 478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kRGBA_8888_ANPBitmapFormat = 1, 488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kRGB_565_ANPBitmapFormat = 2 498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPBitmapFormat; 518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 52a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reedstruct ANPPixelPacking { 53a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed uint8_t AShift; 54a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed uint8_t ABits; 55a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed uint8_t RShift; 56a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed uint8_t RBits; 57a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed uint8_t GShift; 58a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed uint8_t GBits; 59a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed uint8_t BShift; 60a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed uint8_t BBits; 61a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed}; 62a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed 638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPBitmap { 648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void* baseAddr; 658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPBitmapFormat format; 668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t width; 678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t height; 688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t rowBytes; 698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPRectF { 728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float left; 738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float top; 748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float right; 758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float bottom; 768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPRectI { 798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t left; 808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t top; 818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t right; 828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t bottom; 838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPCanvas; 868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPMatrix; 878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPPaint; 888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPPath; 898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPRegion; 908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPTypeface; 918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPMatrixFlags { 938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kIdentity_ANPMatrixFlag = 0, 948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kTranslate_ANPMatrixFlag = 0x01, 958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kScale_ANPMatrixFlag = 0x02, 968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kAffine_ANPMatrixFlag = 0x04, 978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kPerspective_ANPMatrixFlag = 0x08, 988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPMatrixFlag; 1008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/////////////////////////////////////////////////////////////////////////////// 1028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// NPN_GetValue 1038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 104ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger/** queries for a specific ANPInterface. 105a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 1068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project Maybe called with NULL for the NPP instance 107a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 1088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project NPN_GetValue(inst, interface_enum, ANPInterface*) 1098e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 1108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define kLogInterfaceV0_ANPGetValue ((NPNVariable)1000) 1118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define kAudioTrackInterfaceV0_ANPGetValue ((NPNVariable)1001) 1128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define kCanvasInterfaceV0_ANPGetValue ((NPNVariable)1002) 1138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define kMatrixInterfaceV0_ANPGetValue ((NPNVariable)1003) 1148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define kPaintInterfaceV0_ANPGetValue ((NPNVariable)1004) 1152ca6453fc4f0b0ba77f29630f3036d1765db9702Mike Reed#define kPathInterfaceV0_ANPGetValue ((NPNVariable)1005) 1162ca6453fc4f0b0ba77f29630f3036d1765db9702Mike Reed#define kTypefaceInterfaceV0_ANPGetValue ((NPNVariable)1006) 1172ca6453fc4f0b0ba77f29630f3036d1765db9702Mike Reed#define kWindowInterfaceV0_ANPGetValue ((NPNVariable)1007) 118a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define kBitmapInterfaceV0_ANPGetValue ((NPNVariable)1008) 119f86737b0ce8c81f2b529503f83eb8b064769eecaDerek Sollenberger#define kSurfaceInterfaceV0_ANPGetValue ((NPNVariable)1009) 1200a2bed53555947aea37912d694f9c7c376490808Grace Kloba#define kSystemInterfaceV0_ANPGetValue ((NPNVariable)1010) 12156074874733a95498646a3fc575ef62fd9218f58Mike Reed#define kEventInterfaceV0_ANPGetValue ((NPNVariable)1011) 1228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 123ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger/** queries for which drawing model is desired (for the draw event) 124a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 1258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project Should be called inside NPP_New(...) 126a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 1278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project NPN_GetValue(inst, ANPSupportedDrawingModel_EnumValue, uint32_t* bits) 1288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 1298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define kSupportedDrawingModel_ANPGetValue ((NPNVariable)2000) 1308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/////////////////////////////////////////////////////////////////////////////// 13256ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger// NPN_SetValue 1338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 13410d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger/** Request to set the drawing model. SetValue will return false if the drawing 13510d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger model is not supported or has insufficient information for configuration. 136a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 13710d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger NPN_SetValue(inst, kRequestDrawingModel_ANPSetValue, (void*)foo_ANPDrawingModel) 1388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 1398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define kRequestDrawingModel_ANPSetValue ((NPPVariable)1000) 1408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1415536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger/** These are used as bitfields in ANPSupportedDrawingModels_EnumValue, 1425536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger and as-is in ANPRequestDrawingModel_EnumValue. The drawing model determines 1435536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger how to interpret the ANPDrawingContext provided in the Draw event and how 1445536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger to interpret the NPWindow->window field. 1455536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger */ 1465536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenbergerenum ANPDrawingModels { 1475536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger /** Draw into a bitmap from the browser thread in response to a Draw event. 1485536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger NPWindow->window is reserved (ignore) 1495536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger */ 1505536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger kBitmap_ANPDrawingModel = 0, 1515536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger /** Draw into a surface (e.g. raster, openGL, etc.) using the Java surface 1525536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger interface. When this model is used the browser will invoke the Java 1531a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger class specified in the plugin's apk manifest. From that class the browser 1541a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger will invoke the appropriate method to return an an instance of a android 1551a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger Java View. The instance is then embedded in the html. The plugin can then 1561a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger manipulate the view as it would any normal Java View in android. 1575536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 1585536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger Unlike the bitmap model, a surface model is opaque so no html content 1595536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger behind the plugin will be visible. Unless the plugin needs to be 1605536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger transparent the surface model should be chosen over the bitmap model as 1615536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger it will have better performance. 1625536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 1635536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger Further, a plugin can manipulate some surfaces in native code using the 1645536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger ANPSurfaceInterface. This interface can be used to manipulate Java 1655536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger objects that extend Surface.class by allowing them to access the 1665536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger surface's underlying bitmap in native code. For instance, if a raster 1675536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger surface is used the plugin can lock, draw directly into the bitmap, and 1685536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger unlock the surface in native code without making JNI calls to the Java 1695536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger surface object. 1705536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger */ 1715536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger kSurface_ANPDrawingModel = 0x01, 1725536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger}; 1735536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenbergertypedef int32_t ANPDrawingModel; 1745536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 175243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger/** Request to receive/disable events. If the pointer is NULL then all flags will 176243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger be disabled. Otherwise, the event type will be enabled iff its corresponding 17756ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger bit in the EventFlags bit field is set. 17856ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger 17956ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger NPN_SetValue(inst, ANPAcceptEvents, (void*)EventFlags) 18056ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger */ 1811a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger#define kAcceptEvents_ANPSetValue ((NPPVariable)1001) 18256ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger 183ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger/** The EventFlags are a set of bits used to determine which types of events the 18456ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger plugin wishes to receive. For example, if the value is 0x03 then both key 18556ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger and touch events will be provided to the plugin. 18656ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger */ 18756ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenbergerenum ANPEventFlag { 188243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger kKey_ANPEventFlag = 0x01, 189243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger kTouch_ANPEventFlag = 0x02, 19056ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger}; 19156ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenbergertypedef uint32_t ANPEventFlags; 19256ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger 1935536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 1945536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger/////////////////////////////////////////////////////////////////////////////// 1955536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger// ANDROID INTERFACE DEFINITIONS 1965536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 197ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger/** Interfaces provide additional functionality to the plugin via function ptrs. 198ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger Once an interface is retrieved, it is valid for the lifetime of the plugin 1998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project (just like browserfuncs). 200a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 2018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project All ANPInterfaces begin with an inSize field, which must be set by the 2028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project caller (plugin) with the number of bytes allocated for the interface. 2038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project e.g. SomeInterface si; si.inSize = sizeof(si); browser->getvalue(..., &si); 2048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPInterface { 2068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project uint32_t inSize; // size (in bytes) of this struct 2078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 2088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2098e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPLogTypes { 2108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kError_ANPLogType = 0, // error 2118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kWarning_ANPLogType = 1, // warning 2128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kDebug_ANPLogType = 2 // debug only (informational) 2138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 2148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPLogType; 2158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPLogInterfaceV0 : ANPInterface { 217ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** dumps printf messages to the log file 218ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger e.g. interface->log(instance, kWarning_ANPLogType, "value is %d", value); 219ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger */ 22024ba66f9ba2dae444192c4860c7b57c4289d4d5cDerek Sollenberger void (*log)(ANPLogType, const char format[], ...); 2218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 2228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 223a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reedstruct ANPBitmapInterfaceV0 : ANPInterface { 224a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed /** Returns true if the specified bitmap format is supported, and if packing 225a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed is non-null, sets it to the packing info for that format. 226a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed */ 227a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed bool (*getPixelPacking)(ANPBitmapFormat, ANPPixelPacking* packing); 228a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed}; 229a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed 2308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPMatrixInterfaceV0 : ANPInterface { 231ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return a new identity matrix 2328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPMatrix* (*newMatrix)(); 234ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Delete a matrix previously allocated by newMatrix() 2358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*deleteMatrix)(ANPMatrix*); 2378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPMatrixFlag (*getFlags)(const ANPMatrix*); 2398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*copy)(ANPMatrix* dst, const ANPMatrix* src); 2418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 242ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the matrix values in a float array (allcoated by the caller), 2438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project where the values are treated as follows: 2448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project w = x * [6] + y * [7] + [8]; 2458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project x' = (x * [0] + y * [1] + [2]) / w; 2468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project y' = (x * [3] + y * [4] + [5]) / w; 2478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*get3x3)(const ANPMatrix*, float[9]); 249ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Initialize the matrix from values in a float array, 2508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project where the values are treated as follows: 2518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project w = x * [6] + y * [7] + [8]; 2528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project x' = (x * [0] + y * [1] + [2]) / w; 2538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project y' = (x * [3] + y * [4] + [5]) / w; 2548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*set3x3)(ANPMatrix*, const float[9]); 2568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setIdentity)(ANPMatrix*); 2588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preTranslate)(ANPMatrix*, float tx, float ty); 2598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postTranslate)(ANPMatrix*, float tx, float ty); 2608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preScale)(ANPMatrix*, float sx, float sy); 2618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postScale)(ANPMatrix*, float sx, float sy); 2628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preSkew)(ANPMatrix*, float kx, float ky); 2638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postSkew)(ANPMatrix*, float kx, float ky); 2648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preRotate)(ANPMatrix*, float degrees); 2658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postRotate)(ANPMatrix*, float degrees); 2668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preConcat)(ANPMatrix*, const ANPMatrix*); 2678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postConcat)(ANPMatrix*, const ANPMatrix*); 2688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 269ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return true if src is invertible, and if so, return its inverse in dst. 2708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project If src is not invertible, return false and ignore dst. 2718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*invert)(ANPMatrix* dst, const ANPMatrix* src); 2738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 274ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Transform the x,y pairs in src[] by this matrix, and store the results 2758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project in dst[]. The count parameter is treated as the number of pairs in the 2768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project array. It is legal for src and dst to point to the same memory, but 2778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project illegal for the two arrays to partially overlap. 2788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*mapPoints)(ANPMatrix*, float dst[], const float src[], 2808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t count); 2818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 2828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2834603aa50552a853aa7aedcd809460a83586daa53Mike Reedstruct ANPPathInterfaceV0 : ANPInterface { 284ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return a new path */ 2854603aa50552a853aa7aedcd809460a83586daa53Mike Reed ANPPath* (*newPath)(); 2864603aa50552a853aa7aedcd809460a83586daa53Mike Reed 287ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Delete a path previously allocated by ANPPath() */ 2884603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*deletePath)(ANPPath*); 2894603aa50552a853aa7aedcd809460a83586daa53Mike Reed 290ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Make a deep copy of the src path, into the dst path (already allocated 291ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger by the caller). 2924603aa50552a853aa7aedcd809460a83586daa53Mike Reed */ 2934603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*copy)(ANPPath* dst, const ANPPath* src); 2944603aa50552a853aa7aedcd809460a83586daa53Mike Reed 295ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Returns true if the two paths are the same (i.e. have the same points) 2964603aa50552a853aa7aedcd809460a83586daa53Mike Reed */ 2974603aa50552a853aa7aedcd809460a83586daa53Mike Reed bool (*equal)(const ANPPath* path0, const ANPPath* path1); 2984603aa50552a853aa7aedcd809460a83586daa53Mike Reed 299ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Remove any previous points, initializing the path back to empty. */ 3004603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*reset)(ANPPath*); 3014603aa50552a853aa7aedcd809460a83586daa53Mike Reed 302ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return true if the path is empty (has no lines, quads or cubics). */ 3034603aa50552a853aa7aedcd809460a83586daa53Mike Reed bool (*isEmpty)(const ANPPath*); 3044603aa50552a853aa7aedcd809460a83586daa53Mike Reed 305ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the path's bounds in bounds. */ 3064603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*getBounds)(const ANPPath*, ANPRectF* bounds); 3074603aa50552a853aa7aedcd809460a83586daa53Mike Reed 3084603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*moveTo)(ANPPath*, float x, float y); 3094603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*lineTo)(ANPPath*, float x, float y); 3104603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*quadTo)(ANPPath*, float x0, float y0, float x1, float y1); 3114603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*cubicTo)(ANPPath*, float x0, float y0, float x1, float y1, 3124603aa50552a853aa7aedcd809460a83586daa53Mike Reed float x2, float y2); 3134603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*close)(ANPPath*); 3144603aa50552a853aa7aedcd809460a83586daa53Mike Reed 315ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Offset the src path by [dx, dy]. If dst is null, apply the 3164603aa50552a853aa7aedcd809460a83586daa53Mike Reed change directly to the src path. If dst is not null, write the 3174603aa50552a853aa7aedcd809460a83586daa53Mike Reed changed path into dst, and leave the src path unchanged. In that case 3184603aa50552a853aa7aedcd809460a83586daa53Mike Reed dst must have been previously allocated by the caller. 3194603aa50552a853aa7aedcd809460a83586daa53Mike Reed */ 3204603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*offset)(ANPPath* src, float dx, float dy, ANPPath* dst); 3214603aa50552a853aa7aedcd809460a83586daa53Mike Reed 322ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Transform the path by the matrix. If dst is null, apply the 3234603aa50552a853aa7aedcd809460a83586daa53Mike Reed change directly to the src path. If dst is not null, write the 3244603aa50552a853aa7aedcd809460a83586daa53Mike Reed changed path into dst, and leave the src path unchanged. In that case 3254603aa50552a853aa7aedcd809460a83586daa53Mike Reed dst must have been previously allocated by the caller. 3264603aa50552a853aa7aedcd809460a83586daa53Mike Reed */ 3274603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*transform)(ANPPath* src, const ANPMatrix*, ANPPath* dst); 3284603aa50552a853aa7aedcd809460a83586daa53Mike Reed}; 3294603aa50552a853aa7aedcd809460a83586daa53Mike Reed 330a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed/** ANPColor is always defined to have the same packing on all platforms, and 331a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed it is always unpremultiplied. 3320fae426bf2862e6ba2745a999ecb25d172c6860aDerek Sollenberger 333a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed This is in contrast to 32bit format(s) in bitmaps, which are premultiplied, 334a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed and their packing may vary depending on the platform, hence the need for 335a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed ANPBitmapInterface::getPixelPacking() 336a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed */ 3378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPColor; 338a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define ANPColor_ASHIFT 24 339a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define ANPColor_RSHIFT 16 340a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define ANPColor_GSHIFT 8 341a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define ANPColor_BSHIFT 0 3428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define ANP_MAKE_COLOR(a, r, g, b) \ 343a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed (((a) << ANPColor_ASHIFT) | \ 344a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed ((r) << ANPColor_RSHIFT) | \ 345a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed ((g) << ANPColor_GSHIFT) | \ 346a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed ((b) << ANPColor_BSHIFT)) 3478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintFlag { 3498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kAntiAlias_ANPPaintFlag = 1 << 0, 3508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kFilterBitmap_ANPPaintFlag = 1 << 1, 3518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kDither_ANPPaintFlag = 1 << 2, 3528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUnderlineText_ANPPaintFlag = 1 << 3, 3538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kStrikeThruText_ANPPaintFlag = 1 << 4, 3548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kFakeBoldText_ANPPaintFlag = 1 << 5, 3558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPPaintFlags; 3578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintStyles { 3598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kFill_ANPPaintStyle = 0, 3608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kStroke_ANPPaintStyle = 1, 3618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kFillAndStroke_ANPPaintStyle = 2 3628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPPaintStyle; 3648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintCaps { 3668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kButt_ANPPaintCap = 0, 3678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kRound_ANPPaintCap = 1, 3688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kSquare_ANPPaintCap = 2 3698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPPaintCap; 3718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintJoins { 3738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kMiter_ANPPaintJoin = 0, 3748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kRound_ANPPaintJoin = 1, 3758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kBevel_ANPPaintJoin = 2 3768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPPaintJoin; 3788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintAligns { 3808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kLeft_ANPPaintAlign = 0, 3818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kCenter_ANPPaintAlign = 1, 3828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kRight_ANPPaintAlign = 2 3838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPPaintAlign; 3858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPTextEncodings { 3878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUTF8_ANPTextEncoding = 0, 3888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUTF16_ANPTextEncoding = 1, 3898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPTextEncoding; 3918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPTypefaceStyles { 3938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kBold_ANPTypefaceStyle = 1 << 0, 3948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kItalic_ANPTypefaceStyle = 1 << 1 3958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPTypefaceStyle; 3978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 398b91f67b5c82b6d5f399a629b1434fc40a271737cMike Reedtypedef uint32_t ANPFontTableTag; 399b91f67b5c82b6d5f399a629b1434fc40a271737cMike Reed 4008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPFontMetrics { 401ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The greatest distance above the baseline for any glyph (will be <= 0) */ 4028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fTop; 403ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The recommended distance above the baseline (will be <= 0) */ 4048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fAscent; 405ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The recommended distance below the baseline (will be >= 0) */ 4068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fDescent; 407ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The greatest distance below the baseline for any glyph (will be >= 0) */ 4088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fBottom; 409ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The recommended distance to add between lines of text (will be >= 0) */ 4108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fLeading; 4118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 4128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPTypefaceInterfaceV0 : ANPInterface { 4148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return a new reference to the typeface that most closely matches the 4158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project requested name and style. Pass null as the name to return 4168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project the default font for the requested style. Will never return null 4178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4181c97c8027a51a511742fcabf75365e3b5a35828eMike Reed The 5 generic font names "serif", "sans-serif", "monospace", "cursive", 4191c97c8027a51a511742fcabf75365e3b5a35828eMike Reed "fantasy" are recognized, and will be mapped to their logical font 4201c97c8027a51a511742fcabf75365e3b5a35828eMike Reed automatically by this call. 4211c97c8027a51a511742fcabf75365e3b5a35828eMike Reed 4228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param name May be NULL. The name of the font family. 4238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param style The style (normal, bold, italic) of the typeface. 4248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @return reference to the closest-matching typeface. Caller must call 4258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project unref() when they are done with the typeface. 4268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypeface* (*createFromName)(const char name[], ANPTypefaceStyle); 4288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return a new reference to the typeface that most closely matches the 4308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project requested typeface and specified Style. Use this call if you want to 4318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project pick a new style from the same family of the existing typeface. 4328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project If family is NULL, this selects from the default font's family. 4338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param family May be NULL. The name of the existing type face. 4358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param s The style (normal, bold, italic) of the type face. 4368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @return reference to the closest-matching typeface. Call must call 4378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project unref() when they are done. 4388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypeface* (*createFromTypeface)(const ANPTypeface* family, 4408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypefaceStyle); 441a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 4428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the owner count of the typeface. A newly created typeface has an 4438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project owner count of 1. When the owner count is reaches 0, the typeface is 4448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project deleted. 4458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t (*getRefCount)(const ANPTypeface*); 4478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Increment the owner count on the typeface 4498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*ref)(ANPTypeface*); 4518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Decrement the owner count on the typeface. When the count goes to 0, 4538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project the typeface is deleted. 4548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*unref)(ANPTypeface*); 456a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 4578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the style bits for the specified typeface 4588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypefaceStyle (*getStyle)(const ANPTypeface*); 460b91f67b5c82b6d5f399a629b1434fc40a271737cMike Reed 4613cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed /** Some fonts are stored in files. If that is true for the fontID, then 4623cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed this returns the byte length of the full file path. If path is not null, 4633cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed then the full path is copied into path (allocated by the caller), up to 4643cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed length bytes. If index is not null, then it is set to the truetype 4653cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed collection index for this font, or 0 if the font is not in a collection. 4663cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 4673cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed Note: getFontPath does not assume that path is a null-terminated string, 4683cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed so when it succeeds, it only copies the bytes of the file name and 4693cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed nothing else (i.e. it copies exactly the number of bytes returned by the 4703cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed function. If the caller wants to treat path[] as a C string, it must be 4713cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed sure that it is allocated at least 1 byte larger than the returned size, 4723cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed and it must copy in the terminating 0. 4733cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 4743cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed If the fontID does not correspond to a file, then the function returns 4753cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 0, and the path and index parameters are ignored. 4763cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 4773cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @param fontID The font whose file name is being queried 4783cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @param path Either NULL, or storage for receiving up to length bytes 4793cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed of the font's file name. Allocated by the caller. 4803cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @param length The maximum space allocated in path (by the caller). 4813cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed Ignored if path is NULL. 4823cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @param index Either NULL, or receives the TTC index for this font. 4833cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed If the font is not a TTC, then will be set to 0. 4843cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @return The byte length of th font's file name, or 0 if the font is not 4853cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed baked by a file. 4863cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed */ 4873cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed int32_t (*getFontPath)(const ANPTypeface*, char path[], int32_t length, 4883cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed int32_t* index); 4893cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 4901c97c8027a51a511742fcabf75365e3b5a35828eMike Reed /** Return a UTF8 encoded path name for the font directory, or NULL if not 4911c97c8027a51a511742fcabf75365e3b5a35828eMike Reed supported. If returned, this string address will be valid for the life 49210d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger of the plugin instance. It will always end with a '/' character. 493b91f67b5c82b6d5f399a629b1434fc40a271737cMike Reed */ 494ae107e96f52ebe258a8ef5f32100c77ededc2d34Mike Reed const char* (*getFontDirectoryPath)(); 4958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 4968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPPaintInterfaceV0 : ANPInterface { 498ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return a new paint object, which holds all of the color and style 4998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project attributes that affect how things (geometry, text, bitmaps) are drawn 5008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project in a ANPCanvas. 501a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project The paint that is returned is not tied to any particular plugin 5038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project instance, but it must only be accessed from one thread at a time. 5048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaint* (*newPaint)(); 5068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*deletePaint)(ANPPaint*); 507a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintFlags (*getFlags)(const ANPPaint*); 5098e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setFlags)(ANPPaint*, ANPPaintFlags); 510a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPColor (*getColor)(const ANPPaint*); 5128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setColor)(ANPPaint*, ANPColor); 513a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintStyle (*getStyle)(const ANPPaint*); 5158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStyle)(ANPPaint*, ANPPaintStyle); 5168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getStrokeWidth)(const ANPPaint*); 5188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getStrokeMiter)(const ANPPaint*); 5198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintCap (*getStrokeCap)(const ANPPaint*); 5208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintJoin (*getStrokeJoin)(const ANPPaint*); 5218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStrokeWidth)(ANPPaint*, float); 5228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStrokeMiter)(ANPPaint*, float); 5238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStrokeCap)(ANPPaint*, ANPPaintCap); 5248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStrokeJoin)(ANPPaint*, ANPPaintJoin); 525a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTextEncoding (*getTextEncoding)(const ANPPaint*); 5278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintAlign (*getTextAlign)(const ANPPaint*); 5288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getTextSize)(const ANPPaint*); 5298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getTextScaleX)(const ANPPaint*); 5308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getTextSkewX)(const ANPPaint*); 5318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextEncoding)(ANPPaint*, ANPTextEncoding); 5328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextAlign)(ANPPaint*, ANPPaintAlign); 5338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextSize)(ANPPaint*, float); 5348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextScaleX)(ANPPaint*, float); 5358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextSkewX)(ANPPaint*, float); 5368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the typeface ine paint, or null if there is none. This does not 5388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project modify the owner count of the returned typeface. 5398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypeface* (*getTypeface)(const ANPPaint*); 5418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Set the paint's typeface. If the paint already had a non-null typeface, 5438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project its owner count is decremented. If the new typeface is non-null, its 5448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project owner count is incremented. 5458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTypeface)(ANPPaint*, ANPTypeface*); 5478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the width of the text. If bounds is not null, return the bounds 5498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project of the text in that rectangle. 5508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*measureText)(ANPPaint*, const void* text, uint32_t byteLength, 5528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPRectF* bounds); 553a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the number of unichars specifed by the text. 5558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project If widths is not null, returns the array of advance widths for each 5568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project unichar. 5578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project If bounds is not null, returns the array of bounds for each unichar. 5588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int (*getTextWidths)(ANPPaint*, const void* text, uint32_t byteLength, 5608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float widths[], ANPRectF bounds[]); 561a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return in metrics the spacing values for text, respecting the paint's 5638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project typeface and pointsize, and return the spacing between lines 5648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project (descent - ascent + leading). If metrics is NULL, it will be ignored. 5658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getFontMetrics)(ANPPaint*, ANPFontMetrics* metrics); 5678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 5688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPCanvasInterfaceV0 : ANPInterface { 570ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return a canvas that will draw into the specified bitmap. Note: the 5718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project canvas copies the fields of the bitmap, so it need not persist after 5728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project this call, but the canvas DOES point to the same pixel memory that the 5738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bitmap did, so the canvas should not be used after that pixel memory 5748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project goes out of scope. In the case of creating a canvas to draw into the 5758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project pixels provided by kDraw_ANPEventType, those pixels are only while 5768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project handling that event. 577a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project The canvas that is returned is not tied to any particular plugin 5798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project instance, but it must only be accessed from one thread at a time. 5808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPCanvas* (*newCanvas)(const ANPBitmap*); 5828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*deleteCanvas)(ANPCanvas*); 5838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*save)(ANPCanvas*); 5858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*restore)(ANPCanvas*); 5868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*translate)(ANPCanvas*, float tx, float ty); 5878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*scale)(ANPCanvas*, float sx, float sy); 5888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*rotate)(ANPCanvas*, float degrees); 5898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*skew)(ANPCanvas*, float kx, float ky); 5908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*concat)(ANPCanvas*, const ANPMatrix*); 5918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*clipRect)(ANPCanvas*, const ANPRectF*); 5928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*clipPath)(ANPCanvas*, const ANPPath*); 5938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 594ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the current matrix on the canvas 5958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*getTotalMatrix)(ANPCanvas*, ANPMatrix*); 597ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the current clip bounds in local coordinates, expanding it to 5988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project account for antialiasing edge effects if aa is true. If the 5998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project current clip is empty, return false and ignore the bounds argument. 6008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*getLocalClipBounds)(ANPCanvas*, ANPRectF* bounds, bool aa); 602ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the current clip bounds in device coordinates in bounds. If the 6038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project current clip is empty, return false and ignore the bounds argument. 6048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*getDeviceClipBounds)(ANPCanvas*, ANPRectI* bounds); 6064603aa50552a853aa7aedcd809460a83586daa53Mike Reed 6078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawColor)(ANPCanvas*, ANPColor); 6088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawPaint)(ANPCanvas*, const ANPPaint*); 6094603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*drawLine)(ANPCanvas*, float x0, float y0, float x1, float y1, 6104603aa50552a853aa7aedcd809460a83586daa53Mike Reed const ANPPaint*); 6118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawRect)(ANPCanvas*, const ANPRectF*, const ANPPaint*); 6128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawOval)(ANPCanvas*, const ANPRectF*, const ANPPaint*); 6138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawPath)(ANPCanvas*, const ANPPath*, const ANPPaint*); 6148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawText)(ANPCanvas*, const void* text, uint32_t byteLength, 6158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float x, float y, const ANPPaint*); 6168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawPosText)(ANPCanvas*, const void* text, uint32_t byteLength, 6178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project const float xy[], const ANPPaint*); 6188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawBitmap)(ANPCanvas*, const ANPBitmap*, float x, float y, 6198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project const ANPPaint*); 6208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawBitmapRect)(ANPCanvas*, const ANPBitmap*, 6218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project const ANPRectI* src, const ANPRectF* dst, 6228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project const ANPPaint*); 6238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 6248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPWindowInterfaceV0 : ANPInterface { 626e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger /** Registers a set of rectangles that the plugin would like to keep on 627e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger screen. The rectangles are listed in order of priority with the highest 628e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger priority rectangle in location rects[0]. The browser will attempt to keep 629e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger as many of the rectangles on screen as possible and will scroll them into 630e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger view in response to the invocation of this method and other various events. 631e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger The count specifies how many rectangles are in the array. If the count is 632e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger zero it signals the browser that any existing rectangles should be cleared 633e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger and no rectangles will be tracked. 634e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger */ 635e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger void (*setVisibleRects)(NPP instance, const ANPRectI rects[], int32_t count); 636e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger /** Clears any rectangles that are being tracked as a result of a call to 637e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger setVisibleRects. This call is equivalent to setVisibleRect(inst, NULL, 0). 638e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger */ 639e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger void (*clearVisibleRects)(NPP instance); 6405c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger /** Given a boolean value of true the device will be requested to provide 6415c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger a keyboard. A value of false will result in a request to hide the 6425c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger keyboard. Further, the on-screen keyboard will not be displayed if a 6435c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger physical keyboard is active. 6445c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger */ 6455c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger void (*showKeyboard)(NPP instance, bool value); 646e23a6d30242a5dbcdce40e708e0f97b21d06c2afDerek Sollenberger /** Called when a plugin wishes to enter into full screen mode. The plugin's 6471a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger Java class (defined in the plugin's apk manifest) will be called 6481a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger asynchronously to provide a View object to be displayed full screen. 649e23a6d30242a5dbcdce40e708e0f97b21d06c2afDerek Sollenberger */ 650e23a6d30242a5dbcdce40e708e0f97b21d06c2afDerek Sollenberger void (*requestFullScreen)(NPP instance); 651dcab27c390251a3b534b8eeb1fa5b8301686b1abDerek Sollenberger /** Called when a plugin wishes to exit from full screen mode. As a result, 652dcab27c390251a3b534b8eeb1fa5b8301686b1abDerek Sollenberger the plugin's full screen view will be discarded by the view system. 653dcab27c390251a3b534b8eeb1fa5b8301686b1abDerek Sollenberger */ 654dcab27c390251a3b534b8eeb1fa5b8301686b1abDerek Sollenberger void (*exitFullScreen)(NPP instance); 6558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 6568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/////////////////////////////////////////////////////////////////////////////// 6588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPSampleFormats { 6608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUnknown_ANPSamleFormat = 0, 6618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kPCM16Bit_ANPSampleFormat = 1, 6628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kPCM8Bit_ANPSampleFormat = 2 6638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 6648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPSampleFormat; 6658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/** The audio buffer is passed to the callback proc to request more samples. 6678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project It is owned by the system, and the callback may read it, but should not 6688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project maintain a pointer to it outside of the scope of the callback proc. 6698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPAudioBuffer { 6718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project // RO - repeat what was specified in newTrack() 6728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t channelCount; 6738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project // RO - repeat what was specified in newTrack() 6748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPSampleFormat format; 6758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** This buffer is owned by the caller. Inside the callback proc, up to 6768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project "size" bytes of sample data should be written into this buffer. The 6778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project address is only valid for the scope of a single invocation of the 6788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project callback proc. 6798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void* bufferData; 6818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** On input, specifies the maximum number of bytes that can be written 6828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project to "bufferData". On output, specifies the actual number of bytes that 6838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project the callback proc wrote into "bufferData". 6848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project uint32_t size; 6868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 6878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPAudioEvents { 6898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** This event is passed to the callback proc when the audio-track needs 6908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project more sample data written to the provided buffer parameter. 6918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kMoreData_ANPAudioEvent = 0, 6938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** This event is passed to the callback proc if the audio system runs out 6948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project of sample data. In this event, no buffer parameter will be specified 6958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project (i.e. NULL will be passed to the 3rd parameter). 6968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUnderRun_ANPAudioEvent = 1 6988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 6998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPAudioEvent; 7008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/** Called to feed sample data to the track. This will be called in a separate 7028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project thread. However, you may call trackStop() from the callback (but you 7038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project cannot delete the track). 704a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 7058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project For example, when you have written the last chunk of sample data, you can 7068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project immediately call trackStop(). This will take effect after the current 7078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project buffer has been played. 708a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 7098e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project The "user" parameter is the same value that was passed to newTrack() 7108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef void (*ANPAudioCallbackProc)(ANPAudioEvent event, void* user, 7128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPAudioBuffer* buffer); 7138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPAudioTrack; // abstract type for audio tracks 7158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPAudioTrackInterfaceV0 : ANPInterface { 717eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Create a new audio track, or NULL on failure. The track is initially in 718eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger the stopped state and therefore ANPAudioCallbackProc will not be called 719eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger until the track is started. 7208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPAudioTrack* (*newTrack)(uint32_t sampleRate, // sampling rate in Hz 7228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPSampleFormat, 7238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int channelCount, // MONO=1, STEREO=2 7248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPAudioCallbackProc, 7258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void* user); 726eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Deletes a track that was created using newTrack. The track can be 727eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger deleted in any state and it waits for the ANPAudioCallbackProc thread 728eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger to exit before returning. 729eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 7308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*deleteTrack)(ANPAudioTrack*); 7318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*start)(ANPAudioTrack*); 7338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*pause)(ANPAudioTrack*); 7348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*stop)(ANPAudioTrack*); 7358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Returns true if the track is not playing (e.g. pause or stop was called, 7368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project or start was never called. 7378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*isStopped)(ANPAudioTrack*); 7398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/////////////////////////////////////////////////////////////////////////////// 7425536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger// DEFINITION OF VALUES PASSED THROUGH NPP_HandleEvent 7438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPEventTypes { 7453d709e1f628a1547fba1e4cab0c91a55f7ed7e7aDerek Sollenberger kNull_ANPEventType = 0, 7463d709e1f628a1547fba1e4cab0c91a55f7ed7e7aDerek Sollenberger kKey_ANPEventType = 1, 747eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Mouse events are triggered by either clicking with the navigational pad 748eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger or by tapping the touchscreen (if the kDown_ANPTouchAction is handled by 749eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger the plugin then no mouse event is generated). The kKey_ANPEventFlag has 750eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger to be set to true in order to receive these events. 751eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 752d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kMouse_ANPEventType = 2, 753eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Touch events are generated when the user touches on the screen. The 754eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger kTouch_ANPEventFlag has to be set to true in order to receive these 755eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger events. 756eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 757d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kTouch_ANPEventType = 3, 758eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Only triggered by a plugin using the kBitmap_ANPDrawingModel. This event 759eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger signals that the plugin needs to redraw itself into the provided bitmap. 760eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 761d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kDraw_ANPEventType = 4, 762d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kLifecycle_ANPEventType = 5, 76356074874733a95498646a3fc575ef62fd9218f58Mike Reed 76456074874733a95498646a3fc575ef62fd9218f58Mike Reed /** This event type is completely defined by the plugin. 76556074874733a95498646a3fc575ef62fd9218f58Mike Reed When creating an event, the caller must always set the first 76656074874733a95498646a3fc575ef62fd9218f58Mike Reed two fields, the remaining data is optional. 76756074874733a95498646a3fc575ef62fd9218f58Mike Reed ANPEvent evt; 76856074874733a95498646a3fc575ef62fd9218f58Mike Reed evt.inSize = sizeof(ANPEvent); 76956074874733a95498646a3fc575ef62fd9218f58Mike Reed evt.eventType = kCustom_ANPEventType 77056074874733a95498646a3fc575ef62fd9218f58Mike Reed // other data slots are optional 77156074874733a95498646a3fc575ef62fd9218f58Mike Reed evt.other[] = ...; 77256074874733a95498646a3fc575ef62fd9218f58Mike Reed To post a copy of the event, call 77356074874733a95498646a3fc575ef62fd9218f58Mike Reed eventInterface->postEvent(myNPPInstance, &evt); 77456074874733a95498646a3fc575ef62fd9218f58Mike Reed That call makes a copy of the event struct, and post that on the event 77556074874733a95498646a3fc575ef62fd9218f58Mike Reed queue for the plugin. 77656074874733a95498646a3fc575ef62fd9218f58Mike Reed */ 77756074874733a95498646a3fc575ef62fd9218f58Mike Reed kCustom_ANPEventType = 6, 7788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPEventType; 7808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPKeyActions { 7828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kDown_ANPKeyAction = 0, 7838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUp_ANPKeyAction = 1, 7848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPKeyAction; 7868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#include "ANPKeyCodes.h" 7888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPKeyCode; 7898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPKeyModifiers { 7918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kAlt_ANPKeyModifier = 1 << 0, 7928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kShift_ANPKeyModifier = 1 << 1, 7938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// bit-field containing some number of ANPKeyModifier bits 7958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPKeyModifier; 7968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 797d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenbergerenum ANPMouseActions { 798d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kDown_ANPMouseAction = 0, 799d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kUp_ANPMouseAction = 1, 800d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger}; 801d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenbergertypedef int32_t ANPMouseAction; 802d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger 8038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPTouchActions { 804eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** This occurs when the user first touches on the screen. As such, this 805eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger action will always occur prior to any of the other touch actions. If 806eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger the plugin chooses to not handle this action then no other events 807eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger related to that particular touch gesture will be generated. 808eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 8093d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba kDown_ANPTouchAction = 0, 8103d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba kUp_ANPTouchAction = 1, 8113d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba kMove_ANPTouchAction = 2, 8123d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba kCancel_ANPTouchAction = 3, 8133d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba // The web view will ignore the return value from the following actions 8143d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba kLongPress_ANPTouchAction = 4, 8153d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba kDoubleTap_ANPTouchAction = 5, 8168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 8178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPTouchAction; 8188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 8193d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba/** 8203d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba * When a plugin returns from NPP_HandleEvent() for a touch event, it can use 8213d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba * ANPTouchResultMask to tell the web view which touch event it wants to handle. 8223d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba * kHandleTouch_ANPTouchResult will handle all touch event inside the plugin. If 8233d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba * it is not set, a plugin can choose only handle individual event like long 8243d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba * press, or double tap. 8253d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba */ 8263d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Klobaenum ANPTouchResultMask { 8273d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba kHandleTouch_ANPTouchResult = 1, 8283d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba kHandleLongPress_ANPTouchResult = 2, 8293d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba kHandleDoubleTap_ANPTouchResult = 4, 8303d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba}; 8313d0d3fdaa1308448b47592c03cda81c7f9e1f789Grace Kloba 832a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenbergerenum ANPLifecycleActions { 833eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The web view containing this plugin has been paused. See documentation 834eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger on the android activity lifecycle for more information. 835eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 836a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger kPause_ANPLifecycleAction = 0, 837eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The web view containing this plugin has been resumed. See documentation 838eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger on the android activity lifecycle for more information. 839eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 840a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger kResume_ANPLifecycleAction = 1, 841eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The plugin has focus and is now the recipient of input events (e.g. key, 842eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger touch, etc.) 843eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 844a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger kGainFocus_ANPLifecycleAction = 2, 845eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The plugin has lost focus and will not receive any input events until it 846eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger regains focus. This event is always preceded by a GainFocus action. 847eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 848ba11d034d7050033f698b2bc3a3c156e062ba2ddDerek Sollenberger kLoseFocus_ANPLifecycleAction = 3, 849eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The browser is running low on available memory and is requesting that 850eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger the plugin free any unused/inactive resources to prevent a performance 851eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger degradation. 852eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 8530fae426bf2862e6ba2745a999ecb25d172c6860aDerek Sollenberger kFreeMemory_ANPLifecycleAction = 4, 854243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger /** The page has finished loading. This happens when the page's top level 855243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger frame reports that it has completed loading. 856243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger */ 85710c34b4139f0041a0dac539139c7dbee46595b2cDerek Sollenberger kOnLoad_ANPLifecycleAction = 5, 858a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger}; 859a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenbergertypedef uint32_t ANPLifecycleAction; 860a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 8618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/* This is what is passed to NPP_HandleEvent() */ 8628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPEvent { 8638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project uint32_t inSize; // size of this struct in bytes 8648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPEventType eventType; 8658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project // use based on the value in eventType 8668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project union { 8678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project struct { 8688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPKeyAction action; 8698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPKeyCode nativeCode; 8708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t virtualCode; // windows virtual key code 8718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPKeyModifier modifiers; 8728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t repeatCount; // 0 for initial down (or up) 8738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t unichar; // 0 if there is no value 8748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project } key; 8758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project struct { 876d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger ANPMouseAction action; 877d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger int32_t x; // relative to your "window" (0...width) 878d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger int32_t y; // relative to your "window" (0...height) 879d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger } mouse; 880d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger struct { 8818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTouchAction action; 8828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPKeyModifier modifiers; 8838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t x; // relative to your "window" (0...width) 8848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t y; // relative to your "window" (0...height) 8858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project } touch; 886a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger struct { 887a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger ANPLifecycleAction action; 888a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger } lifecycle; 889535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger struct { 890535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger ANPDrawingModel model; 891535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger // relative to (0,0) in top-left of your plugin 892535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger ANPRectI clip; 893535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger // use based on the value in model 894535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger union { 895535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger ANPBitmap bitmap; 896535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger } data; 897535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger } draw; 898243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger int32_t other[8]; 8998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project } data; 9008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 9018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 90256074874733a95498646a3fc575ef62fd9218f58Mike Reedstruct ANPEventInterfaceV0 : ANPInterface { 90356074874733a95498646a3fc575ef62fd9218f58Mike Reed /** Post a copy of the specified event to the plugin. The event will be 90456074874733a95498646a3fc575ef62fd9218f58Mike Reed delivered to the plugin in its main thread (the thread that receives 90556074874733a95498646a3fc575ef62fd9218f58Mike Reed other ANPEvents). If, after posting before delivery, the NPP instance 90656074874733a95498646a3fc575ef62fd9218f58Mike Reed is torn down, the event will be discarded. 90756074874733a95498646a3fc575ef62fd9218f58Mike Reed */ 90856074874733a95498646a3fc575ef62fd9218f58Mike Reed void (*postEvent)(NPP inst, const ANPEvent* event); 90956074874733a95498646a3fc575ef62fd9218f58Mike Reed}; 91056074874733a95498646a3fc575ef62fd9218f58Mike Reed 91156074874733a95498646a3fc575ef62fd9218f58Mike Reed 9128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#endif 913