<!--
{
  "availability" : [
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ARKit",
  "identifier" : "/documentation/ARKit/ReferenceImage",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "ARKit"
    ],
    "preciseIdentifier" : "s:5ARKit14ReferenceImageV"
  },
  "title" : "ReferenceImage"
}
-->

# ReferenceImage

A 2D image the system uses as a reference to find the same image in a person’s surroundings.

```
struct ReferenceImage
```

## Topics

### Creating a reference image

[`init(cgimage:physicalSize:orientation:)`](/documentation/ARKit/ReferenceImage/init(cgimage:physicalSize:orientation:))

Creates a reference image from a Core Graphics image.

[`init(pixelBuffer:physicalSize:orientation:)`](/documentation/ARKit/ReferenceImage/init(pixelBuffer:physicalSize:orientation:))

Creates a reference image from a pixel buffer.

[`loadReferenceImages(inGroupNamed:bundle:)`](/documentation/ARKit/ReferenceImage/loadReferenceImages(inGroupNamed:bundle:))

Creates multiple reference images based on their group name in an asset catalog.

### Inspecting a reference image

[`physicalSize`](/documentation/ARKit/ReferenceImage/physicalSize)

The size, in meters, of a reference image in the real world.

[`name`](/documentation/ARKit/ReferenceImage/name)

The name of a reference image.

[`resourceGroupName`](/documentation/ARKit/ReferenceImage/resourceGroupName)

A string value the represents the name of the resource group the framework loads an image from.

[`description`](/documentation/ARKit/ReferenceImage/description)

A textual representation of this reference image.


---

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)