Skip to content

Commit

Permalink
Updated docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Cerovec committed Aug 26, 2015
1 parent f5dc8c9 commit 8eda063
Show file tree
Hide file tree
Showing 5 changed files with 43 additions and 5 deletions.
17 changes: 17 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,22 @@
# Release notes

## 4.1.0

- Improved video frame quality detection: now only the sharpest and the most focused frames are being processed. This improves quality of the results, but at a slight expense of processing time

- Frame quality estimation can now be enabled using `PPScanSettings frameQualityEstimationMode` property:
- when set to `PPFrameQualityEstimationModeOn`, frame quality estimation is always enabled
- when set to `PPFrameQualityEstimationModeOff`, frame quality estimation is always disabled
- when set to `PPFrameQualityEstimationModeDefault`, frame quality estimation is enabled internally, if the SDK determines it makes sense

- iOS 9 introduced new app multitasking features Split View and Slide Over. When the scanner is on screen and one of those features are used, iOS automatically pauses the Camera (this behaviour is default as of iOS 9 beta 5). This SDK version introduces new setting in `PPUISettings` class, called `cameraPausedView`, where you can define the `UIView` which is presented centered on screen when this happens.

- Known issue on iOS 9: if you use Autorotate overlay feature (`settings.uiSetttings.autorotateOverlay`), present `PPScanningViewController` as a modal view controller, and support Split View iOS 9 feature, then autorotation of camera overlays isn't correct. The best way is to opt-out of Split View feature, and wait for SDK fix when iOS 9 comes out of beta.

- `PPScanningViewController` methods `pauseScanning`, `isScanningPaused`, and `resumeScanningAndResetState:` should now be called only from Main thread, and they are effective immediately. E.g., if `pauseScanning` is called and there is a video frame being processed, result of processing of that frame will be discarded, if `resumeScanningAndResetState:` isn't called in the meantime.

- Re-introduced property `locationOnImage` for `PPPdf417RecognizerResult` objects, which existed prior to v4.0.0. It's now a `PPQuadrangle` object, with clear properties for obtaining corner points of the barcode on the image.

## 4.0.2

- Added support for `PPCameraPresetPhoto` camera preset. Use this if you need the same zoom level as in iOS Camera app. The resolution for video feed when using this preset is the same as devices screen resolution.
Expand Down
4 changes: 2 additions & 2 deletions PPpdf417.podspec
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Pod::Spec.new do |s|

s.name = "PPpdf417"
s.version = "4.0.2"
s.version = "4.1.0"
s.summary = "A delightful component for barcode scanning"
s.homepage = "http://pdf417.mobi"

Expand Down Expand Up @@ -39,7 +39,7 @@ Pod::Spec.new do |s|

s.source = {
:git => 'https://github.com/PDF417/pdf417-ios.git',
:tag => 'v4.0.2'
:tag => 'v4.1.0'
}

s.preserve_paths = 'MicroBlink.embeddedframework/*'
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ pod try PPpdf417

```ruby
platform :ios, '6.0'
pod 'PPpdf417', '~> 4.0.2'
pod 'PPpdf417', '~> 4.1.0'
```

## Requirements
Expand Down
17 changes: 17 additions & 0 deletions Release notes.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,22 @@
# Release notes

## 4.1.0

- Improved video frame quality detection: now only the sharpest and the most focused frames are being processed. This improves quality of the results, but at a slight expense of processing time

- Frame quality estimation can now be enabled using `PPScanSettings frameQualityEstimationMode` property:
- when set to `PPFrameQualityEstimationModeOn`, frame quality estimation is always enabled
- when set to `PPFrameQualityEstimationModeOff`, frame quality estimation is always disabled
- when set to `PPFrameQualityEstimationModeDefault`, frame quality estimation is enabled internally, if the SDK determines it makes sense

- iOS 9 introduced new app multitasking features Split View and Slide Over. When the scanner is on screen and one of those features are used, iOS automatically pauses the Camera (this behaviour is default as of iOS 9 beta 5). This SDK version introduces new setting in `PPUISettings` class, called `cameraPausedView`, where you can define the `UIView` which is presented centered on screen when this happens.

- Known issue on iOS 9: if you use Autorotate overlay feature (`settings.uiSetttings.autorotateOverlay`), present `PPScanningViewController` as a modal view controller, and support Split View iOS 9 feature, then autorotation of camera overlays isn't correct. The best way is to opt-out of Split View feature, and wait for SDK fix when iOS 9 comes out of beta.

- `PPScanningViewController` methods `pauseScanning`, `isScanningPaused`, and `resumeScanningAndResetState:` should now be called only from Main thread, and they are effective immediately. E.g., if `pauseScanning` is called and there is a video frame being processed, result of processing of that frame will be discarded, if `resumeScanningAndResetState:` isn't called in the meantime.

- Re-introduced property `locationOnImage` for `PPPdf417RecognizerResult` objects, which existed prior to v4.0.0. It's now a `PPQuadrangle` object, with clear properties for obtaining corner points of the barcode on the image.

## 4.0.2

- Added support for `PPCameraPresetPhoto` camera preset. Use this if you need the same zoom level as in iOS Camera app. The resolution for video feed when using this preset is the same as devices screen resolution.
Expand Down
8 changes: 6 additions & 2 deletions Transition guide.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,14 @@
## Transition to 4.1.0

- No backwards incompatible changes. See Release notes for new features.

## Transition to 4.0.2

- No changes
- No backwards incompatible changes.

## Transition to 4.0.1

- No changes
- No backwards incompatible changes.

## Transition to 4.0.0

Expand Down

0 comments on commit 8eda063

Please sign in to comment.