1d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav/* 2d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * Copyright (C) 2014 The Android Open Source Project 3d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * 4d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * Licensed under the Apache License, Version 2.0 (the "License"); 5d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * you may not use this file except in compliance with the License. 6d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * You may obtain a copy of the License at 7d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * 8d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * http://www.apache.org/licenses/LICENSE-2.0 9d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * 10d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * Unless required by applicable law or agreed to in writing, software 11d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * distributed under the License is distributed on an "AS IS" BASIS, 12d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * See the License for the specific language governing permissions and 14d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * limitations under the License. 15d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav */ 16d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav 17d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav#ifndef ANDROID_UI_FRAME_STATS_H 18d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav#define ANDROID_UI_FRAME_STATS_H 19d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav 20d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav#include <utils/Flattenable.h> 21d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav#include <utils/Timers.h> 22d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav#include <utils/Vector.h> 23d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav 24d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslavnamespace android { 25d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav 26d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslavclass FrameStats : public LightFlattenable<FrameStats> { 27d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslavpublic: 28d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav 29d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav /* 30d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * Approximate refresh time, in nanoseconds. 31d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav */ 32d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav nsecs_t refreshPeriodNano; 33d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav 34d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav /* 35d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * The times in nanoseconds for when the frame contents were posted by the producer (e.g. 36d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * the application). They are either explicitly set or defaulted to the time when 37d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * Surface::queueBuffer() was called. 38d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav */ 39d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav Vector<nsecs_t> desiredPresentTimesNano; 40d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav 41d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav /* 42d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * The times in milliseconds for when the frame contents were presented on the screen. 43d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav */ 44d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav Vector<nsecs_t> actualPresentTimesNano; 45d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav 46d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav /* 47d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * The times in nanoseconds for when the frame contents were ready to be presented. Note that 48d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * a frame can be posted and still it contents being rendered asynchronously in GL. In such a 49d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * case these are the times when the frame contents were completely rendered (i.e. their fences 50d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav * signaled). 51d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav */ 52d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav Vector<nsecs_t> frameReadyTimesNano; 53d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav 54d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav // LightFlattenable 55d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav bool isFixedSize() const; 56d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav size_t getFlattenedSize() const; 57d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav status_t flatten(void* buffer, size_t size) const; 58d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav status_t unflatten(void const* buffer, size_t size); 59d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav}; 60d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav 61d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav}; // namespace android 62d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav 63d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav#endif // ANDROID_UI_FRAME_STATS_H 64