xiaomi/ResourceParser.java

/*
 * Copyright (c) 2010 - 2011, The MiCode Open Source Community (www.micode.net)
 *
 * 遵循 Apache 许可证 2.0 版（“许可证”）；
 * 除非遵守许可证，否则不得使用此文件。
 * 你可以在以下网址获取许可证副本：
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * 除非适用法律要求或书面同意，
 * 根据许可证分发的软件按“原样”分发，
 * 不附带任何明示或暗示的保证或条件。
 * 请参阅许可证，了解具体的权限和限制。
 */

package net.micode.notes.tool;

import android.content.Context;
import android.preference.PreferenceManager;

import net.micode.notes.R;
import net.micode.notes.ui.NotesPreferenceActivity;

// ResourceParser 类用于解析和提供应用中的各种资源相关信息，包括背景颜色、字体大小、不同视图的背景图片资源等
public class ResourceParser {

    // 定义了一些颜色常量，用于表示不同的颜色选项
    public static final int YELLOW = 0;
    public static final int BLUE = 1;
    public static final int WHITE = 2;
    public static final int GREEN = 3;
    public static final int RED = 4;

    // 默认的背景颜色
    public static final int BG_DEFAULT_COLOR = YELLOW;

    // 定义了一些字体大小常量，用于表示不同的字体大小选项
    public static final int TEXT_SMALL = 0;
    public static final int TEXT_MEDIUM = 1;
    public static final int TEXT_LARGE = 2;
    public static final int TEXT_SUPER = 3;

    // 默认的字体大小
    public static final int BG_DEFAULT_FONT_SIZE = TEXT_MEDIUM;

    // 内部类 NoteBgResources，用于管理笔记编辑界面的背景资源
    public static class NoteBgResources {
        // 编辑界面背景图片资源数组，对应不同的颜色选项
        private final static int[] BG_EDIT_RESOURCES = new int[]{
                R.drawable.edit_yellow,
                R.drawable.edit_blue,
                R.drawable.edit_white,
                R.drawable.edit_green,
                R.drawable.edit_red
        };

        // 编辑界面标题背景图片资源数组，对应不同的颜色选项
        private final static int[] BG_EDIT_TITLE_RESOURCES = new int[]{
                R.drawable.edit_title_yellow,
                R.drawable.edit_title_blue,
                R.drawable.edit_title_white,
                R.drawable.edit_title_green,
                R.drawable.edit_title_red
        };

        // 根据给定的 ID 获取笔记编辑界面的背景图片资源 ID
        public static int getNoteBgResource(int id) {
            return BG_EDIT_RESOURCES[id];
        }

        // 根据给定的 ID 获取笔记编辑界面标题的背景图片资源 ID
        public static int getNoteTitleBgResource(int id) {
            return BG_EDIT_TITLE_RESOURCES[id];
        }
    }

