---
title: USDLayer
framework: usdkit
role: symbol
role_heading: Structure
path: usdkit/usdlayer
---

# USDLayer

A single USD document that stores scene description in a file or in memory.

## Declaration

```swift
struct USDLayer
```

## Topics

### Creating a layer

- [init(displayName:)](usdkit/usdlayer/init(displayname:).md)

### Opening and finding layers

- [find(identifier:)](usdkit/usdlayer/find(identifier:).md)
- [open(_:options:)](usdkit/usdlayer/open(_:options:).md)
- [USDLayer.OpenOptions](usdkit/usdlayer/openoptions.md)
- [USDLayer.Permission](usdkit/usdlayer/permission.md)

### Saving and reloading

- [save()](usdkit/usdlayer/save().md)
- [reload()](usdkit/usdlayer/reload().md)
- [clear()](usdkit/usdlayer/clear().md)

### Exporting and importing

- [export(to:)](usdkit/usdlayer/export(to:)-7vouy.md)
- [export(to:)](usdkit/usdlayer/export(to:)-5hboj.md)
- [importContents(from:)](usdkit/usdlayer/importcontents(from:)-2ipug.md)
- [importContents(from:)](usdkit/usdlayer/importcontents(from:)-99hnf.md)

### Inspecting identity and state

- [identifier](usdkit/usdlayer/identifier.md)
- [resolvedPath](usdkit/usdlayer/resolvedpath.md)
- [displayName](usdkit/usdlayer/displayname.md)
- [isAnonymous](usdkit/usdlayer/isanonymous.md)
- [isValid](usdkit/usdlayer/isvalid.md)
- [isDirty](usdkit/usdlayer/isdirty.md)
- [isMuted](usdkit/usdlayer/ismuted.md)

### Composing the scene

- [defaultPrim](usdkit/usdlayer/defaultprim.md)
- [subLayerPaths](usdkit/usdlayer/sublayerpaths.md)
- [USDLayer.AssetPath](usdkit/usdlayer/assetpath.md)

### Accessing scene description by path

- [prim(at:)](usdkit/usdlayer/prim(at:).md)
- [property(at:)](usdkit/usdlayer/property(at:).md)
- [attribute(at:)](usdkit/usdlayer/attribute(at:).md)
- [relationship(at:)](usdkit/usdlayer/relationship(at:).md)
- [spec(at:)](usdkit/usdlayer/spec(at:).md)
- [specType(at:)](usdkit/usdlayer/spectype(at:).md)
- [traverse(at:_:)](usdkit/usdlayer/traverse(at:_:).md)
- [USDLayer.Path](usdkit/usdlayer/path.md)
- [USDLayer.PathExpression](usdkit/usdlayer/pathexpression.md)
- [USDLayer.Spec](usdkit/usdlayer/spec.md)
- [USDLayer.SpecType](usdkit/usdlayer/spectype.md)

### Reading and authoring fields

- [field(at:name:)](usdkit/usdlayer/field(at:name:).md)
- [fields(at:)](usdkit/usdlayer/fields(at:).md)
- [setField(at:name:value:)](usdkit/usdlayer/setfield(at:name:value:)-83nwe.md)
- [setField(at:name:value:)](usdkit/usdlayer/setfield(at:name:value:)-3242k.md)

### Working with time samples

- [timeSample(at:time:)](usdkit/usdlayer/timesample(at:time:).md)
- [timeSamples(at:)](usdkit/usdlayer/timesamples(at:).md)
- [allTimeSamples](usdkit/usdlayer/alltimesamples.md)
- [setTimeSample(at:time:value:)](usdkit/usdlayer/settimesample(at:time:value:)-6t3qd.md)
- [setTimeSample(at:time:value:)](usdkit/usdlayer/settimesample(at:time:value:)-3ot1j.md)
- [eraseTimeSample(at:time:)](usdkit/usdlayer/erasetimesample(at:time:).md)

### Setting the time range

- [startTimeCode](usdkit/usdlayer/starttimecode.md)
- [endTimeCode](usdkit/usdlayer/endtimecode.md)
- [timeCodesPerSecond](usdkit/usdlayer/timecodespersecond.md)
- [USDLayer.TimeCode](usdkit/usdlayer/timecode.md)
- [USDLayer.TimeOffset](usdkit/usdlayer/timeoffset.md)

### Editing scene description

- [copy(from:to:in:)](usdkit/usdlayer/copy(from:to:in:).md)
- [USDLayer.ListOperation](usdkit/usdlayer/listoperation.md)
- [USDLayer.ListOperationType](usdkit/usdlayer/listoperationtype.md)
- [USDLayer.Relocate](usdkit/usdlayer/relocate.md)
- [USDLayer.RelocatesMap](usdkit/usdlayer/relocatesmap.md)
- [USDLayer.ChangeList](usdkit/usdlayer/changelist.md)

## Relationships

### Conforms To

- [Copyable](swift/copyable.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [Hashable](swift/hashable.md)

## See Also

### Essentials

- [USDStage](usdkit/usdstage-4sfi1.md)
- [USDPrim](usdkit/usdprim.md)