Configure Snapping

VideoEditor SDK supports several configuration options to customize the snapping behavior globally for all sprites in the editor. For a detailed explanation of how to configure different editor views, refer to this guide.

In this example configuration, the editor's snapping behavior is configured to act as a guide for the user to see where the sprites should be placed. A use case could be that an application displays the videos both in rectangular as well as in circular shapes which requires the editor to indicate in which area the sprites' visibility is best.

Rotational snapping#

Sprites snap based on their rotation. By default, the sprites snap to angles in 45-degree steps (0, 45 ... 315)

`enabled`#

By default, the snapping is enabled when rotating a sprite. In this example, this behavior is disabled since only the outer positional snapping guides are needed.

Positional snapping#

Sprites also snap based on their position on the canvas.

Inner positional snapping#

By default, sprites snap to the horizontal and vertical center lines. In this example, the inner positional snapping behavior is disabled.

`snapToVerticalCenterLine`#

If set to true (by default) the center of the sprite snaps to a vertical line indicating the center of the video. In this example, this behavior is disabled since only the outer positional snapping guides are needed.

`snapToHorizontalCenterLine`#

If set to true (by default) By default the center of the sprite snaps to a horizontal line indicating the center of the video. In this example, this behavior is disabled since only the outer positional snapping guides are needed.

Outer positional snapping#

Sprites snap to the border of the video along horizontal and vertical lines. By default, these lines are placed at a distance of 10% of the smaller side of the video from the border (corresponding to 0.1). In this example, we want to increase this distance to 15% to define the visibility of the video.


import { Configuration, VESDK } from "react-native-videoeditorsdk";

export const VideoSnappingConfigurationExample = async (): Promise<void> => {
  // Add a video from the assets directory.
  const video = require("../../../../assets/vesdk/Skater.mp4");

  // Create a `Configuration` object.
  const configuration: Configuration = {
    // For this example the editor's snapping behavior is configured
    // to act as a guide for the user to see where the sprites should
    // be placed. A use case could be that an application displays
    // the videos both in rectangular as well as in circular
    // shapes which requires the editor to indicate where the area
    // is in which sprites' visibility is best.
    snapping: {
      rotation: {
        // By default the snapping is enabled when rotating a sprite.
        // For this example this behavior is disabled since only the
        // outer positional snapping guides are needed.
        enabled: false,
      },

      position: {
        // By default the center of the sprite snaps to a vertical
        // line indicating the center of the video.
        // For this example this behavior is disabled since only the
        // outer positional snapping guides are needed.
        snapToVerticalCenter: false,

        // By default the center of the sprite snaps to a horizontal
        // line indicating the center of the video.
        // For this example this behavior is disabled since only the
        // outer positional snapping guides are needed.
        snapToHorizontalCenter: false,

        // By default the sprite snaps to a horizontal line
        // on the bottom of the video. This value is measured in normalized
        // coordinates relative to the smaller side of the edited video and
        // defaults to 10% (0.1).
        // For this example the value is set to 15% (0.15) to define the
        // visibility area of the video.
        snapToBottom: 0.15,

        // By default the sprite snaps to a horizontal line
        // on the top of the video. This value is measured in normalized
        // coordinates relative to the smaller side of the edited video and
        // defaults to 10% (0.1).
        // For this example the value is set to 15% (0.15) to define the
        // visibility area of the video.
        snapToTop: 0.15,

        // By default the sprite snaps to a vertical line
        // on the left of the video. This value is measured in normalized
        // coordinates relative to the smaller side of the edited video and
        // defaults to 10% (0.1).
        // For this example the value is set to 15% (0.15) to define the
        // visibility area of the video.
        snapToLeft: 0.15,

        // By default the sprite snaps to a vertical line
        // on the right of the video. This value is measured in normalized
        // coordinates relative to the smaller side of the edited video and
        // defaults to 10% (0.1).
        // For this example the value is set to 15% (0.15) to define the
        // visibility area of the video.
        snapToRight: 0.15,
      },
    },
  };

  try {
    // Open the video editor and handle the export as well as any occuring errors.
    const result = await VESDK.openEditor(video, configuration);

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