summaryrefslogtreecommitdiffstats
path: root/cc/input_handler.h
blob: f5b2e2336637fbecad780dcd31f79ecd9d100340 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
// Copyright 2011 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CCInputHandler_h
#define CCInputHandler_h

#include "base/basictypes.h"
#include "base/time.h"
#include "cc/cc_export.h"

namespace gfx {
class Point;
}

namespace cc {

class IntPoint;
class IntSize;

// The InputHandler is a way for the embedders to interact with
// the impl thread side of the compositor implementation.
//
// There is one InputHandler for every LayerTreeHost. It is
// created on the main thread and used only on the impl thread.
//
// The InputHandler is constructed with a InputHandlerClient, which is the
// interface by which the handler can manipulate the LayerTree.
class CC_EXPORT InputHandlerClient {
public:
    enum ScrollStatus { ScrollOnMainThread, ScrollStarted, ScrollIgnored };
    enum ScrollInputType { Gesture, Wheel };

    // Selects a layer to be scrolled at a given point in viewport (logical
    // pixel) coordinates. Returns ScrollStarted if the layer at the coordinates
    // can be scrolled, ScrollOnMainThread if the scroll event should instead be
    // delegated to the main thread, or ScrollIgnored if there is nothing to be
    // scrolled at the given coordinates.
    virtual ScrollStatus scrollBegin(const gfx::Point&, ScrollInputType) = 0;

    // Scroll the selected layer starting at the given position. If the scroll
    // type given to scrollBegin was a gesture, then the scroll point and delta
    // should be in viewport (logical pixel) coordinates. Otherwise they are in
    // scrolling layer's (logical pixel) space. If there is no room to move the
    // layer in the requested direction, its first ancestor layer that can be
    // scrolled will be moved instead. Should only be called if scrollBegin()
    // returned ScrollStarted.
    virtual void scrollBy(const gfx::Point&, const IntSize&) = 0;

    // Stop scrolling the selected layer. Should only be called if scrollBegin()
    // returned ScrollStarted.
    virtual void scrollEnd() = 0;

    virtual void pinchGestureBegin() = 0;
    virtual void pinchGestureUpdate(float magnifyDelta, const IntPoint& anchor) = 0;
    virtual void pinchGestureEnd() = 0;

    virtual void startPageScaleAnimation(const IntSize& targetPosition,
                                         bool anchorPoint,
                                         float pageScale,
                                         base::TimeTicks startTime,
                                         base::TimeDelta duration) = 0;

    // Request another callback to InputHandler::animate().
    virtual void scheduleAnimation() = 0;

protected:
    InputHandlerClient() { }
    virtual ~InputHandlerClient() { }

private:
    DISALLOW_COPY_AND_ASSIGN(InputHandlerClient);
};

class CC_EXPORT InputHandler {
public:
    virtual ~InputHandler() { }

    virtual void bindToClient(InputHandlerClient*) = 0;
    virtual void animate(base::TimeTicks time) = 0;

protected:
    InputHandler() { }

private:
    DISALLOW_COPY_AND_ASSIGN(InputHandler);
};

}

#endif