---
title: PixelLuminanceMetric
framework: metrickit
role: symbol
role_heading: Structure
path: metrickit/pixelluminancemetric
---

# PixelLuminanceMetric

A metric that measures the average luminosity of pixels on an OLED display.

## Declaration

```swift
struct PixelLuminanceMetric
```

## Discussion

Discussion This metric corresponds to the MetricResult.pixelLuminance(_:) case. It appears only in intervalEntries and is not included in state entries. Average pixel luminance (APL) is expressed as a value from 0 to 100 in increments of 1. This metric is only available on devices with OLED displays. On other device types, no value is reported. This type replaces the averagePixelLuminance property of MXDisplayMetric.

## Topics

### Measurements

- [value](metrickit/pixelluminancemetric/value.md)

## Relationships

### Conforms To

- [Decodable](swift/decodable.md)
- [Encodable](swift/encodable.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### GPU and display metrics

- [GPUTimeMetric](metrickit/gputimemetric.md)
- [MetalFrameRateMetric](metrickit/metalframeratemetric.md)
- [AveragePixelLuminance](metrickit/averagepixelluminance.md)