/usr/include/Nux-4.0/Nux/KineticScroller.h is in libnux-4.0-dev 4.0.6+14.04.20140409-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 | /*
* Copyright (C) 2012 - Canonical Ltd.
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License, as
* published by the Free Software Foundation; either version 2.1 or 3.0
* of the License.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranties of
* MERCHANTABILITY, SATISFACTORY QUALITY or FITNESS FOR A PARTICULAR
* PURPOSE. See the applicable version of the GNU Lesser General Public
* License for more details.
*
* You should have received a copy of both the GNU Lesser General Public
* License along with this program. If not, see <http://www.gnu.org/licenses/>
*
* Authored by: Daniel d'Andrada <daniel.dandrada@canonical.com>
*/
#ifndef NUX_KINETIC_SCROLLER_H
#define NUX_KINETIC_SCROLLER_H
#include "KineticScrollingEnums.h"
namespace nux
{
namespace kinetic_scrolling
{
class TickSourceInterface;
}
/*
Drives the scrolling of an entity based on user input
Given information on user input (e.g. touches and mouse events) it tells
how a view/entity/object should react by scrolling in a kinetic fashion.
Thus this class doesn't do anything by itself but must be attached or composed with
the object that you want to have kinetic scrolling.
The scroller moves the content and considers the viewport to be fixed.
*/
class KineticScroller
{
public:
/*!
Minimum movement of the finger along an axis necessary for the scroller to
start following it. I.e. to move from Pressed to FollowingFinger state.
*/
static const int MOVEMENT_THRESHOLD = 5;
KineticScroller();
/*!
Constructor useful for testing purposes.
When testing you would like to manually drive the animations
*/
KineticScroller(kinetic_scrolling::TickSourceInterface *tick_source);
virtual ~KineticScroller();
/***** Initialization ******/
/*!
Specifies the size of the viewport.
Any existing momentum or movement is halted. You will usually call this
method only during initialization.
*/
void SetViewportSize(int width, int height);
/*!
Specifies the size of the content.
Scrolling is only useful when the content is larger than the viewport.
Any existing momentum or movement is halted. You will usually call this
method only during initialization.
*/
void SetContentSize(int width, int height);
/*!
Sets the content position, relative to viewport's top-left corner.
Any existing momentum or movement is halted. You will usually call this
method only during initialization.
*/
void SetContentPosition(int x, int y);
/*!
Defines what happens when the viewport is about to be beyond content boundaries
The default value is DragAndOvershootBounds.
*/
void SetBoundsBehavior(BoundsBehavior bounds_behavior);
/*!
Defines which directions can be scrolled.
The default value is Auto.
*/
void SetScrollableDirections(ScrollableDirections scrollable_directions);
/***** input ******/
/*!
Tells the scroller that a finger is touching the scrollable surface
The scroller is interested only in single finger interactions.
If subsequent fingers hit the surface they shouldn't be informed to the
scroller.
Thus calling this method twice, without a ProcessFingerUp() in between, is
not supported.
*/
void ProcessFingerDown();
/*!
Tells the scroller that a finger has left the scrollable surface
\sa ProcessFingerDown()
*/
void ProcessFingerUp();
/*!
Tells the scroller that a finger has moved along the scrollable surface
\param dx How far it has moved along the X axis.
\param dx How far it has moved along the Y axis.
*/
void ProcessFingerDrag(int dx, int dy);
/***** Scrolling output ******/
//! Emitted when the content position changes
/*!
It won't be emitted due to a call to SetContentPosition().
@param int X coordinate of the new content position.
@param int Y coordinate of the new content position.
*/
sigc::signal<void, int, int> content_position_changed;
KineticScrollerAxisState GetHorizontalAxisState() const;
KineticScrollerAxisState GetVerticalAxisState() const;
private:
class Private;
Private *p;
};
} // namespace nux
#endif // NUX_KINETIC_SCROLLER_H
|