BitmapFactory.java revision 1b22b979256cf163ab9bbfd4fcfa16a8ce862ed1
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.graphics; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.res.AssetManager; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.res.Resources; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.DisplayMetrics; 22eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chenimport android.util.TypedValue; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.BufferedInputStream; 25eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chenimport java.io.FileDescriptor; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.FileInputStream; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.IOException; 28eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chenimport java.io.InputStream; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 31eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen * Creates Bitmap objects from various sources, including files, streams, 32eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen * and byte-arrays. 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class BitmapFactory { 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static class Options { 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create a default Options object, which if left unchanged will give 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the same result from the decoder as if null were passed. 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Options() { 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inDither = true; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inDensity = 0; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inScaled = true; 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If set to true, the decoder will return null (no bitmap), but 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the out... fields will still be set, allowing the caller to query 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap without having to allocate the memory for its pixels. 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean inJustDecodeBounds; 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If set to a value > 1, requests the decoder to subsample the original 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * image, returning a smaller image to save memory. The sample size is 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the number of pixels in either dimension that correspond to a single 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pixel in the decoded bitmap. For example, inSampleSize == 4 returns 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an image that is 1/4 the width/height of the original, and 1/16 the 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * number of pixels. Any value <= 1 is treated the same as 1. Note: the 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * decoder will try to fulfill this request, but the resulting bitmap 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * may have different dimensions that precisely what has been requested. 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Also, powers of 2 are often faster/easier for the decoder to honor. 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int inSampleSize; 65eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this is non-null, the decoder will try to decode into this 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * internal configuration. If it is null, or the request cannot be met, 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the decoder will try to pick the best matching config based on the 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * system's screen depth, and characteristics of the original image such 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as if it has per-pixel alpha (requiring a config that also does). 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap.Config inPreferredConfig; 74eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If dither is true, the decoder will atttempt to dither the decoded 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * image. 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean inDither; 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The desired pixel density of the bitmap. 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.util.DisplayMetrics#DEFAULT_DENSITY 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.util.DisplayMetrics#density 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide pending API council approval 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int inDensity; 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </p>If the bitmap is loaded from {@link android.content.res.Resources} and 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this flag is turned on, the bitmap will be scaled to match the default 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * display's pixel density.</p> 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </p>This flag is turned on by default and should be turned off if you need 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a non-scaled version of the bitmap. In this case, 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.graphics.Bitmap#setAutoScalingEnabled(boolean)} can be used 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to properly scale the bitmap at drawing time.</p> 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide pending API council approval 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean inScaled; 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 106c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * If this is set to true, then the resulting bitmap will allocate its 107c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * pixels such that they can be purged if the system needs to reclaim 108c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * memory. In that instance, when the pixels need to be accessed again 109c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * (e.g. the bitmap is drawn, getPixels() is called), they will be 110c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * automatically re-decoded. 111c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * 112c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * For the re-decode to happen, the bitmap must have access to the 113c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * encoded data, either by sharing a reference to the input 114c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * or by making a copy of it. This distinction is controlled by 115c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * inInputShareable. If this is true, then the bitmap may keep a shallow 116c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * reference to the input. If this is false, then the bitmap will 117c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * explicitly make a copy of the input data, and keep that. Even if 118c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * sharing is allowed, the implementation may still decide to make a 119c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * deep copy of the input data. 120c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed */ 121c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed public boolean inPurgeable; 122c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed 123c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed /** 124c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * This field works in conjuction with inPurgeable. If inPurgeable is 125c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * false, then this field is ignored. If inPurgeable is true, then this 126c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * field determines whether the bitmap can share a reference to the 127c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed * input data (inputstream, array, etc.) or if it must make a deep copy. 128c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed */ 129c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed public boolean inInputShareable; 130c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed 131c70e06bbfac0d92ec218a32e35d9d7fa80f23cc9Mike Reed /** 1321b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed * Normally bitmap allocations count against the dalvik heap, which 1331b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed * means they help trigger GCs when a lot have been allocated. However, 1341b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed * in rare cases, the caller may want to allocate the bitmap outside of 1351b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed * that heap. To request that, set inNativeAlloc to true. In these 1361b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed * rare instances, it is solely up to the caller to ensure that OOM is 1371b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed * managed explicitly by calling bitmap.recycle() as soon as such a 1381b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed * bitmap is no longer needed. 1391b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed * 1401b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed * @hide pending API council approval 1411b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed */ 1421b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed public boolean inNativeAlloc; 1431b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed 1441b22b979256cf163ab9bbfd4fcfa16a8ce862ed1Mike Reed /** 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The resulting width of the bitmap, set independent of the state of 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * inJustDecodeBounds. However, if there is an error trying to decode, 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * outWidth will be set to -1. 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int outWidth; 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The resulting height of the bitmap, set independent of the state of 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * inJustDecodeBounds. However, if there is an error trying to decode, 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * outHeight will be set to -1. 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int outHeight; 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If known, this string is set to the mimetype of the decoded image. 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If not know, or there is an error, it is set to null. 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String outMimeType; 163eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Temp storage to use for decoding. Suggest 16K or so. 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public byte[] inTempStorage; 168eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native void requestCancel(); 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag to indicate that cancel has been called on this object. This 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is useful if there's an intermediary that wants to first decode the 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bounds and then decode the image. In that case the intermediary 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can check, inbetween the bounds decode and the image decode, to see 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the operation is canceled. 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean mCancel; 179eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This can be called from another thread while this options object is 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * inside a decode... call. Calling this will notify the decoder that 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it should cancel its operation. This is not guaranteed to cancel 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the decode, but if it does, the decoder... operation will return 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null, or if inJustDecodeBounds is true, will set outWidth/outHeight 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to -1 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void requestCancelDecode() { 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCancel = true; 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requestCancel(); 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decode a file path into a bitmap. If the specified file name is null, 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or cannot be decoded into a bitmap, the function returns null. 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pathName complete path name for the file to be decoded. 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param opts null-ok; Options that control downsampling and whether the 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * image should be completely decoded, or just is size returned. 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The decoded bitmap, or null if the image data could not be 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * decoded, or, if opts is non-null, if opts requested only the 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * size be returned (in opts.outWidth and opts.outHeight) 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap decodeFile(String pathName, Options opts) { 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = null; 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project InputStream stream = null; 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stream = new FileInputStream(pathName); 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bm = decodeStream(stream, null, opts); 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (Exception e) { 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* do nothing. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project If the exception happened on open, bm will be null. 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } finally { 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (stream != null) { 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stream.close(); 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException e) { 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // do nothing here 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decode a file path into a bitmap. If the specified file name is null, 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or cannot be decoded into a bitmap, the function returns null. 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pathName complete path name for the file to be decoded. 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the resulting decoded bitmap, or null if it could not be decoded. 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap decodeFile(String pathName) { 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return decodeFile(pathName, null); 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decode a new Bitmap from an InputStream. This InputStream was obtained from 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * resources, which we pass to be able to scale the bitmap accordingly. 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap decodeStream(Resources res, TypedValue value, InputStream is, 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect pad, Options opts) { 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (opts == null) { 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project opts = new Options(); 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = decodeStream(is, pad, opts); 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bm != null && res != null && value != null) { 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] np = bm.getNinePatchChunk(); 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final boolean isNinePatch = np != null && NinePatch.isNinePatchChunk(np); 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int density = value.density; 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (opts.inDensity == 0) { 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project opts.inDensity = density == TypedValue.DENSITY_DEFAULT ? 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project DisplayMetrics.DEFAULT_DENSITY : density; 261eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen } 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float scale = opts.inDensity / (float) DisplayMetrics.DEFAULT_DENSITY; 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (opts.inScaled || isNinePatch) { 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bm.setDensityScale(1.0f); 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bm.setAutoScalingEnabled(false); 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Assume we are going to prescale for the screen 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scale = res.getDisplayMetrics().density / scale; 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (scale != 1.0f) { 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // TODO: This is very inefficient and should be done in native by Skia 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final Bitmap oldBitmap = bm; 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bm = Bitmap.createScaledBitmap(oldBitmap, (int) (bm.getWidth() * scale + 0.5f), 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (int) (bm.getHeight() * scale + 0.5f), true); 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project oldBitmap.recycle(); 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (isNinePatch) { 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project np = nativeScaleNinePatch(np, scale, pad); 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bm.setNinePatchChunk(np); 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bm.setDensityScale(scale); 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bm.setAutoScalingEnabled(true); 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decode an image referenced by a resource ID. 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param res The resources object containing the image data 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param id The resource id of the image data 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param opts null-ok; Options that control downsampling and whether the 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * image should be completely decoded, or just is size returned. 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The decoded bitmap, or null if the image data could not be 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * decoded, or, if opts is non-null, if opts requested only the 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * size be returned (in opts.outWidth and opts.outHeight) 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap decodeResource(Resources res, int id, Options opts) { 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = null; 303eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final TypedValue value = new TypedValue(); 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final InputStream is = res.openRawResource(id, value); 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bm = decodeStream(res, value, is, null, opts); 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project is.close(); 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (java.io.IOException e) { 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* do nothing. 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project If the exception happened on open, bm will be null. 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project If it happened on close, bm is still valid. 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 318eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decode an image referenced by a resource ID. 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param res The resources object containing the image data 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param id The resource id of the image data 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The decoded bitmap, or null if the image could not be decode. 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap decodeResource(Resources res, int id) { 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return decodeResource(res, id, null); 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decode an immutable bitmap from the specified byte array. 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param data byte array of compressed image data 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset offset into imageData for where the decoder should begin 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parsing. 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param length the number of bytes, beginning at offset, to parse 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param opts null-ok; Options that control downsampling and whether the 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * image should be completely decoded, or just is size returned. 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The decoded bitmap, or null if the image data could not be 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * decoded, or, if opts is non-null, if opts requested only the 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * size be returned (in opts.outWidth and opts.outHeight) 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap decodeByteArray(byte[] data, int offset, int length, Options opts) { 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((offset | length) < 0 || data.length < offset + length) { 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeDecodeByteArray(data, offset, length, opts); 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 349eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decode an immutable bitmap from the specified byte array. 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param data byte array of compressed image data 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset offset into imageData for where the decoder should begin 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parsing. 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param length the number of bytes, beginning at offset, to parse 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The decoded bitmap, or null if the image could not be decode. 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap decodeByteArray(byte[] data, int offset, int length) { 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return decodeByteArray(data, offset, length, null); 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 362eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decode an input stream into a bitmap. If the input stream is null, or 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * cannot be used to decode a bitmap, the function returns null. 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The stream's position will be where ever it was after the encoded data 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * was read. 368eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen * 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param is The input stream that holds the raw data to be decoded into a 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bitmap. 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param outPadding If not null, return the padding rect for the bitmap if 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it exists, otherwise set padding to [-1,-1,-1,-1]. If 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * no bitmap is returned (null) then padding is 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * unchanged. 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param opts null-ok; Options that control downsampling and whether the 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * image should be completely decoded, or just is size returned. 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The decoded bitmap, or null if the image data could not be 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * decoded, or, if opts is non-null, if opts requested only the 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * size be returned (in opts.outWidth and opts.outHeight) 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap decodeStream(InputStream is, Rect outPadding, Options opts) { 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we don't throw in this case, thus allowing the caller to only check 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the cache, and not force the image to be decoded. 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (is == null) { 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 387eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we need mark/reset to work properly 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!is.markSupported()) { 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project is = new BufferedInputStream(is, 16 * 1024); 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // so we can call reset() if a given codec gives up after reading up to 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // this many bytes. FIXME: need to find out from the codecs what this 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // value should be. 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project is.mark(1024); 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm; 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (is instanceof AssetManager.AssetInputStream) { 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bm = nativeDecodeAsset(((AssetManager.AssetInputStream) is).getAssetInt(), 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outPadding, opts); 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // pass some temp storage down to the native code. 1024 is made up, 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // but should be large enough to avoid too many small calls back 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // into is.read(...) This number is not related to the value passed 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // to mark(...) above. 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte [] tempStorage = null; 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (opts != null) 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project tempStorage = opts.inTempStorage; 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (tempStorage == null) 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project tempStorage = new byte[16 * 1024]; 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bm = nativeDecodeStream(is, tempStorage, outPadding, opts); 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decode an input stream into a bitmap. If the input stream is null, or 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * cannot be used to decode a bitmap, the function returns null. 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The stream's position will be where ever it was after the encoded data 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * was read. 425eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen * 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param is The input stream that holds the raw data to be decoded into a 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bitmap. 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The decoded bitmap, or null if the image data could not be 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * decoded, or, if opts is non-null, if opts requested only the 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * size be returned (in opts.outWidth and opts.outHeight) 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap decodeStream(InputStream is) { 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return decodeStream(is, null, null); 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decode a bitmap from the file descriptor. If the bitmap cannot be decoded 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return null. The position within the descriptor will not be changed when 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this returns, so the descriptor can be used again as is. 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param fd The file descriptor containing the bitmap data to decode 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param outPadding If not null, return the padding rect for the bitmap if 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it exists, otherwise set padding to [-1,-1,-1,-1]. If 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * no bitmap is returned (null) then padding is 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * unchanged. 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param opts null-ok; Options that control downsampling and whether the 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * image should be completely decoded, or just is size returned. 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the decoded bitmap, or null 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap decodeFileDescriptor(FileDescriptor fd, Rect outPadding, Options opts) { 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeDecodeFileDescriptor(fd, outPadding, opts); 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 453eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Decode a bitmap from the file descriptor. If the bitmap cannot be decoded 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return null. The position within the descriptor will not be changed when 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this returns, so the descriptor can be used again as is. 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param fd The file descriptor containing the bitmap data to decode 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the decoded bitmap, or null 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap decodeFileDescriptor(FileDescriptor fd) { 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeDecodeFileDescriptor(fd, null, null); 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 465eb949674fd3b83b706f795fc6b16ab1c66250c93Wei-Ta Chen 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeDecodeStream(InputStream is, byte[] storage, 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect padding, Options opts); 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeDecodeFileDescriptor(FileDescriptor fd, 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect padding, Options opts); 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeDecodeAsset(int asset, Rect padding, Options opts); 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeDecodeByteArray(byte[] data, int offset, 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length, Options opts); 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native byte[] nativeScaleNinePatch(byte[] chunk, float scale, Rect pad); 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 476