---
title: "step(byDecodeTime:wasPinned:)"
framework: avfoundation
role: symbol
role_heading: Instance Method
path: "avfoundation/avsamplecursor/step(bydecodetime:waspinned:)"
---

# step(byDecodeTime:wasPinned:)

Moves the cursor by a given delta time on the decode timeline.

## Declaration

```swift
func step(byDecodeTime deltaDecodeTime: CMTime, wasPinned outWasPinned: UnsafeMutablePointer<ObjCBool>?) -> CMTime
```

## Parameters

- `deltaDecodeTime`: The amount of time to move in the decode timeline.
- `outWasPinned`: The system sets the value of this pointer to doc://com.apple.documentation/documentation/Swift/true if the cursor reaches the beginning or the end of the sample sequence before it reaches the requested time. You may specify nil if you’re not interested in this information.

## Return Value

Return Value The amount of time the cursor was moved along the decode timeline. Because sample cursors snap to sample boundaries when stepped, this value may not be equal to the specified time delta even if the cursor wasn’t pinned.

## See Also

### Navigating samples

- [step(byPresentationTime:wasPinned:)](avfoundation/avsamplecursor/step(bypresentationtime:waspinned:).md)
- [stepInDecodeOrder(byCount:)](avfoundation/avsamplecursor/stepindecodeorder(bycount:).md)
- [stepInPresentationOrder(byCount:)](avfoundation/avsamplecursor/stepinpresentationorder(bycount:).md)