GVRSCNRenderer

KO | EN

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #claude-code #windows #codex #developer-tools #dsh

★ 24 Open GitHub ↗

SceneKit Rendering and ARKit 6DOF Tracking for Google Cardboard

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GVRSCNRenderer

[![CocoaPods](https://img.shields.io/cocoapods/v/GVRSCNRenderer.svg)](https://cocoapods.org/pods/GVRSCNRenderer)
![CocoaPods](https://img.shields.io/cocoapods/p/GVRSCNRenderer.svg)
[![license](https://img.shields.io/github/license/palle-k/GVRSCNRenderer.svg)](https://github.com/palle-k/GVRSCNRenderer/blob/master/License)

Combines Google Cardboard with SceneKit Rendering and ARKit World Tracking.  
Combining ARKit with Google Cardboard enables six degrees of freedom (rotation and translation) in VR:

![Cardboard+ARKit](https://raw.githubusercontent.com/palle-k/GVRSCNRenderer/master/img/cardboard-arkit.gif)

## Installation

GVRSCNRenderer can be installed as a dependency using CocoaPods:

```ruby
target 'Your-App-Name' do
	use_frameworks!
	pod 'GVRSCNRenderer'
end
```

## Usage

Builds on top of `GVRRenderer` from `GVRKit`, which is part of the Google VR SDK for iOS.

### Basic Setup

```swift
import GVRKit
import GVRSCNRenderer

// Create scene:
let scene: SCNScene = ...

// For SceneKit Rendering without world tracking:
let renderer = GVRSCNRenderer(scene: scene)

// For 6DOF Tracking:
let renderer = GVRSCNARTrackingRenderer(scene: scene)

// Create Cardboard view and pass renderer
let view = GVRRendererView(renderer: renderer)
```

### Event Handling

Cardboard trigger events can be handled by the interaction delegate:

```swift
renderer.interactionDelegate = yourEventHandler

extension YourEventHandler: GVRSCNInteractionDelegate {
	func didTrigger(_ renderer: GVRSCNRenderer, headTransform: SCNMatrix4) {
		// Handle trigger event
	}
}
```

### Render Loop Customization

The render loop can be customized using a `SCNSceneRendererDelegate`:

```swift
renderer.rendererDelegate = yourRendererDelegate

extension YourRendererDelegate: SCNSceneRendererDelegate {
	// ...
}
```

### Showing Tracking Features

Tracking features can be shown to signal nearby objects in the real world to the user to avoid collisions (`GVRSCNARTrackingRenderer` only):

```swift
renderer.showsTrackingFeatures = true
```

Customizing feature indicators:

```swift
// Set tracking feature size in meters (e.g. 0.001 == 1mm)
renderer.trackingFeatureSize = ...

// Set tracking feature material
renderer.trackingFeatureMaterial = ...
```

---

3D Model in demo GIF: [Rempart Walls scenery 1 - Fougères castle](https://sketchfab.com/models/ac1367f3ec3d48c4b6a56e0117f20761) by [noxfcna](https://sketchfab.com/noxfcna) is licensed under [CC Attribution](http://creativecommons.org/licenses/by/4.0/)

GVRSCNRenderer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README