| /* |
| * Copyright 2016 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. |
| */ |
| |
| #ifndef ANDROID_SURFACEINTERCEPTOR_H |
| #define ANDROID_SURFACEINTERCEPTOR_H |
| |
| #include <frameworks/native/cmds/surfacereplayer/proto/src/trace.pb.h> |
| |
| #include <mutex> |
| |
| #include <utils/SortedVector.h> |
| #include <utils/Vector.h> |
| |
| namespace android { |
| |
| class BufferItem; |
| class Layer; |
| class SurfaceFlinger; |
| struct DisplayState; |
| struct layer_state_t; |
| |
| constexpr auto DEFAULT_FILENAME = "/data/SurfaceTrace.dat"; |
| |
| /* |
| * SurfaceInterceptor intercepts and stores incoming streams of window |
| * properties on SurfaceFlinger. |
| */ |
| class SurfaceInterceptor { |
| public: |
| SurfaceInterceptor(SurfaceFlinger* const flinger); |
| // Both vectors are used to capture the current state of SF as the initial snapshot in the trace |
| void enable(const SortedVector<sp<Layer>>& layers, |
| const DefaultKeyedVector< wp<IBinder>, DisplayDeviceState>& displays); |
| void disable(); |
| bool isEnabled(); |
| |
| // Intercept display and surface transactions |
| void saveTransaction(const Vector<ComposerState>& stateUpdates, |
| const DefaultKeyedVector< wp<IBinder>, DisplayDeviceState>& displays, |
| const Vector<DisplayState>& changedDisplays, uint32_t flags); |
| |
| // Intercept surface data |
| void saveSurfaceCreation(const sp<const Layer>& layer); |
| void saveSurfaceDeletion(const sp<const Layer>& layer); |
| void saveBufferUpdate(const sp<const Layer>& layer, uint32_t width, uint32_t height, |
| uint64_t frameNumber); |
| |
| // Intercept display data |
| void saveDisplayCreation(const DisplayDeviceState& info); |
| void saveDisplayDeletion(int32_t displayId); |
| void savePowerModeUpdate(int32_t displayId, int32_t mode); |
| void saveVSyncEvent(nsecs_t timestamp); |
| |
| private: |
| // The creation increments of Surfaces and Displays do not contain enough information to capture |
| // the initial state of each object, so a transaction with all of the missing properties is |
| // performed at the initial snapshot for each display and surface. |
| void saveExistingDisplaysLocked( |
| const DefaultKeyedVector< wp<IBinder>, DisplayDeviceState>& displays); |
| void saveExistingSurfacesLocked(const SortedVector<sp<Layer>>& layers); |
| void addInitialSurfaceStateLocked(Increment* increment, const sp<const Layer>& layer); |
| void addInitialDisplayStateLocked(Increment* increment, const DisplayDeviceState& display); |
| |
| status_t writeProtoFileLocked(); |
| const sp<const Layer> getLayer(const wp<const IBinder>& weakHandle); |
| const std::string getLayerName(const sp<const Layer>& layer); |
| int32_t getLayerId(const sp<const Layer>& layer); |
| |
| Increment* createTraceIncrementLocked(); |
| void addSurfaceCreationLocked(Increment* increment, const sp<const Layer>& layer); |
| void addSurfaceDeletionLocked(Increment* increment, const sp<const Layer>& layer); |
| void addBufferUpdateLocked(Increment* increment, const sp<const Layer>& layer, uint32_t width, |
| uint32_t height, uint64_t frameNumber); |
| void addVSyncUpdateLocked(Increment* increment, nsecs_t timestamp); |
| void addDisplayCreationLocked(Increment* increment, const DisplayDeviceState& info); |
| void addDisplayDeletionLocked(Increment* increment, int32_t displayId); |
| void addPowerModeUpdateLocked(Increment* increment, int32_t displayId, int32_t mode); |
| |
| // Add surface transactions to the trace |
| SurfaceChange* createSurfaceChangeLocked(Transaction* transaction, int32_t layerId); |
| void setProtoRectLocked(Rectangle* protoRect, const Rect& rect); |
| void addPositionLocked(Transaction* transaction, int32_t layerId, float x, float y); |
| void addDepthLocked(Transaction* transaction, int32_t layerId, uint32_t z); |
| void addSizeLocked(Transaction* transaction, int32_t layerId, uint32_t w, uint32_t h); |
| void addAlphaLocked(Transaction* transaction, int32_t layerId, float alpha); |
| void addMatrixLocked(Transaction* transaction, int32_t layerId, |
| const layer_state_t::matrix22_t& matrix); |
| void addTransparentRegionLocked(Transaction* transaction, int32_t layerId, |
| const Region& transRegion); |
| void addFlagsLocked(Transaction* transaction, int32_t layerId, uint8_t flags); |
| void addLayerStackLocked(Transaction* transaction, int32_t layerId, uint32_t layerStack); |
| void addCropLocked(Transaction* transaction, int32_t layerId, const Rect& rect); |
| void addDeferTransactionLocked(Transaction* transaction, int32_t layerId, |
| const sp<const Layer>& layer, uint64_t frameNumber); |
| void addFinalCropLocked(Transaction* transaction, int32_t layerId, const Rect& rect); |
| void addOverrideScalingModeLocked(Transaction* transaction, int32_t layerId, |
| int32_t overrideScalingMode); |
| void addSurfaceChangesLocked(Transaction* transaction, const layer_state_t& state); |
| void addTransactionLocked(Increment* increment, const Vector<ComposerState>& stateUpdates, |
| const DefaultKeyedVector< wp<IBinder>, DisplayDeviceState>& displays, |
| const Vector<DisplayState>& changedDisplays, uint32_t transactionFlags); |
| |
| // Add display transactions to the trace |
| DisplayChange* createDisplayChangeLocked(Transaction* transaction, int32_t displayId); |
| void addDisplaySurfaceLocked(Transaction* transaction, int32_t displayId, |
| const sp<const IGraphicBufferProducer>& surface); |
| void addDisplayLayerStackLocked(Transaction* transaction, int32_t displayId, |
| uint32_t layerStack); |
| void addDisplaySizeLocked(Transaction* transaction, int32_t displayId, uint32_t w, |
| uint32_t h); |
| void addDisplayProjectionLocked(Transaction* transaction, int32_t displayId, |
| int32_t orientation, const Rect& viewport, const Rect& frame); |
| void addDisplayChangesLocked(Transaction* transaction, |
| const DisplayState& state, int32_t displayId); |
| |
| |
| bool mEnabled {false}; |
| std::string mOutputFileName {DEFAULT_FILENAME}; |
| std::mutex mTraceMutex {}; |
| Trace mTrace {}; |
| SurfaceFlinger* const mFlinger; |
| }; |
| |
| } |
| |
| #endif // ANDROID_SURFACEINTERCEPTOR_H |