Skip to content

maxxfrazer/FocusEntity

Repository files navigation

FocusEntity

This package is based on ARKit-FocusNode, but adapted to work in Apple's framework RealityKit.


The Example looks identical to the above GIF, which uses the FocusEntity classic style.

See the documentation for more.

Minimum Requirements

  • Swift 5.2
  • iOS 13.0 (RealityKit)
  • Xcode 11

If you're unfamiliar with using RealityKit, I would also recommend reading my articles on Getting Started with RealityKit.

Installation

Swift Package Manager

Add the URL of this repository to your Xcode 11+ Project.

Go to File > Swift Packages > Add Package Dependency, and paste in this link: https://github.com/maxxfrazer/FocusEntity


Usage

See the Example project for a full working example as can be seen in the GIF above

  1. Install FocusEntity with Swift Package Manager
https://github.com/maxxfrazer/FocusEntity.git
  1. Create an instance of FocusEntity, referencing your ARView:
let focusSquare = FocusEntity(on: self.arView, focus: .classic)

And that's it! The FocusEntity should already be tracking around your AR scene. There are options to turn the entity off or change its properties. Check out the documentation or example project to learn more.


Feel free to send me a tweet if you have any problems using FocusEntity, or open an Issue or PR!

The original code to create this repository has been adapted from one of Apple's examples from 2018, license also included. I have adapted the code to be used and distributed from within a Swift Package, and now further adapted to work with RealityKit.