    // 根据上下文获取默认的背景颜色 ID，如果用户在设置中选择了随机背景颜色，则随机返回一个颜色 ID，否则返回默认颜色 ID
    public static int getDefaultBgId(Context context) {
        if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
                NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
            return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
        } else {
            return BG_DEFAULT_COLOR;
        }
    }

    // 内部类 NoteItemBgResources，用于管理笔记列表项的背景资源
    public static class NoteItemBgResources {
        // 笔记列表项第一个的背景图片资源数组，对应不同的颜色选项
        private final static int[] BG_FIRST_RESOURCES = new int[]{
                R.drawable.list_yellow_up,
                R.drawable.list_blue_up,
                R.drawable.list_white_up,
                R.drawable.list_green_up,
                R.drawable.list_red_up
        };

        // 笔记列表项中间的背景图片资源数组，对应不同的颜色选项
        private final static int[] BG_NORMAL_RESOURCES = new int[]{
                R.drawable.list_yellow_middle,
                R.drawable.list_blue_middle,
                R.drawable.list_white_middle,
                R.drawable.list_green_middle,
                R.drawable.list_red_middle
        };

        // 笔记列表项最后一个的背景图片资源数组，对应不同的颜色选项
        private final static int[] BG_LAST_RESOURCES = new int[]{
                R.drawable.list_yellow_down,
                R.drawable.list_blue_down,
                R.drawable.list_white_down,
                R.drawable.list_green_down,
                R.drawable.list_red_down,
        };

        // 单个笔记列表项的背景图片资源数组，对应不同的颜色选项
        private final static int[] BG_SINGLE_RESOURCES = new int[]{
                R.drawable.list_yellow_single,
                R.drawable.list_blue_single,
                R.drawable.list_white_single,
                R.drawable.list_green_single,
                R.drawable.list_red_single
        };

        // 根据给定的 ID 获取笔记列表项第一个的背景图片资源 ID
        public static int getNoteBgFirstRes(int id) {
            return BG_FIRST_RESOURCES[id];
        }

        // 根据给定的 ID 获取笔记列表项最后一个的背景图片资源 ID
        public static int getNoteBgLastRes(int id) {
            return BG_LAST_RESOURCES[id];
        }

        // 根据给定的 ID 获取单个笔记列表项的背景图片资源 ID
        public static int getNoteBgSingleRes(int id) {
            return BG_SINGLE_RESOURCES[id];
        }

        // 根据给定的 ID 获取笔记列表项中间的背景图片资源 ID
        public static int getNoteBgNormalRes(int id) {
            return BG_NORMAL_RESOURCES[id];
        }

        // 获取文件夹的背景图片资源 ID
        public static int getFolderBgRes() {
            return R.drawable.list_folder;
        }
    }

    // 内部类 WidgetBgResources，用于管理小部件的背景资源
    public static class WidgetBgResources {
        // 2x 小部件背景图片资源数组，对应不同的颜色选项
        private final static int[] BG_2X_RESOURCES = new int[]{
                R.drawable.widget_2x_yellow,
                R.drawable.widget_2x_blue,
                R.drawable.widget_2x_white,
                R.drawable.widget_2x_green,
                R.drawable.widget_2x_red,
        };

        // 根据给定的 ID 获取 2x 小部件的背景图片资源 ID
        public static int getWidget2xBgResource(int id) {
            return BG_2X_RESOURCES[id];
        }

        // 4x 小部件背景图片资源数组，对应不同的颜色选项
        private final static int[] BG_4X_RESOURCES = new int[]{
                R.drawable.widget_4x_yellow,
                R.drawable.widget_4x_blue,
                R.drawable.widget_4x_white,
                R.drawable.widget_4x_green,
                R.drawable.widget_4x_red
        };

        // 根据给定的 ID 获取 4x 小部件的背景图片资源 ID
        public static int getWidget4xBgResource(int id) {
            return BG_4X_RESOURCES[id];
        }
    }

    // 内部类 TextAppearanceResources，用于管理文本外观资源
    public static class TextAppearanceResources {
        // 文本外观资源数组，对应不同的字体大小选项
        private final static int[] TEXTAPPEARANCE_RESOURCES = new int[]{
                R.style.TextAppearanceNormal,
                R.style.TextAppearanceMedium,
                R.style.TextAppearanceLarge,
                R.style.TextAppearanceSuper
        };

        // 根据给定的 ID 获取文本外观资源 ID，如果 ID 超出资源数组长度，则返回默认字体大小对应的资源 ID
        public static int getTexAppearanceResource(int id) {
            /**
             * HACKME: Fix bug of store the resource id in shared preference.
             * The id may larger than the length of resources, in this case,
             * return the {@link ResourceParser#BG_DEFAULT_FONT_SIZE}
             */
            if (id >= TEXTAPPEARANCE_RESOURCES.length) {
                return BG_DEFAULT_FONT_SIZE;
            }
            return TEXTAPPEARANCE_RESOURCES[id];
        }

        // 获取文本外观资源数组的长度
        public static int getResourcesSize() {
            return TEXTAPPEARANCE_RESOURCES.length;
        }
    }
}