High Performance Full Screen Image and Video browser in iOS
MIT License
A-J-Full-Screen-Image-Browser is an drop-in solution for full screen image and video browser
A_J_Full_Screen_Image_Browser
into your projectimport UIKit
final class ViewController: UIViewController {
lazy var testVideo: MediaDownloadable = {
return SingleMedia(imageURL: URL(string: "https://dummyimage.com/600&text=thumbnail")!,
isVideoThumbnail: true,
videoURL: URL(string: "http://jplayer.org/video/m4v/Big_Buck_Bunny_Trailer.m4v")!)
}()
lazy var media: [MediaDownloadable] = {
return [testVideo,
SingleMedia(imageURL: URL(string: "https://dummyimage.com/300")!),
SingleMedia(imageURL: URL(string: "https://dummyimage.com/600")!),
testVideo]
}()
@IBAction func onButtonTapped(_ sender: UIButton) {
let vm = FullScreenImageBrowserViewModel(media: media)
let browser = FullScreenImageBrowser(viewModel: vm)
present(browser, animated: true, completion: nil)
}
}
By default,
FullScreenImageBrowser
doesn't use any 3rd library, theSingleImage
usesURLSession
to fetch image. However it's designed to be compatible with any networking library, one good example is AlamofireImage
The following code snippet shows an example how to use AlamofireImage
to seamlessly integrated with FullScreenImageBrowser
.
import Foundation
import AlamofireImage
public class FullScreenImage: MediaDownloadable {
public var image: UIImage?
public var imageURL: URL?
public var videoURL: URL?
public var isVideoThumbnail: Bool
public init(imageURL: URL?, isVideoThumbnail: Bool = false, videoURL: URL? = nil) {
self.imageURL = imageURL
self.videoURL = videoURL
self.isVideoThumbnail = isVideoThumbnail
}
public func loadImageWithCompletionHandler(_ completion: @escaping (UIImage?, NSError?) -> Void) {
if let image = image {
completion(image, nil)
return
}
loadImageWithURL(imageURL, completion: completion)
}
// use any network calls you like
public func loadImageWithURL(_ url: URL?, completion: @escaping (_ image: UIImage?, _ error: NSError?) -> Void) {
guard let _url = url else {
completion(nil, NSError(domain: "FullScreenImageBrowserDomain",
code: -2,
userInfo: [ NSLocalizedDescriptionKey: "Image URL not found."]))
return
}
let urlRequest = URLRequest(url: _url)
downloader.download(urlRequest) { [weak self] response in
debugPrint(response.result)
if let remoteImage = response.result.value {
self?.image = remoteImage
completion(remoteImage, nil)
} else {
completion(nil, NSError(domain: "FullScreenImageBrowserDomain",
code: -1,
userInfo: [ NSLocalizedDescriptionKey: "Couldn't load image from remote"]))
}
}
}
}
animator
FullScreenImageTransitionAnimator.swift
asset
FullScreenImageBrowser.bundle
close.png
[email protected]
[email protected]
core
FullScreenImageBrowser.swift
FullScreenImageBrowserViewModel.swift
MediaDownloadable.swift
MaskImageViewer.swift
SingleImageViewer.swift
ZoomableImageView.swift
helper
SingleImage.swift
UIView+SnapShot.swift
File | Responsiblity |
---|---|
animator | customised fade in/fade out animations with damping factors |
asset | customised static image asset for the full screen image/video browser navigation bar |
core/FullScreenImageBrowser | manager class to be responsible for full screen image/video browser |
core/FullScreenImageBrowserViewModel | datasource and business logic for full screen image/video browser |
core/MediaDownloadable | protocol to define images to be able to asynchronously download |
core/MaskImageViewer |
customised overlay view for full screen image/video browser |
core/SingleImageViewer | view controller to be responsible for single image rendering on the full screen |
core/ZoomableImageView | view to add support for image to zoom, pin, rotate, and animation |
A-J-Full-Screen-Image-Browser is owned and maintained by the Alex Jiang. Thanks iTMan.design for providing computational resources.
A-J-Full-Screen-Image-Browser is released under the MIT license.