About PhotoEditor SDK for iOS

Added

• [ImglyKit] Added H264 video codec initializer with the option to specify a VideoCodecProfileH264.

Changed

• [ImglyKit] Changed .bringToFront overlay buttons are now disabled when the selected sprite is already on top.

Added

• [ImglyKit] Added CameraViewControllerOptions.allowedRecordingOrientations which allow to specify the orientations in which the camera should record.

Fixed

• [ImglyKit] Fixed issue where the camera roll button would not be visible in the CameraViewController when recording a video.

Fixed

• [ImglyKit] Fixed issue where the renderer has not been updating the preview correctly when changing the MediaEditPreviewController.photoEditModel in a way that more than only the sprite models have been changed at the same time.
• [ImglyKit] Improved timely weather data by requesting an update when the editor is about to appear for WeatherProvider's that outlive editor invocations.

Changed

• Enabled library evolution and module stability which allows to use the SDK from now on with any Xcode 11+ (beta) version.
• [VideoEditorSDK] Selecting sprites won't pause video playback anymore to align behavior with Android. In order to restore the old behavior override wantsVideoPlayback of BrushEditController, StickerEditController, TextDesignOptionsToolController, TextFontToolController, and TextOptionsToolController.

Added

• Added experimental XCFramework and Swift Package Manager (SPM) support.

Fixed

• [ImglyKit] Fixed silent force crop behavior when TransformToolControllerOptions.allowFreeCrop and MediaEditViewControllerOptions.forceCropMode are both false where the asset would not be automatically cropped to the best matching aspect if its size would not fit one of the TransformToolControllerOptions.allowedCropAspects.
• [ImglyKit] Fixed that the time label would be hidden when specifying .video as the first item in CameraViewControllerOptions.allowedRecordingModes.

Pre-release of PhotoEditor SDK 10.18.0 built with Xcode 12.0 beta 4. If you notice any issues, please contact https://support.photoeditorsdk.com. This version is not available via CocoaPods trunk but you can source https://github.com/imgly/specs.git to install it as shown in the following example Podfile:

source 'https://github.com/imgly/specs.git'

platform :ios, '11.0'

target 'SwiftExample' do
  use_frameworks!
  pod 'PhotoEditorSDK', '10.18.0-xcode.12.0.beta.4'
end

Changed

• Raised minimum deployment target to iOS 11.0
• Built with Swift 5.3 / Xcode 12.0 beta 4

Added

• [ImglyKit] Added new SmartStickers for weather to the first sticker category. These are hidden per default when StickerToolControllerOptions.weatherProvider is not set. You can use the OpenWeatherProvider or implement your own WeatherProvider.

Fixed

• [ImglyKit] Fixed unlocalized string for key pesdk_smart_sticker_clock warning.

Changed

• [ImglyKit] Changed the displayed sticker category name from "Emoticons" to "Stickers".

Added

• [ImglyKit] Added ToolbarButton.width which allows to configure a custom width for the toolbar buttons.
• [ImglyKit] Added new MultiImageSticker which allows to have multiple variations of a sticker that can be cycled by tapping the sticker on the canvas.
• [ImglyKit] Added new SmartStickers for weekday, date, time, and clock as first items to the first sticker category.

Pre-release of PhotoEditor SDK 10.16.0 built with Xcode 12.0 beta 3. If you notice any issues, please contact https://support.photoeditorsdk.com. This version is not available via CocoaPods trunk but you can source https://github.com/imgly/specs.git to install it as shown in the following example Podfile:

source 'https://github.com/imgly/specs.git'

platform :ios, '11.0'

target 'SwiftExample' do
  use_frameworks!
  pod 'PhotoEditorSDK', '10.16.0-xcode.12.0.beta.3'
end

Changed

• Raised minimum deployment target to iOS 11.0
• Built with Swift 5.3 / Xcode 12.0 beta 3

Added

• [VideoEditorSDK] Added new GIF sticker category and stickers.

Changed

