---
title: cp_frame_query_drawable
framework: compositorservices
role: symbol
role_heading: Function
path: compositorservices/cp_frame_query_drawable
---

# cp_frame_query_drawable

Returns the drawable type you use to retrieve the textures and drawing environment for the frame.

## Declaration

```occ
cp_drawable_tcp_frame_query_drawable(cp_frame_t frame);
```

## Parameters

- `frame`: The frame to query.

## Return Value

Return Value The drawable type, or nil if the layer is in the LayerRenderer.State.paused or LayerRenderer.State.invalidated state.

## Discussion

Discussion Fetch the drawable when you’re ready to encode the drawing commands for the frame. The cp_drawable_t type contains the textures and other information you need to set up your render descriptor in Metal.