Merge "Add missing "Introduced in" docs from NDK" into udc-dev (5b6ca88e) · Commits · e / os / android_frameworks_native

include/android/choreographer.h

+13 −0

Original line number	Diff line number	Diff line
		@@ -219,12 +219,16 @@ void AChoreographer_unregisterRefreshRateCallback(AChoreographer* choreographer,
		*
		* Note that this time should \b not be used to advance animation clocks.
		* Instead, see AChoreographerFrameCallbackData_getFrameTimelineExpectedPresentationTimeNanos().
		*
		* Available since API level 33.
		*/
		int64_t AChoreographerFrameCallbackData_getFrameTimeNanos(
		const AChoreographerFrameCallbackData* data) __INTRODUCED_IN(33);

		/**
		* The number of possible frame timelines.
		*
		* Available since API level 33.
		*/
		size_t AChoreographerFrameCallbackData_getFrameTimelinesLength(
		const AChoreographerFrameCallbackData* data) __INTRODUCED_IN(33);
		@@ -233,15 +237,20 @@ size_t AChoreographerFrameCallbackData_getFrameTimelinesLength(
		* Gets the index of the platform-preferred frame timeline.
		* The preferred frame timeline is the default
		* by which the platform scheduled the app, based on the device configuration.
		*
		* Available since API level 33.
		*/
		size_t AChoreographerFrameCallbackData_getPreferredFrameTimelineIndex(
		const AChoreographerFrameCallbackData* data) __INTRODUCED_IN(33);

		/**
		* Gets the token used by the platform to identify the frame timeline at the given \c index.
		* q
		* Available since API level 33.
		*
		* \param index index of a frame timeline, in \f( [0, FrameTimelinesLength) \f). See
		* AChoreographerFrameCallbackData_getFrameTimelinesLength()
		*
		*/
		AVsyncId AChoreographerFrameCallbackData_getFrameTimelineVsyncId(
		const AChoreographerFrameCallbackData* data, size_t index) __INTRODUCED_IN(33);
		@@ -250,6 +259,8 @@ AVsyncId AChoreographerFrameCallbackData_getFrameTimelineVsyncId(
		* Gets the time in nanoseconds at which the frame described at the given \c index is expected to
		* be presented. This time should be used to advance any animation clocks.
		*
		* Available since API level 33.
		*
		* \param index index of a frame timeline, in \f( [0, FrameTimelinesLength) \f). See
		* AChoreographerFrameCallbackData_getFrameTimelinesLength()
		*/
		@@ -260,6 +271,8 @@ int64_t AChoreographerFrameCallbackData_getFrameTimelineExpectedPresentationTime
		* Gets the time in nanoseconds at which the frame described at the given \c index needs to be
		* ready by in order to be presented on time.
		*
		* Available since API level 33.
		*
		* \param index index of a frame timeline, in \f( [0, FrameTimelinesLength) \f). See
		* AChoreographerFrameCallbackData_getFrameTimelinesLength()
		*/

include/android/surface_control.h

+6 −0

Original line number	Diff line number	Diff line
		@@ -524,6 +524,8 @@ void ASurfaceTransaction_setHdrMetadata_cta861_3(ASurfaceTransaction* transactio
		* Sets the desired extended range brightness for the layer. This only applies for layers whose
		* dataspace has RANGE_EXTENDED set on it.
		*
		* Available since API level 34.
		*
		* @param surface_control The layer whose extended range brightness is being specified
		* @param currentBufferRatio The current hdr/sdr ratio of the current buffer as represented as
		* peakHdrBrightnessInNits / targetSdrWhitePointInNits. For example if the
		@@ -653,6 +655,8 @@ void ASurfaceTransaction_clearFrameRate(ASurfaceTransaction* transaction,
		* and pushing buffers earlier for server side queuing will be advantageous
		* in such cases.
		*
		* Available since API level 31.
		*
		* \param transaction The transaction in which to make the change.
		* \param surface_control The ASurfaceControl on which to control buffer backpressure behavior.
		* \param enableBackPressure Whether to enable back pressure.
		@@ -674,6 +678,8 @@ void ASurfaceTransaction_setEnableBackPressure(ASurfaceTransaction* transaction,
		* AChoreographer_postVsyncCallback(). The \c vsyncId can then be extracted from the
		* callback payload using AChoreographerFrameCallbackData_getFrameTimelineVsyncId().
		*
		* Available since API level 33.
		*
		* \param vsyncId The vsync ID received from AChoreographer, setting the frame's presentation target
		* to the corresponding expected presentation time and deadline from the frame to be rendered. A
		* stale or invalid value will be ignored.