• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2015 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 #include <gui/DisplayEventReceiver.h>
18 #include <utils/Log.h>
19 #include <utils/Looper.h>
20 
21 namespace android {
22 using FrameRateOverride = DisplayEventReceiver::Event::FrameRateOverride;
23 
24 struct VsyncEventData {
25     // The Vsync Id corresponsing to this vsync event. This will be used to
26     // populate ISurfaceComposer::setFrameTimelineVsync and
27     // SurfaceComposerClient::setFrameTimelineVsync
28     int64_t id = FrameTimelineInfo::INVALID_VSYNC_ID;
29 
30     // The deadline in CLOCK_MONOTONIC that the app needs to complete its
31     // frame by (both on the CPU and the GPU)
32     int64_t deadlineTimestamp = std::numeric_limits<int64_t>::max();
33 
34     // The current frame interval in ns when this frame was scheduled.
35     int64_t frameInterval = 0;
36 };
37 
38 class DisplayEventDispatcher : public LooperCallback {
39 public:
40     explicit DisplayEventDispatcher(
41             const sp<Looper>& looper,
42             ISurfaceComposer::VsyncSource vsyncSource = ISurfaceComposer::eVsyncSourceApp,
43             ISurfaceComposer::EventRegistrationFlags eventRegistration = {});
44 
45     status_t initialize();
46     void dispose();
47     status_t scheduleVsync();
48     void injectEvent(const DisplayEventReceiver::Event& event);
49     int getFd() const;
50     virtual int handleEvent(int receiveFd, int events, void* data);
51 
52 protected:
53     virtual ~DisplayEventDispatcher() = default;
54 
55 private:
56     sp<Looper> mLooper;
57     DisplayEventReceiver mReceiver;
58     bool mWaitingForVsync;
59 
60     std::vector<FrameRateOverride> mFrameRateOverrides;
61 
62     virtual void dispatchVsync(nsecs_t timestamp, PhysicalDisplayId displayId, uint32_t count,
63                                VsyncEventData vsyncEventData) = 0;
64     virtual void dispatchHotplug(nsecs_t timestamp, PhysicalDisplayId displayId,
65                                  bool connected) = 0;
66     virtual void dispatchModeChanged(nsecs_t timestamp, PhysicalDisplayId displayId, int32_t modeId,
67                                      nsecs_t vsyncPeriod) = 0;
68     // AChoreographer-specific hook for processing null-events so that looper
69     // can be properly poked.
70     virtual void dispatchNullEvent(nsecs_t timestamp, PhysicalDisplayId displayId) = 0;
71 
72     virtual void dispatchFrameRateOverrides(nsecs_t timestamp, PhysicalDisplayId displayId,
73                                             std::vector<FrameRateOverride> overrides) = 0;
74 
75     bool processPendingEvents(nsecs_t* outTimestamp, PhysicalDisplayId* outDisplayId,
76                               uint32_t* outCount, VsyncEventData* outVsyncEventData);
77 };
78 } // namespace android
79