Changelog

Breaking Changes

Non Breaking Changes

• Engine: If a scene is created with scene.createFromImage or scene.createFromVideo, the content fill mode is now changed to Crop instead of Cover. This is now consistent with adding images or video. To keep the old behavior, the content fill mode can be changed to Cover with block.setContentFillMode once the scene is created.
• Editor/Android: Fixed an issue where the crop reset button remained disabled even when it should have been enabled.
• Engine/Web: Fixed that asset labels were not passed to a custom addAsset function in custom asset sources.
• Engine: supportsBlendMode returns false for the following block types: Stack, Audio, Metrics, Track, CaptionTrack
• Editor/RN: Added proper handling for export errors on Android.
• Editor/Flutter: Added proper handling for export errors on Android.
• Editor/iOS: Fixed attribution sheet presentation looping when opening the bottom most images.
• Engine: Changed the block.setTextColor API to also update the fill color if the color is changed on the whole text and not only the text run. This prevents the fill color from being different than expected.
• Engine: Changed the block.setTextFontSize API to also update the font size property if the font size is changed on the whole text and not only the text run. This prevents the font size property from being different than expected.
• Editor/Android: For scenes without a stack, the toggle pages button is no longer visible by default in the DesignEditor.
• Editor/Web: Fixed an issue where the upload button on the panel would get squished when an image with small height is uploaded and the size gets very longer when a bigger image is uploaded.
• Editor/Web: Export the types FeaturePredicate and FeaturePredicateContext used by the Feature API
• Editor/iOS: For scenes without a stack, the toggle pages button is no longer visible by default in the design editor.
• Editor/Web: Fix an issue where the background color inspector is not visible in some cases.

Breaking Changes

• Editor/iOS: Added new SwiftUI view modifiers: .imgly.navigationBarItems and .imgly.modifyNavigationBarItems, which allow customization of the navigation bar (a list of items shown at the top of the editor). With this change, the button used to dismiss the editor should now always be managed through these new APIs, rather than being injected externally via a regular .toolbar modifier. The BackButtonHiddenKey preference key, previously used to control the visibility of the back button, has been marked as unavailable in favor of the new NavigationBar.Buttons.closeEditor button.
• Editor: Add new ‘Font Combinations’ asset source to our demo assets. It’s enabled by default in our static design editors. To disable, exclude ly.img.textComponents from addDemoAssetSources. Font combinations make use of groups and have limited editing experiences in our video-based editors for now and are therefore disabled there by default. When using these combinations, be aware that the resulting blocks reference font resources in our CDN. These will be replaced with archives in a future release to further decouple resources.
• Editor/iOS: Fixed scene mode not being available in AssetLibrary by removing @Environment(\.imglyAssetLibrarySceneMode) from the public API. Use AssetLibrarySceneModeReader instead.

Non Breaking Changes

• Engine/Android: Added new asset API AssetApi.applyAssetSourceProperty that applies AssetProperty to the Asset.
• Editor/Android: Added new inspector bar button InspectorBar.Button.rememberAnimations that opens the animations sheet in the video editor.
• Editor/Android: Added support for animations in the video editor.
• Editor/Android: Added new Background option to the inspector bar that controls the background of text design blocks.
• Engine: Fixed the playback control APIs to check if the given block is valid.
• Engine: When setting the none animation, and undo set is now added.
• Camera/Android: Enable video and preview stabilization if supported.
• Editor/Web: Fix an issue where the active card background was not visible on hover.
• Engine: When saving block hierarchies to archives, all referenced resources are now added to the archive.
• Editor/Web: Fixed an issue where setting the css custom property ‘—ubq-typography-font_family’ did not work when set under ‘.ubq-public’ class
• Editor/iOS: Fixed the initial scroll position in the timeline on iOS 18.
• Editor/iOS: Fixed scrollbar behavior in the timeline on iOS 18.
• Editor/iOS: Fixed the initial scroll position in the voiceover sheet on iOS 18.
• Editor/iOS: Fix loading error in the Design Editor for scenes without a stack.
• Editor: Allow resizing and moving of elements with mouse or gestures that have a percent unit in x-position, y-position, width, or height.
• Editor/Web: Improved the naming of the animation direction values of block animations in the video editor.
• Engine: When loading individual blocks while no scene is present, design unit information will now be retained and used when saving those blocks again.
• Engine: When loading blocks, design unit conversion is now applied to the entire loaded hierarchy, not just its roots.
• Editor/Web: Fix an issue where disabling the text color feature via configuration will also affect the fill of other block types.
• Editor/Android: Resolved an issue in the Photo Editor where the inspector bar briefly remained visible and interactive after closing the crop sheet. The inspector bar now hides immediately with the crop sheet.
• Editor/iOS: Fixed text alignment options to not depend on layer/resize scope.
• Editor/iOS: Fixed an issue where scrolling the asset library inadvertently tapped an asset on iOS 18.1+.

Breaking Changes

Non Breaking Changes

• Camera/Android: Enable video and preview stabilization if supported.

Breaking Changes

Non Breaking Changes

• Fix(Android): Fix asset property access crash.

