https://github.com/simformsolutionspvtltd/ssverticalpanoramaimage
Capture stunning vertical panorama images with ease and preview them instantly on the built-in screen.
https://github.com/simformsolutionspvtltd/ssverticalpanoramaimage
camera ios ios-swift panorama panorama-image photography swift swift5 swiftui
Last synced: 9 months ago
JSON representation
Capture stunning vertical panorama images with ease and preview them instantly on the built-in screen.
- Host: GitHub
- URL: https://github.com/simformsolutionspvtltd/ssverticalpanoramaimage
- Owner: SimformSolutionsPvtLtd
- License: mit
- Created: 2022-10-12T10:04:21.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-10-09T12:11:55.000Z (over 2 years ago)
- Last Synced: 2025-08-15T20:14:02.041Z (10 months ago)
- Topics: camera, ios, ios-swift, panorama, panorama-image, photography, swift, swift5, swiftui
- Language: Swift
- Homepage:
- Size: 54.9 MB
- Stars: 48
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SSVerticalPanoramaImage
## Capture stunning vertical panorama images with ease and preview them instantly on the built-in screen.
[](https://travis-ci.org/SimformSolutionsPvtLtd/SSVerticalPanoramaImage)
[](https://cocoapods.org/pods/SSVerticalPanoramaImage)
[](https://cocoapods.org/pods/SSVerticalPanoramaImage)
[](https://cocoapods.org/pods/SSVerticalPanoramaImage)
SSVerticalPanoramaImage provides a feature to capture a vertical panorama image and also provides an option to preview it on the built-in screen.
# Features
- Capture vertical panorama image
- Swipe the direction of capture from top to bottom and bottom to top
- Inbuilt flash and zoom functionality
# 🎬 Preview
| Up >> Down | Down >> Up | Normal |
|--|--|--|
|  |  | 
# Installation
### CocoaPods
[CocoaPods][cocoapods-link] is a dependency manager for Cocoa projects. You can install it with the following command:
```bash
$ gem install cocoapods
```
To integrate SSVerticalPanoramaImage into your Xcode project using CocoaPods, specify it in your `Podfile`:
```ruby
platform :ios, '15.0'
use_frameworks!
target '' do
pod 'SSVerticalPanoramaImage'
end
```
Then, run the following command:
```bash
$ pod install
```
# How to use:
1. Create an instance of SSVerticalPanorama and call `openSSVerticalPanoramaCam`.
```swift
var verticalPano: SSVerticalPanorama?
```
```swift
override func viewDidLoad() {
verticalPano = SSVerticalPanorama()
verticalPano?.delegate = self
verticalPano?.showPreviewScreen = true
}
```
```swift
@IBAction func onClickOfOpenCam(_ sender: UIButton) {
guard let navController = navigationController, let verticalPano else { return }
verticalPano.openSSVerticalPanoramaCam(navController: navController)
}
```
2. Confirm the `SSVerticalPanoDelegate` delegate to receive the captured image.
```swift
//MARK: - SSVerticalPanoDelegate
extension ViewController: SSVerticalPanoDelegate {
func onImageCaptured(image: UIImage) {
// Use image
}
}
```
## Customization
* You can customize UI icon using below properties in `viewDidLoad`.
```swift
verticalPano.arrowImage = UIImage(named: "YourImage")
verticalPano.closeImage = UIImage(named: "YourImage")
verticalPano.flashImage = UIImage(named: "YourImage")
verticalPano.zoomInImage = UIImage(named: "YourImage")
verticalPano.zoomOutImage = UIImage(named: "YourImage")
verticalPano.startCameraImage = UIImage(named: "YourImage")
verticalPano.stopCameraImage = UIImage(named: "YourImage")
```
# How to set in-built preview scereen :
* Set `showPreviewScreen` to `true` or `false` to enable or disable in-built preview screen.
```swift
verticalPano.showPreviewScreen = true
```
## Find this library useful? ❤️
Support it by joining __[stargazers]__ for this repository.⭐
## 🤝 How to Contribute
Whether you're helping us fix bugs, improve the docs, or a feature request, we'd love to have you! 💪
Check out our __[Contributing Guide]__ for ideas on contributing.
# Check our other Libraries:
* Also, Check our other libraries - [Awesome-Mobile-Libraries][Awesome-Mobile-Libraries]
## Bugs and Feedback
For bugs, feature requests, and discussion please use __[GitHub Issues]__.
## License
Distributed under the MIT license. See [LICENSE][license-url] for more information.
[//]: # (These are reference links used in the body of this note and get stripped out when the markdown processor does its job. Thanks SO - http://stackoverflow.com/questions/4823468/store-comments-in-markdown-syntax)
[git-repo-url]:
[stargazers]:
[Contributing Guide]:
[GitHub Issues]:
[swift-url]:
[cocoapods-link]:
[license-image]:
[license-url]:
[Awesome-Mobile-Libraries]: