<!--
{
  "availability" : [
    "iOS: 4.0.0 -",
    "iPadOS: 4.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.7.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/AVVideoCompositionLayerInstruction/getTransformRamp(for:start:end:timeRange:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(cs)AVVideoCompositionLayerInstruction(im)getTransformRampForTime:startTransform:endTransform:timeRange:"
  },
  "title" : "getTransformRamp(for:start:end:timeRange:)"
}
-->

# getTransformRamp(for:start:end:timeRange:)

Obtains the transform ramp that includes a specified time.

```
func getTransformRamp(for time: CMTime, start startTransform: UnsafeMutablePointer<CGAffineTransform>?, end endTransform: UnsafeMutablePointer<CGAffineTransform>?, timeRange: UnsafeMutablePointer<CMTimeRange>?) -> Bool
```

## Parameters

`time`

If a ramp with a time range that contains the specified time has been set, information about the effective ramp for that time is supplied. Otherwise, information about the first ramp that starts after the specified time is supplied.

`startTransform`

A pointer to a float to receive the starting transform value for the transform ramp.

    This value may be     `NULL`    .

`endTransform`

A pointer to a float to receive the ending transform value for the transform ramp.

    This value may be     `NULL`    .

`timeRange`

A pointer to a `CMTimeRange` to receive the time range of the transform ramp.

    This value may be     `NULL`    .

## Return Value

<doc://com.apple.documentation/documentation/Swift/true> if values are returned successfully, otherwise <doc://com.apple.documentation/documentation/Swift/false>. <doc://com.apple.documentation/documentation/Swift/false> is returned if `time` is beyond the duration of the last transform ramp that has been set.

## Discussion

---

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)