实现360度全景图像的Android类库--PanoramaGL

PanoramaGL Library ================== Version 0.2 beta (September/2013) Copyright (c) 2010 Javier Baez <javbaezga@gmail.com> 1. Features =========== - SDK 2.0 to 4.2.2. - Architectures ARM, x86 and MIPS. - OpenGL ES 1.0 and 1.1. - Support for spherical, cubic and cylindrical panoramic images. - Scrolling and continuous scrolling. - Inertia to stop continuous scrolling. - Zoom in and zoom out (moving two fingers on the screen). - Reset (placing three fingers on the screen or shaking the device). - Scrolling left to right and from top to bottom using the accelerometer. - Sensorial rotation (Only compatible for devices with Gyroscope or Accelerometer and Magnetometer). - Full control of camera including field of view, zoom, rotation, rotation range, animations, etc. - Hotspots with commands. - Simple JSON protocol. - Creation of virtual tours using the JSON protocol or with programming. - Transitions between panoramas. - Support for events. 2. Licensing ============ * PanoramaGL is open source licensed under the Apache License version 2.0. * Please, do not forget to put the credits in your application :). 2.1. Third-party code used by PanoramaGL ======================================== * glues: OpenGL ES 1.0 CM port of part of GLU by Mike Gorchak <mike@malva.ua>. Copyright (c) 1991-2000 Silicon Graphics, licensed under SGI FREE SOFTWARE LICENSE B version 2.0. * Matrix, MatrixGrabber, MatrixStack and MatrixTrackingGL classes: Copyright (c) 2007 The Android Open Source Project, licensed under Apache License version 2.0. * HttpClient 3.1: Copyright (c) Apache Software Foundation, licensed under Apache License version 2.0. * EasySSLSocketFactory and EasyX509TrustManager classes: Copyright (c) Apache Software Foundation, licensed under Apache License version 2.0. * PLVector3 and PLIntersection classes: Port from C++ to Java of "Demonstration of a line mesh intersection test" example by Jonathan Kreuzer. * PLTokenizer class: Class based in the article "Writing a Parser in Java: The Tokenizer" by Cogito Learning. 2.2. Panoramic images used by HelloPanoramaGL example ===================================================== * quito1, quito2 and quito3 images: Copyright (c) 2013 Geovanny Raura <georaura@gmail.com>. 3. Requirements =============== * Android 2.0 or higher. * OpenGL 1.0 or higher. * Some functionalities need the Accelerometer, Magnetometer and/or Gyroscope. 4. How to import PanoramaGL library? ==================================== 4.1. From source code ===================== a. Download PanoramaGL_0.2-beta.zip or download the source code from repository. b. If you download the zip file then decompress the file. c. Import PanoramaGL project with Eclipse: - Go to File->Import menu. - Select "Existing Projects into Workspace" and click on "Next" button. - Click on "Browse" button and select PanoramaGL project folder. - Click on "Finish" button. d. Right click on your project and select "Properties" option. e. Select on left panel "Android" option. f. In right panel go to "Library" section and click on "Add..." button. g. Select "PanoramaGL" library and click on "OK" button. h. Accept the changes selecting the "OK" button on right bottom corner in properties window. 4.2. From the compiled files ============================ a. Download libglues_0.2-beta.zip. b. Decompress the zip file and copy "libs" folder in your project. c. Download PanoramaGL_0.2-beta.jar. d. Copy jar file in "libs" folder in your project. e. Import jar file in your project: - Right click on your project and select "Properties" option. - Select on left panel "Java Build Path" option. - Select "Libraries" tabulator. - Click on "Add JARs..." button. - Select "libs/PanoramaGL_0.2-beta.jar" file from your project. - Click on "OK" button. - Accept the changes selecting the "OK" button on right bottom corner in properties window. 5. How to use PanoramaGL in your application? ============================================= a. Import the library as described on previous literal. b. Import a spherical image (e.g. spherical_pano.jpg) in "res/raw" folder. c. In the Activity class that you need to make a panoramic viewer, do the next changes: - Inherit from PLView class public class YourActivity extends PLView - Within the onCreate method, load the panoramic image @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); PLSpherical2Panorama panorama = new PLSpherical2Panorama(); panorama.setImage(new PLImage(PLUtils.getBitmap(this, R.raw.spherical_pano), false)); this.setPanorama(panorama); } Note: You can load panoramic images from other methods or events if you need it. 6. Simple JSON Protocol ======================= You can use JSON protocol to load panoramas and to create virtual tours. 6.1. Source code ================ 6.1.1. From the resources ========================= this.load(new PLJSONLoader("res://raw/json_spherical")); Note: For this code, you need to have a file named "json_spherical.data" in "res/raw" folder in your application. 6.1.2. From the file system =========================== this.load(new PLJSONLoader("file:///sdcard/files/json_spherical.data")); Note: For this code, you need to have a file named "json_spherical.data" in "/sdcard/files" folder on the Android device or emulator. 6.1.3. From a Web server ======================== this.load(new PLJSONLoader("http://mydomain/files/json_spherical.data")); Note: For this code, you need to have a file named "json_spherical.data" in "http://mydomain/files" Web server path. 6.2. JSON Protocol ================== { "urlBase": "file:///sdcard/files", //URL base where the files are //The options are: http://, https://, res:// for application resources and file:// for the file system "type": "spherical", //Panorama type: [spherical, spherical2, cubic, cylindrical] "keep": "none", //Keeps the current settings [none, reset, scrolling, inertia, accelerometer, sensorialRotation, all] <Optional> //By default the value is none and you can use the options like a mask e.g. all|~scrolling that meaning keep all except the scrolling options "imageColorFormat": "RGBA8888", //Color format to be used for all images [RGBA8888, RGB565, RGBA4444] <Optional> "height": 3.0, //Sets the panorama's height only for cylindrical panorama <Optional> "divisions": //Divisions section only for spherical, spherical2 and cylindrical panoramas <Optional> { "preview": 50, //Number of divisions for the preview panorama <Optional> "panorama": 50 //Number of divisions for the panorama <Optional> }, "reset": //Reset section <Optional> { "enabled": true, //Enable reset feature [true, false] <Optional> "numberOfTouches": 3, //Number of touches to reset <Optional> "shake": //Shake reset section <Optional> { "enabled": true, //Enable shake reset [true, false] <Optional> "threshold": 1300 //Shake threshold <Optional> } }, "scrolling": //Scrolling section <Optional> { "enabled": true, //Enable scrolling feature [true, false] <Optional> "minDistanceToEnableScrolling": 30 //Minimum distance to enable scrolling in pixels <Optional> }, "inertia": //Inertia section <Optional> { "enabled": false, //Enable inertia feature [true, false] <Optional> "interval": 3 //Inertia's interval in seconds <Optional> }, "accelerometer": //Accelerometer section <Optional> { "enabled": false, //Enable the accelerometer feature [true, false] <Optional> "interval": 0.033, //Update interval of acceler