/SSVerticalPanoramaImage

Capture stunning vertical panorama images with ease and preview them instantly on the built-in screen.

Primary LanguageSwiftMIT LicenseMIT

Banner

SSVerticalPanoramaImage

Capture stunning vertical panorama images with ease and preview them instantly on the built-in screen.

CI Status Version License Platform

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 is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate SSVerticalPanoramaImage into your Xcode project using CocoaPods, specify it in your Podfile:

platform :ios, '15.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'SSVerticalPanoramaImage'
end

Then, run the following command:

$ pod install

How to use:

  1. Create an instance of SSVerticalPanorama and call openSSVerticalPanoramaCam.
  var verticalPano: SSVerticalPanorama?
  override func viewDidLoad() {
      verticalPano = SSVerticalPanorama()
      verticalPano?.delegate = self
      verticalPano?.showPreviewScreen = true
  }
   @IBAction func onClickOfOpenCam(_ sender: UIButton) {
       guard let navController = navigationController, let verticalPano else { return }
       verticalPano.openSSVerticalPanoramaCam(navController: navController)
   }
  1. Confirm the SSVerticalPanoDelegate delegate to receive the captured image.
//MARK: - SSVerticalPanoDelegate
extension ViewController: SSVerticalPanoDelegate {
   func onImageCaptured(image: UIImage) {
       // Use image
   }
}

Customization

  • You can customize UI icon using below properties in viewDidLoad.
    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.
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:

Bugs and Feedback

For bugs, feature requests, and discussion please use GitHub Issues.

License

Distributed under the MIT license. See LICENSE for more information.