# GARSemanticMode

## Summary

| ### Enumerations ||
|---|---|
| `https://developers.google.com/ar/reference/ios/group/GARSemanticMode#garsemanticmode{ https://developers.google.com/ar/reference/ios/group/GARSemanticMode#garsemanticmodedisabled = 0, https://developers.google.com/ar/reference/ios/group/GARSemanticMode#garsemanticmodeenabled = 1 }` | enumDescribes the behavior of the Scene Semantics API. |

## Enumerations

### GARSemanticMode

```
 GARSemanticMode
```
Describes the behavior of the Scene Semantics API.

Scene Semantics uses a machine learning model to label each pixel from the camera feed with a `https://developers.google.com/ar/reference/ios/group/GARSemanticLabel#garsemanticlabel`. See [the Scene Semantics Developer Guide](https://developers.google.com/ar/develop/ios/scene-semantics) for more information.

The Scene Semantics API is currently able to distinguish between outdoor labels specified by `https://developers.google.com/ar/reference/ios/group/GARSemanticLabel#garsemanticlabel`. Usage indoors is currently unsupported and may yield unreliable results. Some ARCore supported devices do not support the Scene Semantics API. Use `https://developers.google.com/ar/reference/ios/category/GARSession(Semantics)#issemanticmodesupported:` to query for support for Scene Semantics. Affected devices are also indicated on the [ARCore supported devices page](https://developers.google.com/ar/devices).

The default value is `https://developers.google.com/ar/reference/ios/group/GARSemanticMode#garsemanticmodedisabled`. Use `https://developers.google.com/ar/reference/ios/category/GARSessionConfiguration(Semantics)#semanticmode` and `https://developers.google.com/ar/reference/ios/interface/GARSession#setconfiguration:error:`to set the desired mode.

| Properties ||
|---|---|
| `GARSemanticModeDisabled` | The Scene Semantics API is not enabled. Calls to `GARFrame::acquireSemanticImage:`, `GARFrame::acquireSemanticConfidenceImage:`, and `GARFrame::fractionForSemanticLabel:error:` will not return valid results. This is the default mode. |
| `GARSemanticModeEnabled` | The Scene Semantics API is enabled. Calls to `GARFrame::acquireSemanticImage:`, `GARFrame::acquireSemanticConfidenceImage:`, and `GARFrame::fractionForSemanticLabel:error:` will return valid results. Use `https://developers.google.com/ar/reference/ios/category/GARSessionConfiguration(Semantics)#semanticmode` and `https://developers.google.com/ar/reference/ios/interface/GARSession#setconfiguration:error:`to set the desired mode. |