147cb510ea11c8886434575118068fc91eaa25facMark Wei/* 247cb510ea11c8886434575118068fc91eaa25facMark Wei * Copyright (C) 2013 The Android Open Source Project 347cb510ea11c8886434575118068fc91eaa25facMark Wei * 447cb510ea11c8886434575118068fc91eaa25facMark Wei * Licensed under the Apache License, Version 2.0 (the "License"); 547cb510ea11c8886434575118068fc91eaa25facMark Wei * you may not use this file except in compliance with the License. 647cb510ea11c8886434575118068fc91eaa25facMark Wei * You may obtain a copy of the License at 747cb510ea11c8886434575118068fc91eaa25facMark Wei * 847cb510ea11c8886434575118068fc91eaa25facMark Wei * http://www.apache.org/licenses/LICENSE-2.0 947cb510ea11c8886434575118068fc91eaa25facMark Wei * 1047cb510ea11c8886434575118068fc91eaa25facMark Wei * Unless required by applicable law or agreed to in writing, software 1147cb510ea11c8886434575118068fc91eaa25facMark Wei * distributed under the License is distributed on an "AS IS" BASIS, 1247cb510ea11c8886434575118068fc91eaa25facMark Wei * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1347cb510ea11c8886434575118068fc91eaa25facMark Wei * See the License for the specific language governing permissions and 1447cb510ea11c8886434575118068fc91eaa25facMark Wei * limitations under the License. 1547cb510ea11c8886434575118068fc91eaa25facMark Wei */ 1647cb510ea11c8886434575118068fc91eaa25facMark Wei 1747cb510ea11c8886434575118068fc91eaa25facMark Weipackage com.android.mail.ui; 1847cb510ea11c8886434575118068fc91eaa25facMark Wei 1947cb510ea11c8886434575118068fc91eaa25facMark Weiimport android.graphics.Bitmap; 2047cb510ea11c8886434575118068fc91eaa25facMark Wei 2147cb510ea11c8886434575118068fc91eaa25facMark Wei/** 2247cb510ea11c8886434575118068fc91eaa25facMark Wei * A canvas to draw loaded photos. 2347cb510ea11c8886434575118068fc91eaa25facMark Wei */ 2447cb510ea11c8886434575118068fc91eaa25facMark Weipublic interface ImageCanvas { 2547cb510ea11c8886434575118068fc91eaa25facMark Wei 2647cb510ea11c8886434575118068fc91eaa25facMark Wei /** 278b7fab5413a3359b41a603b0567c3e375135676fAndy Huang * Dimensions holds the desired width, height, and scale for a bitmap being 288b7fab5413a3359b41a603b0567c3e375135676fAndy Huang * placed in the ImageCanvas. 298b7fab5413a3359b41a603b0567c3e375135676fAndy Huang */ 308b7fab5413a3359b41a603b0567c3e375135676fAndy Huang public static class Dimensions { 318b7fab5413a3359b41a603b0567c3e375135676fAndy Huang public int width; 328b7fab5413a3359b41a603b0567c3e375135676fAndy Huang public int height; 338b7fab5413a3359b41a603b0567c3e375135676fAndy Huang public float scale; 34d267498a916882165afb88e7e42cd898d5e748d0Régis Décamps public float fontSize; 358b7fab5413a3359b41a603b0567c3e375135676fAndy Huang 368b7fab5413a3359b41a603b0567c3e375135676fAndy Huang public static final float SCALE_ONE = 1.0f; 378b7fab5413a3359b41a603b0567c3e375135676fAndy Huang public static final float SCALE_HALF = 0.5f; 388b7fab5413a3359b41a603b0567c3e375135676fAndy Huang public static final float SCALE_QUARTER = 0.25f; 398b7fab5413a3359b41a603b0567c3e375135676fAndy Huang 408b7fab5413a3359b41a603b0567c3e375135676fAndy Huang public Dimensions() { 418b7fab5413a3359b41a603b0567c3e375135676fAndy Huang } 428b7fab5413a3359b41a603b0567c3e375135676fAndy Huang 438b7fab5413a3359b41a603b0567c3e375135676fAndy Huang public Dimensions(int w, int h, float s) { 44d267498a916882165afb88e7e42cd898d5e748d0Régis Décamps this(w, h, s, -1f); 45d267498a916882165afb88e7e42cd898d5e748d0Régis Décamps } 46d267498a916882165afb88e7e42cd898d5e748d0Régis Décamps 47d267498a916882165afb88e7e42cd898d5e748d0Régis Décamps public Dimensions(int width, int height, float scale, float fontSize) { 48d267498a916882165afb88e7e42cd898d5e748d0Régis Décamps this.width = width; 49d267498a916882165afb88e7e42cd898d5e748d0Régis Décamps this.height = height; 50d267498a916882165afb88e7e42cd898d5e748d0Régis Décamps this.scale = scale; 51d267498a916882165afb88e7e42cd898d5e748d0Régis Décamps this.fontSize = fontSize; 528b7fab5413a3359b41a603b0567c3e375135676fAndy Huang } 538b7fab5413a3359b41a603b0567c3e375135676fAndy Huang 54479505d71969e26b0785d8e0e1b81108731cf827Mark Wei @Override 55479505d71969e26b0785d8e0e1b81108731cf827Mark Wei public String toString() { 56479505d71969e26b0785d8e0e1b81108731cf827Mark Wei return String.format("Dimens [%d x %d]", width, height); 57479505d71969e26b0785d8e0e1b81108731cf827Mark Wei } 58479505d71969e26b0785d8e0e1b81108731cf827Mark Wei } 598b7fab5413a3359b41a603b0567c3e375135676fAndy Huang 608b7fab5413a3359b41a603b0567c3e375135676fAndy Huang /** 618b7fab5413a3359b41a603b0567c3e375135676fAndy Huang * Draw/composite the given Bitmap corresponding with the key 'id'. It will be sized according 628b7fab5413a3359b41a603b0567c3e375135676fAndy Huang * to whatever {@link #getDesiredDimensions(Object, Dimensions)} reported when the 638b7fab5413a3359b41a603b0567c3e375135676fAndy Huang * decode request was made. 648b7fab5413a3359b41a603b0567c3e375135676fAndy Huang * 658b7fab5413a3359b41a603b0567c3e375135676fAndy Huang * @param decoded an exactly-sized, decoded bitmap to display 66479505d71969e26b0785d8e0e1b81108731cf827Mark Wei * @param key 678b7fab5413a3359b41a603b0567c3e375135676fAndy Huang */ 68479505d71969e26b0785d8e0e1b81108731cf827Mark Wei void drawImage(Bitmap decoded, Object key); 6947cb510ea11c8886434575118068fc91eaa25facMark Wei 7047cb510ea11c8886434575118068fc91eaa25facMark Wei /** 7147cb510ea11c8886434575118068fc91eaa25facMark Wei * Reset all state associated with this view so that it can be reused. 7247cb510ea11c8886434575118068fc91eaa25facMark Wei */ 738b7fab5413a3359b41a603b0567c3e375135676fAndy Huang void reset(); 748b7fab5413a3359b41a603b0567c3e375135676fAndy Huang 758b7fab5413a3359b41a603b0567c3e375135676fAndy Huang /** 768b7fab5413a3359b41a603b0567c3e375135676fAndy Huang * Outputs the desired dimensions that the object with key 'id' would like to be drawn to. 778b7fab5413a3359b41a603b0567c3e375135676fAndy Huang * 78479505d71969e26b0785d8e0e1b81108731cf827Mark Wei * @param key 798b7fab5413a3359b41a603b0567c3e375135676fAndy Huang * @param outDim caller-allocated {@link Dimensions} object to house the result 808b7fab5413a3359b41a603b0567c3e375135676fAndy Huang */ 81479505d71969e26b0785d8e0e1b81108731cf827Mark Wei void getDesiredDimensions(Object key, Dimensions outDim); 828b7fab5413a3359b41a603b0567c3e375135676fAndy Huang 838b7fab5413a3359b41a603b0567c3e375135676fAndy Huang /** 84b53fe05fb867685d0d3f2f37daf0f93bc6488dedAndy Huang * Return an arbitrary integer to associate with any asynchronous requests for images that 85b53fe05fb867685d0d3f2f37daf0f93bc6488dedAndy Huang * currently belong to this canvas. If, later on when results are available, the generation 86b53fe05fb867685d0d3f2f37daf0f93bc6488dedAndy Huang * that is then reported does not match, the photo manager will assume the image is no longer 87b53fe05fb867685d0d3f2f37daf0f93bc6488dedAndy Huang * desired and will not offer the image. 88b53fe05fb867685d0d3f2f37daf0f93bc6488dedAndy Huang * <p> 89b53fe05fb867685d0d3f2f37daf0f93bc6488dedAndy Huang * Implementors should basically treat this as a counter to increment upon reset() or 90b53fe05fb867685d0d3f2f37daf0f93bc6488dedAndy Huang * data binding. 918b7fab5413a3359b41a603b0567c3e375135676fAndy Huang */ 92b53fe05fb867685d0d3f2f37daf0f93bc6488dedAndy Huang int getGeneration(); 9347cb510ea11c8886434575118068fc91eaa25facMark Wei} 94