1 /*
2  * Copyright (C) 2017 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 #pragma once
18 
19 #include <string>
20 
21 #include "JankTracker.h"
22 #include "utils/Macros.h"
23 
24 namespace android {
25 namespace uirenderer {
26 namespace protos {
27 class GraphicsStatsProto;
28 }
29 
30 /*
31  * The exported entry points used by GraphicsStatsService.java in f/b/services/core
32  *
33  * NOTE: Avoid exporting a requirement on the protobuf itself. Keep the usage
34  * of the generated protobuf classes internal to libhwui.so to minimize library
35  * bloat.
36  */
37 class GraphicsStatsService {
38 public:
39     class Dump;
40     enum class DumpType {
41         Text,
42         Protobuf,
43     };
44 
45     ANDROID_API static void saveBuffer(const std::string& path, const std::string& package,
46                                        int64_t versionCode, int64_t startTime, int64_t endTime,
47                                        const ProfileData* data);
48 
49     ANDROID_API static Dump* createDump(int outFd, DumpType type);
50     ANDROID_API static void addToDump(Dump* dump, const std::string& path,
51                                       const std::string& package, int64_t versionCode,
52                                       int64_t startTime, int64_t endTime, const ProfileData* data);
53     ANDROID_API static void addToDump(Dump* dump, const std::string& path);
54     ANDROID_API static void finishDump(Dump* dump);
55 
56     // Visible for testing
57     static bool parseFromFile(const std::string& path, protos::GraphicsStatsProto* output);
58 };
59 
60 } /* namespace uirenderer */
61 } /* namespace android */
62