ash/host/root_window_transformer.h

// Copyright 2014 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef ASH_HOST_ROOT_WINDOW_TRANSFORMER_H_
#define ASH_HOST_ROOT_WINDOW_TRANSFORMER_H_

#include "ash/ash_export.h"

namespace gfx {
class Insets;
class Rect;
class Size;
class Transform;
}

namespace ash {

// RootWindowTransformer controls how RootWindow should be placed and
// transformed inside the host window.
class ASH_EXPORT RootWindowTransformer {
 public:
  virtual ~RootWindowTransformer() {}

  // Returns the transform that converts root window coordinates in DIP to
  // host (platform) window coordinates. The transform normally includes
  // rotation and scaling, except for unified desktop, which doesn't include
  // rotation.
  virtual gfx::Transform GetTransform() const = 0;

  // Returns the inverse of the transform above. This method is to
  // provide an accurate inverse of the transform because the result of
  // |gfx::Transform::GetInverse| may contains computational error.
  virtual gfx::Transform GetInverseTransform() const = 0;

  // Returns the root window's bounds for given host window size in DIP.
  // This is necessary to handle the case where the root window's size
  // is bigger than the host window. (Screen magnifier for example).
  virtual gfx::Rect GetRootWindowBounds(const gfx::Size& host_size) const = 0;

  // Returns the insets that specifies the effective area of
  // the host window.
  virtual gfx::Insets GetHostInsets() const = 0;

  // Returns the transform for applying host insets and magnifier scale. It is
  // similar to GetTransform() but without the screen rotation.
  virtual gfx::Transform GetInsetsAndScaleTransform() const = 0;
};

}  // namespace ash

#endif  // ASH_HOST_ROOT_WINDOW_TRANSFORMER_H_