Breaking Changes

Non Breaking Changes

• Editor/RN: Added option to change the kotlinCompilerExtensionVersion.
• Editor/RN: Added support for Kotlin v2.0.0+.
• Engine: Animations are no longer active during crop or text editing to allow more precise editing.
• Editor/Flutter: Added option to change the kotlinCompilerExtensionVersion.
• Editor/Flutter: Added support for Kotlin v2.0.0+.
• Engine: Animations are now only applied in design scenes (i.e. if the scene’s mode is Design and not Video).
• Engine: forceLoadAVResource no longer sets an error state when a block has an empty URI. Editor/RN: Fixed a crash on Android when exporting scenes containing content:// Uri(s). The SDK now allows these Uri(s) by default. Updated EditorResult documentation to clarify that such Uri(s) may not be reusable and recommend handling them using EngineConfiguration.onUpload and engine.editor.setUriResolver.
• Editor/RN: Fixed thumbnails not being encoded correctly.
• Editor/Flutter: Fixed thumbnails not being encoded correctly.
• Editor/Flutter: Fixed thumbnail of postcard editor exports would be blank.
• Editor/RN: Fixed thumbnail of postcard editor exports would be blank.
• Engine: Fixed a crash that could occur when the useSystemFontFallback setting was enabled while continuously changing a text block’s font.
• Engine/Web: Fixed HDR video display.
• Editor/Web: Improved selection frame behavior by preventing frame visibility during playback mode
• Engine: Fixed stuttering on exported videos.
• Engine: Fixed stutters and repeated frames in exported videos.
• Camera/iOS: Set preferredVideoStabilizationMode as standard to improve recording’s stabilization.

Breaking Changes

• Editor/Web: Revert breaking TextArea height introduced in 1.49.0

Non Breaking Changes

• Editor/Web: Fixed the editor crashing when being loaded in 32bit browsers.

Breaking Changes

• Engine: All video fill blocks and audio blocks now have playback looping disabled by default. Loading a scene created with the editor version 1.48 and earlier containing looping video fill and audio blocks will disable looping of these blocks and will add a metadata with the key ly.img.default-looping-disabled to these blocks. To re-enable looping on blocks intended to loop, use setLooping. The metadata can be safely removed.
• Engine/Node.js: The minimum required Node.js version is now 20.

Non Breaking Changes

Features

• Editor/Web: A new Ken Burns animation is available as an In and Out animation.
• Editor/iOS: Added a new Inspector Bar Button that opens a sheet for customizing text background color, padding, and corner radius.
• Editor/Android: Added an export error dialog for design scenes to handle errors gracefully and prevent crashes during the export process.
• Editor: We’ve introduced GIF support in our video editor, GIF files are now added as video clips instead of images when applied to a video scene.
• Engine: defaultApplyAsset recognizes the key-value pair "looping"/"true" in asset metadata and sets the "playback/looping" property to true for audio blocks and video fill blocks.

UI/UX

• Editor/Web: Added separate controls for vertical and horizontal padding in text background settings, providing more precise control over text appearance.
• Editor/Web: Tooltips will now appear faster when hovering over the controls in the editor.
• Editor/Web: Fixed keyboard navigation issues in the TypefaceSelect component including dropdown not closing on Enter and search field not clearing properly.

Fixes

• Engine: Fixed the crop zoom animation not to distort the fill when the fill mode is Fit.
• Engine: Fixed potential crash when replacing a GIF.
• Editor/Android: Fixed an issue where a gradient color stop would not appear as selected if it had the same value as the other color stop.
• Engine: Fixed missing text in exports if the font resources are not immediately loaded.
• Editor/Android: Fixed navigation bar overlapping UI elements in the asset library when using button navigation mode.
• Editor/Web: Fix an issue where in was not possible in some cases to have fully rounded corners on the text background due to the limitation on the max value of the rounded corners.
• Engine: Fixed exiting inline text editing mode to add an undo step without the need to wait for user input on the canvas.
• Editor/Web: Fixed an issue where Width and Height for Transform values were not updating correctly Editor/Flutter: Fixed a crash on Android when exporting scenes containing content:// Uri(s). The SDK now allows these Uri(s) by default. Updated EditorResult documentation to clarify that such Uri(s) may not be reusable and recommend handling them using EngineConfiguration.onUpload and engine.editor.setUriResolver.
• Editor/iOS: Ensure presented sheets correctly adopt the application’s color scheme on iOS 18, even when overridden.
• Editor/Web: Fixed an issue where the video playback performance was poor when editing complex videos.

Breaking Changes

Non Breaking Changes

• Editor/Web: Fixed color selector labels appearing cut off under some circumstances

Breaking Changes

• Editor/Android: Added a new configuration property navigationBar to EditorConfiguration that allows customizing the navigation bar (a list of items that appears at the top of the editor).
• Editor/Android: Removed navigationIcon parameter from EditorConfiguration. The navigationIcon in the navigation bar should now be customized via navigationBar parameter in EditorConfiguration.
• Editor/Android: IconTextButton composable function now also accepts tint: Color parameter that controls the tint color of icon/text.
• Engine: All video fill blocks and audio blocks now have playback looping disabled by default. Loading a scene created with the editor version 1.48 and earlier containing looping video fill and audio blocks will disable looping of these blocks and will add a metadata with the key ly.img.default-looping-disabled to these blocks. To re-enable looping on blocks intended to loop, use setLooping. The metadata can be safely removed.

