content: /*
   * Copyright (C) 2008 The Android Open Source Project
   *
   * Licensed 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
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  
  package android.view;
  
  import android.content.Context;
  import android.hardware.SensorListener;
  
  /**
   * Helper class for receiving notifications from the SensorManager when
   * the orientation of the device has changed.
   *  @deprecated use {@link android.view.OrientationEventListener} instead.
   *  This class internally uses the OrientationEventListener.
   */
  @Deprecated
  public abstract class OrientationListener implements SensorListener {
      private OrientationEventListener mOrientationEventLis;
      
      /**
       * Returned from onOrientationChanged when the device orientation cannot be determined
       * (typically when the device is in a close to flat position).
       *
       *  @see #onOrientationChanged
       */
      public static final int ORIENTATION_UNKNOWN = OrientationEventListener.ORIENTATION_UNKNOWN;
  
      /**
       * Creates a new OrientationListener.
       * 
       * @param context for the OrientationListener.
       */
      public OrientationListener(Context context) {
          mOrientationEventLis = new OrientationEventListenerInternal(context);
      }
  
      /**
       * Creates a new OrientationListener.
       * 
       * @param context for the OrientationListener.
       * @param rate at which sensor events are processed (see also
       * {@link android.hardware.SensorManager SensorManager}). Use the default
       * value of {@link android.hardware.SensorManager#SENSOR_DELAY_NORMAL 
       * SENSOR_DELAY_NORMAL} for simple screen orientation change detection.
       */
      public OrientationListener(Context context, int rate) {
          mOrientationEventLis = new OrientationEventListenerInternal(context, rate);
      }
      
      class OrientationEventListenerInternal extends OrientationEventListener {
          OrientationEventListenerInternal(Context context) {
              super(context);
          }
          
          OrientationEventListenerInternal(Context context, int rate) {
              super(context, rate);
              // register so that onSensorChanged gets invoked
              registerListener(OrientationListener.this);
          }
                  
          public void onOrientationChanged(int orientation) {
              OrientationListener.this.onOrientationChanged(orientation);
          }
      }
      
      /**
       * Enables the OrientationListener so it will monitor the sensor and call
       * {@link #onOrientationChanged} when the device orientation changes.
       */
      public void enable() {
          mOrientationEventLis.enable();
      }
  
      /**
       * Disables the OrientationListener.
       */
      public void disable() {
          mOrientationEventLis.disable();
      }
      
      public void onAccuracyChanged(int sensor, int accuracy) {
      }
      
      public void onSensorChanged(int sensor, float[] values) {
          // just ignore the call here onOrientationChanged is invoked anyway
      }
  
  
      /**
       * Look at {@link android.view.OrientationEventListener#onOrientationChanged}
       * for method description and usage
       * @param orientation The new orientation of the device.
       *
       *  @see #ORIENTATION_UNKNOWN
       */
      abstract public void onOrientationChanged(int orientation);
      
  }
  