Supported levels of detail for a request.
On iOS, only one detail level -- `.reduced` -- is currently supported. This level is optimized
for generation and viewing entirely on mobile devices.
On macOS, RealityKit object creation can generate models at different levels of detail. Higher
levels of detail may take longer to create, require more memory and processing power to generate,
and create objects with more complex geometry and texture requirements.
### Set a Level of Complexity
Each detail level corresponds to an object of a specific size and complexity. Here’s
the expected final size of the generated object from each detail level.
| Detail Level | Triangles | Estimated File Size |
| ------------ | --------- | ------------------- |
| `.preview` | <25k | ≈5MB |
| `.reduced` | <50k | ≈10MB |
| `.medium` | <100k | ≈30MB |
| `.full` | <250k | ≈100MB |
| `.raw` | <30M | Varies |
| `.custom` | Varies | Varies |
### Create Texture Maps
Each detail level produces a 3D object with texture maps. The higher the complexity
level, the larger the generated texture maps, and the more memory the system requires
to display those objects in an AR scene.
RealityKit creates five texture maps at the `.full` detail level: a single diffuse
map, normal map, ambient occlusion map, roughness map, and displacement map. For
`.preview`, `.reduced`, and `.medium` detail levels, it produces just the single
diffuse, normal and ambient occlusion maps.
When producing a model at the `.raw` detail level, only diffuse texture maps are
created, but RealityKit may create up to 16 diffuse maps, each covering different
parts of the model. Raw models are produced at the highest resolution possible from
the source images, so they don’t benefit from having the other types of texture maps,
which are used to supplement a low-resolution model with data from a higher-resolution
version of the same model.
Raw models aren’t suitable for use in an AR scene and you should only use this setting
if you plan to export the model to a 3D software package.
Custom detail level can be used to specify several parameters of the output mesh and textures
to provide more control over the produced assets than the preset levels.
Here are the texture map sizes generated for each detail level and the amount of
texture memory the uncompressed textures use at runtime.
| Detail Level | Texture Size | Texture Memory Required |
| ------------ | ------------ | ----------------------- |
| `.preview` | 1024 x 1024 | 10.666667 MB |
| `.reduced` | 2048 x 2048 | 42.666667 MB |
| `.medium` | 4096 x 4096 | 170.666667 MB |
| `.full` | 8192 x 8192 | 853.33333 MB |
| `.raw` | 8192 x 8192 (multiple) | Varies |
| `.custom` | Varies | Varies |
Creates a new instance with the specified raw value.
If there is no value of the type that corresponds with the specified raw
value, this initializer returns `nil`. For example:
enum PaperSize: String {
case A4, A5, Letter, Legal
}
print(PaperSize(rawValue: "Legal"))
// Prints "Optional(PaperSize.Legal)"
print(PaperSize(rawValue: "Tabloid"))
// Prints "nil"
- Parameter rawValue: The raw value to use for the new instance.
get · iOS 17.0+
rawValue
TypeScript
getRawValue($self: PhotogrammetrySession_Request_Detail): number
Swift declaration
var rawValue: Int { get }
The corresponding value of the raw type.
A new instance initialized with `rawValue` will be equivalent to this
instance. For example:
enum PaperSize: String {
case A4, A5, Letter, Legal
}
let selectedSize = PaperSize.Letter
print(selectedSize.rawValue)
// Prints "Letter"
print(selectedSize == PaperSize(rawValue: selectedSize.rawValue)!)
// Prints "true"
