blob: cd60c00038d213e18abb91b8f2eb9fc9c4775be7 (
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
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
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
|
/*
* Copyright (C) 2013 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 com.android.camera.filmstrip;
/**
* An interface which defines the controller of filmstrip.
* A filmstrip has 4 states:
* <ol>
* <li>Filmstrip</li>
* Images are scaled down and the user can navigate quickly by swiping.
* Action bar and controls are shown.
* <li>Full-screen</li>
* One single image occupies the whole screen. Action bar and controls are
* hidden.
* <li>Zoom view</li>
* Zoom in to view the details of one single image.
* </ol>
* Only the following state transitions can happen:
* <ol>
* <li>filmstrip --> full-screen</li>
* <li>full-screen --> filmstrip</li>
* <li>full-screen --> full-screen with UIs</li>
* <li>full-screen --> zoom view</li>
* <li>zoom view --> full-screen</li>
* </ol>
*
* Upon entering/leaving each of the states, the
* {@link com.android.camera.filmstrip.FilmstripController.FilmstripListener} will be notified.
*/
public interface FilmstripController {
/**
* Sets the listener for filmstrip events.
*
* @param l
*/
public void setListener(FilmstripListener l);
/**
* Sets the gap width between each images on the filmstrip.
*
* @param imageGap The gap width in pixels.
*/
public void setImageGap(int imageGap);
/**
* @return The ID of the current item, or -1.
*/
public int getCurrentId();
/**
* Sets the {@link DataAdapter}.
*/
public void setDataAdapter(DataAdapter adapter);
/**
* Returns whether the filmstrip is in filmstrip mode.
*/
public boolean inFilmstrip();
/**
* @return Whether the filmstrip is in full-screen mode.
*/
public boolean inFullScreen();
/**
* @return Whether the current view in filmstrip is camera preview.
*/
public boolean isCameraPreview();
/**
* @return Whether the filmstrip is in full-screen camrea preview.
*/
public boolean inCameraFullscreen();
/**
* @return Whether the filmstrip is in scaling animation.
*/
public boolean isScaling();
/**
* Scrolls the filmstrip horizontally.
*
* @param deltaX The distance in pixel The filmstrip will be scrolled by.
*/
public void scroll(float deltaX);
/**
* Flings the filmstrip horizontally.
*
* @param velocity
*/
public void fling(float velocity);
/**
* Scrolls the filmstrip horizontally to a specific position.
*
* @param position The final position.
* @param duration The duration of this scrolling.
* @param interruptible Whether this scrolling can be interrupted.
*/
public void scrollToPosition(int position, int duration, boolean interruptible);
/**
* Scrolls the filmstrip horizontally to the center of the next item.
*
* @return Whether the next item exists.
*/
public boolean goToNextItem();
/**
* Stops the scrolling.
*
* @param forced Forces to stop even if the scrolling can not be
* interrupted.
* @return Whether the scrolling is stopped.
*/
public boolean stopScrolling(boolean forced);
/**
* Returns whether the filmstrip is scrolling.
* @return
*/
public boolean isScrolling();
/**
* Puts the first item in the center in full-screen.
*/
public void goToFirstItem();
/**
* Scales down to filmstrip mode. If the current item is camera preview,
* scrolls to the next item.
*/
public void goToFilmstrip();
/**
* Scales up to full-screen mode.
*/
public void goToFullScreen();
/**
* An interface which defines the FilmStripView UI action listener.
*/
interface FilmstripListener {
/**
* Callback when the data item is promoted. A data is promoted if the user
* swipe up a data vertically.
*
* @param dataID The ID of the promoted data.
*/
public void onDataPromoted(int dataID);
/**
* Callback when the data item is demoted. A data is promoted if the user
* swipe down a data vertically.
*
* @param dataID The ID of the demoted data.
*/
public void onDataDemoted(int dataID);
/**
*
* Called when all the data has been reloaded.
*/
public void onDataReloaded();
/**
* The callback when the item enters full-screen state.
*
* @param dataId The ID of the current focused image data.
*/
public void onEnterFullScreen(int dataId);
/**
* The callback when the item leaves full-screen.
*
* @param dataId The ID of the current focused image data.
*/
public void onLeaveFullScreen(int dataId);
/**
* The callback when the item enters filmstrip.
*
* @param dataId The ID of the current focused image data.
*/
public void onEnterFilmstrip(int dataId);
/**
* The callback when the item leaves filmstrip.
*
* @param dataId The ID of the current focused image data.
*/
public void onLeaveFilmstrip(int dataId);
/**
* The callback when the item enters zoom view.
*
* @param dataID
*/
public void onEnterZoomView(int dataID);
/**
* The callback when the data focus changed.
*
* @param prevDataId The ID of the previously focused data or {@code -1} if
* none.
* @param newDataId The ID of the focused data of {@code -1} if none.
*/
public void onDataFocusChanged(int prevDataId, int newDataId);
}
}
|
