├── .gitignore
├── .travis.yml
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── build.gradle
├── docs
├── images
│ ├── demo.gif
│ └── google_play.png
├── issue_template.md
└── javadoc
│ ├── allclasses-frame.html
│ ├── allclasses-noframe.html
│ ├── com
│ └── davemorrissey
│ │ └── labs
│ │ └── subscaleview
│ │ ├── ImageSource.html
│ │ ├── ImageViewState.html
│ │ ├── SubsamplingScaleImageView.AnimationBuilder.html
│ │ ├── SubsamplingScaleImageView.DefaultOnAnimationEventListener.html
│ │ ├── SubsamplingScaleImageView.DefaultOnImageEventListener.html
│ │ ├── SubsamplingScaleImageView.DefaultOnStateChangedListener.html
│ │ ├── SubsamplingScaleImageView.OnAnimationEventListener.html
│ │ ├── SubsamplingScaleImageView.OnImageEventListener.html
│ │ ├── SubsamplingScaleImageView.OnStateChangedListener.html
│ │ ├── SubsamplingScaleImageView.html
│ │ ├── decoder
│ │ ├── CompatDecoderFactory.html
│ │ ├── DecoderFactory.html
│ │ ├── ImageDecoder.html
│ │ ├── ImageRegionDecoder.html
│ │ ├── SkiaImageDecoder.html
│ │ ├── SkiaImageRegionDecoder.html
│ │ ├── SkiaPooledImageRegionDecoder.html
│ │ ├── package-frame.html
│ │ ├── package-summary.html
│ │ └── package-tree.html
│ │ ├── package-frame.html
│ │ ├── package-summary.html
│ │ └── package-tree.html
│ ├── constant-values.html
│ ├── deprecated-list.html
│ ├── help-doc.html
│ ├── index-all.html
│ ├── index.html
│ ├── overview-frame.html
│ ├── overview-summary.html
│ ├── overview-tree.html
│ ├── package-list
│ ├── script.js
│ ├── serialized-form.html
│ └── stylesheet.css
├── gradle.properties
├── gradle
└── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── library
├── build.gradle
├── proguard-rules.txt
└── src
│ └── main
│ ├── AndroidManifest.xml
│ └── kotlin
│ └── com
│ └── davemorrissey
│ └── labs
│ └── subscaleview
│ ├── CompatDecoderFactory.kt
│ ├── DecoderFactory.kt
│ ├── GestureDetectorListener.java
│ ├── ImageDecoder.kt
│ ├── ImageRegionDecoder.kt
│ ├── SkiaImageDecoder.kt
│ ├── SkiaImageRegionDecoder.kt
│ ├── SkiaPooledImageRegionDecoder.kt
│ └── SubsamplingScaleImageView.kt
├── sample
├── assets
│ ├── card.png
│ ├── sanmartino.jpg
│ └── swissroad.jpg
├── build.gradle
└── src
│ └── main
│ ├── AndroidManifest.xml
│ ├── kotlin
│ └── com
│ │ └── davemorrissey
│ │ └── labs
│ │ └── subscaleview
│ │ └── test
│ │ └── BasicFeaturesActivity.kt
│ └── res
│ ├── drawable-nodpi
│ ├── button_standout_inactive.xml
│ ├── button_standout_pressed.xml
│ ├── button_transparent_pressed.xml
│ ├── buttonstate_standout.xml
│ ├── buttonstate_transparent.xml
│ ├── pushpin_blue.png
│ └── transparent.xml
│ ├── drawable-xhdpi
│ ├── next.png
│ ├── play.png
│ ├── previous.png
│ ├── reset.png
│ └── rotate.png
│ ├── layout
│ └── pages_activity.xml
│ ├── mipmap-hdpi
│ └── ic_launcher.png
│ ├── mipmap-mdpi
│ └── ic_launcher.png
│ ├── mipmap-xhdpi
│ └── ic_launcher.png
│ ├── mipmap-xxhdpi
│ └── ic_launcher.png
│ ├── mipmap-xxxhdpi
│ └── ic_launcher.png
│ └── values
│ ├── colors.xml
│ ├── strings.xml
│ └── style.xml
└── settings.gradle
/.gitignore:
--------------------------------------------------------------------------------
1 | # Gradle files
2 | .gradle/
3 | build/
4 |
5 | # Local configuration file (sdk path, etc)
6 | local.properties
7 |
8 | # Android Studio generated folders
9 | .navigation/
10 | captures/
11 | .externalNativeBuild
12 |
13 | # IntelliJ project files
14 | *.iml
15 | .idea/
16 |
17 | # Misc
18 | .DS_Store
19 |
--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
1 | language: android
2 |
3 | before_cache:
4 | - rm -f $HOME/.gradle/caches/modules-2/modules-2.lock
5 | - rm -fr $HOME/.gradle/caches/*/plugin-resolution/
6 |
7 | before_install:
8 | - yes | sdkmanager "platforms;android-27"
9 |
10 | cache:
11 | directories:
12 | - $HOME/.gradle/caches/
13 | - $HOME/.gradle/wrapper/
14 | - $HOME/.android/build-cache
15 |
16 | android:
17 | components:
18 | - tools
19 | - build-tools-26.0.2
20 | - android-27
21 | - platform-tools
22 | licenses:
23 | - 'android-sdk-license-.+'
24 |
25 | script:
26 | ./gradlew build
27 |
--------------------------------------------------------------------------------
/CONTRIBUTING.md:
--------------------------------------------------------------------------------
1 | Before raising a new issue, please check the following places for an answer to your question!
2 |
3 | * Read through [the wiki](https://github.com/davemorrissey/subsampling-scale-image-view/wiki) for a comprehensive guide to using the view.
4 | * Search through [open and closed issues](https://github.com/davemorrissey/subsampling-scale-image-view/issues?utf8=%E2%9C%93&q=is%3Aissue)
5 | * Check examples in [the sample project](https://github.com/davemorrissey/subsampling-scale-image-view/tree/master/sample/src/com/davemorrissey/labs/subscaleview/sample) - most common uses are covered.
6 | * See if there's an answer to your question on [StackOverflow](http://stackoverflow.com/).
7 |
8 | If you get stuck adding the view in your project or need help extending it for your requirements, please consider asking for help on StackOverflow instead of raising an issue. This issue tracker is intended for reporting bugs and raising feature requests.
9 |
10 | Thanks for reading!
11 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | Apache License
2 | Version 2.0, January 2004
3 | http://www.apache.org/licenses/
4 |
5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6 |
7 | 1. Definitions.
8 |
9 | "License" shall mean the terms and conditions for use, reproduction, and
10 | distribution as defined by Sections 1 through 9 of this document.
11 |
12 | "Licensor" shall mean the copyright owner or entity authorized by the copyright
13 | owner that is granting the License.
14 |
15 | "Legal Entity" shall mean the union of the acting entity and all other entities
16 | that control, are controlled by, or are under common control with that entity.
17 | For the purposes of this definition, "control" means (i) the power, direct or
18 | indirect, to cause the direction or management of such entity, whether by
19 | contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
20 | outstanding shares, or (iii) beneficial ownership of such entity.
21 |
22 | "You" (or "Your") shall mean an individual or Legal Entity exercising
23 | permissions granted by this License.
24 |
25 | "Source" form shall mean the preferred form for making modifications, including
26 | but not limited to software source code, documentation source, and configuration
27 | files.
28 |
29 | "Object" form shall mean any form resulting from mechanical transformation or
30 | translation of a Source form, including but not limited to compiled object code,
31 | generated documentation, and conversions to other media types.
32 |
33 | "Work" shall mean the work of authorship, whether in Source or Object form, made
34 | available under the License, as indicated by a copyright notice that is included
35 | in or attached to the work (an example is provided in the Appendix below).
36 |
37 | "Derivative Works" shall mean any work, whether in Source or Object form, that
38 | is based on (or derived from) the Work and for which the editorial revisions,
39 | annotations, elaborations, or other modifications represent, as a whole, an
40 | original work of authorship. For the purposes of this License, Derivative Works
41 | shall not include works that remain separable from, or merely link (or bind by
42 | name) to the interfaces of, the Work and Derivative Works thereof.
43 |
44 | "Contribution" shall mean any work of authorship, including the original version
45 | of the Work and any modifications or additions to that Work or Derivative Works
46 | thereof, that is intentionally submitted to Licensor for inclusion in the Work
47 | by the copyright owner or by an individual or Legal Entity authorized to submit
48 | on behalf of the copyright owner. For the purposes of this definition,
49 | "submitted" means any form of electronic, verbal, or written communication sent
50 | to the Licensor or its representatives, including but not limited to
51 | communication on electronic mailing lists, source code control systems, and
52 | issue tracking systems that are managed by, or on behalf of, the Licensor for
53 | the purpose of discussing and improving the Work, but excluding communication
54 | that is conspicuously marked or otherwise designated in writing by the copyright
55 | owner as "Not a Contribution."
56 |
57 | "Contributor" shall mean Licensor and any individual or Legal Entity on behalf
58 | of whom a Contribution has been received by Licensor and subsequently
59 | incorporated within the Work.
60 |
61 | 2. Grant of Copyright License.
62 |
63 | Subject to the terms and conditions of this License, each Contributor hereby
64 | grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
65 | irrevocable copyright license to reproduce, prepare Derivative Works of,
66 | publicly display, publicly perform, sublicense, and distribute the Work and such
67 | Derivative Works in Source or Object form.
68 |
69 | 3. Grant of Patent License.
70 |
71 | Subject to the terms and conditions of this License, each Contributor hereby
72 | grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
73 | irrevocable (except as stated in this section) patent license to make, have
74 | made, use, offer to sell, sell, import, and otherwise transfer the Work, where
75 | such license applies only to those patent claims licensable by such Contributor
76 | that are necessarily infringed by their Contribution(s) alone or by combination
77 | of their Contribution(s) with the Work to which such Contribution(s) was
78 | submitted. If You institute patent litigation against any entity (including a
79 | cross-claim or counterclaim in a lawsuit) alleging that the Work or a
80 | Contribution incorporated within the Work constitutes direct or contributory
81 | patent infringement, then any patent licenses granted to You under this License
82 | for that Work shall terminate as of the date such litigation is filed.
83 |
84 | 4. Redistribution.
85 |
86 | You may reproduce and distribute copies of the Work or Derivative Works thereof
87 | in any medium, with or without modifications, and in Source or Object form,
88 | provided that You meet the following conditions:
89 |
90 | You must give any other recipients of the Work or Derivative Works a copy of
91 | this License; and
92 | You must cause any modified files to carry prominent notices stating that You
93 | changed the files; and
94 | You must retain, in the Source form of any Derivative Works that You distribute,
95 | all copyright, patent, trademark, and attribution notices from the Source form
96 | of the Work, excluding those notices that do not pertain to any part of the
97 | Derivative Works; and
98 | If the Work includes a "NOTICE" text file as part of its distribution, then any
99 | Derivative Works that You distribute must include a readable copy of the
100 | attribution notices contained within such NOTICE file, excluding those notices
101 | that do not pertain to any part of the Derivative Works, in at least one of the
102 | following places: within a NOTICE text file distributed as part of the
103 | Derivative Works; within the Source form or documentation, if provided along
104 | with the Derivative Works; or, within a display generated by the Derivative
105 | Works, if and wherever such third-party notices normally appear. The contents of
106 | the NOTICE file are for informational purposes only and do not modify the
107 | License. You may add Your own attribution notices within Derivative Works that
108 | You distribute, alongside or as an addendum to the NOTICE text from the Work,
109 | provided that such additional attribution notices cannot be construed as
110 | modifying the License.
111 | You may add Your own copyright statement to Your modifications and may provide
112 | additional or different license terms and conditions for use, reproduction, or
113 | distribution of Your modifications, or for any such Derivative Works as a whole,
114 | provided Your use, reproduction, and distribution of the Work otherwise complies
115 | with the conditions stated in this License.
116 |
117 | 5. Submission of Contributions.
118 |
119 | Unless You explicitly state otherwise, any Contribution intentionally submitted
120 | for inclusion in the Work by You to the Licensor shall be under the terms and
121 | conditions of this License, without any additional terms or conditions.
122 | Notwithstanding the above, nothing herein shall supersede or modify the terms of
123 | any separate license agreement you may have executed with Licensor regarding
124 | such Contributions.
125 |
126 | 6. Trademarks.
127 |
128 | This License does not grant permission to use the trade names, trademarks,
129 | service marks, or product names of the Licensor, except as required for
130 | reasonable and customary use in describing the origin of the Work and
131 | reproducing the content of the NOTICE file.
132 |
133 | 7. Disclaimer of Warranty.
134 |
135 | Unless required by applicable law or agreed to in writing, Licensor provides the
136 | Work (and each Contributor provides its Contributions) on an "AS IS" BASIS,
137 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied,
138 | including, without limitation, any warranties or conditions of TITLE,
139 | NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are
140 | solely responsible for determining the appropriateness of using or
141 | redistributing the Work and assume any risks associated with Your exercise of
142 | permissions under this License.
143 |
144 | 8. Limitation of Liability.
145 |
146 | In no event and under no legal theory, whether in tort (including negligence),
147 | contract, or otherwise, unless required by applicable law (such as deliberate
148 | and grossly negligent acts) or agreed to in writing, shall any Contributor be
149 | liable to You for damages, including any direct, indirect, special, incidental,
150 | or consequential damages of any character arising as a result of this License or
151 | out of the use or inability to use the Work (including but not limited to
152 | damages for loss of goodwill, work stoppage, computer failure or malfunction, or
153 | any and all other commercial damages or losses), even if such Contributor has
154 | been advised of the possibility of such damages.
155 |
156 | 9. Accepting Warranty or Additional Liability.
157 |
158 | While redistributing the Work or Derivative Works thereof, You may choose to
159 | offer, and charge a fee for, acceptance of support, warranty, indemnity, or
160 | other liability obligations and/or rights consistent with this License. However,
161 | in accepting such obligations, You may act only on Your own behalf and on Your
162 | sole responsibility, not on behalf of any other Contributor, and only if You
163 | agree to indemnify, defend, and hold each Contributor harmless for any liability
164 | incurred by, or claims asserted against, such Contributor by reason of your
165 | accepting any such warranty or additional liability.
166 |
167 | END OF TERMS AND CONDITIONS
168 |
169 | APPENDIX: How to apply the Apache License to your work
170 |
171 | To apply the Apache License to your work, attach the following boilerplate
172 | notice, with the fields enclosed by brackets "[]" replaced with your own
173 | identifying information. (Don't include the brackets!) The text should be
174 | enclosed in the appropriate comment syntax for the file format. We also
175 | recommend that a file or class name and description of purpose be included on
176 | the same "printed page" as the copyright notice for easier identification within
177 | third-party archives.
178 |
179 | Copyright [yyyy] [name of copyright owner]
180 |
181 | Licensed under the Apache License, Version 2.0 (the "License");
182 | you may not use this file except in compliance with the License.
183 | You may obtain a copy of the License at
184 |
185 | http://www.apache.org/licenses/LICENSE-2.0
186 |
187 | Unless required by applicable law or agreed to in writing, software
188 | distributed under the License is distributed on an "AS IS" BASIS,
189 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
190 | See the License for the specific language governing permissions and
191 | limitations under the License.
192 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | Subsampling Scale Image View
2 | ===========================
3 |
4 | [](https://travis-ci.org/davemorrissey/subsampling-scale-image-view)
5 |
6 | A custom image view for Android, designed for photo galleries and displaying huge images (e.g. maps and building plans) without `OutOfMemoryError`s. Includes pinch to zoom, panning, rotation and animation support, and allows easy extension so you can add your own overlays and touch event detection.
7 |
8 | The view optionally uses subsampling and tiles to support very large images - a low resolution base layer is loaded and as you zoom in, it is overlaid with smaller high resolution tiles for the visible area. This avoids holding too much data in memory. It's ideal for displaying large images while allowing you to zoom in to the high resolution details. You can disable tiling for smaller images and when displaying a bitmap object. There are some advantages and disadvantages to disabling tiling so to decide which is best, see [the wiki](https://github.com/davemorrissey/subsampling-scale-image-view/wiki/02.-Displaying-images).
9 |
10 | #### Guides
11 |
12 | * [Releases & downloads](https://github.com/davemorrissey/subsampling-scale-image-view/releases)
13 | * [Installation and setup](https://github.com/davemorrissey/subsampling-scale-image-view/wiki/01.-Setup)
14 | * [Image display notes & limitations](https://github.com/davemorrissey/subsampling-scale-image-view/wiki/02.-Displaying-images)
15 | * [Using preview images](https://github.com/davemorrissey/subsampling-scale-image-view/wiki/03.-Preview-images)
16 | * [Handling orientation changes](https://github.com/davemorrissey/subsampling-scale-image-view/wiki/05.-Orientation-changes)
17 | * [Advanced configuration](https://github.com/davemorrissey/subsampling-scale-image-view/wiki/07.-Configuration)
18 | * [Event handling](https://github.com/davemorrissey/subsampling-scale-image-view/wiki/09.-Events)
19 | * [Animation](https://github.com/davemorrissey/subsampling-scale-image-view/wiki/08.-Animation)
20 | * [Extension](https://github.com/davemorrissey/subsampling-scale-image-view/wiki/10.-Extension)
21 | * [Reference (JavaDocs)](http://davemorrissey.github.io/subsampling-scale-image-view/javadoc/)
22 |
23 | #### Migration guides
24 |
25 | Versions 3.9.0, 3.8.0 and 3.0.0 contain breaking changes. Migration instructions can be found [in the wiki](https://github.com/davemorrissey/subsampling-scale-image-view/wiki/X.--Migration-guides).
26 |
27 | #### Download the sample app
28 |
29 | [](https://play.google.com/store/apps/details?id=com.davemorrissey.labs.subscaleview.sample)
30 |
31 | [Kotlin Sample App on GitHub](https://github.com/davemorrissey/ssiv-kotlin-sample)
32 |
33 | #### Demo
34 |
35 | 
36 |
37 | ## Features
38 |
39 | #### Image display
40 |
41 | * Display images from assets, resources, the file system or bitmaps
42 | * Automatically rotate images from the file system (e.g. the camera or gallery) according to EXIF
43 | * Manually rotate images in 90° increments
44 | * Display a region of the source image
45 | * Use a preview image while large images load
46 | * Swap images at runtime
47 | * Use a custom bitmap decoder
48 |
49 | *With tiling enabled:*
50 |
51 | * Display huge images, larger than can be loaded into memory
52 | * Show high resolution detail on zooming in
53 | * Tested up to 20,000x20,000px, though larger images are slower
54 |
55 | #### Gesture detection
56 |
57 | * One finger pan
58 | * Two finger pinch to zoom
59 | * Quick scale (one finger zoom)
60 | * Pan while zooming
61 | * Seamless switch between pan and zoom
62 | * Fling momentum after panning
63 | * Double tap to zoom in and out
64 | * Options to disable pan and/or zoom gestures
65 |
66 | #### Animation
67 |
68 | * Public methods for animating the scale and center
69 | * Customisable duration and easing
70 | * Optional uninterruptible animations
71 |
72 | #### Overridable event detection
73 | * Supports `OnClickListener` and `OnLongClickListener`
74 | * Supports interception of events using `GestureDetector` and `OnTouchListener`
75 | * Extend to add your own gestures
76 |
77 | #### Easy integration
78 | * Use within a `ViewPager` to create a photo gallery
79 | * Easily restore scale, center and orientation after screen rotation
80 | * Can be extended to add overlay graphics that move and scale with the image
81 | * Handles view resizing and `wrap_content` layout
82 |
83 | ## Quick start
84 |
85 | **1)** Add this library as a dependency in your app's build.gradle file.
86 |
87 | dependencies {
88 | implementation 'com.davemorrissey.labs:subsampling-scale-image-view:3.10.0'
89 | }
90 |
91 | **2)** Add the view to your layout XML.
92 |
93 |
96 |
97 |
101 |
102 |
103 |
104 | **3a)** Now, in your fragment or activity, set the image resource, asset name or file path.
105 |
106 | SubsamplingScaleImageView imageView = (SubsamplingScaleImageView)findViewById(id.imageView);
107 | imageView.setImage(ImageSource.resource(R.drawable.monkey));
108 | // ... or ...
109 | imageView.setImage(ImageSource.asset("map.png"))
110 | // ... or ...
111 | imageView.setImage(ImageSource.uri("/sdcard/DCIM/DSCM00123.JPG"));
112 |
113 | **3b)** Or, if you have a `Bitmap` object in memory, load it into the view. This is unsuitable for large images because it bypasses subsampling - you may get an `OutOfMemoryError`.
114 |
115 | SubsamplingScaleImageView imageView = (SubsamplingScaleImageView)findViewById(id.imageView);
116 | imageView.setImage(ImageSource.bitmap(bitmap));
117 |
118 | ## Photo credits
119 |
120 | * San Martino by Luca Bravo, via [unsplash.com](https://unsplash.com/photos/lWAOc0UuJ-A)
121 | * Swiss Road by Ludovic Fremondiere, via [unsplash.com](https://unsplash.com/photos/3XN-BNRDUyY)
122 |
123 | ## About
124 |
125 | Copyright 2018 David Morrissey, and licensed under the Apache License, Version 2.0. No attribution is necessary but it's very much appreciated. Star this project if you like it!
126 |
--------------------------------------------------------------------------------
/build.gradle:
--------------------------------------------------------------------------------
1 | // Top-level build file where you can add configuration options common to all sub-projects/modules.
2 |
3 | buildscript {
4 | ext.kotlin_version = '1.7.10'
5 |
6 | repositories {
7 | google()
8 | jcenter()
9 | }
10 | dependencies {
11 | classpath 'com.android.tools.build:gradle:7.3.1'
12 | classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
13 | }
14 | }
15 |
16 | allprojects {
17 | repositories {
18 | google()
19 | jcenter()
20 | }
21 | }
22 |
--------------------------------------------------------------------------------
/docs/images/demo.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/FossifyOrg/subsampling-scale-image-view/fc9559cae264a1928a9fa39116e019e29126da1a/docs/images/demo.gif
--------------------------------------------------------------------------------
/docs/images/google_play.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/FossifyOrg/subsampling-scale-image-view/fc9559cae264a1928a9fa39116e019e29126da1a/docs/images/google_play.png
--------------------------------------------------------------------------------
/docs/issue_template.md:
--------------------------------------------------------------------------------
1 | *Please provide as much of the following information as possible. Please do not raise issues to ask for help developing your app.*
2 |
3 | ### Expected behaviour
4 |
5 | ### Actual behaviour
6 |
7 | ### Steps to reproduce
8 |
9 | (Include your setup code, and where relevant, your layout XML)
10 |
11 | ### Affected devices
12 |
13 | (Specific devices, screen densities, SDK versions)
14 |
15 | ### Affected images
16 |
17 | (Attach images you have problems with)
18 |
--------------------------------------------------------------------------------
/docs/javadoc/allclasses-frame.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
public static interface SubsamplingScaleImageView.OnAnimationEventListener
111 |
An event listener for animations, allows events to be triggered when an animation completes,
112 | is aborted by another animation starting, or is aborted by a touch event. Note that none of
113 | these events are triggered if the activity is paused, the image is swapped, or in other cases
114 | where the view's internal state gets wiped or draw events stop.
public static interface SubsamplingScaleImageView.OnStateChangedListener
111 |
An event listener, allowing activities to be notified of pan and zoom events. Initialisation
112 | and calls made by your code do not trigger events; touch events and animations do. Methods in
113 | this listener will be called on the UI thread and may be called very frequently - your
114 | implementation should return quickly.
Decode an image. The URI can be in one of the following formats:
161 |
162 | File: file:///scard/picture.jpg
163 |
164 | Asset: file:///android_asset/picture.png
165 |
166 | Resource: android.resource://com.example.app/drawable/picture
An event listener for animations, allows events to be triggered when an animation completes,
87 | is aborted by another animation starting, or is aborted by a touch event.
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.
73 |
74 |
75 |
76 |
77 |
Overview
78 |
The Overview page is the front page of this API document and provides a list of all packages with a summary for each. This page can also contain an overall description of the set of packages.
79 |
80 |
81 |
Package
82 |
Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain six categories:
83 |
84 |
Interfaces (italic)
85 |
Classes
86 |
Enums
87 |
Exceptions
88 |
Errors
89 |
Annotation Types
90 |
91 |
92 |
93 |
Class/Interface
94 |
Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:
95 |
96 |
Class inheritance diagram
97 |
Direct Subclasses
98 |
All Known Subinterfaces
99 |
All Known Implementing Classes
100 |
Class/interface declaration
101 |
Class/interface description
102 |
103 |
104 |
Nested Class Summary
105 |
Field Summary
106 |
Constructor Summary
107 |
Method Summary
108 |
109 |
110 |
Field Detail
111 |
Constructor Detail
112 |
Method Detail
113 |
114 |
Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.
115 |
116 |
117 |
Annotation Type
118 |
Each annotation type has its own separate page with the following sections:
119 |
120 |
Annotation Type declaration
121 |
Annotation Type description
122 |
Required Element Summary
123 |
Optional Element Summary
124 |
Element Detail
125 |
126 |
127 |
128 |
Enum
129 |
Each enum has its own separate page with the following sections:
130 |
131 |
Enum declaration
132 |
Enum description
133 |
Enum Constant Summary
134 |
Enum Constant Detail
135 |
136 |
137 |
138 |
Tree (Class Hierarchy)
139 |
There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.Object. The interfaces do not inherit from java.lang.Object.
140 |
141 |
When viewing the Overview page, clicking on "Tree" displays the hierarchy for all packages.
142 |
When viewing a particular package, class or interface page, clicking "Tree" displays the hierarchy for only that package.
143 |
144 |
145 |
146 |
Deprecated API
147 |
The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.
148 |
149 |
150 |
Index
151 |
The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.
152 |
153 |
154 |
Prev/Next
155 |
These links take you to the next or previous class, interface, package, or related page.
156 |
157 |
158 |
Frames/No Frames
159 |
These links show and hide the HTML frames. All pages are available with or without frames.
160 |
161 |
162 |
All Classes
163 |
The All Classes link shows all classes and interfaces except non-static nested types.
164 |
165 |
166 |
Serialized Form
167 |
Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking "Serialized Form" in the "See also" section of the class description.