From App Bundle

PhotoEditor SDK supports adding custom frames from the app bundle.

Adding Frames#

Custom frames can be added by specifying them in the configuration.frame.items array. Each frame takes a unique identifier, a name, a relativeScale, an optional thumbnailUri as well as an optional layoutMode.

Image Groups#

To add the images for each frame tile, you can specify them inside the imageGroups property. Each frame consists of four groups corresponding to each side of the frame. In our example, we opt for the "horizontal inside" mode of arranging image tiles providing only a middle image for the left and right parts of the frame and a start, middle and end image for the top and bottom parts. Refer to the guide on frames for an in-depth explanation.

Image Modes#

By default, the midMode is set to FrameTileMode.repeat which repeats the middle image to fill out the entire space. For this example, it is set to FrameTileMode.stretch for all image groups to keep the correct pattern. In this mode, the middle image is stretched to fill out the entire space.


import 'package:catalog/models/code_example.dart';
import 'package:imgly_sdk/imgly_sdk.dart';
import 'package:photo_editor_sdk/photo_editor_sdk.dart';

class PhotoFramesLocalExample extends CodeExample {
  @override
  void invoke() async {
    // Create an [ImageGroupSet] to assign the local assets for
    // a custom frame.
    final imageGroupSet = ImageGroupSet(
        top: FrameImageGroup("assets/imgly_frame_lowpoly_top.png",
            startUri: "assets/imgly_frame_lowpoly_top_left.png",
            endUri: "assets/imgly_frame_lowpoly_top_right.png",
            midMode: FrameTileMode.stretch
            ),
        left: FrameImageGroup("assets/imgly_frame_lowpoly_left.png",
            midMode: FrameTileMode.stretch
            ),
        right: FrameImageGroup("assets/imgly_frame_lowpoly_right.png",
            midMode: FrameTileMode.stretch
            ),
        bottom: FrameImageGroup("assets/imgly_frame_lowpoly_bottom.png",
            startUri: "assets/imgly_frame_lowpoly_bottom_left.png",
            endUri: "assets/imgly_frame_lowpoly_bottom_right.png",
            midMode: FrameTileMode.stretch
            ));

    // Create [FrameOptions] to customize the frame tool.
    final frameOptions = FrameOptions(items: [
      Frame("custom_frame", "Custom", imageGroupSet, 0.1,
          "assets/imgly_frame_lowpoly_thumbnail.png",
          layoutMode: FrameLayoutMode.horizontalInside)
    ]);

    // Create a [Configuration] instance.
    final configuration = Configuration(frame: frameOptions);

    try {
      // Open the photo editor and handle the export as well as any occurring errors.
      final result = await PESDK.openEditor(
          image: "assets/LA.jpg", configuration: configuration);

      if (result != null) {
        // The user exported a new photo successfully and the newly generated photo is located at `result.image`.
        print(result.image);
      } else {
        // The user exported a new photo successfully and the newly generated photo is located at `result.image`.
        return;
      }
    } catch (error) {
      // The user exported a new photo successfully and the newly generated photo is located at `result.image`.
      print(error);
    }
  }
}