CTPanoramaView alternatives and similar libraries
Based on the "Image" category.
Alternatively, view CTPanoramaView alternatives based on common mentions on social networks and blogs.
-
GPU Image
An open source iOS framework for GPU-based image and video processing -
SDWebImage
Asynchronous image downloader with cache support as a UIImageView category -
Kingfisher
A lightweight, pure-Swift library for downloading and caching images from the web. -
MWPhotoBrowser
A simple iOS photo and video browser with grid view, captions and selections. -
FastImageCache
iOS library for quickly displaying images while scrolling -
TOCropViewController
A view controller for iOS that allows users to crop portions of UIImage objects -
GPUImage2
GPUImage 2 is a BSD-licensed Swift framework for GPU-accelerated video and image processing. -
PINRemoteImage
A thread safe, performant, feature rich image fetcher -
AlamofireImage
AlamofireImage is an image component library for Alamofire -
IDMPhotoBrowser
Photo Browser / Viewer inspired by Facebook's and Tweetbot's with ARC support, swipe-to-dismiss, image progress and more -
NYTPhotoViewer
A modern photo viewing experience for iOS. -
SKPhotoBrowser
Simple PhotoBrowser/Viewer inspired by facebook, twitter photo browsers written by swift -
AspectFillFaceAware
An extension that gives UIImageView the ability to focus on faces within an image. -
UIImageColors
Fetches the most dominant and prominent colors from an image. -
RSKImageCropper
An image cropper / photo cropper for iOS like in the Contacts app with support for landscape orientation. -
GPUImage3
GPUImage 3 is a BSD-licensed Swift framework for GPU-accelerated video and image processing using Metal. -
TLPhotoPicker
📷 multiple phassets picker for iOS lib. like a facebook -
ImageSlideshow
Swift image slideshow with circular scrolling, timer and full screen viewer -
Lightbox
:milky_way: A convenient and easy to use image viewer for your iOS app -
EBPhotoPages
A photo gallery for iOS with a modern feature set. Similar features as the Facebook photo browser. -
TinyCrayon
A smart and easy-to-use image masking and cutout SDK for mobile apps. -
MetalPetal
A GPU accelerated image and video processing framework built on Metal. -
Twitter Image Pipline
Twitter Image Pipeline is a robust and performant image loading and caching framework for iOS clients -
ImagePickerSheetController
ImagePickerSheetController replicates the custom photo action sheet in iMessage. -
Sharaku
(Not maintained)Image filtering UI library like Instagram. -
YUCIHighPassSkinSmoothing
An implementation of High Pass Skin Smoothing using Apple's Core Image Framework -
SFSafeSymbols
Safely access Apple's SF Symbols using static typing -
DFImageManager
Image loading, processing, caching and preheating -
ImageScout
A Swift implementation of fastimage. Supports PNG, GIF, and JPEG. -
Paparazzo
Custom iOS camera and photo picker with editing capabilities -
ShadowImageView
A apple music cover picture shadow style image library -
OnlyPictures
A simple and flexible way to add source of overlapping circular pictures, currently supports horizontal overlapping or distant pictures with great layout flexibility. -
AXPhotoViewer
An iOS/tvOS photo gallery viewer, useful for viewing a large (or small!) number of photos. -
ComplimentaryGradientView
Create complementary gradients generated from dominant and prominent colors in supplied image. Inspired by Grade.js -
Imaginary
:unicorn: Remote images, as easy as one, two, three. -
SimpleImageViewer
A snappy image viewer with zoom and interactive dismissal transition. -
SABlurImageView
You can use blur effect and it's animation easily to call only two methods. -
Viewer
Image viewer (or Lightbox) with support for local and remote videos and images
Appwrite - The Open Source Firebase alternative introduces iOS support
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of CTPanoramaView or a related project?
README
CTPanoramaView
CTPanoramaView is a high-performance library that uses SceneKit to display complete spherical or cylindrical panoramas with touch or motion based controls.
Requirements
- iOS 8.0+
- v1.0 requires Xcode 8.0 and Swift 3.0
- v1.1 requires XCode 9.0 and Swift 4.0
- v1.2 requires XCode 10.0 and Swift 4.2
- v1.3 requires XCode 10.0 and Swift 5.0
- v1.4 requires XCode 12.0 and Swift 5.0
CTPanoramaView can be used both from Objective-C and Swift code.
Installation
Using Carthage
To install CTPanoramaView using Carthage, add the folowing line into your Cartfile:
github "scihant/CTPanoramaView" ~> 1.3
Then run the carthage update
command to build the framework and drag the built CTPanoramaView.framework
into your XCode project.
Using CocoaPods
To install CTPanoramaView using CocoaPods, add the following line into your Podfile:
pod "CTPanoramaView", "~> 1.3"
Then run the pod install
command and use the created workspace to open your project from now on.
Manual Install
Just add the file CTPanoramaView.swift
(and CTPieSliceView.swift
if you want to use it as the compass view) to your project.
Running the Example project
The example project is located in the Example directory. The framework target is already added as a dependency to it therefore you can run it directly.
Usage
Create an instance of CTPanoramaView
either in code or using a Storyboard/Nib.
Then load a panoramic image and set it as the image of the CTPanoramaView instance:
// Create an instance of CTPanoramaView called "panoramaView" somewhere
// ...
let image = UIImage(named: "panoramicImage.png")
panaromaView.image = image
Configuration
Panorama Types
CTPanoramaView supports two types of panoramic images:
- Spherical panoramas (also called 360 photos)
- Cylindrical panoramas
All panoramas should be full. Partial panoramas (panoramas with a field of view of less than 360º) are not supported. For a spherical panorama, the image should use equirectangular projection. Cubic format is not supported.
CTPanoramaView will automatically determine whether the given image is a spherical or cylindircal panorama by looking at the aspect ratio of the image. If it is 2:1, then it will assume a spherical panorama. If you want to override this default value, change the value of the panoramaType
property after the image is set.
panaromaView.panoramaType = .spherical // or .cylindrical
Control Methods
CTPanoramaView allows the user to navigate the panorama two different ways. To change the control method, use the controlMethod
property.
panaromaView.controlMethod = .touch // Touch based control
panaromaView.controlMethod = .motion // Accelerometer & gyroscope based control
The default control method is touch based control. You can change the control method on the fly, while the panorama is being displayed on the screen. The visible section will get automatically reset during a control method change.
When using touch based control, you can set the starting angle of the viewer in radians using the startAngle
property of CTPanoramaView. This property is ignored in motion based control mode.
Orientation Support
All orientations are supported. Orientation changes are automatically handled. Therefore you don't have to worry about things getting messed up after an orientation change.
Compass
If you want to display a compass that shows the users current field of view, use the compass
property.
When you set this property to a custom UIView
subclass conforming to the CTPanoramaCompass
protocol, the view will automatically supplied with rotation and field of view angles whenever one of them changes.
// compassView is a custom view that conforms to the `CTPanoramaCompass` protocol.
panaromaView.compass = compassView
The protocol contains only a single method, which is updateUI(rotationAngle:fieldOfViewAngle:)
. Here, rotationAngle
is the amount of rotation around the vertical axis, and fieldOfViewAngle
is the horizontal FoV angle of the camera. Both values are in radians.
You can see an example implementation of a compass in the supplied CTPieSliceView
class. Add it into your view hierarchy somewhere above your CTPanoramaView
instance, and then set it as its compass. You'll see that it shows the current FoV accurately. Here's how CTPieSliceView
looks in its default configuration:
CTPieSliceView
has several customizable properties such as sliceColor
, outerRingColor
and bgColor
, all of which can also be modified from the interface builder thanks to its live-rendering support.
Overlay Views
There is also a convenience property named overlayView
that can be used to add a custom view that covers the entire panorama view on top. When using touch based controls, it's up to you to make sure that the overlay view does not "consume" the touches it receives so that the CTPanoramaView
instance can receive the touch events properly.
How to Contribute
Create a feature branch off the dev branch and then send me a pull request. I don't merge PR's directly to master so please don't make your changes there.