android_npapi.h revision 1a15528b92bc6af8faeaad983c380fcca4d1de44
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) 1218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 122ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger/** queries for which drawing model is desired (for the draw event) 123a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 1248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project Should be called inside NPP_New(...) 125a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 1268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project NPN_GetValue(inst, ANPSupportedDrawingModel_EnumValue, uint32_t* bits) 1278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 1288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define kSupportedDrawingModel_ANPGetValue ((NPNVariable)2000) 1298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/////////////////////////////////////////////////////////////////////////////// 13156ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger// NPN_SetValue 1328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 13310d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger/** Request to set the drawing model. SetValue will return false if the drawing 13410d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger model is not supported or has insufficient information for configuration. 135a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 13610d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger NPN_SetValue(inst, kRequestDrawingModel_ANPSetValue, (void*)foo_ANPDrawingModel) 1378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 1388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define kRequestDrawingModel_ANPSetValue ((NPPVariable)1000) 1398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1405536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger/** These are used as bitfields in ANPSupportedDrawingModels_EnumValue, 1415536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger and as-is in ANPRequestDrawingModel_EnumValue. The drawing model determines 1425536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger how to interpret the ANPDrawingContext provided in the Draw event and how 1435536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger to interpret the NPWindow->window field. 1445536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger */ 1455536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenbergerenum ANPDrawingModels { 1465536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger /** Draw into a bitmap from the browser thread in response to a Draw event. 1475536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger NPWindow->window is reserved (ignore) 1485536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger */ 1495536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger kBitmap_ANPDrawingModel = 0, 1505536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger /** Draw into a surface (e.g. raster, openGL, etc.) using the Java surface 1515536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger interface. When this model is used the browser will invoke the Java 1521a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger class specified in the plugin's apk manifest. From that class the browser 1531a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger will invoke the appropriate method to return an an instance of a android 1541a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger Java View. The instance is then embedded in the html. The plugin can then 1551a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger manipulate the view as it would any normal Java View in android. 1565536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 1575536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger Unlike the bitmap model, a surface model is opaque so no html content 1585536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger behind the plugin will be visible. Unless the plugin needs to be 1595536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger transparent the surface model should be chosen over the bitmap model as 1605536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger it will have better performance. 1615536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 1625536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger Further, a plugin can manipulate some surfaces in native code using the 1635536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger ANPSurfaceInterface. This interface can be used to manipulate Java 1645536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger objects that extend Surface.class by allowing them to access the 1655536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger surface's underlying bitmap in native code. For instance, if a raster 1665536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger surface is used the plugin can lock, draw directly into the bitmap, and 1675536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger unlock the surface in native code without making JNI calls to the Java 1685536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger surface object. 1695536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger */ 1705536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger kSurface_ANPDrawingModel = 0x01, 1715536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger}; 1725536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenbergertypedef int32_t ANPDrawingModel; 1735536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 174243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger/** Request to receive/disable events. If the pointer is NULL then all flags will 175243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger be disabled. Otherwise, the event type will be enabled iff its corresponding 17656ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger bit in the EventFlags bit field is set. 17756ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger 17856ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger NPN_SetValue(inst, ANPAcceptEvents, (void*)EventFlags) 17956ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger */ 1801a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger#define kAcceptEvents_ANPSetValue ((NPPVariable)1001) 18156ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger 182ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger/** The EventFlags are a set of bits used to determine which types of events the 18356ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger plugin wishes to receive. For example, if the value is 0x03 then both key 18456ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger and touch events will be provided to the plugin. 18556ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger */ 18656ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenbergerenum ANPEventFlag { 187243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger kKey_ANPEventFlag = 0x01, 188243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger kTouch_ANPEventFlag = 0x02, 18956ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger}; 19056ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenbergertypedef uint32_t ANPEventFlags; 19156ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger 1925536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 1935536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger/////////////////////////////////////////////////////////////////////////////// 1945536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger// ANDROID INTERFACE DEFINITIONS 1955536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 196ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger/** Interfaces provide additional functionality to the plugin via function ptrs. 197ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger Once an interface is retrieved, it is valid for the lifetime of the plugin 1988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project (just like browserfuncs). 199a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 2008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project All ANPInterfaces begin with an inSize field, which must be set by the 2018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project caller (plugin) with the number of bytes allocated for the interface. 2028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project e.g. SomeInterface si; si.inSize = sizeof(si); browser->getvalue(..., &si); 2038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPInterface { 2058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project uint32_t inSize; // size (in bytes) of this struct 2068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 2078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPLogTypes { 2098e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kError_ANPLogType = 0, // error 2108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kWarning_ANPLogType = 1, // warning 2118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kDebug_ANPLogType = 2 // debug only (informational) 2128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 2138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPLogType; 2148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPLogInterfaceV0 : ANPInterface { 216ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** dumps printf messages to the log file 217ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger e.g. interface->log(instance, kWarning_ANPLogType, "value is %d", value); 218ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger */ 2198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*log)(NPP instance, ANPLogType, const char format[], ...); 2208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 2218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 222a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reedstruct ANPBitmapInterfaceV0 : ANPInterface { 223a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed /** Returns true if the specified bitmap format is supported, and if packing 224a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed is non-null, sets it to the packing info for that format. 225a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed */ 226a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed bool (*getPixelPacking)(ANPBitmapFormat, ANPPixelPacking* packing); 227a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed}; 228a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed 2298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPMatrixInterfaceV0 : ANPInterface { 230ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return a new identity matrix 2318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPMatrix* (*newMatrix)(); 233ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Delete a matrix previously allocated by newMatrix() 2348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*deleteMatrix)(ANPMatrix*); 2368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPMatrixFlag (*getFlags)(const ANPMatrix*); 2388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*copy)(ANPMatrix* dst, const ANPMatrix* src); 2408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 241ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the matrix values in a float array (allcoated by the caller), 2428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project where the values are treated as follows: 2438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project w = x * [6] + y * [7] + [8]; 2448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project x' = (x * [0] + y * [1] + [2]) / w; 2458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project y' = (x * [3] + y * [4] + [5]) / w; 2468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*get3x3)(const ANPMatrix*, float[9]); 248ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Initialize the matrix from values in a float array, 2498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project where the values are treated as follows: 2508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project w = x * [6] + y * [7] + [8]; 2518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project x' = (x * [0] + y * [1] + [2]) / w; 2528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project y' = (x * [3] + y * [4] + [5]) / w; 2538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*set3x3)(ANPMatrix*, const float[9]); 2558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setIdentity)(ANPMatrix*); 2578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preTranslate)(ANPMatrix*, float tx, float ty); 2588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postTranslate)(ANPMatrix*, float tx, float ty); 2598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preScale)(ANPMatrix*, float sx, float sy); 2608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postScale)(ANPMatrix*, float sx, float sy); 2618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preSkew)(ANPMatrix*, float kx, float ky); 2628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postSkew)(ANPMatrix*, float kx, float ky); 2638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preRotate)(ANPMatrix*, float degrees); 2648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postRotate)(ANPMatrix*, float degrees); 2658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preConcat)(ANPMatrix*, const ANPMatrix*); 2668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postConcat)(ANPMatrix*, const ANPMatrix*); 2678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 268ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return true if src is invertible, and if so, return its inverse in dst. 2698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project If src is not invertible, return false and ignore dst. 2708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*invert)(ANPMatrix* dst, const ANPMatrix* src); 2728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 273ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Transform the x,y pairs in src[] by this matrix, and store the results 2748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project in dst[]. The count parameter is treated as the number of pairs in the 2758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project array. It is legal for src and dst to point to the same memory, but 2768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project illegal for the two arrays to partially overlap. 2778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*mapPoints)(ANPMatrix*, float dst[], const float src[], 2798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t count); 2808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 2818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2824603aa50552a853aa7aedcd809460a83586daa53Mike Reedstruct ANPPathInterfaceV0 : ANPInterface { 283ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return a new path */ 2844603aa50552a853aa7aedcd809460a83586daa53Mike Reed ANPPath* (*newPath)(); 2854603aa50552a853aa7aedcd809460a83586daa53Mike Reed 286ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Delete a path previously allocated by ANPPath() */ 2874603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*deletePath)(ANPPath*); 2884603aa50552a853aa7aedcd809460a83586daa53Mike Reed 289ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Make a deep copy of the src path, into the dst path (already allocated 290ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger by the caller). 2914603aa50552a853aa7aedcd809460a83586daa53Mike Reed */ 2924603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*copy)(ANPPath* dst, const ANPPath* src); 2934603aa50552a853aa7aedcd809460a83586daa53Mike Reed 294ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Returns true if the two paths are the same (i.e. have the same points) 2954603aa50552a853aa7aedcd809460a83586daa53Mike Reed */ 2964603aa50552a853aa7aedcd809460a83586daa53Mike Reed bool (*equal)(const ANPPath* path0, const ANPPath* path1); 2974603aa50552a853aa7aedcd809460a83586daa53Mike Reed 298ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Remove any previous points, initializing the path back to empty. */ 2994603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*reset)(ANPPath*); 3004603aa50552a853aa7aedcd809460a83586daa53Mike Reed 301ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return true if the path is empty (has no lines, quads or cubics). */ 3024603aa50552a853aa7aedcd809460a83586daa53Mike Reed bool (*isEmpty)(const ANPPath*); 3034603aa50552a853aa7aedcd809460a83586daa53Mike Reed 304ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the path's bounds in bounds. */ 3054603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*getBounds)(const ANPPath*, ANPRectF* bounds); 3064603aa50552a853aa7aedcd809460a83586daa53Mike Reed 3074603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*moveTo)(ANPPath*, float x, float y); 3084603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*lineTo)(ANPPath*, float x, float y); 3094603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*quadTo)(ANPPath*, float x0, float y0, float x1, float y1); 3104603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*cubicTo)(ANPPath*, float x0, float y0, float x1, float y1, 3114603aa50552a853aa7aedcd809460a83586daa53Mike Reed float x2, float y2); 3124603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*close)(ANPPath*); 3134603aa50552a853aa7aedcd809460a83586daa53Mike Reed 314ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Offset the src path by [dx, dy]. If dst is null, apply the 3154603aa50552a853aa7aedcd809460a83586daa53Mike Reed change directly to the src path. If dst is not null, write the 3164603aa50552a853aa7aedcd809460a83586daa53Mike Reed changed path into dst, and leave the src path unchanged. In that case 3174603aa50552a853aa7aedcd809460a83586daa53Mike Reed dst must have been previously allocated by the caller. 3184603aa50552a853aa7aedcd809460a83586daa53Mike Reed */ 3194603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*offset)(ANPPath* src, float dx, float dy, ANPPath* dst); 3204603aa50552a853aa7aedcd809460a83586daa53Mike Reed 321ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Transform the path by the matrix. If dst is null, apply the 3224603aa50552a853aa7aedcd809460a83586daa53Mike Reed change directly to the src path. If dst is not null, write the 3234603aa50552a853aa7aedcd809460a83586daa53Mike Reed changed path into dst, and leave the src path unchanged. In that case 3244603aa50552a853aa7aedcd809460a83586daa53Mike Reed dst must have been previously allocated by the caller. 3254603aa50552a853aa7aedcd809460a83586daa53Mike Reed */ 3264603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*transform)(ANPPath* src, const ANPMatrix*, ANPPath* dst); 3274603aa50552a853aa7aedcd809460a83586daa53Mike Reed}; 3284603aa50552a853aa7aedcd809460a83586daa53Mike Reed 329a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed/** ANPColor is always defined to have the same packing on all platforms, and 330a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed it is always unpremultiplied. 3310fae426bf2862e6ba2745a999ecb25d172c6860aDerek Sollenberger 332a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed This is in contrast to 32bit format(s) in bitmaps, which are premultiplied, 333a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed and their packing may vary depending on the platform, hence the need for 334a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed ANPBitmapInterface::getPixelPacking() 335a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed */ 3368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPColor; 337a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define ANPColor_ASHIFT 24 338a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define ANPColor_RSHIFT 16 339a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define ANPColor_GSHIFT 8 340a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define ANPColor_BSHIFT 0 3418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define ANP_MAKE_COLOR(a, r, g, b) \ 342a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed (((a) << ANPColor_ASHIFT) | \ 343a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed ((r) << ANPColor_RSHIFT) | \ 344a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed ((g) << ANPColor_GSHIFT) | \ 345a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed ((b) << ANPColor_BSHIFT)) 3468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintFlag { 3488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kAntiAlias_ANPPaintFlag = 1 << 0, 3498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kFilterBitmap_ANPPaintFlag = 1 << 1, 3508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kDither_ANPPaintFlag = 1 << 2, 3518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUnderlineText_ANPPaintFlag = 1 << 3, 3528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kStrikeThruText_ANPPaintFlag = 1 << 4, 3538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kFakeBoldText_ANPPaintFlag = 1 << 5, 3548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPPaintFlags; 3568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintStyles { 3588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kFill_ANPPaintStyle = 0, 3598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kStroke_ANPPaintStyle = 1, 3608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kFillAndStroke_ANPPaintStyle = 2 3618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPPaintStyle; 3638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintCaps { 3658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kButt_ANPPaintCap = 0, 3668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kRound_ANPPaintCap = 1, 3678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kSquare_ANPPaintCap = 2 3688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPPaintCap; 3708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintJoins { 3728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kMiter_ANPPaintJoin = 0, 3738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kRound_ANPPaintJoin = 1, 3748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kBevel_ANPPaintJoin = 2 3758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPPaintJoin; 3778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintAligns { 3798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kLeft_ANPPaintAlign = 0, 3808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kCenter_ANPPaintAlign = 1, 3818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kRight_ANPPaintAlign = 2 3828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPPaintAlign; 3848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPTextEncodings { 3868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUTF8_ANPTextEncoding = 0, 3878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUTF16_ANPTextEncoding = 1, 3888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPTextEncoding; 3908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPTypefaceStyles { 3928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kBold_ANPTypefaceStyle = 1 << 0, 3938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kItalic_ANPTypefaceStyle = 1 << 1 3948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPTypefaceStyle; 3968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 397b91f67b5c82b6d5f399a629b1434fc40a271737cMike Reedtypedef uint32_t ANPFontTableTag; 398b91f67b5c82b6d5f399a629b1434fc40a271737cMike Reed 3998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPFontMetrics { 400ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The greatest distance above the baseline for any glyph (will be <= 0) */ 4018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fTop; 402ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The recommended distance above the baseline (will be <= 0) */ 4038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fAscent; 404ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The recommended distance below the baseline (will be >= 0) */ 4058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fDescent; 406ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The greatest distance below the baseline for any glyph (will be >= 0) */ 4078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fBottom; 408ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The recommended distance to add between lines of text (will be >= 0) */ 4098e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fLeading; 4108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 4118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPTypefaceInterfaceV0 : ANPInterface { 4138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return a new reference to the typeface that most closely matches the 4148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project requested name and style. Pass null as the name to return 4158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project the default font for the requested style. Will never return null 4168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4171c97c8027a51a511742fcabf75365e3b5a35828eMike Reed The 5 generic font names "serif", "sans-serif", "monospace", "cursive", 4181c97c8027a51a511742fcabf75365e3b5a35828eMike Reed "fantasy" are recognized, and will be mapped to their logical font 4191c97c8027a51a511742fcabf75365e3b5a35828eMike Reed automatically by this call. 4201c97c8027a51a511742fcabf75365e3b5a35828eMike Reed 4218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param name May be NULL. The name of the font family. 4228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param style The style (normal, bold, italic) of the typeface. 4238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @return reference to the closest-matching typeface. Caller must call 4248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project unref() when they are done with the typeface. 4258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypeface* (*createFromName)(const char name[], ANPTypefaceStyle); 4278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return a new reference to the typeface that most closely matches the 4298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project requested typeface and specified Style. Use this call if you want to 4308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project pick a new style from the same family of the existing typeface. 4318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project If family is NULL, this selects from the default font's family. 4328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param family May be NULL. The name of the existing type face. 4348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param s The style (normal, bold, italic) of the type face. 4358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @return reference to the closest-matching typeface. Call must call 4368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project unref() when they are done. 4378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypeface* (*createFromTypeface)(const ANPTypeface* family, 4398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypefaceStyle); 440a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 4418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the owner count of the typeface. A newly created typeface has an 4428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project owner count of 1. When the owner count is reaches 0, the typeface is 4438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project deleted. 4448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t (*getRefCount)(const ANPTypeface*); 4468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Increment the owner count on the typeface 4488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*ref)(ANPTypeface*); 4508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Decrement the owner count on the typeface. When the count goes to 0, 4528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project the typeface is deleted. 4538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*unref)(ANPTypeface*); 455a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 4568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the style bits for the specified typeface 4578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypefaceStyle (*getStyle)(const ANPTypeface*); 459b91f67b5c82b6d5f399a629b1434fc40a271737cMike Reed 4603cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed /** Some fonts are stored in files. If that is true for the fontID, then 4613cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed this returns the byte length of the full file path. If path is not null, 4623cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed then the full path is copied into path (allocated by the caller), up to 4633cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed length bytes. If index is not null, then it is set to the truetype 4643cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed collection index for this font, or 0 if the font is not in a collection. 4653cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 4663cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed Note: getFontPath does not assume that path is a null-terminated string, 4673cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed so when it succeeds, it only copies the bytes of the file name and 4683cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed nothing else (i.e. it copies exactly the number of bytes returned by the 4693cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed function. If the caller wants to treat path[] as a C string, it must be 4703cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed sure that it is allocated at least 1 byte larger than the returned size, 4713cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed and it must copy in the terminating 0. 4723cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 4733cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed If the fontID does not correspond to a file, then the function returns 4743cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 0, and the path and index parameters are ignored. 4753cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 4763cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @param fontID The font whose file name is being queried 4773cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @param path Either NULL, or storage for receiving up to length bytes 4783cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed of the font's file name. Allocated by the caller. 4793cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @param length The maximum space allocated in path (by the caller). 4803cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed Ignored if path is NULL. 4813cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @param index Either NULL, or receives the TTC index for this font. 4823cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed If the font is not a TTC, then will be set to 0. 4833cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @return The byte length of th font's file name, or 0 if the font is not 4843cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed baked by a file. 4853cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed */ 4863cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed int32_t (*getFontPath)(const ANPTypeface*, char path[], int32_t length, 4873cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed int32_t* index); 4883cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 4891c97c8027a51a511742fcabf75365e3b5a35828eMike Reed /** Return a UTF8 encoded path name for the font directory, or NULL if not 4901c97c8027a51a511742fcabf75365e3b5a35828eMike Reed supported. If returned, this string address will be valid for the life 49110d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger of the plugin instance. It will always end with a '/' character. 492b91f67b5c82b6d5f399a629b1434fc40a271737cMike Reed */ 493ae107e96f52ebe258a8ef5f32100c77ededc2d34Mike Reed const char* (*getFontDirectoryPath)(); 4948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 4958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPPaintInterfaceV0 : ANPInterface { 497ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return a new paint object, which holds all of the color and style 4988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project attributes that affect how things (geometry, text, bitmaps) are drawn 4998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project in a ANPCanvas. 500a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project The paint that is returned is not tied to any particular plugin 5028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project instance, but it must only be accessed from one thread at a time. 5038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaint* (*newPaint)(); 5058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*deletePaint)(ANPPaint*); 506a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintFlags (*getFlags)(const ANPPaint*); 5088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setFlags)(ANPPaint*, ANPPaintFlags); 509a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPColor (*getColor)(const ANPPaint*); 5118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setColor)(ANPPaint*, ANPColor); 512a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintStyle (*getStyle)(const ANPPaint*); 5148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStyle)(ANPPaint*, ANPPaintStyle); 5158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getStrokeWidth)(const ANPPaint*); 5178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getStrokeMiter)(const ANPPaint*); 5188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintCap (*getStrokeCap)(const ANPPaint*); 5198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintJoin (*getStrokeJoin)(const ANPPaint*); 5208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStrokeWidth)(ANPPaint*, float); 5218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStrokeMiter)(ANPPaint*, float); 5228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStrokeCap)(ANPPaint*, ANPPaintCap); 5238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStrokeJoin)(ANPPaint*, ANPPaintJoin); 524a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTextEncoding (*getTextEncoding)(const ANPPaint*); 5268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintAlign (*getTextAlign)(const ANPPaint*); 5278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getTextSize)(const ANPPaint*); 5288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getTextScaleX)(const ANPPaint*); 5298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getTextSkewX)(const ANPPaint*); 5308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextEncoding)(ANPPaint*, ANPTextEncoding); 5318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextAlign)(ANPPaint*, ANPPaintAlign); 5328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextSize)(ANPPaint*, float); 5338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextScaleX)(ANPPaint*, float); 5348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextSkewX)(ANPPaint*, float); 5358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the typeface ine paint, or null if there is none. This does not 5378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project modify the owner count of the returned typeface. 5388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypeface* (*getTypeface)(const ANPPaint*); 5408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Set the paint's typeface. If the paint already had a non-null typeface, 5428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project its owner count is decremented. If the new typeface is non-null, its 5438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project owner count is incremented. 5448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTypeface)(ANPPaint*, ANPTypeface*); 5468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the width of the text. If bounds is not null, return the bounds 5488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project of the text in that rectangle. 5498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*measureText)(ANPPaint*, const void* text, uint32_t byteLength, 5518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPRectF* bounds); 552a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the number of unichars specifed by the text. 5548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project If widths is not null, returns the array of advance widths for each 5558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project unichar. 5568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project If bounds is not null, returns the array of bounds for each unichar. 5578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int (*getTextWidths)(ANPPaint*, const void* text, uint32_t byteLength, 5598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float widths[], ANPRectF bounds[]); 560a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return in metrics the spacing values for text, respecting the paint's 5628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project typeface and pointsize, and return the spacing between lines 5638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project (descent - ascent + leading). If metrics is NULL, it will be ignored. 5648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getFontMetrics)(ANPPaint*, ANPFontMetrics* metrics); 5668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 5678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPCanvasInterfaceV0 : ANPInterface { 569ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return a canvas that will draw into the specified bitmap. Note: the 5708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project canvas copies the fields of the bitmap, so it need not persist after 5718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project this call, but the canvas DOES point to the same pixel memory that the 5728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bitmap did, so the canvas should not be used after that pixel memory 5738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project goes out of scope. In the case of creating a canvas to draw into the 5748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project pixels provided by kDraw_ANPEventType, those pixels are only while 5758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project handling that event. 576a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project The canvas that is returned is not tied to any particular plugin 5788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project instance, but it must only be accessed from one thread at a time. 5798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPCanvas* (*newCanvas)(const ANPBitmap*); 5818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*deleteCanvas)(ANPCanvas*); 5828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*save)(ANPCanvas*); 5848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*restore)(ANPCanvas*); 5858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*translate)(ANPCanvas*, float tx, float ty); 5868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*scale)(ANPCanvas*, float sx, float sy); 5878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*rotate)(ANPCanvas*, float degrees); 5888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*skew)(ANPCanvas*, float kx, float ky); 5898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*concat)(ANPCanvas*, const ANPMatrix*); 5908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*clipRect)(ANPCanvas*, const ANPRectF*); 5918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*clipPath)(ANPCanvas*, const ANPPath*); 5928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 593ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the current matrix on the canvas 5948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*getTotalMatrix)(ANPCanvas*, ANPMatrix*); 596ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the current clip bounds in local coordinates, expanding it to 5978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project account for antialiasing edge effects if aa is true. If the 5988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project current clip is empty, return false and ignore the bounds argument. 5998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*getLocalClipBounds)(ANPCanvas*, ANPRectF* bounds, bool aa); 601ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the current clip bounds in device coordinates in bounds. If the 6028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project current clip is empty, return false and ignore the bounds argument. 6038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*getDeviceClipBounds)(ANPCanvas*, ANPRectI* bounds); 6054603aa50552a853aa7aedcd809460a83586daa53Mike Reed 6068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawColor)(ANPCanvas*, ANPColor); 6078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawPaint)(ANPCanvas*, const ANPPaint*); 6084603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*drawLine)(ANPCanvas*, float x0, float y0, float x1, float y1, 6094603aa50552a853aa7aedcd809460a83586daa53Mike Reed const ANPPaint*); 6108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawRect)(ANPCanvas*, const ANPRectF*, const ANPPaint*); 6118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawOval)(ANPCanvas*, const ANPRectF*, const ANPPaint*); 6128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawPath)(ANPCanvas*, const ANPPath*, const ANPPaint*); 6138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawText)(ANPCanvas*, const void* text, uint32_t byteLength, 6148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float x, float y, const ANPPaint*); 6158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawPosText)(ANPCanvas*, const void* text, uint32_t byteLength, 6168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project const float xy[], const ANPPaint*); 6178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawBitmap)(ANPCanvas*, const ANPBitmap*, float x, float y, 6188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project const ANPPaint*); 6198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawBitmapRect)(ANPCanvas*, const ANPBitmap*, 6208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project const ANPRectI* src, const ANPRectF* dst, 6218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project const ANPPaint*); 6228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 6238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPWindowInterfaceV0 : ANPInterface { 6258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Given the window field from the NPWindow struct, and an optional rect 6268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project describing the subset of the window that will be drawn to (may be null) 6278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project return true if the bitmap for that window can be accessed, and if so, 6288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project fill out the specified ANPBitmap to point to the window's pixels. 629a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 6308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project When drawing is complete, call unlock(window) 6318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*lockRect)(void* window, const ANPRectI* inval, ANPBitmap*); 6338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** The same as lockRect, but takes a region instead of a rect to specify 6348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project the area that will be changed/drawn. 6358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*lockRegion)(void* window, const ANPRegion* inval, ANPBitmap*); 6378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Given a successful call to lock(window, inval, &bitmap), call unlock 6388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project to release access to the pixels, and allow the browser to display the 6398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project results. If lock returned false, unlock should not be called. 6408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*unlock)(void* window); 642e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger /** Registers a set of rectangles that the plugin would like to keep on 643e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger screen. The rectangles are listed in order of priority with the highest 644e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger priority rectangle in location rects[0]. The browser will attempt to keep 645e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger as many of the rectangles on screen as possible and will scroll them into 646e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger view in response to the invocation of this method and other various events. 647e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger The count specifies how many rectangles are in the array. If the count is 648e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger zero it signals the browser that any existing rectangles should be cleared 649e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger and no rectangles will be tracked. 650e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger */ 651e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger void (*setVisibleRects)(NPP instance, const ANPRectI rects[], int32_t count); 652e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger /** Clears any rectangles that are being tracked as a result of a call to 653e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger setVisibleRects. This call is equivalent to setVisibleRect(inst, NULL, 0). 654e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger */ 655e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger void (*clearVisibleRects)(NPP instance); 6565c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger /** Given a boolean value of true the device will be requested to provide 6575c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger a keyboard. A value of false will result in a request to hide the 6585c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger keyboard. Further, the on-screen keyboard will not be displayed if a 6595c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger physical keyboard is active. 6605c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger */ 6615c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger void (*showKeyboard)(NPP instance, bool value); 662e23a6d30242a5dbcdce40e708e0f97b21d06c2afDerek Sollenberger /** Called when a plugin wishes to enter into full screen mode. The plugin's 6631a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger Java class (defined in the plugin's apk manifest) will be called 6641a15528b92bc6af8faeaad983c380fcca4d1de44Derek Sollenberger asynchronously to provide a View object to be displayed full screen. 665e23a6d30242a5dbcdce40e708e0f97b21d06c2afDerek Sollenberger */ 666e23a6d30242a5dbcdce40e708e0f97b21d06c2afDerek Sollenberger void (*requestFullScreen)(NPP instance); 6678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 6688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/////////////////////////////////////////////////////////////////////////////// 6708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPSampleFormats { 6728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUnknown_ANPSamleFormat = 0, 6738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kPCM16Bit_ANPSampleFormat = 1, 6748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kPCM8Bit_ANPSampleFormat = 2 6758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 6768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPSampleFormat; 6778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/** The audio buffer is passed to the callback proc to request more samples. 6798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project It is owned by the system, and the callback may read it, but should not 6808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project maintain a pointer to it outside of the scope of the callback proc. 6818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPAudioBuffer { 6838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project // RO - repeat what was specified in newTrack() 6848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t channelCount; 6858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project // RO - repeat what was specified in newTrack() 6868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPSampleFormat format; 6878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** This buffer is owned by the caller. Inside the callback proc, up to 6888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project "size" bytes of sample data should be written into this buffer. The 6898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project address is only valid for the scope of a single invocation of the 6908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project callback proc. 6918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void* bufferData; 6938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** On input, specifies the maximum number of bytes that can be written 6948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project to "bufferData". On output, specifies the actual number of bytes that 6958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project the callback proc wrote into "bufferData". 6968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project uint32_t size; 6988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 6998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPAudioEvents { 7018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** This event is passed to the callback proc when the audio-track needs 7028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project more sample data written to the provided buffer parameter. 7038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kMoreData_ANPAudioEvent = 0, 7058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** This event is passed to the callback proc if the audio system runs out 7068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project of sample data. In this event, no buffer parameter will be specified 7078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project (i.e. NULL will be passed to the 3rd parameter). 7088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7098e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUnderRun_ANPAudioEvent = 1 7108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPAudioEvent; 7128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/** Called to feed sample data to the track. This will be called in a separate 7148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project thread. However, you may call trackStop() from the callback (but you 7158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project cannot delete the track). 716a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 7178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project For example, when you have written the last chunk of sample data, you can 7188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project immediately call trackStop(). This will take effect after the current 7198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project buffer has been played. 720a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 7218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project The "user" parameter is the same value that was passed to newTrack() 7228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef void (*ANPAudioCallbackProc)(ANPAudioEvent event, void* user, 7248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPAudioBuffer* buffer); 7258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPAudioTrack; // abstract type for audio tracks 7278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPAudioTrackInterfaceV0 : ANPInterface { 729eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Create a new audio track, or NULL on failure. The track is initially in 730eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger the stopped state and therefore ANPAudioCallbackProc will not be called 731eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger until the track is started. 7328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPAudioTrack* (*newTrack)(uint32_t sampleRate, // sampling rate in Hz 7348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPSampleFormat, 7358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int channelCount, // MONO=1, STEREO=2 7368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPAudioCallbackProc, 7378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void* user); 738eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Deletes a track that was created using newTrack. The track can be 739eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger deleted in any state and it waits for the ANPAudioCallbackProc thread 740eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger to exit before returning. 741eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 7428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*deleteTrack)(ANPAudioTrack*); 7438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*start)(ANPAudioTrack*); 7458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*pause)(ANPAudioTrack*); 7468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*stop)(ANPAudioTrack*); 7478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Returns true if the track is not playing (e.g. pause or stop was called, 7488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project or start was never called. 7498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*isStopped)(ANPAudioTrack*); 7518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/////////////////////////////////////////////////////////////////////////////// 7545536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger// DEFINITION OF VALUES PASSED THROUGH NPP_HandleEvent 7558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPEventTypes { 7573d709e1f628a1547fba1e4cab0c91a55f7ed7e7aDerek Sollenberger kNull_ANPEventType = 0, 7583d709e1f628a1547fba1e4cab0c91a55f7ed7e7aDerek Sollenberger kKey_ANPEventType = 1, 759eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Mouse events are triggered by either clicking with the navigational pad 760eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger or by tapping the touchscreen (if the kDown_ANPTouchAction is handled by 761eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger the plugin then no mouse event is generated). The kKey_ANPEventFlag has 762eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger to be set to true in order to receive these events. 763eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 764d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kMouse_ANPEventType = 2, 765eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Touch events are generated when the user touches on the screen. The 766eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger kTouch_ANPEventFlag has to be set to true in order to receive these 767eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger events. 768eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 769d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kTouch_ANPEventType = 3, 770eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Only triggered by a plugin using the kBitmap_ANPDrawingModel. This event 771eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger signals that the plugin needs to redraw itself into the provided bitmap. 772eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 773d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kDraw_ANPEventType = 4, 774d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kLifecycle_ANPEventType = 5, 7758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPEventType; 7778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPKeyActions { 7798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kDown_ANPKeyAction = 0, 7808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUp_ANPKeyAction = 1, 7818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPKeyAction; 7838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#include "ANPKeyCodes.h" 7858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPKeyCode; 7868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPKeyModifiers { 7888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kAlt_ANPKeyModifier = 1 << 0, 7898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kShift_ANPKeyModifier = 1 << 1, 7908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// bit-field containing some number of ANPKeyModifier bits 7928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPKeyModifier; 7938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 794d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenbergerenum ANPMouseActions { 795d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kDown_ANPMouseAction = 0, 796d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kUp_ANPMouseAction = 1, 797d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger}; 798d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenbergertypedef int32_t ANPMouseAction; 799d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger 8008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPTouchActions { 801eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** This occurs when the user first touches on the screen. As such, this 802eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger action will always occur prior to any of the other touch actions. If 803eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger the plugin chooses to not handle this action then no other events 804eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger related to that particular touch gesture will be generated. 805eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 80656ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger kDown_ANPTouchAction = 0, 80756ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger kUp_ANPTouchAction = 1, 80856ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger kMove_ANPTouchAction = 2, 80956ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger kCancel_ANPTouchAction = 3, 8108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 8118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPTouchAction; 8128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 813a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenbergerenum ANPLifecycleActions { 814eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The web view containing this plugin has been paused. See documentation 815eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger on the android activity lifecycle for more information. 816eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 817a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger kPause_ANPLifecycleAction = 0, 818eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The web view containing this plugin has been resumed. See documentation 819eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger on the android activity lifecycle for more information. 820eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 821a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger kResume_ANPLifecycleAction = 1, 822eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The plugin has focus and is now the recipient of input events (e.g. key, 823eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger touch, etc.) 824eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 825a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger kGainFocus_ANPLifecycleAction = 2, 826eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The plugin has lost focus and will not receive any input events until it 827eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger regains focus. This event is always preceded by a GainFocus action. 828eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 829ba11d034d7050033f698b2bc3a3c156e062ba2ddDerek Sollenberger kLoseFocus_ANPLifecycleAction = 3, 830eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The browser is running low on available memory and is requesting that 831eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger the plugin free any unused/inactive resources to prevent a performance 832eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger degradation. 833eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 8340fae426bf2862e6ba2745a999ecb25d172c6860aDerek Sollenberger kFreeMemory_ANPLifecycleAction = 4, 835243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger /** The page has finished loading. This happens when the page's top level 836243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger frame reports that it has completed loading. 837243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger */ 83810c34b4139f0041a0dac539139c7dbee46595b2cDerek Sollenberger kOnLoad_ANPLifecycleAction = 5, 839a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger}; 840a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenbergertypedef uint32_t ANPLifecycleAction; 841a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 8428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/* This is what is passed to NPP_HandleEvent() */ 8438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPEvent { 8448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project uint32_t inSize; // size of this struct in bytes 8458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPEventType eventType; 8468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project // use based on the value in eventType 8478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project union { 8488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project struct { 8498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPKeyAction action; 8508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPKeyCode nativeCode; 8518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t virtualCode; // windows virtual key code 8528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPKeyModifier modifiers; 8538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t repeatCount; // 0 for initial down (or up) 8548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t unichar; // 0 if there is no value 8558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project } key; 8568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project struct { 857d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger ANPMouseAction action; 858d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger int32_t x; // relative to your "window" (0...width) 859d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger int32_t y; // relative to your "window" (0...height) 860d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger } mouse; 861d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger struct { 8628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTouchAction action; 8638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPKeyModifier modifiers; 8648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t x; // relative to your "window" (0...width) 8658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t y; // relative to your "window" (0...height) 8668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project } touch; 867a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger struct { 868a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger ANPLifecycleAction action; 869a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger } lifecycle; 870535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger struct { 871535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger ANPDrawingModel model; 872535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger // relative to (0,0) in top-left of your plugin 873535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger ANPRectI clip; 874535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger // use based on the value in model 875535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger union { 876535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger ANPBitmap bitmap; 877535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger } data; 878535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger } draw; 879243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger int32_t other[8]; 8808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project } data; 8818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 8828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 8838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#endif 884