Loading include/android/surface_control.h +114 −106 Original line number Diff line number Diff line Loading @@ -62,7 +62,8 @@ typedef struct ASurfaceControl ASurfaceControl; * * Available since API level 29. */ ASurfaceControl* ASurfaceControl_createFromWindow(ANativeWindow* parent, const char* debug_name) ASurfaceControl* _Nullable ASurfaceControl_createFromWindow(ANativeWindow* _Nonnull parent, const char* _Nonnull debug_name) __INTRODUCED_IN(29); /** Loading @@ -70,7 +71,8 @@ ASurfaceControl* ASurfaceControl_createFromWindow(ANativeWindow* parent, const c * * Available since API level 29. */ ASurfaceControl* ASurfaceControl_create(ASurfaceControl* parent, const char* debug_name) ASurfaceControl* _Nullable ASurfaceControl_create(ASurfaceControl* _Nonnull parent, const char* _Nonnull debug_name) __INTRODUCED_IN(29); /** Loading @@ -81,7 +83,7 @@ ASurfaceControl* ASurfaceControl_create(ASurfaceControl* parent, const char* deb * * Available since API level 31. */ void ASurfaceControl_acquire(ASurfaceControl* surface_control) __INTRODUCED_IN(31); void ASurfaceControl_acquire(ASurfaceControl* _Nonnull surface_control) __INTRODUCED_IN(31); /** * Removes a reference that was previously acquired with one of the following functions: Loading @@ -92,7 +94,7 @@ void ASurfaceControl_acquire(ASurfaceControl* surface_control) __INTRODUCED_IN(3 * * Available since API level 29. */ void ASurfaceControl_release(ASurfaceControl* surface_control) __INTRODUCED_IN(29); void ASurfaceControl_release(ASurfaceControl* _Nonnull surface_control) __INTRODUCED_IN(29); struct ASurfaceTransaction; Loading @@ -108,14 +110,14 @@ typedef struct ASurfaceTransaction ASurfaceTransaction; * * Available since API level 29. */ ASurfaceTransaction* ASurfaceTransaction_create() __INTRODUCED_IN(29); ASurfaceTransaction* _Nonnull ASurfaceTransaction_create() __INTRODUCED_IN(29); /** * Destroys the \a transaction object. * * Available since API level 29. */ void ASurfaceTransaction_delete(ASurfaceTransaction* transaction) __INTRODUCED_IN(29); void ASurfaceTransaction_delete(ASurfaceTransaction* _Nullable transaction) __INTRODUCED_IN(29); /** * Applies the updates accumulated in \a transaction. Loading @@ -126,7 +128,7 @@ void ASurfaceTransaction_delete(ASurfaceTransaction* transaction) __INTRODUCED_I * * Available since API level 29. */ void ASurfaceTransaction_apply(ASurfaceTransaction* transaction) __INTRODUCED_IN(29); void ASurfaceTransaction_apply(ASurfaceTransaction* _Nonnull transaction) __INTRODUCED_IN(29); /** * An opaque handle returned during a callback that can be used to query general stats and stats for Loading Loading @@ -154,10 +156,10 @@ typedef struct ASurfaceTransactionStats ASurfaceTransactionStats; * * Available since API level 29. */ typedef void (*ASurfaceTransaction_OnComplete)(void* context, ASurfaceTransactionStats* stats) typedef void (*ASurfaceTransaction_OnComplete)(void* _Null_unspecified context, ASurfaceTransactionStats* _Nonnull stats) __INTRODUCED_IN(29); /** * The ASurfaceTransaction_OnCommit callback is invoked when transaction is applied and the updates * are ready to be presented. This callback will be invoked before the Loading @@ -183,7 +185,8 @@ typedef void (*ASurfaceTransaction_OnComplete)(void* context, ASurfaceTransactio * * Available since API level 31. */ typedef void (*ASurfaceTransaction_OnCommit)(void* context, ASurfaceTransactionStats* stats) typedef void (*ASurfaceTransaction_OnCommit)(void* _Null_unspecified context, ASurfaceTransactionStats* _Nonnull stats) __INTRODUCED_IN(31); /** Loading @@ -192,8 +195,8 @@ typedef void (*ASurfaceTransaction_OnCommit)(void* context, ASurfaceTransactionS * * Available since API level 29. */ int64_t ASurfaceTransactionStats_getLatchTime(ASurfaceTransactionStats* surface_transaction_stats) __INTRODUCED_IN(29); int64_t ASurfaceTransactionStats_getLatchTime( ASurfaceTransactionStats* _Nonnull surface_transaction_stats) __INTRODUCED_IN(29); /** * Returns a sync fence that signals when the transaction has been presented. Loading @@ -204,8 +207,8 @@ int64_t ASurfaceTransactionStats_getLatchTime(ASurfaceTransactionStats* surface_ * * Available since API level 29. */ int ASurfaceTransactionStats_getPresentFenceFd(ASurfaceTransactionStats* surface_transaction_stats) __INTRODUCED_IN(29); int ASurfaceTransactionStats_getPresentFenceFd( ASurfaceTransactionStats* _Nonnull surface_transaction_stats) __INTRODUCED_IN(29); /** * \a outASurfaceControls returns an array of ASurfaceControl pointers that were updated during the Loading @@ -217,18 +220,18 @@ int ASurfaceTransactionStats_getPresentFenceFd(ASurfaceTransactionStats* surface * * \a outASurfaceControlsSize returns the size of the ASurfaceControls array. */ void ASurfaceTransactionStats_getASurfaceControls(ASurfaceTransactionStats* surface_transaction_stats, ASurfaceControl*** outASurfaceControls, size_t* outASurfaceControlsSize) __INTRODUCED_IN(29); void ASurfaceTransactionStats_getASurfaceControls( ASurfaceTransactionStats* _Nonnull surface_transaction_stats, ASurfaceControl* _Nullable* _Nullable* _Nonnull outASurfaceControls, size_t* _Nonnull outASurfaceControlsSize) __INTRODUCED_IN(29); /** * Releases the array of ASurfaceControls that were returned by * ASurfaceTransactionStats_getASurfaceControls(). * * Available since API level 29. */ void ASurfaceTransactionStats_releaseASurfaceControls(ASurfaceControl** surface_controls) __INTRODUCED_IN(29); void ASurfaceTransactionStats_releaseASurfaceControls( ASurfaceControl* _Nonnull* _Nonnull surface_controls) __INTRODUCED_IN(29); /** * Returns the timestamp of when the CURRENT buffer was acquired. A buffer is considered Loading @@ -241,9 +244,9 @@ void ASurfaceTransactionStats_releaseASurfaceControls(ASurfaceControl** surface_ * fence has signaled, depending on internal timing differences. Therefore the caller should * use the acquire fence passed in to setBuffer and query the signal time. */ int64_t ASurfaceTransactionStats_getAcquireTime(ASurfaceTransactionStats* surface_transaction_stats, ASurfaceControl* surface_control) __INTRODUCED_IN(29); int64_t ASurfaceTransactionStats_getAcquireTime( ASurfaceTransactionStats* _Nonnull surface_transaction_stats, ASurfaceControl* _Nonnull surface_control) __INTRODUCED_IN(29); /** * The returns the fence used to signal the release of the PREVIOUS buffer set on Loading @@ -268,9 +271,8 @@ int64_t ASurfaceTransactionStats_getAcquireTime(ASurfaceTransactionStats* surfac * Available since API level 29. */ int ASurfaceTransactionStats_getPreviousReleaseFenceFd( ASurfaceTransactionStats* surface_transaction_stats, ASurfaceControl* surface_control) __INTRODUCED_IN(29); ASurfaceTransactionStats* _Nonnull surface_transaction_stats, ASurfaceControl* _Nonnull surface_control) __INTRODUCED_IN(29); /** * Sets the callback that will be invoked when the updates from this transaction Loading @@ -279,8 +281,10 @@ int ASurfaceTransactionStats_getPreviousReleaseFenceFd( * * Available since API level 29. */ void ASurfaceTransaction_setOnComplete(ASurfaceTransaction* transaction, void* context, ASurfaceTransaction_OnComplete func) __INTRODUCED_IN(29); void ASurfaceTransaction_setOnComplete(ASurfaceTransaction* _Nonnull transaction, void* _Null_unspecified context, ASurfaceTransaction_OnComplete _Nonnull func) __INTRODUCED_IN(29); /** * Sets the callback that will be invoked when the updates from this transaction are applied and are Loading @@ -289,8 +293,10 @@ void ASurfaceTransaction_setOnComplete(ASurfaceTransaction* transaction, void* c * * Available since API level 31. */ void ASurfaceTransaction_setOnCommit(ASurfaceTransaction* transaction, void* context, ASurfaceTransaction_OnCommit func) __INTRODUCED_IN(31); void ASurfaceTransaction_setOnCommit(ASurfaceTransaction* _Nonnull transaction, void* _Null_unspecified context, ASurfaceTransaction_OnCommit _Nonnull func) __INTRODUCED_IN(31); /** * Reparents the \a surface_control from its old parent to the \a new_parent surface control. Loading @@ -300,9 +306,9 @@ void ASurfaceTransaction_setOnCommit(ASurfaceTransaction* transaction, void* con * * Available since API level 29. */ void ASurfaceTransaction_reparent(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, ASurfaceControl* new_parent) __INTRODUCED_IN(29); void ASurfaceTransaction_reparent(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, ASurfaceControl* _Nullable new_parent) __INTRODUCED_IN(29); /** * Parameter for ASurfaceTransaction_setVisibility(). Loading @@ -318,8 +324,8 @@ enum ASurfaceTransactionVisibility : int8_t { * * Available since API level 29. */ void ASurfaceTransaction_setVisibility(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, void ASurfaceTransaction_setVisibility(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, enum ASurfaceTransactionVisibility visibility) __INTRODUCED_IN(29); Loading @@ -332,8 +338,8 @@ void ASurfaceTransaction_setVisibility(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setZOrder(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, int32_t z_order) void ASurfaceTransaction_setZOrder(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, int32_t z_order) __INTRODUCED_IN(29); /** Loading @@ -349,9 +355,10 @@ void ASurfaceTransaction_setZOrder(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setBuffer(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, AHardwareBuffer* buffer, int acquire_fence_fd) __INTRODUCED_IN(29); void ASurfaceTransaction_setBuffer(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, AHardwareBuffer* _Nonnull buffer, int acquire_fence_fd) __INTRODUCED_IN(29); /** * Updates the color for \a surface_control. This will make the background color for the Loading @@ -361,9 +368,9 @@ void ASurfaceTransaction_setBuffer(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setColor(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, float r, float g, float b, float alpha, enum ADataSpace dataspace) void ASurfaceTransaction_setColor(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float r, float g, float b, float alpha, enum ADataSpace dataspace) __INTRODUCED_IN(29); /** Loading @@ -371,13 +378,13 @@ void ASurfaceTransaction_setColor(ASurfaceTransaction* transaction, * The surface's source rect is clipped by the bounds of its current buffer. The source rect's width * and height must be > 0. * * \param destination Specifies the rect in the parent's space where this surface will be drawn. The post * source rect bounds are scaled to fit the destination rect. The surface's destination rect is * \param destination Specifies the rect in the parent's space where this surface will be drawn. The * post source rect bounds are scaled to fit the destination rect. The surface's destination rect is * clipped by the bounds of its parent. The destination rect's width and height must be > 0. * * \param transform The transform applied after the source rect is applied to the buffer. This parameter * should be set to 0 for no transform. To specify a transfrom use the NATIVE_WINDOW_TRANSFORM_* * enum. * \param transform The transform applied after the source rect is applied to the buffer. This * parameter should be set to 0 for no transform. To specify a transfrom use the * NATIVE_WINDOW_TRANSFORM_* enum. * * Available since API level 29. * Loading @@ -386,8 +393,8 @@ void ASurfaceTransaction_setColor(ASurfaceTransaction* transaction, * to set different properties at different times, instead of having to specify all the desired * properties at once. */ void ASurfaceTransaction_setGeometry(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, const ARect& source, void ASurfaceTransaction_setGeometry(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, const ARect& source, const ARect& destination, int32_t transform) __INTRODUCED_IN(29); Loading @@ -400,8 +407,8 @@ void ASurfaceTransaction_setGeometry(ASurfaceTransaction* transaction, * * Available since API level 31. */ void ASurfaceTransaction_setCrop(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, const ARect& crop) void ASurfaceTransaction_setCrop(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, const ARect& crop) __INTRODUCED_IN(31); /** Loading @@ -412,9 +419,9 @@ void ASurfaceTransaction_setCrop(ASurfaceTransaction* transaction, * * Available since API level 31. */ void ASurfaceTransaction_setPosition(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, int32_t x, int32_t y) __INTRODUCED_IN(31); void ASurfaceTransaction_setPosition(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, int32_t x, int32_t y) __INTRODUCED_IN(31); /** * \param transform The transform applied after the source rect is applied to the buffer. This Loading @@ -423,9 +430,9 @@ void ASurfaceTransaction_setPosition(ASurfaceTransaction* transaction, * * Available since API level 31. */ void ASurfaceTransaction_setBufferTransform(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, int32_t transform) __INTRODUCED_IN(31); void ASurfaceTransaction_setBufferTransform(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, int32_t transform) __INTRODUCED_IN(31); /** * Sets an x and y scale of a surface with (0, 0) as the centerpoint of the scale. Loading @@ -435,9 +442,9 @@ void ASurfaceTransaction_setBufferTransform(ASurfaceTransaction* transaction, * * Available since API level 31. */ void ASurfaceTransaction_setScale(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, float xScale, float yScale) __INTRODUCED_IN(31); void ASurfaceTransaction_setScale(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float xScale, float yScale) __INTRODUCED_IN(31); /** * Parameter for ASurfaceTransaction_setBufferTransparency(). */ Loading @@ -453,8 +460,8 @@ enum ASurfaceTransactionTransparency : int8_t { * * Available since API level 29. */ void ASurfaceTransaction_setBufferTransparency(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, void ASurfaceTransaction_setBufferTransparency(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, enum ASurfaceTransactionTransparency transparency) __INTRODUCED_IN(29); Loading @@ -464,9 +471,10 @@ void ASurfaceTransaction_setBufferTransparency(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setDamageRegion(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, const ARect rects[], uint32_t count) __INTRODUCED_IN(29); void ASurfaceTransaction_setDamageRegion(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, const ARect* _Nullable rects, uint32_t count) __INTRODUCED_IN(29); /** * Specifies a desiredPresentTime for the transaction. The framework will try to present Loading @@ -480,7 +488,7 @@ void ASurfaceTransaction_setDamageRegion(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setDesiredPresentTime(ASurfaceTransaction* transaction, void ASurfaceTransaction_setDesiredPresentTime(ASurfaceTransaction* _Nonnull transaction, int64_t desiredPresentTime) __INTRODUCED_IN(29); /** Loading @@ -490,8 +498,8 @@ void ASurfaceTransaction_setDesiredPresentTime(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setBufferAlpha(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, float alpha) void ASurfaceTransaction_setBufferAlpha(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float alpha) __INTRODUCED_IN(29); /** Loading @@ -501,9 +509,9 @@ void ASurfaceTransaction_setBufferAlpha(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setBufferDataSpace(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, enum ADataSpace data_space) __INTRODUCED_IN(29); void ASurfaceTransaction_setBufferDataSpace(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, enum ADataSpace data_space) __INTRODUCED_IN(29); /** * SMPTE ST 2086 "Mastering Display Color Volume" static metadata Loading @@ -513,9 +521,9 @@ void ASurfaceTransaction_setBufferDataSpace(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setHdrMetadata_smpte2086(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, struct AHdrMetadata_smpte2086* metadata) void ASurfaceTransaction_setHdrMetadata_smpte2086(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, struct AHdrMetadata_smpte2086* _Nullable metadata) __INTRODUCED_IN(29); /** Loading @@ -526,9 +534,9 @@ void ASurfaceTransaction_setHdrMetadata_smpte2086(ASurfaceTransaction* transacti * * Available since API level 29. */ void ASurfaceTransaction_setHdrMetadata_cta861_3(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, struct AHdrMetadata_cta861_3* metadata) void ASurfaceTransaction_setHdrMetadata_cta861_3(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, struct AHdrMetadata_cta861_3* _Nullable metadata) __INTRODUCED_IN(29); /** Loading Loading @@ -578,10 +586,10 @@ void ASurfaceTransaction_setHdrMetadata_cta861_3(ASurfaceTransaction* transactio * * Available since API level 34. */ void ASurfaceTransaction_setExtendedRangeBrightness(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, float currentBufferRatio, float desiredRatio) __INTRODUCED_IN(__ANDROID_API_U__); void ASurfaceTransaction_setExtendedRangeBrightness(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float currentBufferRatio, float desiredRatio) __INTRODUCED_IN(__ANDROID_API_U__); /** * Sets the desired HDR headroom for the layer. See: ASurfaceTransaction_setExtendedRangeBrightness, Loading Loading @@ -617,8 +625,8 @@ void ASurfaceTransaction_setExtendedRangeBrightness(ASurfaceTransaction* transac * * Available since API level 35. */ void ASurfaceTransaction_setDesiredHdrHeadroom(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, void ASurfaceTransaction_setDesiredHdrHeadroom(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float desiredHeadroom) __INTRODUCED_IN(__ANDROID_API_V__); Loading @@ -630,8 +638,8 @@ void ASurfaceTransaction_setDesiredHdrHeadroom(ASurfaceTransaction* transaction, * * Available since API level 30. */ void ASurfaceTransaction_setFrameRate(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, float frameRate, void ASurfaceTransaction_setFrameRate(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float frameRate, int8_t compatibility) __INTRODUCED_IN(30); /** Loading Loading @@ -666,9 +674,10 @@ void ASurfaceTransaction_setFrameRate(ASurfaceTransaction* transaction, * * Available since API level 31. */ void ASurfaceTransaction_setFrameRateWithChangeStrategy(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, float frameRate, int8_t compatibility, int8_t changeFrameRateStrategy) void ASurfaceTransaction_setFrameRateWithChangeStrategy(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float frameRate, int8_t compatibility, int8_t changeFrameRateStrategy) __INTRODUCED_IN(31); /** Loading @@ -692,8 +701,8 @@ void ASurfaceTransaction_setFrameRateWithChangeStrategy(ASurfaceTransaction* tra * * Available since API level 34. */ void ASurfaceTransaction_clearFrameRate(ASurfaceTransaction* transaction, ASurfaceControl* surface_control) void ASurfaceTransaction_clearFrameRate(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control) __INTRODUCED_IN(__ANDROID_API_U__); /** Loading Loading @@ -722,10 +731,9 @@ void ASurfaceTransaction_clearFrameRate(ASurfaceTransaction* transaction, * \param surface_control The ASurfaceControl on which to control buffer backpressure behavior. * \param enableBackPressure Whether to enable back pressure. */ void ASurfaceTransaction_setEnableBackPressure(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, bool enableBackPressure) __INTRODUCED_IN(31); void ASurfaceTransaction_setEnableBackPressure(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, bool enableBackPressure) __INTRODUCED_IN(31); /** * Sets the frame timeline to use in SurfaceFlinger. Loading @@ -745,7 +753,7 @@ void ASurfaceTransaction_setEnableBackPressure(ASurfaceTransaction* transaction, * to the corresponding expected presentation time and deadline from the frame to be rendered. A * stale or invalid value will be ignored. */ void ASurfaceTransaction_setFrameTimeline(ASurfaceTransaction* transaction, void ASurfaceTransaction_setFrameTimeline(ASurfaceTransaction* _Nonnull transaction, AVsyncId vsyncId) __INTRODUCED_IN(33); __END_DECLS Loading Loading
include/android/surface_control.h +114 −106 Original line number Diff line number Diff line Loading @@ -62,7 +62,8 @@ typedef struct ASurfaceControl ASurfaceControl; * * Available since API level 29. */ ASurfaceControl* ASurfaceControl_createFromWindow(ANativeWindow* parent, const char* debug_name) ASurfaceControl* _Nullable ASurfaceControl_createFromWindow(ANativeWindow* _Nonnull parent, const char* _Nonnull debug_name) __INTRODUCED_IN(29); /** Loading @@ -70,7 +71,8 @@ ASurfaceControl* ASurfaceControl_createFromWindow(ANativeWindow* parent, const c * * Available since API level 29. */ ASurfaceControl* ASurfaceControl_create(ASurfaceControl* parent, const char* debug_name) ASurfaceControl* _Nullable ASurfaceControl_create(ASurfaceControl* _Nonnull parent, const char* _Nonnull debug_name) __INTRODUCED_IN(29); /** Loading @@ -81,7 +83,7 @@ ASurfaceControl* ASurfaceControl_create(ASurfaceControl* parent, const char* deb * * Available since API level 31. */ void ASurfaceControl_acquire(ASurfaceControl* surface_control) __INTRODUCED_IN(31); void ASurfaceControl_acquire(ASurfaceControl* _Nonnull surface_control) __INTRODUCED_IN(31); /** * Removes a reference that was previously acquired with one of the following functions: Loading @@ -92,7 +94,7 @@ void ASurfaceControl_acquire(ASurfaceControl* surface_control) __INTRODUCED_IN(3 * * Available since API level 29. */ void ASurfaceControl_release(ASurfaceControl* surface_control) __INTRODUCED_IN(29); void ASurfaceControl_release(ASurfaceControl* _Nonnull surface_control) __INTRODUCED_IN(29); struct ASurfaceTransaction; Loading @@ -108,14 +110,14 @@ typedef struct ASurfaceTransaction ASurfaceTransaction; * * Available since API level 29. */ ASurfaceTransaction* ASurfaceTransaction_create() __INTRODUCED_IN(29); ASurfaceTransaction* _Nonnull ASurfaceTransaction_create() __INTRODUCED_IN(29); /** * Destroys the \a transaction object. * * Available since API level 29. */ void ASurfaceTransaction_delete(ASurfaceTransaction* transaction) __INTRODUCED_IN(29); void ASurfaceTransaction_delete(ASurfaceTransaction* _Nullable transaction) __INTRODUCED_IN(29); /** * Applies the updates accumulated in \a transaction. Loading @@ -126,7 +128,7 @@ void ASurfaceTransaction_delete(ASurfaceTransaction* transaction) __INTRODUCED_I * * Available since API level 29. */ void ASurfaceTransaction_apply(ASurfaceTransaction* transaction) __INTRODUCED_IN(29); void ASurfaceTransaction_apply(ASurfaceTransaction* _Nonnull transaction) __INTRODUCED_IN(29); /** * An opaque handle returned during a callback that can be used to query general stats and stats for Loading Loading @@ -154,10 +156,10 @@ typedef struct ASurfaceTransactionStats ASurfaceTransactionStats; * * Available since API level 29. */ typedef void (*ASurfaceTransaction_OnComplete)(void* context, ASurfaceTransactionStats* stats) typedef void (*ASurfaceTransaction_OnComplete)(void* _Null_unspecified context, ASurfaceTransactionStats* _Nonnull stats) __INTRODUCED_IN(29); /** * The ASurfaceTransaction_OnCommit callback is invoked when transaction is applied and the updates * are ready to be presented. This callback will be invoked before the Loading @@ -183,7 +185,8 @@ typedef void (*ASurfaceTransaction_OnComplete)(void* context, ASurfaceTransactio * * Available since API level 31. */ typedef void (*ASurfaceTransaction_OnCommit)(void* context, ASurfaceTransactionStats* stats) typedef void (*ASurfaceTransaction_OnCommit)(void* _Null_unspecified context, ASurfaceTransactionStats* _Nonnull stats) __INTRODUCED_IN(31); /** Loading @@ -192,8 +195,8 @@ typedef void (*ASurfaceTransaction_OnCommit)(void* context, ASurfaceTransactionS * * Available since API level 29. */ int64_t ASurfaceTransactionStats_getLatchTime(ASurfaceTransactionStats* surface_transaction_stats) __INTRODUCED_IN(29); int64_t ASurfaceTransactionStats_getLatchTime( ASurfaceTransactionStats* _Nonnull surface_transaction_stats) __INTRODUCED_IN(29); /** * Returns a sync fence that signals when the transaction has been presented. Loading @@ -204,8 +207,8 @@ int64_t ASurfaceTransactionStats_getLatchTime(ASurfaceTransactionStats* surface_ * * Available since API level 29. */ int ASurfaceTransactionStats_getPresentFenceFd(ASurfaceTransactionStats* surface_transaction_stats) __INTRODUCED_IN(29); int ASurfaceTransactionStats_getPresentFenceFd( ASurfaceTransactionStats* _Nonnull surface_transaction_stats) __INTRODUCED_IN(29); /** * \a outASurfaceControls returns an array of ASurfaceControl pointers that were updated during the Loading @@ -217,18 +220,18 @@ int ASurfaceTransactionStats_getPresentFenceFd(ASurfaceTransactionStats* surface * * \a outASurfaceControlsSize returns the size of the ASurfaceControls array. */ void ASurfaceTransactionStats_getASurfaceControls(ASurfaceTransactionStats* surface_transaction_stats, ASurfaceControl*** outASurfaceControls, size_t* outASurfaceControlsSize) __INTRODUCED_IN(29); void ASurfaceTransactionStats_getASurfaceControls( ASurfaceTransactionStats* _Nonnull surface_transaction_stats, ASurfaceControl* _Nullable* _Nullable* _Nonnull outASurfaceControls, size_t* _Nonnull outASurfaceControlsSize) __INTRODUCED_IN(29); /** * Releases the array of ASurfaceControls that were returned by * ASurfaceTransactionStats_getASurfaceControls(). * * Available since API level 29. */ void ASurfaceTransactionStats_releaseASurfaceControls(ASurfaceControl** surface_controls) __INTRODUCED_IN(29); void ASurfaceTransactionStats_releaseASurfaceControls( ASurfaceControl* _Nonnull* _Nonnull surface_controls) __INTRODUCED_IN(29); /** * Returns the timestamp of when the CURRENT buffer was acquired. A buffer is considered Loading @@ -241,9 +244,9 @@ void ASurfaceTransactionStats_releaseASurfaceControls(ASurfaceControl** surface_ * fence has signaled, depending on internal timing differences. Therefore the caller should * use the acquire fence passed in to setBuffer and query the signal time. */ int64_t ASurfaceTransactionStats_getAcquireTime(ASurfaceTransactionStats* surface_transaction_stats, ASurfaceControl* surface_control) __INTRODUCED_IN(29); int64_t ASurfaceTransactionStats_getAcquireTime( ASurfaceTransactionStats* _Nonnull surface_transaction_stats, ASurfaceControl* _Nonnull surface_control) __INTRODUCED_IN(29); /** * The returns the fence used to signal the release of the PREVIOUS buffer set on Loading @@ -268,9 +271,8 @@ int64_t ASurfaceTransactionStats_getAcquireTime(ASurfaceTransactionStats* surfac * Available since API level 29. */ int ASurfaceTransactionStats_getPreviousReleaseFenceFd( ASurfaceTransactionStats* surface_transaction_stats, ASurfaceControl* surface_control) __INTRODUCED_IN(29); ASurfaceTransactionStats* _Nonnull surface_transaction_stats, ASurfaceControl* _Nonnull surface_control) __INTRODUCED_IN(29); /** * Sets the callback that will be invoked when the updates from this transaction Loading @@ -279,8 +281,10 @@ int ASurfaceTransactionStats_getPreviousReleaseFenceFd( * * Available since API level 29. */ void ASurfaceTransaction_setOnComplete(ASurfaceTransaction* transaction, void* context, ASurfaceTransaction_OnComplete func) __INTRODUCED_IN(29); void ASurfaceTransaction_setOnComplete(ASurfaceTransaction* _Nonnull transaction, void* _Null_unspecified context, ASurfaceTransaction_OnComplete _Nonnull func) __INTRODUCED_IN(29); /** * Sets the callback that will be invoked when the updates from this transaction are applied and are Loading @@ -289,8 +293,10 @@ void ASurfaceTransaction_setOnComplete(ASurfaceTransaction* transaction, void* c * * Available since API level 31. */ void ASurfaceTransaction_setOnCommit(ASurfaceTransaction* transaction, void* context, ASurfaceTransaction_OnCommit func) __INTRODUCED_IN(31); void ASurfaceTransaction_setOnCommit(ASurfaceTransaction* _Nonnull transaction, void* _Null_unspecified context, ASurfaceTransaction_OnCommit _Nonnull func) __INTRODUCED_IN(31); /** * Reparents the \a surface_control from its old parent to the \a new_parent surface control. Loading @@ -300,9 +306,9 @@ void ASurfaceTransaction_setOnCommit(ASurfaceTransaction* transaction, void* con * * Available since API level 29. */ void ASurfaceTransaction_reparent(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, ASurfaceControl* new_parent) __INTRODUCED_IN(29); void ASurfaceTransaction_reparent(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, ASurfaceControl* _Nullable new_parent) __INTRODUCED_IN(29); /** * Parameter for ASurfaceTransaction_setVisibility(). Loading @@ -318,8 +324,8 @@ enum ASurfaceTransactionVisibility : int8_t { * * Available since API level 29. */ void ASurfaceTransaction_setVisibility(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, void ASurfaceTransaction_setVisibility(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, enum ASurfaceTransactionVisibility visibility) __INTRODUCED_IN(29); Loading @@ -332,8 +338,8 @@ void ASurfaceTransaction_setVisibility(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setZOrder(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, int32_t z_order) void ASurfaceTransaction_setZOrder(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, int32_t z_order) __INTRODUCED_IN(29); /** Loading @@ -349,9 +355,10 @@ void ASurfaceTransaction_setZOrder(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setBuffer(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, AHardwareBuffer* buffer, int acquire_fence_fd) __INTRODUCED_IN(29); void ASurfaceTransaction_setBuffer(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, AHardwareBuffer* _Nonnull buffer, int acquire_fence_fd) __INTRODUCED_IN(29); /** * Updates the color for \a surface_control. This will make the background color for the Loading @@ -361,9 +368,9 @@ void ASurfaceTransaction_setBuffer(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setColor(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, float r, float g, float b, float alpha, enum ADataSpace dataspace) void ASurfaceTransaction_setColor(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float r, float g, float b, float alpha, enum ADataSpace dataspace) __INTRODUCED_IN(29); /** Loading @@ -371,13 +378,13 @@ void ASurfaceTransaction_setColor(ASurfaceTransaction* transaction, * The surface's source rect is clipped by the bounds of its current buffer. The source rect's width * and height must be > 0. * * \param destination Specifies the rect in the parent's space where this surface will be drawn. The post * source rect bounds are scaled to fit the destination rect. The surface's destination rect is * \param destination Specifies the rect in the parent's space where this surface will be drawn. The * post source rect bounds are scaled to fit the destination rect. The surface's destination rect is * clipped by the bounds of its parent. The destination rect's width and height must be > 0. * * \param transform The transform applied after the source rect is applied to the buffer. This parameter * should be set to 0 for no transform. To specify a transfrom use the NATIVE_WINDOW_TRANSFORM_* * enum. * \param transform The transform applied after the source rect is applied to the buffer. This * parameter should be set to 0 for no transform. To specify a transfrom use the * NATIVE_WINDOW_TRANSFORM_* enum. * * Available since API level 29. * Loading @@ -386,8 +393,8 @@ void ASurfaceTransaction_setColor(ASurfaceTransaction* transaction, * to set different properties at different times, instead of having to specify all the desired * properties at once. */ void ASurfaceTransaction_setGeometry(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, const ARect& source, void ASurfaceTransaction_setGeometry(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, const ARect& source, const ARect& destination, int32_t transform) __INTRODUCED_IN(29); Loading @@ -400,8 +407,8 @@ void ASurfaceTransaction_setGeometry(ASurfaceTransaction* transaction, * * Available since API level 31. */ void ASurfaceTransaction_setCrop(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, const ARect& crop) void ASurfaceTransaction_setCrop(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, const ARect& crop) __INTRODUCED_IN(31); /** Loading @@ -412,9 +419,9 @@ void ASurfaceTransaction_setCrop(ASurfaceTransaction* transaction, * * Available since API level 31. */ void ASurfaceTransaction_setPosition(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, int32_t x, int32_t y) __INTRODUCED_IN(31); void ASurfaceTransaction_setPosition(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, int32_t x, int32_t y) __INTRODUCED_IN(31); /** * \param transform The transform applied after the source rect is applied to the buffer. This Loading @@ -423,9 +430,9 @@ void ASurfaceTransaction_setPosition(ASurfaceTransaction* transaction, * * Available since API level 31. */ void ASurfaceTransaction_setBufferTransform(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, int32_t transform) __INTRODUCED_IN(31); void ASurfaceTransaction_setBufferTransform(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, int32_t transform) __INTRODUCED_IN(31); /** * Sets an x and y scale of a surface with (0, 0) as the centerpoint of the scale. Loading @@ -435,9 +442,9 @@ void ASurfaceTransaction_setBufferTransform(ASurfaceTransaction* transaction, * * Available since API level 31. */ void ASurfaceTransaction_setScale(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, float xScale, float yScale) __INTRODUCED_IN(31); void ASurfaceTransaction_setScale(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float xScale, float yScale) __INTRODUCED_IN(31); /** * Parameter for ASurfaceTransaction_setBufferTransparency(). */ Loading @@ -453,8 +460,8 @@ enum ASurfaceTransactionTransparency : int8_t { * * Available since API level 29. */ void ASurfaceTransaction_setBufferTransparency(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, void ASurfaceTransaction_setBufferTransparency(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, enum ASurfaceTransactionTransparency transparency) __INTRODUCED_IN(29); Loading @@ -464,9 +471,10 @@ void ASurfaceTransaction_setBufferTransparency(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setDamageRegion(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, const ARect rects[], uint32_t count) __INTRODUCED_IN(29); void ASurfaceTransaction_setDamageRegion(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, const ARect* _Nullable rects, uint32_t count) __INTRODUCED_IN(29); /** * Specifies a desiredPresentTime for the transaction. The framework will try to present Loading @@ -480,7 +488,7 @@ void ASurfaceTransaction_setDamageRegion(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setDesiredPresentTime(ASurfaceTransaction* transaction, void ASurfaceTransaction_setDesiredPresentTime(ASurfaceTransaction* _Nonnull transaction, int64_t desiredPresentTime) __INTRODUCED_IN(29); /** Loading @@ -490,8 +498,8 @@ void ASurfaceTransaction_setDesiredPresentTime(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setBufferAlpha(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, float alpha) void ASurfaceTransaction_setBufferAlpha(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float alpha) __INTRODUCED_IN(29); /** Loading @@ -501,9 +509,9 @@ void ASurfaceTransaction_setBufferAlpha(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setBufferDataSpace(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, enum ADataSpace data_space) __INTRODUCED_IN(29); void ASurfaceTransaction_setBufferDataSpace(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, enum ADataSpace data_space) __INTRODUCED_IN(29); /** * SMPTE ST 2086 "Mastering Display Color Volume" static metadata Loading @@ -513,9 +521,9 @@ void ASurfaceTransaction_setBufferDataSpace(ASurfaceTransaction* transaction, * * Available since API level 29. */ void ASurfaceTransaction_setHdrMetadata_smpte2086(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, struct AHdrMetadata_smpte2086* metadata) void ASurfaceTransaction_setHdrMetadata_smpte2086(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, struct AHdrMetadata_smpte2086* _Nullable metadata) __INTRODUCED_IN(29); /** Loading @@ -526,9 +534,9 @@ void ASurfaceTransaction_setHdrMetadata_smpte2086(ASurfaceTransaction* transacti * * Available since API level 29. */ void ASurfaceTransaction_setHdrMetadata_cta861_3(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, struct AHdrMetadata_cta861_3* metadata) void ASurfaceTransaction_setHdrMetadata_cta861_3(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, struct AHdrMetadata_cta861_3* _Nullable metadata) __INTRODUCED_IN(29); /** Loading Loading @@ -578,10 +586,10 @@ void ASurfaceTransaction_setHdrMetadata_cta861_3(ASurfaceTransaction* transactio * * Available since API level 34. */ void ASurfaceTransaction_setExtendedRangeBrightness(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, float currentBufferRatio, float desiredRatio) __INTRODUCED_IN(__ANDROID_API_U__); void ASurfaceTransaction_setExtendedRangeBrightness(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float currentBufferRatio, float desiredRatio) __INTRODUCED_IN(__ANDROID_API_U__); /** * Sets the desired HDR headroom for the layer. See: ASurfaceTransaction_setExtendedRangeBrightness, Loading Loading @@ -617,8 +625,8 @@ void ASurfaceTransaction_setExtendedRangeBrightness(ASurfaceTransaction* transac * * Available since API level 35. */ void ASurfaceTransaction_setDesiredHdrHeadroom(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, void ASurfaceTransaction_setDesiredHdrHeadroom(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float desiredHeadroom) __INTRODUCED_IN(__ANDROID_API_V__); Loading @@ -630,8 +638,8 @@ void ASurfaceTransaction_setDesiredHdrHeadroom(ASurfaceTransaction* transaction, * * Available since API level 30. */ void ASurfaceTransaction_setFrameRate(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, float frameRate, void ASurfaceTransaction_setFrameRate(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float frameRate, int8_t compatibility) __INTRODUCED_IN(30); /** Loading Loading @@ -666,9 +674,10 @@ void ASurfaceTransaction_setFrameRate(ASurfaceTransaction* transaction, * * Available since API level 31. */ void ASurfaceTransaction_setFrameRateWithChangeStrategy(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, float frameRate, int8_t compatibility, int8_t changeFrameRateStrategy) void ASurfaceTransaction_setFrameRateWithChangeStrategy(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, float frameRate, int8_t compatibility, int8_t changeFrameRateStrategy) __INTRODUCED_IN(31); /** Loading @@ -692,8 +701,8 @@ void ASurfaceTransaction_setFrameRateWithChangeStrategy(ASurfaceTransaction* tra * * Available since API level 34. */ void ASurfaceTransaction_clearFrameRate(ASurfaceTransaction* transaction, ASurfaceControl* surface_control) void ASurfaceTransaction_clearFrameRate(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control) __INTRODUCED_IN(__ANDROID_API_U__); /** Loading Loading @@ -722,10 +731,9 @@ void ASurfaceTransaction_clearFrameRate(ASurfaceTransaction* transaction, * \param surface_control The ASurfaceControl on which to control buffer backpressure behavior. * \param enableBackPressure Whether to enable back pressure. */ void ASurfaceTransaction_setEnableBackPressure(ASurfaceTransaction* transaction, ASurfaceControl* surface_control, bool enableBackPressure) __INTRODUCED_IN(31); void ASurfaceTransaction_setEnableBackPressure(ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, bool enableBackPressure) __INTRODUCED_IN(31); /** * Sets the frame timeline to use in SurfaceFlinger. Loading @@ -745,7 +753,7 @@ void ASurfaceTransaction_setEnableBackPressure(ASurfaceTransaction* transaction, * to the corresponding expected presentation time and deadline from the frame to be rendered. A * stale or invalid value will be ignored. */ void ASurfaceTransaction_setFrameTimeline(ASurfaceTransaction* transaction, void ASurfaceTransaction_setFrameTimeline(ASurfaceTransaction* _Nonnull transaction, AVsyncId vsyncId) __INTRODUCED_IN(33); __END_DECLS Loading