android_npapi.h revision 3298a7d84b96ade73c6b170671711a8f2792ae59
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 1525536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger class specified by kSetPluginStubJavaClassName_ANPSetValue which will 1535536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger return an instance of a android Java View. The instance is then embedded 1545536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger in the html. The plugin can then manipulate the view as it would any 1555536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 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 17410d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger/** Set the name of the Java class found in the plugin's apk that implements the 17510d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger PluginStub interface. The value provided must be a null terminated char* 17619d8bd10cbc60aee378a8762c27b264a4813445bDerek Sollenberger that contains the fully qualified class name (e.g., your.package.className). 17719d8bd10cbc60aee378a8762c27b264a4813445bDerek Sollenberger A local copy is made of the char* so the caller can safely free the memory 17819d8bd10cbc60aee378a8762c27b264a4813445bDerek Sollenberger as soon as the function returns. 17910d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger 18019d8bd10cbc60aee378a8762c27b264a4813445bDerek Sollenberger This value must be set prior to selecting the Surface_ANPDrawingModel or 18119d8bd10cbc60aee378a8762c27b264a4813445bDerek Sollenberger requesting to enter full-screen mode. 18219d8bd10cbc60aee378a8762c27b264a4813445bDerek Sollenberger 18319d8bd10cbc60aee378a8762c27b264a4813445bDerek Sollenberger NPN_SetValue(inst, kSetPluginStubJavaClassName_ANPSetValue, 18419d8bd10cbc60aee378a8762c27b264a4813445bDerek Sollenberger (void*)nullTerminatedChar*) 18510d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger */ 18619d8bd10cbc60aee378a8762c27b264a4813445bDerek Sollenberger#define kSetPluginStubJavaClassName_ANPSetValue ((NPPVariable)1001) 18710d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger 188243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger/** Request to receive/disable events. If the pointer is NULL then all flags will 189243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger be disabled. Otherwise, the event type will be enabled iff its corresponding 19056ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger bit in the EventFlags bit field is set. 19156ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger 19256ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger NPN_SetValue(inst, ANPAcceptEvents, (void*)EventFlags) 19356ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger */ 19410d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger#define kAcceptEvents_ANPSetValue ((NPPVariable)1002) 19556ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger 196ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger/** The EventFlags are a set of bits used to determine which types of events the 19756ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger plugin wishes to receive. For example, if the value is 0x03 then both key 19856ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger and touch events will be provided to the plugin. 19956ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger */ 20056ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenbergerenum ANPEventFlag { 201243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger kKey_ANPEventFlag = 0x01, 202243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger kTouch_ANPEventFlag = 0x02, 20356ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger}; 20456ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenbergertypedef uint32_t ANPEventFlags; 20556ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger 2065536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 2075536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger/////////////////////////////////////////////////////////////////////////////// 2085536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger// ANDROID INTERFACE DEFINITIONS 2095536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger 210ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger/** Interfaces provide additional functionality to the plugin via function ptrs. 211ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger Once an interface is retrieved, it is valid for the lifetime of the plugin 2128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project (just like browserfuncs). 213a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 2148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project All ANPInterfaces begin with an inSize field, which must be set by the 2158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project caller (plugin) with the number of bytes allocated for the interface. 2168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project e.g. SomeInterface si; si.inSize = sizeof(si); browser->getvalue(..., &si); 2178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPInterface { 2198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project uint32_t inSize; // size (in bytes) of this struct 2208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 2218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPLogTypes { 2238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kError_ANPLogType = 0, // error 2248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kWarning_ANPLogType = 1, // warning 2258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kDebug_ANPLogType = 2 // debug only (informational) 2268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 2278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPLogType; 2288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPLogInterfaceV0 : ANPInterface { 230ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** dumps printf messages to the log file 231ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger e.g. interface->log(instance, kWarning_ANPLogType, "value is %d", value); 232ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger */ 2338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*log)(NPP instance, ANPLogType, const char format[], ...); 2348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 2358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 236a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reedstruct ANPBitmapInterfaceV0 : ANPInterface { 237a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed /** Returns true if the specified bitmap format is supported, and if packing 238a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed is non-null, sets it to the packing info for that format. 239a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed */ 240a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed bool (*getPixelPacking)(ANPBitmapFormat, ANPPixelPacking* packing); 241a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed}; 242a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed 2438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPMatrixInterfaceV0 : ANPInterface { 244ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return a new identity matrix 2458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPMatrix* (*newMatrix)(); 247ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Delete a matrix previously allocated by newMatrix() 2488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*deleteMatrix)(ANPMatrix*); 2508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPMatrixFlag (*getFlags)(const ANPMatrix*); 2528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*copy)(ANPMatrix* dst, const ANPMatrix* src); 2548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 255ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the matrix values in a float array (allcoated by the caller), 2568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project where the values are treated as follows: 2578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project w = x * [6] + y * [7] + [8]; 2588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project x' = (x * [0] + y * [1] + [2]) / w; 2598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project y' = (x * [3] + y * [4] + [5]) / w; 2608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*get3x3)(const ANPMatrix*, float[9]); 262ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Initialize the matrix from values in a float array, 2638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project where the values are treated as follows: 2648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project w = x * [6] + y * [7] + [8]; 2658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project x' = (x * [0] + y * [1] + [2]) / w; 2668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project y' = (x * [3] + y * [4] + [5]) / w; 2678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*set3x3)(ANPMatrix*, const float[9]); 2698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setIdentity)(ANPMatrix*); 2718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preTranslate)(ANPMatrix*, float tx, float ty); 2728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postTranslate)(ANPMatrix*, float tx, float ty); 2738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preScale)(ANPMatrix*, float sx, float sy); 2748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postScale)(ANPMatrix*, float sx, float sy); 2758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preSkew)(ANPMatrix*, float kx, float ky); 2768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postSkew)(ANPMatrix*, float kx, float ky); 2778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preRotate)(ANPMatrix*, float degrees); 2788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postRotate)(ANPMatrix*, float degrees); 2798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*preConcat)(ANPMatrix*, const ANPMatrix*); 2808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*postConcat)(ANPMatrix*, const ANPMatrix*); 2818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 282ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return true if src is invertible, and if so, return its inverse in dst. 2838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project If src is not invertible, return false and ignore dst. 2848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*invert)(ANPMatrix* dst, const ANPMatrix* src); 2868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 287ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Transform the x,y pairs in src[] by this matrix, and store the results 2888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project in dst[]. The count parameter is treated as the number of pairs in the 2898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project array. It is legal for src and dst to point to the same memory, but 2908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project illegal for the two arrays to partially overlap. 2918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 2928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*mapPoints)(ANPMatrix*, float dst[], const float src[], 2938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t count); 2948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 2958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 2964603aa50552a853aa7aedcd809460a83586daa53Mike Reedstruct ANPPathInterfaceV0 : ANPInterface { 297ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return a new path */ 2984603aa50552a853aa7aedcd809460a83586daa53Mike Reed ANPPath* (*newPath)(); 2994603aa50552a853aa7aedcd809460a83586daa53Mike Reed 300ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Delete a path previously allocated by ANPPath() */ 3014603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*deletePath)(ANPPath*); 3024603aa50552a853aa7aedcd809460a83586daa53Mike Reed 303ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Make a deep copy of the src path, into the dst path (already allocated 304ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger by the caller). 3054603aa50552a853aa7aedcd809460a83586daa53Mike Reed */ 3064603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*copy)(ANPPath* dst, const ANPPath* src); 3074603aa50552a853aa7aedcd809460a83586daa53Mike Reed 308ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Returns true if the two paths are the same (i.e. have the same points) 3094603aa50552a853aa7aedcd809460a83586daa53Mike Reed */ 3104603aa50552a853aa7aedcd809460a83586daa53Mike Reed bool (*equal)(const ANPPath* path0, const ANPPath* path1); 3114603aa50552a853aa7aedcd809460a83586daa53Mike Reed 312ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Remove any previous points, initializing the path back to empty. */ 3134603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*reset)(ANPPath*); 3144603aa50552a853aa7aedcd809460a83586daa53Mike Reed 315ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return true if the path is empty (has no lines, quads or cubics). */ 3164603aa50552a853aa7aedcd809460a83586daa53Mike Reed bool (*isEmpty)(const ANPPath*); 3174603aa50552a853aa7aedcd809460a83586daa53Mike Reed 318ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the path's bounds in bounds. */ 3194603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*getBounds)(const ANPPath*, ANPRectF* bounds); 3204603aa50552a853aa7aedcd809460a83586daa53Mike Reed 3214603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*moveTo)(ANPPath*, float x, float y); 3224603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*lineTo)(ANPPath*, float x, float y); 3234603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*quadTo)(ANPPath*, float x0, float y0, float x1, float y1); 3244603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*cubicTo)(ANPPath*, float x0, float y0, float x1, float y1, 3254603aa50552a853aa7aedcd809460a83586daa53Mike Reed float x2, float y2); 3264603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*close)(ANPPath*); 3274603aa50552a853aa7aedcd809460a83586daa53Mike Reed 328ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Offset the src path by [dx, dy]. If dst is null, apply the 3294603aa50552a853aa7aedcd809460a83586daa53Mike Reed change directly to the src path. If dst is not null, write the 3304603aa50552a853aa7aedcd809460a83586daa53Mike Reed changed path into dst, and leave the src path unchanged. In that case 3314603aa50552a853aa7aedcd809460a83586daa53Mike Reed dst must have been previously allocated by the caller. 3324603aa50552a853aa7aedcd809460a83586daa53Mike Reed */ 3334603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*offset)(ANPPath* src, float dx, float dy, ANPPath* dst); 3344603aa50552a853aa7aedcd809460a83586daa53Mike Reed 335ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Transform the path by the matrix. If dst is null, apply the 3364603aa50552a853aa7aedcd809460a83586daa53Mike Reed change directly to the src path. If dst is not null, write the 3374603aa50552a853aa7aedcd809460a83586daa53Mike Reed changed path into dst, and leave the src path unchanged. In that case 3384603aa50552a853aa7aedcd809460a83586daa53Mike Reed dst must have been previously allocated by the caller. 3394603aa50552a853aa7aedcd809460a83586daa53Mike Reed */ 3404603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*transform)(ANPPath* src, const ANPMatrix*, ANPPath* dst); 3414603aa50552a853aa7aedcd809460a83586daa53Mike Reed}; 3424603aa50552a853aa7aedcd809460a83586daa53Mike Reed 343a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed/** ANPColor is always defined to have the same packing on all platforms, and 344a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed it is always unpremultiplied. 3450fae426bf2862e6ba2745a999ecb25d172c6860aDerek Sollenberger 346a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed This is in contrast to 32bit format(s) in bitmaps, which are premultiplied, 347a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed and their packing may vary depending on the platform, hence the need for 348a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed ANPBitmapInterface::getPixelPacking() 349a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed */ 3508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPColor; 351a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define ANPColor_ASHIFT 24 352a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define ANPColor_RSHIFT 16 353a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define ANPColor_GSHIFT 8 354a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed#define ANPColor_BSHIFT 0 3558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define ANP_MAKE_COLOR(a, r, g, b) \ 356a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed (((a) << ANPColor_ASHIFT) | \ 357a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed ((r) << ANPColor_RSHIFT) | \ 358a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed ((g) << ANPColor_GSHIFT) | \ 359a6ac9647bf473365f8d817790e11aeda7374a6d8Mike Reed ((b) << ANPColor_BSHIFT)) 3608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintFlag { 3628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kAntiAlias_ANPPaintFlag = 1 << 0, 3638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kFilterBitmap_ANPPaintFlag = 1 << 1, 3648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kDither_ANPPaintFlag = 1 << 2, 3658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUnderlineText_ANPPaintFlag = 1 << 3, 3668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kStrikeThruText_ANPPaintFlag = 1 << 4, 3678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kFakeBoldText_ANPPaintFlag = 1 << 5, 3688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPPaintFlags; 3708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintStyles { 3728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kFill_ANPPaintStyle = 0, 3738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kStroke_ANPPaintStyle = 1, 3748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kFillAndStroke_ANPPaintStyle = 2 3758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPPaintStyle; 3778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintCaps { 3798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kButt_ANPPaintCap = 0, 3808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kRound_ANPPaintCap = 1, 3818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kSquare_ANPPaintCap = 2 3828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPPaintCap; 3848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintJoins { 3868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kMiter_ANPPaintJoin = 0, 3878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kRound_ANPPaintJoin = 1, 3888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kBevel_ANPPaintJoin = 2 3898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPPaintJoin; 3918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPPaintAligns { 3938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kLeft_ANPPaintAlign = 0, 3948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kCenter_ANPPaintAlign = 1, 3958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kRight_ANPPaintAlign = 2 3968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 3978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPPaintAlign; 3988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 3998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPTextEncodings { 4008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUTF8_ANPTextEncoding = 0, 4018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUTF16_ANPTextEncoding = 1, 4028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 4038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPTextEncoding; 4048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPTypefaceStyles { 4068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kBold_ANPTypefaceStyle = 1 << 0, 4078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kItalic_ANPTypefaceStyle = 1 << 1 4088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 4098e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPTypefaceStyle; 4108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 411b91f67b5c82b6d5f399a629b1434fc40a271737cMike Reedtypedef uint32_t ANPFontTableTag; 412b91f67b5c82b6d5f399a629b1434fc40a271737cMike Reed 4138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPFontMetrics { 414ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The greatest distance above the baseline for any glyph (will be <= 0) */ 4158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fTop; 416ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The recommended distance above the baseline (will be <= 0) */ 4178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fAscent; 418ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The recommended distance below the baseline (will be >= 0) */ 4198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fDescent; 420ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The greatest distance below the baseline for any glyph (will be >= 0) */ 4218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fBottom; 422ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** The recommended distance to add between lines of text (will be >= 0) */ 4238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float fLeading; 4248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 4258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPTypefaceInterfaceV0 : ANPInterface { 4278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return a new reference to the typeface that most closely matches the 4288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project requested name and style. Pass null as the name to return 4298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project the default font for the requested style. Will never return null 4308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4311c97c8027a51a511742fcabf75365e3b5a35828eMike Reed The 5 generic font names "serif", "sans-serif", "monospace", "cursive", 4321c97c8027a51a511742fcabf75365e3b5a35828eMike Reed "fantasy" are recognized, and will be mapped to their logical font 4331c97c8027a51a511742fcabf75365e3b5a35828eMike Reed automatically by this call. 4341c97c8027a51a511742fcabf75365e3b5a35828eMike Reed 4358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param name May be NULL. The name of the font family. 4368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param style The style (normal, bold, italic) of the typeface. 4378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @return reference to the closest-matching typeface. Caller must call 4388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project unref() when they are done with the typeface. 4398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypeface* (*createFromName)(const char name[], ANPTypefaceStyle); 4418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return a new reference to the typeface that most closely matches the 4438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project requested typeface and specified Style. Use this call if you want to 4448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project pick a new style from the same family of the existing typeface. 4458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project If family is NULL, this selects from the default font's family. 4468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param family May be NULL. The name of the existing type face. 4488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param s The style (normal, bold, italic) of the type face. 4498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @return reference to the closest-matching typeface. Call must call 4508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project unref() when they are done. 4518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypeface* (*createFromTypeface)(const ANPTypeface* family, 4538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypefaceStyle); 454a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 4558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the owner count of the typeface. A newly created typeface has an 4568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project owner count of 1. When the owner count is reaches 0, the typeface is 4578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project deleted. 4588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t (*getRefCount)(const ANPTypeface*); 4608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Increment the owner count on the typeface 4628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*ref)(ANPTypeface*); 4648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 4658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Decrement the owner count on the typeface. When the count goes to 0, 4668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project the typeface is deleted. 4678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*unref)(ANPTypeface*); 469a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 4708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the style bits for the specified typeface 4718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 4728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypefaceStyle (*getStyle)(const ANPTypeface*); 473b91f67b5c82b6d5f399a629b1434fc40a271737cMike Reed 4743cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed /** Some fonts are stored in files. If that is true for the fontID, then 4753cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed this returns the byte length of the full file path. If path is not null, 4763cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed then the full path is copied into path (allocated by the caller), up to 4773cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed length bytes. If index is not null, then it is set to the truetype 4783cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed collection index for this font, or 0 if the font is not in a collection. 4793cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 4803cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed Note: getFontPath does not assume that path is a null-terminated string, 4813cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed so when it succeeds, it only copies the bytes of the file name and 4823cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed nothing else (i.e. it copies exactly the number of bytes returned by the 4833cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed function. If the caller wants to treat path[] as a C string, it must be 4843cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed sure that it is allocated at least 1 byte larger than the returned size, 4853cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed and it must copy in the terminating 0. 4863cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 4873cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed If the fontID does not correspond to a file, then the function returns 4883cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 0, and the path and index parameters are ignored. 4893cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 4903cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @param fontID The font whose file name is being queried 4913cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @param path Either NULL, or storage for receiving up to length bytes 4923cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed of the font's file name. Allocated by the caller. 4933cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @param length The maximum space allocated in path (by the caller). 4943cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed Ignored if path is NULL. 4953cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @param index Either NULL, or receives the TTC index for this font. 4963cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed If the font is not a TTC, then will be set to 0. 4973cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed @return The byte length of th font's file name, or 0 if the font is not 4983cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed baked by a file. 4993cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed */ 5003cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed int32_t (*getFontPath)(const ANPTypeface*, char path[], int32_t length, 5013cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed int32_t* index); 5023cec237b4a0df2776318c343c9ccc9bbbcfd11f8Mike Reed 5031c97c8027a51a511742fcabf75365e3b5a35828eMike Reed /** Return a UTF8 encoded path name for the font directory, or NULL if not 5041c97c8027a51a511742fcabf75365e3b5a35828eMike Reed supported. If returned, this string address will be valid for the life 50510d4052577e66430f5a3716ec51a401f1b4b21c2Derek Sollenberger of the plugin instance. It will always end with a '/' character. 506b91f67b5c82b6d5f399a629b1434fc40a271737cMike Reed */ 507ae107e96f52ebe258a8ef5f32100c77ededc2d34Mike Reed const char* (*getFontDirectoryPath)(); 5088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 5098e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPPaintInterfaceV0 : ANPInterface { 511ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return a new paint object, which holds all of the color and style 5128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project attributes that affect how things (geometry, text, bitmaps) are drawn 5138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project in a ANPCanvas. 514a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project The paint that is returned is not tied to any particular plugin 5168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project instance, but it must only be accessed from one thread at a time. 5178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaint* (*newPaint)(); 5198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*deletePaint)(ANPPaint*); 520a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintFlags (*getFlags)(const ANPPaint*); 5228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setFlags)(ANPPaint*, ANPPaintFlags); 523a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPColor (*getColor)(const ANPPaint*); 5258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setColor)(ANPPaint*, ANPColor); 526a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintStyle (*getStyle)(const ANPPaint*); 5288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStyle)(ANPPaint*, ANPPaintStyle); 5298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getStrokeWidth)(const ANPPaint*); 5318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getStrokeMiter)(const ANPPaint*); 5328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintCap (*getStrokeCap)(const ANPPaint*); 5338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintJoin (*getStrokeJoin)(const ANPPaint*); 5348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStrokeWidth)(ANPPaint*, float); 5358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStrokeMiter)(ANPPaint*, float); 5368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStrokeCap)(ANPPaint*, ANPPaintCap); 5378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setStrokeJoin)(ANPPaint*, ANPPaintJoin); 538a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTextEncoding (*getTextEncoding)(const ANPPaint*); 5408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPPaintAlign (*getTextAlign)(const ANPPaint*); 5418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getTextSize)(const ANPPaint*); 5428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getTextScaleX)(const ANPPaint*); 5438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getTextSkewX)(const ANPPaint*); 5448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextEncoding)(ANPPaint*, ANPTextEncoding); 5458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextAlign)(ANPPaint*, ANPPaintAlign); 5468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextSize)(ANPPaint*, float); 5478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextScaleX)(ANPPaint*, float); 5488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTextSkewX)(ANPPaint*, float); 5498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the typeface ine paint, or null if there is none. This does not 5518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project modify the owner count of the returned typeface. 5528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTypeface* (*getTypeface)(const ANPPaint*); 5548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Set the paint's typeface. If the paint already had a non-null typeface, 5568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project its owner count is decremented. If the new typeface is non-null, its 5578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project owner count is incremented. 5588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*setTypeface)(ANPPaint*, ANPTypeface*); 5608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the width of the text. If bounds is not null, return the bounds 5628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project of the text in that rectangle. 5638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*measureText)(ANPPaint*, const void* text, uint32_t byteLength, 5658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPRectF* bounds); 566a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return the number of unichars specifed by the text. 5688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project If widths is not null, returns the array of advance widths for each 5698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project unichar. 5708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project If bounds is not null, returns the array of bounds for each unichar. 5718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int (*getTextWidths)(ANPPaint*, const void* text, uint32_t byteLength, 5738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float widths[], ANPRectF bounds[]); 574a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Return in metrics the spacing values for text, respecting the paint's 5768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project typeface and pointsize, and return the spacing between lines 5778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project (descent - ascent + leading). If metrics is NULL, it will be ignored. 5788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float (*getFontMetrics)(ANPPaint*, ANPFontMetrics* metrics); 5808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 5818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPCanvasInterfaceV0 : ANPInterface { 583ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return a canvas that will draw into the specified bitmap. Note: the 5848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project canvas copies the fields of the bitmap, so it need not persist after 5858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project this call, but the canvas DOES point to the same pixel memory that the 5868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bitmap did, so the canvas should not be used after that pixel memory 5878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project goes out of scope. In the case of creating a canvas to draw into the 5888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project pixels provided by kDraw_ANPEventType, those pixels are only while 5898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project handling that event. 590a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 5918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project The canvas that is returned is not tied to any particular plugin 5928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project instance, but it must only be accessed from one thread at a time. 5938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 5948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPCanvas* (*newCanvas)(const ANPBitmap*); 5958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*deleteCanvas)(ANPCanvas*); 5968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 5978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*save)(ANPCanvas*); 5988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*restore)(ANPCanvas*); 5998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*translate)(ANPCanvas*, float tx, float ty); 6008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*scale)(ANPCanvas*, float sx, float sy); 6018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*rotate)(ANPCanvas*, float degrees); 6028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*skew)(ANPCanvas*, float kx, float ky); 6038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*concat)(ANPCanvas*, const ANPMatrix*); 6048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*clipRect)(ANPCanvas*, const ANPRectF*); 6058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*clipPath)(ANPCanvas*, const ANPPath*); 6068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 607ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the current matrix on the canvas 6088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6098e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*getTotalMatrix)(ANPCanvas*, ANPMatrix*); 610ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the current clip bounds in local coordinates, expanding it to 6118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project account for antialiasing edge effects if aa is true. If the 6128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project current clip is empty, return false and ignore the bounds argument. 6138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*getLocalClipBounds)(ANPCanvas*, ANPRectF* bounds, bool aa); 615ce300b91859a4830a00c388a600cddef96ed48e1Derek Sollenberger /** Return the current clip bounds in device coordinates in bounds. If the 6168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project current clip is empty, return false and ignore the bounds argument. 6178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*getDeviceClipBounds)(ANPCanvas*, ANPRectI* bounds); 6194603aa50552a853aa7aedcd809460a83586daa53Mike Reed 6208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawColor)(ANPCanvas*, ANPColor); 6218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawPaint)(ANPCanvas*, const ANPPaint*); 6224603aa50552a853aa7aedcd809460a83586daa53Mike Reed void (*drawLine)(ANPCanvas*, float x0, float y0, float x1, float y1, 6234603aa50552a853aa7aedcd809460a83586daa53Mike Reed const ANPPaint*); 6248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawRect)(ANPCanvas*, const ANPRectF*, const ANPPaint*); 6258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawOval)(ANPCanvas*, const ANPRectF*, const ANPPaint*); 6268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawPath)(ANPCanvas*, const ANPPath*, const ANPPaint*); 6278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawText)(ANPCanvas*, const void* text, uint32_t byteLength, 6288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project float x, float y, const ANPPaint*); 6298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawPosText)(ANPCanvas*, const void* text, uint32_t byteLength, 6308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project const float xy[], const ANPPaint*); 6318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawBitmap)(ANPCanvas*, const ANPBitmap*, float x, float y, 6328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project const ANPPaint*); 6338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*drawBitmapRect)(ANPCanvas*, const ANPBitmap*, 6348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project const ANPRectI* src, const ANPRectF* dst, 6358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project const ANPPaint*); 6368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 6378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPWindowInterfaceV0 : ANPInterface { 6398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Given the window field from the NPWindow struct, and an optional rect 6408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project describing the subset of the window that will be drawn to (may be null) 6418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project return true if the bitmap for that window can be accessed, and if so, 6428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project fill out the specified ANPBitmap to point to the window's pixels. 643a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 6448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project When drawing is complete, call unlock(window) 6458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*lockRect)(void* window, const ANPRectI* inval, ANPBitmap*); 6478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** The same as lockRect, but takes a region instead of a rect to specify 6488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project the area that will be changed/drawn. 6498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*lockRegion)(void* window, const ANPRegion* inval, ANPBitmap*); 6518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Given a successful call to lock(window, inval, &bitmap), call unlock 6528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project to release access to the pixels, and allow the browser to display the 6538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project results. If lock returned false, unlock should not be called. 6548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*unlock)(void* window); 656e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger /** Registers a set of rectangles that the plugin would like to keep on 657e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger screen. The rectangles are listed in order of priority with the highest 658e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger priority rectangle in location rects[0]. The browser will attempt to keep 659e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger as many of the rectangles on screen as possible and will scroll them into 660e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger view in response to the invocation of this method and other various events. 661e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger The count specifies how many rectangles are in the array. If the count is 662e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger zero it signals the browser that any existing rectangles should be cleared 663e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger and no rectangles will be tracked. 664e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger */ 665e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger void (*setVisibleRects)(NPP instance, const ANPRectI rects[], int32_t count); 666e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger /** Clears any rectangles that are being tracked as a result of a call to 667e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger setVisibleRects. This call is equivalent to setVisibleRect(inst, NULL, 0). 668e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger */ 669e0204f4150fd9c321f119dc78d9e23e3164b4b1dDerek Sollenberger void (*clearVisibleRects)(NPP instance); 6705c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger /** Given a boolean value of true the device will be requested to provide 6715c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger a keyboard. A value of false will result in a request to hide the 6725c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger keyboard. Further, the on-screen keyboard will not be displayed if a 6735c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger physical keyboard is active. 6745c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger */ 6755c6846a9fb474dce40db8859579e0d6a3f802787Derek Sollenberger void (*showKeyboard)(NPP instance, bool value); 676e23a6d30242a5dbcdce40e708e0f97b21d06c2afDerek Sollenberger /** Called when a plugin wishes to enter into full screen mode. The plugin's 677e23a6d30242a5dbcdce40e708e0f97b21d06c2afDerek Sollenberger Java class (set using kSetPluginStubJavaClassName_ANPSetValue) will be 678e23a6d30242a5dbcdce40e708e0f97b21d06c2afDerek Sollenberger called asynchronously to provide a View object to be displayed full screen. 679e23a6d30242a5dbcdce40e708e0f97b21d06c2afDerek Sollenberger */ 680e23a6d30242a5dbcdce40e708e0f97b21d06c2afDerek Sollenberger void (*requestFullScreen)(NPP instance); 6818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 6828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/////////////////////////////////////////////////////////////////////////////// 6848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPSampleFormats { 6868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUnknown_ANPSamleFormat = 0, 6878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kPCM16Bit_ANPSampleFormat = 1, 6888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kPCM8Bit_ANPSampleFormat = 2 6898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 6908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPSampleFormat; 6918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 6928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/** The audio buffer is passed to the callback proc to request more samples. 6938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project It is owned by the system, and the callback may read it, but should not 6948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project maintain a pointer to it outside of the scope of the callback proc. 6958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 6968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPAudioBuffer { 6978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project // RO - repeat what was specified in newTrack() 6988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t channelCount; 6998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project // RO - repeat what was specified in newTrack() 7008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPSampleFormat format; 7018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** This buffer is owned by the caller. Inside the callback proc, up to 7028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project "size" bytes of sample data should be written into this buffer. The 7038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project address is only valid for the scope of a single invocation of the 7048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project callback proc. 7058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void* bufferData; 7078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** On input, specifies the maximum number of bytes that can be written 7088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project to "bufferData". On output, specifies the actual number of bytes that 7098e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project the callback proc wrote into "bufferData". 7108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project uint32_t size; 7128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPAudioEvents { 7158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** This event is passed to the callback proc when the audio-track needs 7168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project more sample data written to the provided buffer parameter. 7178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kMoreData_ANPAudioEvent = 0, 7198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** This event is passed to the callback proc if the audio system runs out 7208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project of sample data. In this event, no buffer parameter will be specified 7218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project (i.e. NULL will be passed to the 3rd parameter). 7228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUnderRun_ANPAudioEvent = 1 7248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPAudioEvent; 7268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/** Called to feed sample data to the track. This will be called in a separate 7288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project thread. However, you may call trackStop() from the callback (but you 7298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project cannot delete the track). 730a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 7318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project For example, when you have written the last chunk of sample data, you can 7328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project immediately call trackStop(). This will take effect after the current 7338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project buffer has been played. 734a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 7358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project The "user" parameter is the same value that was passed to newTrack() 7368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef void (*ANPAudioCallbackProc)(ANPAudioEvent event, void* user, 7388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPAudioBuffer* buffer); 7398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPAudioTrack; // abstract type for audio tracks 7418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPAudioTrackInterfaceV0 : ANPInterface { 743eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Create a new audio track, or NULL on failure. The track is initially in 744eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger the stopped state and therefore ANPAudioCallbackProc will not be called 745eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger until the track is started. 7468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPAudioTrack* (*newTrack)(uint32_t sampleRate, // sampling rate in Hz 7488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPSampleFormat, 7498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int channelCount, // MONO=1, STEREO=2 7508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPAudioCallbackProc, 7518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void* user); 752eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Deletes a track that was created using newTrack. The track can be 753eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger deleted in any state and it waits for the ANPAudioCallbackProc thread 754eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger to exit before returning. 755eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 7568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*deleteTrack)(ANPAudioTrack*); 7578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*start)(ANPAudioTrack*); 7598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*pause)(ANPAudioTrack*); 7608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project void (*stop)(ANPAudioTrack*); 7618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /** Returns true if the track is not playing (e.g. pause or stop was called, 7628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project or start was never called. 7638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 7648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project bool (*isStopped)(ANPAudioTrack*); 7658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/////////////////////////////////////////////////////////////////////////////// 7685536af7a20bdd4beeb2211f19f6ff535fdc4be41Derek Sollenberger// DEFINITION OF VALUES PASSED THROUGH NPP_HandleEvent 7698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPEventTypes { 7713d709e1f628a1547fba1e4cab0c91a55f7ed7e7aDerek Sollenberger kNull_ANPEventType = 0, 7723d709e1f628a1547fba1e4cab0c91a55f7ed7e7aDerek Sollenberger kKey_ANPEventType = 1, 773eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Mouse events are triggered by either clicking with the navigational pad 774eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger or by tapping the touchscreen (if the kDown_ANPTouchAction is handled by 775eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger the plugin then no mouse event is generated). The kKey_ANPEventFlag has 776eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger to be set to true in order to receive these events. 777eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 778d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kMouse_ANPEventType = 2, 779eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Touch events are generated when the user touches on the screen. The 780eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger kTouch_ANPEventFlag has to be set to true in order to receive these 781eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger events. 782eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 783d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kTouch_ANPEventType = 3, 784eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** Only triggered by a plugin using the kBitmap_ANPDrawingModel. This event 785eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger signals that the plugin needs to redraw itself into the provided bitmap. 786eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 787d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kDraw_ANPEventType = 4, 788d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kLifecycle_ANPEventType = 5, 7898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPEventType; 7918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPKeyActions { 7938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kDown_ANPKeyAction = 0, 7948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kUp_ANPKeyAction = 1, 7958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 7968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPKeyAction; 7978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 7988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#include "ANPKeyCodes.h" 7998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPKeyCode; 8008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 8018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPKeyModifiers { 8028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kAlt_ANPKeyModifier = 1 << 0, 8038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project kShift_ANPKeyModifier = 1 << 1, 8048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 8058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// bit-field containing some number of ANPKeyModifier bits 8068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef uint32_t ANPKeyModifier; 8078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 808d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenbergerenum ANPMouseActions { 809d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kDown_ANPMouseAction = 0, 810d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger kUp_ANPMouseAction = 1, 811d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger}; 812d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenbergertypedef int32_t ANPMouseAction; 813d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger 8148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectenum ANPTouchActions { 815eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** This occurs when the user first touches on the screen. As such, this 816eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger action will always occur prior to any of the other touch actions. If 817eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger the plugin chooses to not handle this action then no other events 818eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger related to that particular touch gesture will be generated. 819eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 82056ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger kDown_ANPTouchAction = 0, 82156ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger kUp_ANPTouchAction = 1, 82256ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger kMove_ANPTouchAction = 2, 82356ce2fa12f7492cf355cfb37b80b679d7921f6d4Derek Sollenberger kCancel_ANPTouchAction = 3, 8248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 8258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projecttypedef int32_t ANPTouchAction; 8268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 827a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenbergerenum ANPLifecycleActions { 828eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The web view containing this plugin has been paused. See documentation 829eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger on the android activity lifecycle for more information. 830eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 831a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger kPause_ANPLifecycleAction = 0, 832eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The web view containing this plugin has been resumed. See documentation 833eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger on the android activity lifecycle for more information. 834eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 835a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger kResume_ANPLifecycleAction = 1, 836eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The plugin has focus and is now the recipient of input events (e.g. key, 837eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger touch, etc.) 838eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 839a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger kGainFocus_ANPLifecycleAction = 2, 840eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The plugin has lost focus and will not receive any input events until it 841eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger regains focus. This event is always preceded by a GainFocus action. 842eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 843ba11d034d7050033f698b2bc3a3c156e062ba2ddDerek Sollenberger kLoseFocus_ANPLifecycleAction = 3, 844eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger /** The browser is running low on available memory and is requesting that 845eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger the plugin free any unused/inactive resources to prevent a performance 846eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger degradation. 847eb4c3b4c18be49e65ed131514eb1343ff9699d89Derek Sollenberger */ 8480fae426bf2862e6ba2745a999ecb25d172c6860aDerek Sollenberger kFreeMemory_ANPLifecycleAction = 4, 849243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger /** The page has finished loading. This happens when the page's top level 850243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger frame reports that it has completed loading. 851243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger */ 85210c34b4139f0041a0dac539139c7dbee46595b2cDerek Sollenberger kOnLoad_ANPLifecycleAction = 5, 853a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger}; 854a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenbergertypedef uint32_t ANPLifecycleAction; 855a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger 8568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/* This is what is passed to NPP_HandleEvent() */ 8578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectstruct ANPEvent { 8588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project uint32_t inSize; // size of this struct in bytes 8598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPEventType eventType; 8608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project // use based on the value in eventType 8618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project union { 8628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project struct { 8638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPKeyAction action; 8648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPKeyCode nativeCode; 8658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t virtualCode; // windows virtual key code 8668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPKeyModifier modifiers; 8678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t repeatCount; // 0 for initial down (or up) 8688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t unichar; // 0 if there is no value 8698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project } key; 8708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project struct { 871d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger ANPMouseAction action; 872d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger int32_t x; // relative to your "window" (0...width) 873d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger int32_t y; // relative to your "window" (0...height) 874d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger } mouse; 875d3fd788536f3fe65035a8fbba4ede47701716c43Derek Sollenberger struct { 8768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPTouchAction action; 8778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project ANPKeyModifier modifiers; 8788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t x; // relative to your "window" (0...width) 8798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project int32_t y; // relative to your "window" (0...height) 8808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project } touch; 881a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger struct { 882a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger ANPLifecycleAction action; 883a2c69492fd11733119d4f6ce3540acdfee9bf88cDerek Sollenberger } lifecycle; 884535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger struct { 885535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger ANPDrawingModel model; 886535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger // relative to (0,0) in top-left of your plugin 887535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger ANPRectI clip; 888535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger // use based on the value in model 889535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger union { 890535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger ANPBitmap bitmap; 891535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger } data; 892535c54975bd9f79f3ab3f02f8d1b831d8ade7c51Derek Sollenberger } draw; 893243869ecee2d4b5ab0f796fcc6692ece5b03c15eDerek Sollenberger int32_t other[8]; 8948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project } data; 8958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project}; 8968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 8978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#endif 898