aboutsummaryrefslogtreecommitdiff
path: root/input/multitouch/BasicMultitouch/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'input/multitouch/BasicMultitouch/README.md')
-rw-r--r--input/multitouch/BasicMultitouch/README.md40
1 files changed, 32 insertions, 8 deletions
diff --git a/input/multitouch/BasicMultitouch/README.md b/input/multitouch/BasicMultitouch/README.md
index 0b0be8f0..27889e9b 100644
--- a/input/multitouch/BasicMultitouch/README.md
+++ b/input/multitouch/BasicMultitouch/README.md
@@ -1,19 +1,43 @@
+
Android BasicMultitouch Sample
-==============================
+===================================
+
+Sample demonstrates the use of [MotionEvent][1] properties to keep track of
+individual touches across multiple touch events.
+
+[1]: http://developer.android.com/reference/android/view/MotionEvent.html
+
+Introduction
+------------
-This samples demonstrates the use of MotionEvent properties to keep track of individual touches
-across multiple touch events.
+This is an example of keeping track of individual touches across multiple
+[MotionEvent][1]s.
-Touch the screen with multiple fingers to show that the pointer id
-(also represented by a colour) does not change as new touch events are received.</string>
+This sample uses a custom View (`TouchDisplayView`) that responds to
+touch events and draws a colored circle for each touch point. The view holds
+data related to a touch pointer, including its current position, pressure,
+and its past touch history.
+
+The View draws graphics based on data associated with each touch event to a
+canvas. A large circle indicates the current position of a touch, while smaller
+trailing circles represent previous positions for that touch.
+The size of the large circle is scaled depending on the pressure of the user's
+touch.
+
+[1]: http://developer.android.com/reference/android/view/MotionEvent.html
Pre-requisites
--------------
-- Android SDK v20
-- Android Build Tools v20
+- Android SDK v23
+- Android Build Tools v22.0.1
- Android Support Repository
+Screenshots
+-------------
+
+<img src="screenshots/intro.png" height="400" alt="Screenshot"/> <img src="screenshots/touches.png" height="400" alt="Screenshot"/>
+
Getting Started
---------------
@@ -44,7 +68,7 @@ file to you under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License. You may obtain a copy of
the License at
- http://www.apache.org/licenses/LICENSE-2.0
+http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT