blob: a0f4f2703fd7d7befbd2edda168f05b3b799cb86 [file] [log] [blame]
Siarhei Vishniakou7b7c8f62018-12-12 16:09:20 -08001/*
2 * Copyright (C) 2018 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17#ifndef _LIBINPUT_TOUCHVIDEOFRAME_H
18#define _LIBINPUT_TOUCHVIDEOFRAME_H
19
20#include <stdint.h>
21#include <sys/time.h>
22#include <vector>
23
24namespace android {
25
26/**
27 * Represents data from a single scan of the touchscreen device.
28 * Similar in concept to a video frame, but the touch strength is used as
29 * the values instead.
30 */
31class TouchVideoFrame {
32public:
33 TouchVideoFrame(uint32_t width, uint32_t height, std::vector<int16_t> data,
Siarhei Vishniakou26cf29d2019-02-15 16:48:38 -060034 const struct timeval& timestamp);
Siarhei Vishniakou7b7c8f62018-12-12 16:09:20 -080035
Siarhei Vishniakou26cf29d2019-02-15 16:48:38 -060036 bool operator==(const TouchVideoFrame& rhs) const;
Siarhei Vishniakou473174e2017-12-27 16:44:42 -080037
Siarhei Vishniakou7b7c8f62018-12-12 16:09:20 -080038 /**
39 * Width of the frame
40 */
Siarhei Vishniakou26cf29d2019-02-15 16:48:38 -060041 uint32_t getWidth() const;
Siarhei Vishniakou7b7c8f62018-12-12 16:09:20 -080042 /**
43 * Height of the frame
44 */
Siarhei Vishniakou26cf29d2019-02-15 16:48:38 -060045 uint32_t getHeight() const;
Siarhei Vishniakou7b7c8f62018-12-12 16:09:20 -080046 /**
47 * The touch strength data.
48 * The array is a 2-D row-major matrix, with dimensions (height, width).
49 * Total size of the array should equal getHeight() * getWidth().
50 * Data is allowed to be negative.
51 */
Siarhei Vishniakou26cf29d2019-02-15 16:48:38 -060052 const std::vector<int16_t>& getData() const;
Siarhei Vishniakou7b7c8f62018-12-12 16:09:20 -080053 /**
54 * Time at which the heatmap was taken.
55 */
Siarhei Vishniakou26cf29d2019-02-15 16:48:38 -060056 const struct timeval& getTimestamp() const;
Siarhei Vishniakou7b7c8f62018-12-12 16:09:20 -080057
58private:
59 uint32_t mWidth;
60 uint32_t mHeight;
61 std::vector<int16_t> mData;
62 struct timeval mTimestamp;
63};
64
65} // namespace android
66
67#endif // _LIBINPUT_TOUCHVIDEOFRAME_H