# HardwareBufferRenderer.RenderRequest

Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Summary:[Methods](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderRequest#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderRequest#inhmethods)  

# HardwareBufferRenderer.RenderRequest

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/graphics/HardwareBufferRenderer.RenderRequest "View this page in Kotlin")\|Java

`
public

final

class
HardwareBufferRenderer.RenderRequest
`  
`

extends `[Object](https://developer.android.com/reference/java/lang/Object)`


``


`

|---|-------------------------------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.graphics.HardwareBufferRenderer.RenderRequest |

<br />

*** ** * ** ***

Sets the parameters that can be used to control a render request for a[HardwareBufferRenderer](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer). This is not thread-safe and must not be held on to for longer than a single request.

## Summary

|                                                                                                                                                                                                                                                                                                                                                                                           ### Public methods                                                                                                                                                                                                                                                                                                                                                                                           ||
|------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` void`                                                                                                                                  | ` `[draw](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderRequest#draw(java.util.concurrent.Executor,%20java.util.function.Consumer<android.graphics.HardwareBufferRenderer.RenderResult>))`(`[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor, `[Consumer](https://developer.android.com/reference/java/util/function/Consumer)`<`[HardwareBufferRenderer.RenderResult](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderResult)`> renderCallback) ` Syncs the RenderNode tree to the render thread and requests content to be drawn. |
| ` `[HardwareBufferRenderer.RenderRequest](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderRequest) | ` `[setBufferTransform](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderRequest#setBufferTransform(int))`(int bufferTransform) ` Specifies a transform to be applied before content is rendered.                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ` `[HardwareBufferRenderer.RenderRequest](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderRequest) | ` `[setColorSpace](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderRequest#setColorSpace(android.graphics.ColorSpace))`(`[ColorSpace](https://developer.android.com/reference/android/graphics/ColorSpace)` colorSpace) ` Configures the color space which the content should be rendered in.                                                                                                                                                                                                                                                                                                                          |

| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object)          | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object.                                                                                                                                                      | | ` boolean`                                                                     | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one.                                           | | ` void`                                                                        | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.                                                          | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`<?>` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`.                                                                                                                                                | | ` int`                                                                         | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object.                                                                                                                                                 | | ` final void`                                                                  | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor.                                                                                                                            | | ` final void`                                                                  | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor.                                                                                                                         | | ` `[String](https://developer.android.com/reference/java/lang/String)          | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object.                                                                                                                                            | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed.                   | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*.                                                                                             | ||

## Public methods

### draw

Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void draw (Executor executor, 
                Consumer<HardwareBufferRenderer.RenderResult> renderCallback)
```

Syncs the RenderNode tree to the render thread and requests content to be drawn. This[RenderRequest](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderRequest)instance should no longer be used after calling this method. The system internally may reuse instances of[RenderRequest](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderRequest)to reduce allocation churn.

<br />

|                                                                                                                                                                                                                                                               Parameters                                                                                                                                                                                                                                                                ||
|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `executor`       | `Executor`: Executor used to deliver callbacks This value cannot be`null`. <br />                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `renderCallback` | `Consumer`: Callback invoked when rendering is complete. This includes a[RenderResult](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderResult)that provides a[SyncFence](https://developer.android.com/reference/android/hardware/SyncFence)that should be waited upon for completion before consuming the rendered output in the provided[HardwareBuffer](https://developer.android.com/reference/android/hardware/HardwareBuffer)instance. This value cannot be`null`. <br /> |

|                                                                                                                                    Throws                                                                                                                                    ||
|--------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [IllegalStateException](https://developer.android.com/reference/java/lang/IllegalStateException) | if attempt to draw is made when[HardwareBufferRenderer.isClosed()](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer#isClosed())returns true |

### setBufferTransform

Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public HardwareBufferRenderer.RenderRequest setBufferTransform (int bufferTransform)
```

Specifies a transform to be applied before content is rendered. This is useful for pre-rotating content for the current display orientation to increase performance of displaying the associated buffer. This transformation will also adjust the light source position for the specified rotation.

<br />

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              ||
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `bufferTransform` | `int`: Value is[SurfaceControl.BUFFER_TRANSFORM_IDENTITY](https://developer.android.com/reference/android/view/SurfaceControl#BUFFER_TRANSFORM_IDENTITY),[SurfaceControl.BUFFER_TRANSFORM_MIRROR_HORIZONTAL](https://developer.android.com/reference/android/view/SurfaceControl#BUFFER_TRANSFORM_MIRROR_HORIZONTAL),[SurfaceControl.BUFFER_TRANSFORM_MIRROR_VERTICAL](https://developer.android.com/reference/android/view/SurfaceControl#BUFFER_TRANSFORM_MIRROR_VERTICAL),[SurfaceControl.BUFFER_TRANSFORM_ROTATE_90](https://developer.android.com/reference/android/view/SurfaceControl#BUFFER_TRANSFORM_ROTATE_90),[SurfaceControl.BUFFER_TRANSFORM_ROTATE_180](https://developer.android.com/reference/android/view/SurfaceControl#BUFFER_TRANSFORM_ROTATE_180),[SurfaceControl.BUFFER_TRANSFORM_ROTATE_270](https://developer.android.com/reference/android/view/SurfaceControl#BUFFER_TRANSFORM_ROTATE_270), android.view.SurfaceControl.BUFFER_TRANSFORM_MIRROR_HORIZONTAL_ROTATE_90, or android.view.SurfaceControl.BUFFER_TRANSFORM_MIRROR_VERTICAL_ROTATE_90 <br /> |

|                                                                                  Returns                                                                                  ||
|---------------------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [HardwareBufferRenderer.RenderRequest](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderRequest) | This value cannot be`null`. <br /> |

**See also:**

- [SurfaceControl.Transaction.setBufferTransform(SurfaceControl, int)](https://developer.android.com/reference/android/view/SurfaceControl.Transaction#setBufferTransform(android.view.SurfaceControl,%20int))  

### setColorSpace

Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public HardwareBufferRenderer.RenderRequest setColorSpace (ColorSpace colorSpace)
```

Configures the color space which the content should be rendered in. This affects how the framework will interpret the color at each pixel. The color space provided here must be non-null, RGB based and leverage an ICC parametric curve. The min/max values of the components should not reduce the numerical range compared to the previously assigned color space. If left unspecified, the default color space of SRGB will be used.

<br />

|                                                                 Parameters                                                                  ||
|--------------|-------------------------------------------------------------------------------------------------------------------------------|
| `colorSpace` | `ColorSpace`: The color space the content should be rendered in. If null is provided the default of SRGB will be used. <br /> |

|                                                                    Returns                                                                    ||
|---------------------------------------------------------------------------------------------------------------------------------------|--------|
| [HardwareBufferRenderer.RenderRequest](https://developer.android.com/reference/android/graphics/HardwareBufferRenderer.RenderRequest) | <br /> |