<!--
{
  "documentType" : "article",
  "framework" : "Xcode",
  "identifier" : "/documentation/Xcode/Inspecting-pipeline-states",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Inspecting pipeline states"
}
-->

# Inspecting pipeline states

Determine how your render and compute passes behave by examining their properties.

## Overview

The Metal debugger allows you to inspect a pipeline state with the Pipeline State viewer.
Double-click a pipeline state to open it and view its associated properties in a table.

![A screenshot of the Pipeline State viewer displaying the pipeline state’s properties hierarchically.](images/com.apple.Xcode/gputools-metal-debugger-psov-overview.png)

In the screenshot above, the name of the pipeline state, G-buffer Creation, appears above the table.
To the right of the name, you can click the Reveal in Memory button or the Reveal in Timeline button to open the Memory viewer or the Performance timeline, respectively, which both highlight the pipeline state.

The table displays the properties of your pipeline state in a logical hierarchy.
Click the disclosure controls on the left to expand the groups to view more information.
Using the table, you can quickly inspect the properties of <doc://com.apple.documentation/documentation/Metal/MTLRenderPipelineState> or <doc://com.apple.documentation/documentation/Metal/MTLComputePipelineState>.

### Limit your scope with filters

Use the filter field at the bottom of the Pipeline State viewer to adjust the filtering criteria by typing filter terms into it.
Then the table displays the related pipeline state properties that match the filter terms, and highlights the matches.

![A screenshot of the Pipeline State viewer filtering for the term pixel. The list displays the matching properties hierarchically.](images/com.apple.Xcode/gputools-metal-debugger-psov-filter.png)

When there are two or more filter terms, you can click the filter button to choose whether to match any or all of the terms.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)