Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gsabran/DDDKit
360 video player for iOS written in swift - a subset of SceneKit that works
https://github.com/gsabran/DDDKit
360-video 3d-rendering cocoapods ios scenekit swift
Last synced: 6 days ago
JSON representation
360 video player for iOS written in swift - a subset of SceneKit that works
- Host: GitHub
- URL: https://github.com/gsabran/DDDKit
- Owner: gsabran
- License: mit
- Created: 2016-10-03T02:28:45.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-01-10T11:23:30.000Z (almost 6 years ago)
- Last Synced: 2024-11-20T03:35:03.426Z (22 days ago)
- Topics: 360-video, 3d-rendering, cocoapods, ios, scenekit, swift
- Language: Swift
- Homepage:
- Size: 85.5 MB
- Stars: 133
- Watchers: 9
- Forks: 15
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - swift-360-videos - Pure swift (no SceneKit) 3D library with focus on video and 360. (Media / Video)
- awesome-ios-star - swift-360-videos - Pure swift (no SceneKit) 3D library with focus on video and 360. (Media / Video)
README
# DDDKit
[](https://swift.org)
[](http://cocoapods.org/pods/DDDKit)
[](http://cocoapods.org/pods/DDDKit)
[](http://cocoapods.org/pods/DDDKit)
An open source library to support 360 videos and pictures. It's designed as a generic 3D library that you can use for much more!
## Example of use cases
- 360 video player
- 360 image display
- generic 3D scene
- photo / video filters within a 3D scene
## Installation
See the [wiki](https://github.com/team-pie/DDDKit/wiki/Installation)! or:
```
pod 'DDDKit'
```
### Quickstart
```swift
import DDDKit
import AVFoundation
class ViewController: DDD360VideoViewController {
override func viewDidLoad() {
super.viewDidLoad()
show(from: myVideoURL)
}
}
```
## Example
### Image filter (easy to be creative!)
```swift
// B&W filter:
@IBAction func didPressBW(_ sender: Any) {
let program = try! DDDShaderProgram(fragment: defaultShader, shaderModifiers: [
.fragment: "gl_FragColor = vec4(vec3(gl_FragColor.x + gl_FragColor.y + gl_FragColor.z) / 3.0, 1.0);",
])
videoNode.material.shaderProgram = program
}
```
### 360 [cubic](https://github.com/facebook/transform360) projection
```swift
node.geometry = DDDGeometry.Cube()
let videoTexture = DDDVideoTexture(player: player) // AVPlayer with 360 cubic video
node.material.set(
property: videoTexture,
for: "SamplerY",
and: "SamplerUV"
)
```
### Screenshots from the demo app:
## Documentation
See the [wiki](https://github.com/team-pie/DDDKit/wiki)!
## Features
- easy to use syntax and logic
- support of image and video textures
- direct and easy access to shader's code, shaders modifiers -> easy to make image filters
- focus on reliability on video support.
- equirectangular and cubic 360 support
- elements that can have any shape / position
## Why not SceneKit?
- SceneKit has bugs, such as memory leaks, failing video support (see [SO](http://stackoverflow.com/questions/39542205/ios10-scenekit-render-a-video-with-custom-shader))
- no support of AVPlayerLayer / AVPlayer as video input
- indirect video support (through SpriteKit)
- openGL backed rendering failing on iOS 10
- poor documentation
- unresponsiveness from Apple on issues, and no timeline/transparency on fixes
- no access to code to fix things yourself, since it's not open source.
## Author
Guillaume Sabran, [email protected], CTO @Pie
## License
DDDKit is available under the MIT license. See the LICENSE file for more info.