blob: c597ed2cc61e77d6d075dc65a5b4c7e37a676abc [file] [log] [blame]
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001/*
2 * Copyright (C) 2007 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -070017#define LOG_NDEBUG 0
Mathias Agopianbc726112009-09-23 15:44:05 -070018#define LOG_TAG "BootAnimation"
19
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080020#include <stdint.h>
21#include <sys/types.h>
22#include <math.h>
23#include <fcntl.h>
24#include <utils/misc.h>
Mathias Agopianb4d5a722009-09-23 17:05:19 -070025#include <signal.h>
Elliott Hughesbb94f312014-10-21 10:41:33 -070026#include <time.h>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080027
Jason parksbd9a08d2011-01-31 15:04:34 -060028#include <cutils/properties.h>
29
Mathias Agopianb13b9bd2012-02-17 18:27:36 -080030#include <androidfw/AssetManager.h>
Mathias Agopianac31a3b2009-05-21 19:59:24 -070031#include <binder/IPCThreadState.h>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080032#include <utils/Atomic.h>
33#include <utils/Errors.h>
34#include <utils/Log.h>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080035
36#include <ui/PixelFormat.h>
37#include <ui/Rect.h>
38#include <ui/Region.h>
39#include <ui/DisplayInfo.h>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080040
Jeff Brown0b722fe2012-08-24 22:40:14 -070041#include <gui/ISurfaceComposer.h>
Mathias Agopian8335f1c2012-02-25 18:48:35 -080042#include <gui/Surface.h>
43#include <gui/SurfaceComposerClient.h>
Mathias Agopian000479f2010-02-09 17:46:37 -080044
Andreas Gampecfedceb2014-09-30 21:48:18 -070045// TODO: Fix Skia.
46#pragma GCC diagnostic push
47#pragma GCC diagnostic ignored "-Wunused-parameter"
Derek Sollenbergereece0dd2014-02-27 14:31:29 -050048#include <SkBitmap.h>
49#include <SkStream.h>
50#include <SkImageDecoder.h>
Andreas Gampecfedceb2014-09-30 21:48:18 -070051#pragma GCC diagnostic pop
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080052
53#include <GLES/gl.h>
54#include <GLES/glext.h>
55#include <EGL/eglext.h>
56
57#include "BootAnimation.h"
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -070058#include "AudioPlayer.h"
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080059
Jeff Sharkey28f08772014-04-16 09:41:58 -070060#define OEM_BOOTANIMATION_FILE "/oem/media/bootanimation.zip"
Jim Huangc11f4622010-08-10 03:12:15 +080061#define SYSTEM_BOOTANIMATION_FILE "/system/media/bootanimation.zip"
Jason parksbd9a08d2011-01-31 15:04:34 -060062#define SYSTEM_ENCRYPTED_BOOTANIMATION_FILE "/system/media/bootanimation-encrypted.zip"
Kevin Hesterd3782b22012-04-26 10:38:55 -070063#define EXIT_PROP_NAME "service.bootanim.exit"
Jim Huangc11f4622010-08-10 03:12:15 +080064
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080065namespace android {
66
Narayan Kamathafd31e02013-12-03 13:16:03 +000067static const int ANIM_ENTRY_NAME_MAX = 256;
68
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080069// ---------------------------------------------------------------------------
70
Andriy Naborskyy815e51d2016-03-24 16:43:34 -070071BootAnimation::BootAnimation() : Thread(false), mClockEnabled(true) {
Mathias Agopian627e7b52009-05-21 19:21:59 -070072 mSession = new SurfaceComposerClient();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080073}
74
75BootAnimation::~BootAnimation() {
76}
77
78void BootAnimation::onFirstRef() {
Mathias Agopianbc726112009-09-23 15:44:05 -070079 status_t err = mSession->linkToComposerDeath(this);
Steve Block3762c312012-01-06 19:20:56 +000080 ALOGE_IF(err, "linkToComposerDeath failed (%s) ", strerror(-err));
Mathias Agopian8434c532009-09-23 18:52:49 -070081 if (err == NO_ERROR) {
Mathias Agopianbc726112009-09-23 15:44:05 -070082 run("BootAnimation", PRIORITY_DISPLAY);
83 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080084}
85
Mathias Agopianbc726112009-09-23 15:44:05 -070086sp<SurfaceComposerClient> BootAnimation::session() const {
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080087 return mSession;
88}
89
Mathias Agopianbc726112009-09-23 15:44:05 -070090
Narayan Kamathafd31e02013-12-03 13:16:03 +000091void BootAnimation::binderDied(const wp<IBinder>&)
Mathias Agopianbc726112009-09-23 15:44:05 -070092{
93 // woah, surfaceflinger died!
Steve Block5baa3a62011-12-20 16:23:08 +000094 ALOGD("SurfaceFlinger died, exiting...");
Mathias Agopianbc726112009-09-23 15:44:05 -070095
96 // calling requestExit() is not enough here because the Surface code
97 // might be blocked on a condition variable that will never be updated.
98 kill( getpid(), SIGKILL );
99 requestExit();
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -0700100 if (mAudioPlayer != NULL) {
101 mAudioPlayer->requestExit();
102 }
Mathias Agopianbc726112009-09-23 15:44:05 -0700103}
104
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800105status_t BootAnimation::initTexture(Texture* texture, AssetManager& assets,
106 const char* name) {
107 Asset* asset = assets.open(name, Asset::ACCESS_BUFFER);
Andreas Gampecfedceb2014-09-30 21:48:18 -0700108 if (asset == NULL)
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800109 return NO_INIT;
110 SkBitmap bitmap;
111 SkImageDecoder::DecodeMemory(asset->getBuffer(false), asset->getLength(),
Mike Reed42a1d082014-07-07 18:06:18 -0400112 &bitmap, kUnknown_SkColorType, SkImageDecoder::kDecodePixels_Mode);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800113 asset->close();
114 delete asset;
115
116 // ensure we can call getPixels(). No need to call unlock, since the
117 // bitmap will go out of scope when we return from this method.
118 bitmap.lockPixels();
119
120 const int w = bitmap.width();
121 const int h = bitmap.height();
122 const void* p = bitmap.getPixels();
123
124 GLint crop[4] = { 0, h, w, -h };
125 texture->w = w;
126 texture->h = h;
127
128 glGenTextures(1, &texture->name);
129 glBindTexture(GL_TEXTURE_2D, texture->name);
130
Mike Reed42a1d082014-07-07 18:06:18 -0400131 switch (bitmap.colorType()) {
132 case kAlpha_8_SkColorType:
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800133 glTexImage2D(GL_TEXTURE_2D, 0, GL_ALPHA, w, h, 0, GL_ALPHA,
134 GL_UNSIGNED_BYTE, p);
135 break;
Mike Reed42a1d082014-07-07 18:06:18 -0400136 case kARGB_4444_SkColorType:
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800137 glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, w, h, 0, GL_RGBA,
138 GL_UNSIGNED_SHORT_4_4_4_4, p);
139 break;
Mike Reed42a1d082014-07-07 18:06:18 -0400140 case kN32_SkColorType:
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800141 glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, w, h, 0, GL_RGBA,
142 GL_UNSIGNED_BYTE, p);
143 break;
Mike Reed42a1d082014-07-07 18:06:18 -0400144 case kRGB_565_SkColorType:
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800145 glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, w, h, 0, GL_RGB,
146 GL_UNSIGNED_SHORT_5_6_5, p);
147 break;
148 default:
149 break;
150 }
151
152 glTexParameteriv(GL_TEXTURE_2D, GL_TEXTURE_CROP_RECT_OES, crop);
153 glTexParameterx(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST);
154 glTexParameterx(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST);
155 glTexParameterx(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_REPEAT);
156 glTexParameterx(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_REPEAT);
157 return NO_ERROR;
158}
159
Mykola Kondratenko0c1eeb32014-04-15 09:35:44 +0200160status_t BootAnimation::initTexture(const Animation::Frame& frame)
Mathias Agopiana8826d62009-10-01 03:10:14 -0700161{
162 //StopWatch watch("blah");
163
164 SkBitmap bitmap;
Mykola Kondratenko0c1eeb32014-04-15 09:35:44 +0200165 SkMemoryStream stream(frame.map->getDataPtr(), frame.map->getDataLength());
Mathias Agopian2b99e552011-11-10 15:59:07 -0800166 SkImageDecoder* codec = SkImageDecoder::Factory(&stream);
Andreas Gampecfedceb2014-09-30 21:48:18 -0700167 if (codec != NULL) {
Elliott Hughesc367d482013-10-29 13:12:55 -0700168 codec->setDitherImage(false);
Mathias Agopian2b99e552011-11-10 15:59:07 -0800169 codec->decode(&stream, &bitmap,
Mike Reed42a1d082014-07-07 18:06:18 -0400170 kN32_SkColorType,
Mathias Agopian2b99e552011-11-10 15:59:07 -0800171 SkImageDecoder::kDecodePixels_Mode);
172 delete codec;
173 }
Mathias Agopiana8826d62009-10-01 03:10:14 -0700174
Mykola Kondratenko0c1eeb32014-04-15 09:35:44 +0200175 // FileMap memory is never released until application exit.
176 // Release it now as the texture is already loaded and the memory used for
177 // the packed resource can be released.
Narayan Kamath688ff4c2015-02-23 15:47:54 +0000178 delete frame.map;
Mykola Kondratenko0c1eeb32014-04-15 09:35:44 +0200179
Mathias Agopiana8826d62009-10-01 03:10:14 -0700180 // ensure we can call getPixels(). No need to call unlock, since the
181 // bitmap will go out of scope when we return from this method.
182 bitmap.lockPixels();
183
184 const int w = bitmap.width();
185 const int h = bitmap.height();
186 const void* p = bitmap.getPixels();
187
188 GLint crop[4] = { 0, h, w, -h };
189 int tw = 1 << (31 - __builtin_clz(w));
190 int th = 1 << (31 - __builtin_clz(h));
191 if (tw < w) tw <<= 1;
192 if (th < h) th <<= 1;
193
Mike Reed42a1d082014-07-07 18:06:18 -0400194 switch (bitmap.colorType()) {
195 case kN32_SkColorType:
Mathias Agopiana8826d62009-10-01 03:10:14 -0700196 if (tw != w || th != h) {
197 glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, tw, th, 0, GL_RGBA,
198 GL_UNSIGNED_BYTE, 0);
199 glTexSubImage2D(GL_TEXTURE_2D, 0,
200 0, 0, w, h, GL_RGBA, GL_UNSIGNED_BYTE, p);
201 } else {
202 glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, tw, th, 0, GL_RGBA,
203 GL_UNSIGNED_BYTE, p);
204 }
205 break;
206
Mike Reed42a1d082014-07-07 18:06:18 -0400207 case kRGB_565_SkColorType:
Mathias Agopiana8826d62009-10-01 03:10:14 -0700208 if (tw != w || th != h) {
209 glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, tw, th, 0, GL_RGB,
210 GL_UNSIGNED_SHORT_5_6_5, 0);
211 glTexSubImage2D(GL_TEXTURE_2D, 0,
212 0, 0, w, h, GL_RGB, GL_UNSIGNED_SHORT_5_6_5, p);
213 } else {
214 glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, tw, th, 0, GL_RGB,
215 GL_UNSIGNED_SHORT_5_6_5, p);
216 }
217 break;
218 default:
219 break;
220 }
221
222 glTexParameteriv(GL_TEXTURE_2D, GL_TEXTURE_CROP_RECT_OES, crop);
223
224 return NO_ERROR;
225}
226
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800227status_t BootAnimation::readyToRun() {
228 mAssets.addDefaultAssets();
229
Jeff Brown0b722fe2012-08-24 22:40:14 -0700230 sp<IBinder> dtoken(SurfaceComposerClient::getBuiltInDisplay(
231 ISurfaceComposer::eDisplayIdMain));
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800232 DisplayInfo dinfo;
Jeff Brown0b722fe2012-08-24 22:40:14 -0700233 status_t status = SurfaceComposerClient::getDisplayInfo(dtoken, &dinfo);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800234 if (status)
235 return -1;
236
237 // create the native surface
Jeff Brown0b722fe2012-08-24 22:40:14 -0700238 sp<SurfaceControl> control = session()->createSurface(String8("BootAnimation"),
239 dinfo.w, dinfo.h, PIXEL_FORMAT_RGB_565);
Mathias Agopian439863f2011-06-28 19:09:31 -0700240
241 SurfaceComposerClient::openGlobalTransaction();
Mathias Agopian17f638b2009-04-16 20:04:08 -0700242 control->setLayer(0x40000000);
Mathias Agopian439863f2011-06-28 19:09:31 -0700243 SurfaceComposerClient::closeGlobalTransaction();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800244
Mathias Agopian17f638b2009-04-16 20:04:08 -0700245 sp<Surface> s = control->getSurface();
246
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800247 // initialize opengl and egl
Mathias Agopian738b9a42009-08-06 16:41:02 -0700248 const EGLint attribs[] = {
Mathias Agopian1b253b72011-08-15 15:20:22 -0700249 EGL_RED_SIZE, 8,
250 EGL_GREEN_SIZE, 8,
251 EGL_BLUE_SIZE, 8,
Mathias Agopiana8826d62009-10-01 03:10:14 -0700252 EGL_DEPTH_SIZE, 0,
253 EGL_NONE
Mathias Agopian738b9a42009-08-06 16:41:02 -0700254 };
Andreas Gampecfedceb2014-09-30 21:48:18 -0700255 EGLint w, h;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800256 EGLint numConfigs;
257 EGLConfig config;
258 EGLSurface surface;
259 EGLContext context;
Mathias Agopian627e7b52009-05-21 19:21:59 -0700260
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800261 EGLDisplay display = eglGetDisplay(EGL_DEFAULT_DISPLAY);
Mathias Agopian627e7b52009-05-21 19:21:59 -0700262
263 eglInitialize(display, 0, 0);
Mathias Agopian1b253b72011-08-15 15:20:22 -0700264 eglChooseConfig(display, attribs, &config, 1, &numConfigs);
Mathias Agopian1473f462009-04-10 14:24:30 -0700265 surface = eglCreateWindowSurface(display, config, s.get(), NULL);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800266 context = eglCreateContext(display, config, NULL, NULL);
267 eglQuerySurface(display, surface, EGL_WIDTH, &w);
268 eglQuerySurface(display, surface, EGL_HEIGHT, &h);
Mathias Agopiana8826d62009-10-01 03:10:14 -0700269
Mathias Agopianabac0102009-07-31 14:47:00 -0700270 if (eglMakeCurrent(display, surface, surface, context) == EGL_FALSE)
271 return NO_INIT;
Mathias Agopiana8826d62009-10-01 03:10:14 -0700272
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800273 mDisplay = display;
274 mContext = context;
275 mSurface = surface;
276 mWidth = w;
277 mHeight = h;
Mathias Agopian17f638b2009-04-16 20:04:08 -0700278 mFlingerSurfaceControl = control;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800279 mFlingerSurface = s;
280
Elliott Hughesc367d482013-10-29 13:12:55 -0700281 // If the device has encryption turned on or is in process
Jason parksbd9a08d2011-01-31 15:04:34 -0600282 // of being encrypted we show the encrypted boot animation.
283 char decrypt[PROPERTY_VALUE_MAX];
284 property_get("vold.decrypt", decrypt, "");
285
286 bool encryptedAnimation = atoi(decrypt) != 0 || !strcmp("trigger_restart_min_framework", decrypt);
287
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700288 if (encryptedAnimation && (access(SYSTEM_ENCRYPTED_BOOTANIMATION_FILE, R_OK) == 0)) {
289 mZipFileName = SYSTEM_ENCRYPTED_BOOTANIMATION_FILE;
Jason parksbd9a08d2011-01-31 15:04:34 -0600290 }
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700291 else if (access(OEM_BOOTANIMATION_FILE, R_OK) == 0) {
292 mZipFileName = OEM_BOOTANIMATION_FILE;
293 }
294 else if (access(SYSTEM_BOOTANIMATION_FILE, R_OK) == 0) {
295 mZipFileName = SYSTEM_BOOTANIMATION_FILE;
296 }
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800297 return NO_ERROR;
298}
299
Mathias Agopiana8826d62009-10-01 03:10:14 -0700300bool BootAnimation::threadLoop()
301{
302 bool r;
Narayan Kamathafd31e02013-12-03 13:16:03 +0000303 // We have no bootanimation file, so we use the stock android logo
304 // animation.
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700305 if (mZipFileName.isEmpty()) {
Mathias Agopiana8826d62009-10-01 03:10:14 -0700306 r = android();
307 } else {
308 r = movie();
309 }
310
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800311 eglMakeCurrent(mDisplay, EGL_NO_SURFACE, EGL_NO_SURFACE, EGL_NO_CONTEXT);
312 eglDestroyContext(mDisplay, mContext);
313 eglDestroySurface(mDisplay, mSurface);
Mathias Agopian6cf0db22009-04-17 19:36:26 -0700314 mFlingerSurface.clear();
Mathias Agopian17f638b2009-04-16 20:04:08 -0700315 mFlingerSurfaceControl.clear();
Mathias Agopian627e7b52009-05-21 19:21:59 -0700316 eglTerminate(mDisplay);
317 IPCThreadState::self()->stopProcess();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800318 return r;
319}
320
Mathias Agopiana8826d62009-10-01 03:10:14 -0700321bool BootAnimation::android()
322{
Mathias Agopianb2cf9542009-03-24 18:34:16 -0700323 initTexture(&mAndroid[0], mAssets, "images/android-logo-mask.png");
324 initTexture(&mAndroid[1], mAssets, "images/android-logo-shine.png");
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800325
326 // clear screen
Mathias Agopiana8826d62009-10-01 03:10:14 -0700327 glShadeModel(GL_FLAT);
Mathias Agopianb2cf9542009-03-24 18:34:16 -0700328 glDisable(GL_DITHER);
329 glDisable(GL_SCISSOR_TEST);
Mathias Agopian59f19e42011-05-06 19:22:12 -0700330 glClearColor(0,0,0,1);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800331 glClear(GL_COLOR_BUFFER_BIT);
332 eglSwapBuffers(mDisplay, mSurface);
333
Mathias Agopiana8826d62009-10-01 03:10:14 -0700334 glEnable(GL_TEXTURE_2D);
335 glTexEnvx(GL_TEXTURE_ENV, GL_TEXTURE_ENV_MODE, GL_REPLACE);
336
Mathias Agopianb2cf9542009-03-24 18:34:16 -0700337 const GLint xc = (mWidth - mAndroid[0].w) / 2;
338 const GLint yc = (mHeight - mAndroid[0].h) / 2;
339 const Rect updateRect(xc, yc, xc + mAndroid[0].w, yc + mAndroid[0].h);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800340
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800341 glScissor(updateRect.left, mHeight - updateRect.bottom, updateRect.width(),
342 updateRect.height());
343
Mathias Agopianb2cf9542009-03-24 18:34:16 -0700344 // Blend state
345 glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
346 glTexEnvx(GL_TEXTURE_ENV, GL_TEXTURE_ENV_MODE, GL_REPLACE);
347
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800348 const nsecs_t startTime = systemTime();
349 do {
Mathias Agopian13796652009-03-24 22:49:21 -0700350 nsecs_t now = systemTime();
351 double time = now - startTime;
Mathias Agopianb2cf9542009-03-24 18:34:16 -0700352 float t = 4.0f * float(time / us2ns(16667)) / mAndroid[1].w;
353 GLint offset = (1 - (t - floorf(t))) * mAndroid[1].w;
354 GLint x = xc - offset;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800355
Mathias Agopian81668642009-07-28 11:41:30 -0700356 glDisable(GL_SCISSOR_TEST);
357 glClear(GL_COLOR_BUFFER_BIT);
358
359 glEnable(GL_SCISSOR_TEST);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800360 glDisable(GL_BLEND);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800361 glBindTexture(GL_TEXTURE_2D, mAndroid[1].name);
Mathias Agopianb2cf9542009-03-24 18:34:16 -0700362 glDrawTexiOES(x, yc, 0, mAndroid[1].w, mAndroid[1].h);
363 glDrawTexiOES(x + mAndroid[1].w, yc, 0, mAndroid[1].w, mAndroid[1].h);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800364
Mathias Agopianb2cf9542009-03-24 18:34:16 -0700365 glEnable(GL_BLEND);
366 glBindTexture(GL_TEXTURE_2D, mAndroid[0].name);
367 glDrawTexiOES(xc, yc, 0, mAndroid[0].w, mAndroid[0].h);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800368
Mathias Agopian627e7b52009-05-21 19:21:59 -0700369 EGLBoolean res = eglSwapBuffers(mDisplay, mSurface);
370 if (res == EGL_FALSE)
371 break;
372
Mathias Agopian13796652009-03-24 22:49:21 -0700373 // 12fps: don't animate too fast to preserve CPU
374 const nsecs_t sleepTime = 83333 - ns2us(systemTime() - now);
375 if (sleepTime > 0)
Mathias Agopiana8826d62009-10-01 03:10:14 -0700376 usleep(sleepTime);
Kevin Hesterd3782b22012-04-26 10:38:55 -0700377
378 checkExit();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800379 } while (!exitPending());
380
381 glDeleteTextures(1, &mAndroid[0].name);
382 glDeleteTextures(1, &mAndroid[1].name);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800383 return false;
384}
385
Mathias Agopiana8826d62009-10-01 03:10:14 -0700386
Kevin Hesterd3782b22012-04-26 10:38:55 -0700387void BootAnimation::checkExit() {
388 // Allow surface flinger to gracefully request shutdown
389 char value[PROPERTY_VALUE_MAX];
390 property_get(EXIT_PROP_NAME, value, "0");
391 int exitnow = atoi(value);
392 if (exitnow) {
393 requestExit();
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -0700394 if (mAudioPlayer != NULL) {
395 mAudioPlayer->requestExit();
396 }
Kevin Hesterd3782b22012-04-26 10:38:55 -0700397 }
398}
399
Jesse Hall083b84c2014-09-22 10:51:09 -0700400// Parse a color represented as an HTML-style 'RRGGBB' string: each pair of
401// characters in str is a hex number in [0, 255], which are converted to
402// floating point values in the range [0.0, 1.0] and placed in the
403// corresponding elements of color.
404//
405// If the input string isn't valid, parseColor returns false and color is
406// left unchanged.
407static bool parseColor(const char str[7], float color[3]) {
408 float tmpColor[3];
409 for (int i = 0; i < 3; i++) {
410 int val = 0;
411 for (int j = 0; j < 2; j++) {
412 val *= 16;
413 char c = str[2*i + j];
414 if (c >= '0' && c <= '9') val += c - '0';
415 else if (c >= 'A' && c <= 'F') val += (c - 'A') + 10;
416 else if (c >= 'a' && c <= 'f') val += (c - 'a') + 10;
417 else return false;
418 }
419 tmpColor[i] = static_cast<float>(val) / 255.0f;
420 }
421 memcpy(color, tmpColor, sizeof(tmpColor));
422 return true;
423}
424
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700425
426static bool readFile(ZipFileRO* zip, const char* name, String8& outString)
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -0700427{
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700428 ZipEntryRO entry = zip->findEntryByName(name);
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -0700429 ALOGE_IF(!entry, "couldn't find %s", name);
430 if (!entry) {
431 return false;
432 }
433
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700434 FileMap* entryMap = zip->createEntryFileMap(entry);
435 zip->releaseEntry(entry);
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -0700436 ALOGE_IF(!entryMap, "entryMap is null");
437 if (!entryMap) {
438 return false;
439 }
440
441 outString.setTo((char const*)entryMap->getDataPtr(), entryMap->getDataLength());
Narayan Kamath688ff4c2015-02-23 15:47:54 +0000442 delete entryMap;
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -0700443 return true;
444}
445
Damien Bargiacchia704b7d2016-02-16 16:55:49 -0800446// The time glyphs are stored in a single image of height 64 pixels. Each digit is 40 pixels wide,
447// and the colon character is half that at 20 pixels. The glyph order is '0123456789:'.
448// We render 24 hour time.
449void BootAnimation::drawTime(const Texture& clockTex, const int yPos) {
450 static constexpr char TIME_FORMAT[] = "%H:%M";
451 static constexpr int TIME_LENGTH = sizeof(TIME_FORMAT);
452
453 static constexpr int DIGIT_HEIGHT = 64;
454 static constexpr int DIGIT_WIDTH = 40;
455 static constexpr int COLON_WIDTH = DIGIT_WIDTH / 2;
456 static constexpr int TIME_WIDTH = (DIGIT_WIDTH * 4) + COLON_WIDTH;
457
458 if (clockTex.h < DIGIT_HEIGHT || clockTex.w < (10 * DIGIT_WIDTH + COLON_WIDTH)) {
459 ALOGE("Clock texture is too small; abandoning boot animation clock");
460 mClockEnabled = false;
461 return;
462 }
463
464 time_t rawtime;
465 time(&rawtime);
466 struct tm* timeInfo = localtime(&rawtime);
467
468 char timeBuff[TIME_LENGTH];
469 size_t length = strftime(timeBuff, TIME_LENGTH, TIME_FORMAT, timeInfo);
470
471 if (length != TIME_LENGTH - 1) {
472 ALOGE("Couldn't format time; abandoning boot animation clock");
473 mClockEnabled = false;
474 return;
475 }
476
477 glEnable(GL_BLEND); // Allow us to draw on top of the animation
478 glBindTexture(GL_TEXTURE_2D, clockTex.name);
479
480 int xPos = (mWidth - TIME_WIDTH) / 2;
481 int cropRect[4] = { 0, DIGIT_HEIGHT, DIGIT_WIDTH, -DIGIT_HEIGHT };
482
483 for (int i = 0; i < TIME_LENGTH - 1; i++) {
484 char c = timeBuff[i];
485 int width = DIGIT_WIDTH;
486 int pos = c - '0'; // Position in the character list
487 if (pos < 0 || pos > 10) {
488 continue;
489 }
490 if (c == ':') {
491 width = COLON_WIDTH;
492 }
493
494 // Crop the texture to only the pixels in the current glyph
495 int left = pos * DIGIT_WIDTH;
496 cropRect[0] = left;
497 cropRect[2] = width;
498 glTexParameteriv(GL_TEXTURE_2D, GL_TEXTURE_CROP_RECT_OES, cropRect);
499
500 glDrawTexiOES(xPos, yPos, 0, width, DIGIT_HEIGHT);
501
502 xPos += width;
503 }
504
505 glDisable(GL_BLEND); // Return to the animation's default behaviour
506 glBindTexture(GL_TEXTURE_2D, 0);
507}
508
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700509bool BootAnimation::parseAnimationDesc(Animation& animation)
Mathias Agopiana8826d62009-10-01 03:10:14 -0700510{
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -0700511 String8 desString;
512
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700513 if (!readFile(animation.zip, "desc.txt", desString)) {
Narayan Kamathafd31e02013-12-03 13:16:03 +0000514 return false;
515 }
Mathias Agopiana8826d62009-10-01 03:10:14 -0700516 char const* s = desString.string();
517
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -0700518 // Create and initialize an AudioPlayer if we have an audio_conf.txt file
519 String8 audioConf;
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700520 if (readFile(animation.zip, "audio_conf.txt", audioConf)) {
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -0700521 mAudioPlayer = new AudioPlayer;
522 if (!mAudioPlayer->init(audioConf.string())) {
523 ALOGE("mAudioPlayer.init failed");
524 mAudioPlayer = NULL;
525 }
526 }
527
Mathias Agopiana8826d62009-10-01 03:10:14 -0700528 // Parse the description file
529 for (;;) {
530 const char* endl = strstr(s, "\n");
Andreas Gampecfedceb2014-09-30 21:48:18 -0700531 if (endl == NULL) break;
Mathias Agopiana8826d62009-10-01 03:10:14 -0700532 String8 line(s, endl - s);
533 const char* l = line.string();
Damien Bargiacchia704b7d2016-02-16 16:55:49 -0800534 int fps = 0;
535 int width = 0;
536 int height = 0;
537 int count = 0;
538 int pause = 0;
539 int clockPosY = -1;
Narayan Kamathafd31e02013-12-03 13:16:03 +0000540 char path[ANIM_ENTRY_NAME_MAX];
Jesse Hall083b84c2014-09-22 10:51:09 -0700541 char color[7] = "000000"; // default to black if unspecified
542
Kevin Hesterd3782b22012-04-26 10:38:55 -0700543 char pathType;
Mathias Agopiana8826d62009-10-01 03:10:14 -0700544 if (sscanf(l, "%d %d %d", &width, &height, &fps) == 3) {
Jesse Hall083b84c2014-09-22 10:51:09 -0700545 // ALOGD("> w=%d, h=%d, fps=%d", width, height, fps);
Mathias Agopiana8826d62009-10-01 03:10:14 -0700546 animation.width = width;
547 animation.height = height;
548 animation.fps = fps;
Damien Bargiacchia704b7d2016-02-16 16:55:49 -0800549 } else if (sscanf(l, " %c %d %d %s #%6s %d",
550 &pathType, &count, &pause, path, color, &clockPosY) >= 4) {
551 // ALOGD("> type=%c, count=%d, pause=%d, path=%s, color=%s, clockPosY=%d", pathType, count, pause, path, color, clockPosY);
Mathias Agopiana8826d62009-10-01 03:10:14 -0700552 Animation::Part part;
Kevin Hesterd3782b22012-04-26 10:38:55 -0700553 part.playUntilComplete = pathType == 'c';
Mathias Agopiana8826d62009-10-01 03:10:14 -0700554 part.count = count;
555 part.pause = pause;
556 part.path = path;
Damien Bargiacchia704b7d2016-02-16 16:55:49 -0800557 part.clockPosY = clockPosY;
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -0700558 part.audioFile = NULL;
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700559 part.animation = NULL;
Jesse Hall083b84c2014-09-22 10:51:09 -0700560 if (!parseColor(color, part.backgroundColor)) {
561 ALOGE("> invalid color '#%s'", color);
562 part.backgroundColor[0] = 0.0f;
563 part.backgroundColor[1] = 0.0f;
564 part.backgroundColor[2] = 0.0f;
565 }
Mathias Agopiana8826d62009-10-01 03:10:14 -0700566 animation.parts.add(part);
567 }
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700568 else if (strcmp(l, "$SYSTEM") == 0) {
569 // ALOGD("> SYSTEM");
570 Animation::Part part;
571 part.playUntilComplete = false;
572 part.count = 1;
573 part.pause = 0;
574 part.audioFile = NULL;
575 part.animation = loadAnimation(String8(SYSTEM_BOOTANIMATION_FILE));
576 if (part.animation != NULL)
577 animation.parts.add(part);
578 }
Mathias Agopiana8826d62009-10-01 03:10:14 -0700579 s = ++endl;
580 }
581
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700582 return true;
583}
584
585bool BootAnimation::preloadZip(Animation& animation)
586{
Mathias Agopiana8826d62009-10-01 03:10:14 -0700587 // read all the data structures
588 const size_t pcount = animation.parts.size();
Narayan Kamathafd31e02013-12-03 13:16:03 +0000589 void *cookie = NULL;
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700590 ZipFileRO* mZip = animation.zip;
Narayan Kamathafd31e02013-12-03 13:16:03 +0000591 if (!mZip->startIteration(&cookie)) {
592 return false;
593 }
594
595 ZipEntryRO entry;
596 char name[ANIM_ENTRY_NAME_MAX];
597 while ((entry = mZip->nextEntry(cookie)) != NULL) {
598 const int foundEntryName = mZip->getEntryFileName(entry, name, ANIM_ENTRY_NAME_MAX);
599 if (foundEntryName > ANIM_ENTRY_NAME_MAX || foundEntryName == -1) {
600 ALOGE("Error fetching entry file name");
601 continue;
602 }
603
604 const String8 entryName(name);
605 const String8 path(entryName.getPathDir());
606 const String8 leaf(entryName.getPathLeaf());
607 if (leaf.size() > 0) {
608 for (size_t j=0 ; j<pcount ; j++) {
609 if (path == animation.parts[j].path) {
Narayan Kamath4600dd02015-06-16 12:02:57 +0100610 uint16_t method;
Narayan Kamathafd31e02013-12-03 13:16:03 +0000611 // supports only stored png files
612 if (mZip->getEntryInfo(entry, &method, NULL, NULL, NULL, NULL, NULL)) {
613 if (method == ZipFileRO::kCompressStored) {
614 FileMap* map = mZip->createEntryFileMap(entry);
615 if (map) {
Narayan Kamathafd31e02013-12-03 13:16:03 +0000616 Animation::Part& part(animation.parts.editItemAt(j));
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -0700617 if (leaf == "audio.wav") {
618 // a part may have at most one audio file
619 part.audioFile = map;
620 } else {
621 Animation::Frame frame;
622 frame.name = leaf;
623 frame.map = map;
624 part.frames.add(frame);
625 }
Mathias Agopiana8826d62009-10-01 03:10:14 -0700626 }
627 }
628 }
629 }
630 }
631 }
632 }
633
Narayan Kamathafd31e02013-12-03 13:16:03 +0000634 mZip->endIteration(cookie);
635
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700636 return true;
637}
638
639bool BootAnimation::movie()
640{
641
642 Animation* animation = loadAnimation(mZipFileName);
643 if (animation == NULL)
644 return false;
645
Damien Bargiacchia704b7d2016-02-16 16:55:49 -0800646 // Blend required to draw time on top of animation frames.
647 glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
Mathias Agopiana8826d62009-10-01 03:10:14 -0700648 glShadeModel(GL_FLAT);
649 glDisable(GL_DITHER);
650 glDisable(GL_SCISSOR_TEST);
651 glDisable(GL_BLEND);
Mathias Agopiana8826d62009-10-01 03:10:14 -0700652
653 glBindTexture(GL_TEXTURE_2D, 0);
654 glEnable(GL_TEXTURE_2D);
655 glTexEnvx(GL_TEXTURE_ENV, GL_TEXTURE_ENV_MODE, GL_REPLACE);
656 glTexParameterx(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_REPEAT);
657 glTexParameterx(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_REPEAT);
658 glTexParameterx(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
659 glTexParameterx(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
660
Damien Bargiacchia704b7d2016-02-16 16:55:49 -0800661 bool clockTextureInitialized = false;
662 if (mClockEnabled) {
663 clockTextureInitialized = (initTexture(&mClock, mAssets, "images/clock64.png") == NO_ERROR);
664 mClockEnabled = clockTextureInitialized;
665 }
666
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700667 playAnimation(*animation);
668 releaseAnimation(animation);
669
Andriy Naborskyy815e51d2016-03-24 16:43:34 -0700670 if (clockTextureInitialized) {
671 glDeleteTextures(1, &mClock.name);
672 }
673
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700674 return false;
675}
676
677bool BootAnimation::playAnimation(const Animation& animation)
678{
679 const size_t pcount = animation.parts.size();
Mathias Agopiana8826d62009-10-01 03:10:14 -0700680 const int xc = (mWidth - animation.width) / 2;
681 const int yc = ((mHeight - animation.height) / 2);
Mathias Agopiana8826d62009-10-01 03:10:14 -0700682 nsecs_t frameDuration = s2ns(1) / animation.fps;
683
Mathias Agopian9f3020d2009-11-06 16:30:18 -0800684 Region clearReg(Rect(mWidth, mHeight));
685 clearReg.subtractSelf(Rect(xc, yc, xc+animation.width, yc+animation.height));
686
Narayan Kamathafd31e02013-12-03 13:16:03 +0000687 for (size_t i=0 ; i<pcount ; i++) {
Mathias Agopiana8826d62009-10-01 03:10:14 -0700688 const Animation::Part& part(animation.parts[i]);
689 const size_t fcount = part.frames.size();
690 glBindTexture(GL_TEXTURE_2D, 0);
691
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700692 // Handle animation package
693 if (part.animation != NULL) {
694 playAnimation(*part.animation);
695 if (exitPending())
696 break;
697 continue; //to next part
698 }
699
Mathias Agopiana8826d62009-10-01 03:10:14 -0700700 for (int r=0 ; !part.count || r<part.count ; r++) {
Kevin Hesterd3782b22012-04-26 10:38:55 -0700701 // Exit any non playuntil complete parts immediately
702 if(exitPending() && !part.playUntilComplete)
703 break;
704
Mike Lockwoodebf9a0d2014-10-02 16:08:47 -0700705 // only play audio file the first time we animate the part
706 if (r == 0 && mAudioPlayer != NULL && part.audioFile) {
707 mAudioPlayer->playFile(part.audioFile);
708 }
709
Jesse Hall083b84c2014-09-22 10:51:09 -0700710 glClearColor(
711 part.backgroundColor[0],
712 part.backgroundColor[1],
713 part.backgroundColor[2],
714 1.0f);
715
Narayan Kamathafd31e02013-12-03 13:16:03 +0000716 for (size_t j=0 ; j<fcount && (!exitPending() || part.playUntilComplete) ; j++) {
Mathias Agopiana8826d62009-10-01 03:10:14 -0700717 const Animation::Frame& frame(part.frames[j]);
Mathias Agopiandb7dd2a2012-05-12 15:08:21 -0700718 nsecs_t lastFrame = systemTime();
Mathias Agopiana8826d62009-10-01 03:10:14 -0700719
720 if (r > 0) {
721 glBindTexture(GL_TEXTURE_2D, frame.tid);
722 } else {
723 if (part.count != 1) {
724 glGenTextures(1, &frame.tid);
725 glBindTexture(GL_TEXTURE_2D, frame.tid);
726 glTexParameterx(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
727 glTexParameterx(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
728 }
Mykola Kondratenko0c1eeb32014-04-15 09:35:44 +0200729 initTexture(frame);
Mathias Agopiana8826d62009-10-01 03:10:14 -0700730 }
731
Mathias Agopian9f3020d2009-11-06 16:30:18 -0800732 if (!clearReg.isEmpty()) {
733 Region::const_iterator head(clearReg.begin());
734 Region::const_iterator tail(clearReg.end());
735 glEnable(GL_SCISSOR_TEST);
736 while (head != tail) {
Andreas Gampecfedceb2014-09-30 21:48:18 -0700737 const Rect& r2(*head++);
738 glScissor(r2.left, mHeight - r2.bottom,
739 r2.width(), r2.height());
Mathias Agopian9f3020d2009-11-06 16:30:18 -0800740 glClear(GL_COLOR_BUFFER_BIT);
741 }
742 glDisable(GL_SCISSOR_TEST);
743 }
Chris Elliottd13d5042015-05-04 15:24:12 -0700744 // specify the y center as ceiling((mHeight - animation.height) / 2)
745 // which is equivalent to mHeight - (yc + animation.height)
746 glDrawTexiOES(xc, mHeight - (yc + animation.height),
747 0, animation.width, animation.height);
Damien Bargiacchia704b7d2016-02-16 16:55:49 -0800748 if (mClockEnabled && part.clockPosY >= 0) {
749 drawTime(mClock, part.clockPosY);
750 }
751
Mathias Agopiana8826d62009-10-01 03:10:14 -0700752 eglSwapBuffers(mDisplay, mSurface);
753
754 nsecs_t now = systemTime();
755 nsecs_t delay = frameDuration - (now - lastFrame);
Mathias Agopiandb7dd2a2012-05-12 15:08:21 -0700756 //ALOGD("%lld, %lld", ns2ms(now - lastFrame), ns2ms(delay));
Mathias Agopiana8826d62009-10-01 03:10:14 -0700757 lastFrame = now;
Mathias Agopiandb7dd2a2012-05-12 15:08:21 -0700758
759 if (delay > 0) {
760 struct timespec spec;
761 spec.tv_sec = (now + delay) / 1000000000;
762 spec.tv_nsec = (now + delay) % 1000000000;
763 int err;
764 do {
765 err = clock_nanosleep(CLOCK_MONOTONIC, TIMER_ABSTIME, &spec, NULL);
766 } while (err<0 && errno == EINTR);
767 }
Kevin Hesterd3782b22012-04-26 10:38:55 -0700768
769 checkExit();
Mathias Agopiana8826d62009-10-01 03:10:14 -0700770 }
Kevin Hesterd3782b22012-04-26 10:38:55 -0700771
Mathias Agopiana8826d62009-10-01 03:10:14 -0700772 usleep(part.pause * ns2us(frameDuration));
Kevin Hesterd3782b22012-04-26 10:38:55 -0700773
774 // For infinite parts, we've now played them at least once, so perhaps exit
775 if(exitPending() && !part.count)
776 break;
Mathias Agopiana8826d62009-10-01 03:10:14 -0700777 }
778
779 // free the textures for this part
780 if (part.count != 1) {
Narayan Kamathafd31e02013-12-03 13:16:03 +0000781 for (size_t j=0 ; j<fcount ; j++) {
Mathias Agopiana8826d62009-10-01 03:10:14 -0700782 const Animation::Frame& frame(part.frames[j]);
783 glDeleteTextures(1, &frame.tid);
784 }
785 }
786 }
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700787 return true;
Mathias Agopiana8826d62009-10-01 03:10:14 -0700788}
789
Andriy Naborskyy39218ba2015-08-16 21:32:50 -0700790void BootAnimation::releaseAnimation(Animation* animation) const
791{
792 for (Vector<Animation::Part>::iterator it = animation->parts.begin(),
793 e = animation->parts.end(); it != e; ++it) {
794 if (it->animation)
795 releaseAnimation(it->animation);
796 }
797 if (animation->zip)
798 delete animation->zip;
799 delete animation;
800}
801
802BootAnimation::Animation* BootAnimation::loadAnimation(const String8& fn)
803{
804 if (mLoadedFiles.indexOf(fn) >= 0) {
805 ALOGE("File \"%s\" is already loaded. Cyclic ref is not allowed",
806 fn.string());
807 return NULL;
808 }
809 ZipFileRO *zip = ZipFileRO::open(fn);
810 if (zip == NULL) {
811 ALOGE("Failed to open animation zip \"%s\": %s",
812 fn.string(), strerror(errno));
813 return NULL;
814 }
815
816 Animation *animation = new Animation;
817 animation->fileName = fn;
818 animation->zip = zip;
819 mLoadedFiles.add(animation->fileName);
820
821 parseAnimationDesc(*animation);
822 preloadZip(*animation);
823
824 mLoadedFiles.remove(fn);
825 return animation;
826}
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800827// ---------------------------------------------------------------------------
828
829}
830; // namespace android