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/**
18 * @addtogroup Choreographer
19 * @{
20 */
21
22/**
23 * @file choreographer.h
24 */
25
26#ifndef ANDROID_CHOREOGRAPHER_H
27#define ANDROID_CHOREOGRAPHER_H
28
29#include <sys/cdefs.h>
30
31__BEGIN_DECLS
32
33#if __ANDROID_API__ >= 24
34
35struct AChoreographer;
36typedef struct AChoreographer AChoreographer;
37
38/**
39 * Prototype of the function that is called when a new frame is being rendered.
40 * It's passed the time that the frame is being rendered as nanoseconds in the
41 * CLOCK_MONOTONIC time base, as well as the data pointer provided by the
42 * application that registered a callback. All callbacks that run as part of
43 * rendering a frame will observe the same frame time, so it should be used
44 * whenever events need to be synchronized (e.g. animations).
45 */
46typedef void (*AChoreographer_frameCallback)(long frameTimeNanos, void* data);
47
48/**
49 * Get the AChoreographer instance for the current thread. This must be called
50 * on an ALooper thread.
51 */
52AChoreographer* AChoreographer_getInstance();
53
54/**
55 * Post a callback to be run on the next frame. The data pointer provided will
56 * be passed to the callback function when it's called.
57 */
58void AChoreographer_postFrameCallback(AChoreographer* choreographer,
59                AChoreographer_frameCallback callback, void* data);
60/**
61 * Post a callback to be run on the frame following the specified delay. The
62 * data pointer provided will be passed to the callback function when it's
63 * called.
64 */
65void AChoreographer_postFrameCallbackDelayed(AChoreographer* choreographer,
66                AChoreographer_frameCallback callback, void* data, long delayMillis);
67
68#endif /* __ANDROID_API__ >= 24 */
69
70__END_DECLS
71
72#endif // ANDROID_CHOREOGRAPHER_H
73
74/** @} */
75