Non Breaking Changes

• Editor/Web: Introduced the new ly.img.opacity feature key to control the opacity slider in the editor.
• Editor/Web: Introduced the new ly.img.blendMode feature key to control the blend mode select in the editor.
• Editor/iOS: Fixed an issue where assets would not correctly load when CocoaPods used in React Native apps where built using static frameworks.
• Editor/Web: Fixed an issue where Crop, Cover, and Fit dropdown was not creating history snapshots
• Editor/Android: Increased vertical inset in VideoEditor during crop mode to 24.dp.
• Editor/Web: Fix an issue where, when putting a spacer in front of the inspector bar elements, a separator is suddenly shown at the beginning.
• Editor/iOS: Overriding the .preferredColorScheme for the editor now also correctly changes the interface style for sheets.
• Engine: Fix HDR tone mapping for iOS
• Editor/Web: Update the video support error to align with our current supported browsers.
• Editor/Web: Fixed an issue with the showDialog UI API where a separator was shown in the dialog even when no actions were provided.
• Editor/Web: Fixed an issue with the showDialog UI API where the onClose callback was not always triggered when a dialog was closed.
• Engine: Fixed possibly wrong crop for elements that have a previewFileURI set with a preview image of a different aspect ratio than the original image.
• Editor/Web: Fix an issue where it was not possible to override the volume feature configuration to be shown for pages as well.
• Editor/Web: Fixed an issue where popovers and tooltips would sometimes briefly appear in the wrong position.
• Editor/Android: Reset trim offset to zero and trim length to new duration when replacing a block.
• Editor/iOS: Reset trim length to new duration when replacing a block.
• Editor/Web: Fix an issue where if the undo/redo controls are removed from the editor, the undo/redo shortcuts would not work.
• Editor/Web: Fix an issue where if the zoom controls are removed from the editor, the zoom shortcuts would not work.
• Editor/Web: Fix an issue where the panel API would not response if a panel is opened during initialization.
• Editor/Web: Fix an issue where calling supportsVideo in a supported browser would return false.
• Editor/iOS: Improved export performance on iOS with faster processing and reduced UI blocking.
• Editor/iOS: Remove “Replace” button when a voiceover is selected.
• Editor/iOS: Fix incorrect behavior when another block was previously selected before opening voiceover sheet.
• Editor/Android: Reduced update frequency of progress indicator during video export to improve export times.
• Editor/Web: Fixed an issue where Card labels had inconsistent top margin on asset library panel
• Editor/Web: Fixed an issue where Card height is not consistent
• Editor/Android: Fixed an issue where fill and stroke options were incorrectly displayed for a block, even when disabled, due to a missing scope check.

UI/UX Changes

• Editor/Web: Move the opacity and blend mode controls from the more menu into the inspector bar.
• Editor/Web: Introduced new canvas actions to control the arrangement of layers.
• Editor/Web: Removed the labels from some of the UI controls to make the UI cleaner.

Breaking Changes

Non Breaking Changes

• Editor/Web: Fix a visual glitch when opening an Asset Library grid view.
• Camera/Android: Fixed countdown timer broken layout on increasing system font size.
• Engine: Fixed that a block could end up with a distorted image or video fill if block.fillParent was used and the resource was not yet loaded, see documentation.
• Editor/Web: Fix a bug where double-clicking does not activate Crop Mode or Text Mode in Safari.
• Editor: Improved the error icons on failed blocks, e.g., if an image cannot be decoded.
• Editor/Web: Fixed an issue where image preview would not work for imported archives.
• Engine/Swift: Fixed potential crashes after loading a different scene in the same engine instance.
• Engine/Swift: Improved memory footprint when loading large videos.
• Engine: Fixed an text layouting issue for text blocks with automatic width and height where words could be clipped-off for some fonts.
• Editor/Web: Fixed missing playhead in trim seeker
• Engine: Updated the URI handling to no longer send the fragment part to the server.
• Engine: Fixed an issue that could prevent scene interactions while video thumbnails are being generated.
• Engine: Fixed variable FPS videos not showing the correct frame.
• Engine: Fixed video empty edit lists not being handled correctly.
• Editor/Web: When video editing is not supported, details about the missing APIs and codecs are logged to the console.
• Editor/Web: Introduced a new checkVideoSupport method that throws an error with the reason when video editing is not supported.
• Editor/Web: Introduced a new checkVideoExportSupport method that rejects with the reason when the video export is not supported.
• Editor/Web: Added a new builder.TextArea option placeholder to set the placeholder text for the textarea.
• Editor/Web: Allow using suffix as builder.TextArea option which renders a suffix element after the inputLabel.
• Editor/Web: The @imgly/LoadingSpinner icon is now animated