gecko/mobile/android/base/LightweightTheme.java

/* -*- Mode: Java; c-basic-offset: 4; tab-width: 20; indent-tabs-mode: nil; -*-
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

package org.mozilla.gecko;

import org.mozilla.gecko.gfx.BitmapUtils;
import org.mozilla.gecko.util.GeckoEventListener;

import org.json.JSONObject;

import android.app.Application;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.graphics.drawable.Drawable;
import android.graphics.drawable.BitmapDrawable;
import android.graphics.Rect;
import android.graphics.Shader;
import android.os.Build;
import android.util.DisplayMetrics;
import android.view.Gravity;
import android.view.View;
import android.view.ViewParent;

import java.net.URL;
import java.io.InputStream;
import java.util.List;
import java.util.ArrayList;

import android.util.Log;

public class LightweightTheme implements GeckoEventListener {
    private static final String LOGTAG = "GeckoLightweightTheme";

    private Application mApplication;
    private Bitmap mBitmap;
    private int mColor;
    private boolean mIsLight;

    public static interface OnChangeListener {
        // This is the View's default post.
        // This is required to post the change/rest on UI thread.
        public boolean post(Runnable action);

        // The View should change its background/text color. 
        public void onLightweightThemeChanged();

        // The View should reset to its default background/text color.
        public void onLightweightThemeReset();
    }

    private List<OnChangeListener> mListeners;
    
    public LightweightTheme(Application application) {
        mApplication = application;
        mListeners = new ArrayList<OnChangeListener>();

        GeckoAppShell.getEventDispatcher().registerEventListener("LightweightTheme:Update", this);
        GeckoAppShell.getEventDispatcher().registerEventListener("LightweightTheme:Disable", this);
    }

    public void addListener(final OnChangeListener listener) {
        // Don't inform the listeners that attached late.
        // Their onLayout() will take care of them before their onDraw();
        mListeners.add(listener);
    }

    public void removeListener(OnChangeListener listener) {
        mListeners.remove(listener);
    }

    public void setLightweightTheme(String headerURL) {
        try {
            // Get the image and convert it to a bitmap.
            URL url = new URL(headerURL);
            InputStream stream = url.openStream();
            mBitmap = BitmapFactory.decodeStream(stream);
            stream.close();

            // The download could be HTTP for previews, so let's be sure we have a bitmap
            if (mBitmap == null || mBitmap.getWidth() == 0 || mBitmap.getHeight() == 0) {
                mBitmap = null;
                return;
            }

            // To find the dominant color only once, take the bottom 25% of pixels.
            DisplayMetrics dm = mApplication.getResources().getDisplayMetrics();
            int maxWidth = Math.max(dm.widthPixels, dm.heightPixels);
            int height = (int) (mBitmap.getHeight() * 0.25);
            Bitmap cropped = Bitmap.createBitmap(mBitmap, mBitmap.getWidth() - maxWidth,
                                                          mBitmap.getHeight() - height, 
                                                          maxWidth, height);
            mColor = BitmapUtils.getDominantColor(cropped, false);

            double luminance = (0.2125 * ((mColor & 0x00FF0000) >> 16)) + 
                               (0.7154 * ((mColor & 0x0000FF00) >> 8)) + 
                               (0.0721 * (mColor &0x000000FF));
            mIsLight = (luminance > 110) ? true : false;

            notifyListeners();
        } catch(java.net.MalformedURLException e) {
            mBitmap = null;
        } catch(java.io.IOException e) {
            mBitmap = null;
        }
    }

    public void resetLightweightTheme() {
        if (mBitmap != null) {
            // Reset the bitmap.
            mBitmap = null;

            // Post the reset on the UI thread.
            for (OnChangeListener listener : mListeners) {
                 final OnChangeListener oneListener = listener;
                 oneListener.post(new Runnable() {
                     @Override
                     public void run() {
                         oneListener.onLightweightThemeReset();
                     }
                 });
            }
        }
    }

    public void notifyListeners() {
        if (mBitmap == null)
            return;

        // Post the change on the UI thread.
        for (OnChangeListener listener : mListeners) {
             final OnChangeListener oneListener = listener;
             oneListener.post(new Runnable() {
                 @Override
                 public void run() {
                     oneListener.onLightweightThemeChanged();
                 }
             });
        }
    }

    @Override
    public void handleMessage(String event, JSONObject message) {
        try {
            if (event.equals("LightweightTheme:Update")) {
                JSONObject lightweightTheme = message.getJSONObject("data");
                String headerURL = lightweightTheme.getString("headerURL"); 
                int mark = headerURL.indexOf('?');
                if (mark != -1)
                    headerURL = headerURL.substring(0, mark);
                setLightweightTheme(headerURL);
            } else if (event.equals("LightweightTheme:Disable")) {
                resetLightweightTheme();
            }
        } catch (Exception e) {
            Log.e(LOGTAG, "Exception handling message \"" + event + "\":", e);
        }
    }


    /**
     * A lightweight theme is enabled only if there is an active bitmap.
     *
     * @return True if the theme is enabled.
     */
    public boolean isEnabled() {
        return (mBitmap != null);
    }

    /**
     * Based on the luminance of the domanint color, a theme is classified as light or dark.
     *
     * @return True if the theme is light.
     */
    public boolean isLightTheme() {
        return mIsLight;
    }

    /**
     * Crop the image based on the position of the view on the window.
     * Either the View or one of its ancestors might have scrolled or translated.
     * This value should be taken into account while mapping the View to the Bitmap.
     *
     * @param view The view requesting a cropped bitmap.
     */
    private Bitmap getCroppedBitmap(View view) {
        if (mBitmap == null || view == null)
            return null;

        // Get the global position of the view on the entire screen.
        Rect rect = new Rect();
        view.getGlobalVisibleRect(rect);

        // Get the activity's window position. This does an IPC call, may be expensive.
        Rect window = new Rect();
        view.getWindowVisibleDisplayFrame(window);

        // Calculate the coordinates for the cropped bitmap.
        int screenWidth = view.getContext().getResources().getDisplayMetrics().widthPixels;
        int left = mBitmap.getWidth() - screenWidth + rect.left;
        int right = mBitmap.getWidth() - screenWidth + rect.right;
        int top = rect.top - window.top;
        int bottom = rect.bottom - window.top;

        int offsetX = 0;
        int offsetY = 0;

        // Find if this view or any of its ancestors has been translated or scrolled.
        ViewParent parent;
        View curView = view;
        do {
            if (Build.VERSION.SDK_INT >= 11) {
                offsetX += (int) curView.getTranslationX() - curView.getScrollX();
                offsetY += (int) curView.getTranslationY() - curView.getScrollY();
            } else {
                offsetX -= curView.getScrollX();
                offsetY -= curView.getScrollY();
            }

            parent = curView.getParent();

            if (parent instanceof View)
                curView = (View) parent;

        } while(parent instanceof View && parent != null);

        // Adjust the coordinates for the offset.
        left -= offsetX;
        right -= offsetX;
        top -= offsetY;
        bottom -= offsetY;

        // The either the required height may be less than the available image height or more than it.
        // If the height required is more, crop only the available portion on the image.
        int width = right - left;
        int height = (bottom > mBitmap.getHeight() ? mBitmap.getHeight() - top : bottom - top);

        // There is a chance that the view is not visible or doesn't fall within the phone's size.
        // In this case, 'rect' will have all values as '0'. Hence 'top' and 'bottom' may be negative,
        // and createBitmap() will fail.
        // The view will get a background in its next layout pass.
        try {
            return Bitmap.createBitmap(mBitmap, left, top, width, height);
        } catch (Exception e) {
            return null;
        }
    }

    /**
     * Converts the cropped bitmap to a BitmapDrawable and returns the same.
     *
     * @param view The view for which a background drawable is required.
     * @return Either the cropped bitmap as a Drawable or null.
     */
    public Drawable getDrawable(View view) {
        Bitmap bitmap = getCroppedBitmap(view);
        if (bitmap == null)
            return null;

        BitmapDrawable drawable = new BitmapDrawable(view.getContext().getResources(), bitmap);
        drawable.setGravity(Gravity.TOP|Gravity.RIGHT);
        drawable.setTileModeXY(Shader.TileMode.CLAMP, Shader.TileMode.CLAMP);
        return drawable;
    }

    /**
     * Converts the cropped bitmap to a LightweightThemeDrawable, with the required texture.
     * The texture can either be an actual texture to be repeated or a bitmap-drawable that 
     * specifies how to repeat it.
     *
     * @param view The view for which a background drawable is required.
     * @param textureId The resource id of the texture.
     * @return Either the cropped bitmap as a Drawable or null.
     */
    public LightweightThemeDrawable getTextureDrawable(View view, int textureId) {
        return getTextureDrawable(view, textureId, false);
    }

    /**
     * Converts the cropped bitmap to a LightweightThemeDrawable, with the required texture.
     * The texture can either be an actual texture to be repeated or a bitmap-drawable that 
     * specifies how to repeat it. The dominant color can be drawn over the texture, if specified.
     *
     * @param view The view for which a background drawable is required.
     * @param textureId The resource id of the texture.
     * @param needsColor A layer of dominant color is needed or not.
     * @return Either the cropped bitmap as a Drawable or null.
     */
    public LightweightThemeDrawable getTextureDrawable(View view, int textureId, boolean needsColor) {
        Bitmap bitmap = getCroppedBitmap(view);
        if (bitmap == null)
            return null;

        LightweightThemeDrawable drawable = new LightweightThemeDrawable(view.getContext().getResources(), bitmap);
        drawable.setTexture(textureId);

        if (needsColor)
            drawable.setColor(mColor & 0x22FFFFFF);

        return drawable;
    }

    /**
     * Converts the cropped bitmap to a LightweightThemeDrawable, placing it over the dominant color.
     *
     * @param view The view for which a background drawable is required.
     * @return Either the cropped bitmap as a Drawable or null.
     */
     public LightweightThemeDrawable getColorDrawable(View view) {
         return getColorDrawable(view, mColor);
     }

    /**
     * Converts the cropped bitmap to a LightweightThemeDrawable, placing it over the required color.
     *
     * @param view The view for which a background drawable is required.
     * @return Either the cropped bitmap as a Drawable or null.
     */
    public LightweightThemeDrawable getColorDrawable(View view, int color) {
        Bitmap bitmap = getCroppedBitmap(view);
        if (bitmap == null)
            return null;

        LightweightThemeDrawable drawable = new LightweightThemeDrawable(view.getContext().getResources(), bitmap);
        drawable.setColor(color);
        return drawable;
    }
}