Skip to content
超轻量级的 iOS 全景图组件
Objective-C Ruby
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
BSPanoramaView.xcodeproj
BSPanoramaView Fix registeration bug and add memory limitation Nov 16, 2017
.gitignore Initial commit Nov 15, 2017
BSPanorama.gif 添加效果文件 Nov 15, 2017
BSPanoramaView.podspec Fix registeration bug and add memory limitation Nov 16, 2017
Chinese.md Update Chinese.md Nov 15, 2017
LICENSE Initial commit Nov 15, 2017
README.md Update README.md Nov 15, 2017

README.md

BSPanoramaView

中文文档请阅读这里

Due to the limitation of recording screen, the actual experience on real device is much better the gif shown above.

BSPanoramaView is a lightweight panorama picture browser on iOS platform, which will only make the binary file 30k larger.

BSPanoramaView does not rely on any other third party framework and it only contains about three hundred lines of code.

BSPanoramaView was inspired by WushuputiGH/Panorama and copied some calculations about OpenGL but rewrote the application architecture and fixed many bugs.

At current time, BSPanoramaView can be applied in production environment if you are tolerant of some tiny defects.

Usage

BSPanoramaView is the subclass of GLKView which itself is a subclass of UIView, so you can use BSPanoramaView as a normal view:

#import "BSPanoramaView.h"

- (void)viewDidLoad {
    [super viewDidLoad];

    BSPanoramaView *panoView = [[BSPanoramaView alloc] initWithFrame:self.view.bounds imageName:@"test"];
    [self.view addSubview:panoView];
}

The texture(test.png) takes a lot of memory. For example, an picture with resolution of 4096 * 20148 takes 32M memory which means you should be careful about the memory occupation.

When the instance of BSPanoramaView is released, it will unload the texture in dealloc method and you don't need to pay any extra attention to this:

- (void)dealloc {
    [self unloadImage];
}

However, if it is not released, such as scrolling outside the screen, you should be careful to call unloadImage method manually at proper time. This is also demostrated in the code in PanoTableViewCell class.

Installation

You can just copy the source code into your project because there are only two files.

However, since this is a beta-version code which may be optimized constantly, I strongly encourage you to use Cocoapods:

pod 'BSPanoramaView'
You can’t perform that action at this time.