• Built with Swift 5.2.4 / Xcode 11.6

Fixed

• [VideoEditorSDK] Fixed video playback was not paused when exporting an unedited video.

Pre-release of PhotoEditor SDK 10.15.0 built with Xcode 12.0 beta 2. If you notice any issues, please contact https://support.photoeditorsdk.com. This version is not available via CocoaPods trunk but you can source https://github.com/imgly/specs.git to install it as shown in the following example Podfile:

source 'https://github.com/imgly/specs.git'

platform :ios, '11.0'

target 'SwiftExample' do
  use_frameworks!
  pod 'PhotoEditorSDK', '10.15.0-xcode.12.0.beta.2'
end

Changed

• Raised minimum deployment target to iOS 11.0
• Built with Swift 5.3 / Xcode 12.0 beta 2

Changed

• [ImglyKit] Changed access level of CameraViewController's UIImagePickerControllerDelegate implementation to open in order to allow further customization within subclasses.
• [VideoEditorSDK] The original URL of the input video is now returned by the VideoEditViewControllerDelegate instead of nil when exporting an unedited video in order to align the behavior with PhotoEditorSDK.

Added

• [ImglyKit] Added TextToolControllerOptions.maximumTextSize to configure the maximum initial font size for text added within the text tool.
• [ImglyKit] Added missing analytics events for adding, selecting, and removing text designs.
• [ImglyKit] Added CameraController.cameraPosition to determine the active camera position.

Fixed

• [ImglyKit] Fixed subclassing of TextToolController, TextDesignToolController, BrushColorToolController, StickerGestureController, StickerColorToolController, StickerEditController, TextGestureController, TextColorToolController, and TextDesignGestureController which caused undefined symbols for _OBJC_METACLASS_ errors.
• [ImglyKit] Fixed image picker in camera would allow selecting media types that are not included in the CameraViewControllerOptions.allowedRecordingModes.

Pre-release of PhotoEditor SDK 10.14.0 built with Xcode 12.0 beta 1. If you notice any issues, please contact https://support.photoeditorsdk.com. This version is not available via CocoaPods trunk but you can source https://github.com/imgly/specs.git to install it as shown in the following example Podfile:

source 'https://github.com/imgly/specs.git'

platform :ios, '11.0'

target 'SwiftExample' do
  use_frameworks!
  pod 'PhotoEditorSDK', '10.14.0-xcode.12.0.beta.1'
end

Changed

• Raised minimum deployment target to iOS 11.0
• Built with Swift 5.3 / Xcode 12.0 beta 1

Added

• [VideoEditorSDK] Added support for animated GIF stickers. Sticker adjustments (brightness, contrast, saturation) and non-default tint modes are not supported for animated stickers.

Fixed

• [VideoEditorSDK] Fixed video playback to start at trimmed start position when loading a PhotoEditModel or serialization.
• [VideoEditorSDK] Fixed crash for videos with invalid audio.

Fixed

• [VideoEditorSDK] Fixed missing intermediate directories were not created for export filename.
• [ImglyKit] Fixed static frames would not appear or lead to crash.
• [ImglyKit] Fixed dynamic frames would lead to crash if not all patches have been set.
• [ImglyKit] Fixed error: Couldn't IRGen expression, no additional error when using the lldb console.

Changed

• Built with Swift 5.2.4 / Xcode 11.5

Changed

• [ImglyKit] Changed access level of AdjustEditController.updateSlider to open in order to allow further customization within subclasses.

Added

• [ImglyKit] Added MenuCollectionViewCell.cornerRadius and MenuCollectionViewCell.selectionBorderWidth which allow customization via UIAppearance proxy calls.

Fixed

• [ImglyKit] Fixed force cropping could be undone.

Changed

• [ImglyKit] Changed access level of Slider.thumbView, Slider.leftUnfilledTrackView, Slider.rightUnfilledTrackView, and Slider.filledTrackView to open in order to allow further customization within subclasses of Slider.

Added

