Single tool use

View on GitHub

When you want customers to perform only one action on the photo, you can use single tool mode on PhotoEditor SDK. Single tool mode supported tools are Transform, Filters, Adjustments, Focus, Overlays, and Brush.

To open the editor in single tool mode, two constraints need to be satisfied. You need to set singleToolMode to true (set by default) and make sure you only set one tool to be available in tools.

The tool menu items displayed in the main menu can be configured through the configuration.tools option and takes an array of Tools, so we will set the array to only include the tool item we want to use.

Make sure your license includes the tool you want to use. For further information on the configuration.tools option please refer to our dedicated section.


import { Configuration, PESDK, Tool } from "react-native-photoeditorsdk";

export const photoSingleToolExample = async (): Promise<void> => {
  // Add a photo from the assets directory.
  const photo = require("../../../../assets/pesdk/LA.jpg");

  try {
    // Create a `Configuration` object.
    const configuration: Configuration = {
      // In this example, the single tool mode is enabled.
      singleToolMode: true,
      // To determine which tool is used, we need to assign it.
      // For this example, we only use the transform tool.
      tools: [Tool.TRANSFORM],
    };

    // Open the photo editor and handle the export as well as any occuring errors.
    const result = await PESDK.openEditor(photo, configuration);

    if (result != null) {
      // The user exported a new photo successfully and the newly generated photo is located at `result.image`.
      console.log(result.image);
    } else {
      // The user tapped on the cancel button within the editor.
      return;
    }
  } catch (error) {
    // There was an error generating the photo.
    console.log(error);
  }
};

Single tool use

Configure menu items#