19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 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.view; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.hardware.SensorListener; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper class for receiving notifications from the SensorManager when 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the orientation of the device has changed. 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated use {@link android.view.OrientationEventListener} instead. 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class internally uses the OrientationEventListener. 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project@Deprecated 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic abstract class OrientationListener implements SensorListener { 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private OrientationEventListener mOrientationEventLis; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returned from onOrientationChanged when the device orientation cannot be determined 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (typically when the device is in a close to flat position). 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onOrientationChanged 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ORIENTATION_UNKNOWN = OrientationEventListener.ORIENTATION_UNKNOWN; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new OrientationListener. 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context for the OrientationListener. 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public OrientationListener(Context context) { 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOrientationEventLis = new OrientationEventListenerInternal(context); 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new OrientationListener. 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context for the OrientationListener. 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rate at which sensor events are processed (see also 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.hardware.SensorManager SensorManager}). Use the default 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * value of {@link android.hardware.SensorManager#SENSOR_DELAY_NORMAL 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * SENSOR_DELAY_NORMAL} for simple screen orientation change detection. 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public OrientationListener(Context context, int rate) { 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOrientationEventLis = new OrientationEventListenerInternal(context, rate); 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project class OrientationEventListenerInternal extends OrientationEventListener { 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project OrientationEventListenerInternal(Context context) { 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(context); 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project OrientationEventListenerInternal(Context context, int rate) { 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(context, rate); 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // register so that onSensorChanged gets invoked 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project registerListener(OrientationListener.this); 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onOrientationChanged(int orientation) { 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project OrientationListener.this.onOrientationChanged(orientation); 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enables the OrientationListener so it will monitor the sensor and call 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #onOrientationChanged} when the device orientation changes. 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void enable() { 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOrientationEventLis.enable(); 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disables the OrientationListener. 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void disable() { 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mOrientationEventLis.disable(); 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onAccuracyChanged(int sensor, int accuracy) { 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onSensorChanged(int sensor, float[] values) { 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // just ignore the call here onOrientationChanged is invoked anyway 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Look at {@link android.view.OrientationEventListener#onOrientationChanged} 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for method description and usage 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param orientation The new orientation of the device. 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ORIENTATION_UNKNOWN 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project abstract public void onOrientationChanged(int orientation); 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 111