• [ImglyKit] Added UIAppearance proxy support for Slider.trackHeight, Slider.trackCornerRadius, and Slider.thumbSize.

Changed

• Built with Swift 5.2.2 / Xcode 11.4.1
• [ImglyKit] Changed the initial minimum font size for text added with the text tool to 20.0. In order to return to the old default value and line break behavior set TextToolControllerOptions.minimumTextSize to 1.0.

Added

• [ImglyKit] Added TextToolControllerOptions.minimumTextSize to configure the initial minimum font size for text added with the text tool which affects the automatic line break behavior.

Fixed

• [ImglyKit] Fixed adding personal stickers would lead to the toolbar being hidden beneath the keyboard in the text and text design tool for iOS versions older than 13.0.
• [ImglyKit] Added a workaround that fixes wrong layout of the navigation bar for iOS 13 devices without a notch when a MediaEditViewController is embedded into a UINavigationController and uses a different prefersStatusBarHidden setting as the parent view.

Changed

• [ImglyKit] 🚨 ConfigurationBuilder.configure(from:) methods don't parse the tile configurations for LUTFilter objects from the lutURI filename anymore and the default changed from a 8x8 to a 5x5 tile configuration.
• [ImglyKit] Added @available(iOS 11.0, *) restriction to ImageFileFormat.heif as this has always been noted in the API docs but was not enforced by the compiler.

Added

• [ImglyKit] Added LUTEffect initializer for specific tile configurations that does not parse its URL for tile configurations.
• [ImglyKit] Added Configuration.appearanceProxyConfigurationClosure intended for custom UIAppearance proxy calls.
• [ImglyKit] Enabled SnapGuideView properties for UIAppearance proxy calls.
• [ImglyKit] Added snap guide colors to the Theme.

Fixed

• [ImglyKit] Added a workaround that fixes black image exports with the iOS 13.4 Simulator in general and all iOS 13.x Simulators running on macOS 10.15.4. Exports of images larger than 4096^2 are still failing to render on the aforementioned iOS Simulator configurations. On real devices everything works as expected.

Changed

• Built with Swift 5.2 / Xcode 11.4.

Fixed

• [VideoEditorSDK] Fixed initial position of the video position seeker when the playback is paused and the trim tool is entered.
• [ImglyKit] Fixed StickerToolControllerOptions.titleViewConfigurationClosure not being called for the selected sticker category.

Fixed

• [ImglyKit] Added missing localizable strings for filter groups.
• [ImglyKit] Fixed focus operation not being centered when the focus tool is applied to a cropped image.

Changed

• [ImglyKit] Changed UICollectionViewDelegate methods implemented by StickerSelectionController to open instead of public.

Fixed

• [ImglyKit] Fixed infinite layout loop when rotating an inverted text design on iOS 13.
• [ImglyKit] Fixed class replacement not working for BlendModeCollectionViewCell and StickerCollectionViewCell.
• [ImglyKit] Fixed misplaced sticker bounding box when switching from opacity to color editing mode of a sticker.

Fixed

• [ImglyKit] Increased the touch area of the color picker controls which were difficult to use at the borders of the color selection views.
• [ImglyKit] Fixed default ordering of the frames for cross-platform consistency.
• [ImglyKit] Fixed accidental drawing while using the color picker in the BrushColorToolController.

Changed

• Built with Swift 5.1.3 / Xcode 11.3.1.

Fixed

• [ImglyKit] Fixed overwriting of configuration options when calling a ConfigurationBuilder.configure* closure more than once. Existing configuration options are now passed to successive invocations.
• [ImglyKit] Fixed text tool and text design tool which would remain active even if the text was deleted.
• [ImglyKit] Fixed switching the camera mode too fast would lead to the blur view appearing permanently and thereby disabling the camera functionality.
• [VideoEditorSDK] Fixed an issue where the frame options tool would show the wrong video frame when playback is paused.

Changed

• Built with Swift 5.1.3 / Xcode 11.3.

