<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.0.0 -",
    "macOS: 10.15.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/SimpleMaterial",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation14SimpleMaterialV"
  },
  "title" : "SimpleMaterial"
}
-->

# SimpleMaterial

A basic material that responds to lights in the scene.

```
struct SimpleMaterial
```

## Overview

`SimpleMaterial` responds to both
real and virtual lighting to enhance realism.

Add a `SimpleMaterial` to a model by setting it as one of the
[`materials`](/documentation/RealityKit/ModelComponent/materials) in a [`ModelComponent`](/documentation/RealityKit/ModelComponent).

```swift
let simpleMaterial = SimpleMaterial(
    color: .red, isMetallic: false
)
let model = ModelComponent(
    mesh: .generateBox(size: 1),
    materials: [simpleMaterial]
)
redBoxEntity.components.set(model)
```

For example, a red `SimpleMaterial` that is not metallic, and one that is metallic:

|Not metallic                                                                                                                                                                |Metallic                                                                                                                                                              |
|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|![A screenshot of a red cube in a living room scene. The cube is rounded on the edges and appears to be made of a reflective plastic material.](simplematerial-not-metallic)|![A screenshot of a red cube in a living room scene. The cube is rounded on the edges and appears to be made of a reflective metal material.](simplematerial-metallic)|

## Topics

### Creating a simple material

[`init()`](/documentation/RealityKit/SimpleMaterial/init())

Creates a simple material.

[`init(color:roughness:isMetallic:)`](/documentation/RealityKit/SimpleMaterial/init(color:roughness:isMetallic:)-1ebae)

Creates a simple material with specific characteristics in macOS.

### Characterizing a material

[`color`](/documentation/RealityKit/SimpleMaterial/color)

The material’s color.

[`baseColor`](/documentation/RealityKit/SimpleMaterial/baseColor-swift.property)

The base color of the material.

[`BaseColor`](/documentation/RealityKit/SimpleMaterial/BaseColor-swift.typealias)

The type used to represent base color.

[`tintColor`](/documentation/RealityKit/SimpleMaterial/tintColor-6v03h)

A tint color applied to the base color in macOS.

[`Texture`](/documentation/RealityKit/SimpleMaterial/Texture)

The type used to represent textures.

[`metallic`](/documentation/RealityKit/SimpleMaterial/metallic)

A value that you set to control whether the material has a metallic look.

[`roughness`](/documentation/RealityKit/SimpleMaterial/roughness)

The roughness of the material.

## Relationships

### Conforms To

[`Material`](/documentation/RealityKit/Material)

---

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)