Fixed

• [ImglyKit] Added a public initializer for PhotoEditRenderer that's accessible with Objective-C.
• [ImglyKit] Fixed Objective-C compatibility of SpriteModel.
• [ImglyKit] Fixed CGFloat? properties not being exposed to Objective-C by converting them to NSNumber?.
• [ImglyKit] Fixed rotational snapping of sprites which led to misaligned snapping angles and guides after the image has been rotated with the transform tool.
• [ImglyKit] Fixed FrameOptionsToolControllerOptions.allowedFrameActions not being accessible from Objective-C.

Changed

• [PhotoEditorSDK] Restricted access level of PhotoEditViewController.options to public in order to prevent overrides which would likely cause unexpected behavior.
• [VideoEditorSDK] Restricted access level of VideoEditViewController.options to public in order to prevent overrides which would likely cause unexpected behavior.

Fixed

• [ImglyKit] Fixed animation of the media capturing buttons in the CameraViewController when switching the capturing mode from photo to video and vice versa.
• [ImglyKit] Fixed slider in the sticker tool which was not updated when multiple stickers with different opacity, brightness, contrast, or saturation values were edited one after the other.
• [ImglyKit] Fixed image preview for the iOS Simulator with Metal support (iOS 13 Simulator running on macOS 10.15) which led to the preview image being displayed upside down.
• [ImglyKit] Fixed image preview in the transform and frame tool for the iOS Simulator with Metal support (iOS 13 Simulator running on macOS 10.15) which led to the display of an empty canvas.

Changed

• Built with Swift 5.1.2 / Xcode 11.2.1.

Added

• [ImglyKit] Added configuration option MediaEditViewControllerOptions.navigationControllerMode to keep the Toolbar if the MediaEditViewController or one of its ancestors is a child of a UINavigationController.

Deprecated

• [ImglyKit] Deprecated MediaEditViewControllerOptions.useParentNavigationItem in favor of MediaEditViewControllerOptions.navigationControllerMode.

Fixed

• [ImglyKit] Fixed background color of the menu accessory view to use the Theme.menuBackgroundColor. This issue could result in a black gap at the bottom of the screen if the menu accessory view extended below the bottom safeAreaLayoutGuide, e.g., when the MediaEditViewController was embedded in a UINavigationController.

Changed

• Built with Swift 5.1.2 / Xcode 11.2.

Added

• [ImglyKit] Added option to add personal stickers from the camera roll via UIImagePickerController. This feature is disabled by default and can be configured with StickerToolControllerOptions. If the same AssetCatalog is used for multiple editor instances and/or for de-/serialization added personal stickers will accumulate in this single AssetCatalog instance which is AssetCatalog.shared per default. In order to remove all added personal stickers use AssetCatalog.removeTemporaryItems() or create a new AssetCatalog for every editing session.

Fixed

• [ImglyKit] Fixed orientation of assets with EXIF metadata.

Changed

• [ImglyKit] Default sticker category identifiers were changed for cross-platform compatibility and consistency with filter categories. pesdk_sticker_asset_emoticonsStickerCategory was changed to imgly_sticker_category_emoticons and pesdk_sticker_asset_shapesStickerCategory was changed to imgly_sticker_category_shapes.

Added

• [ImglyKit] Added AssetCatalog to configure all assets that are available to an editor instance for editing tasks. Per default the shared instance is used. Use the Configuration to setup the asset catalog. StickerCategory.all, Frame.all, Effect.all, Overlay.all, FontImporter.all, and TextDesign.all can still be used but these calls are redirected to AssetCatalog.shared internally.

Fixed

• [ImglyKit] Fixed sticker icon resizing based on StickerToolControllerOptions.stickerPreviewSize.
• [ImglyKit] Fixed broken alpha channel of imgly_frame_wood_passepartout_thumbnail.png for source distribution via podspec.
• [ImglyKit] Fixed an issue that caused the last used sticker category to not being reselected when adding another sticker.