React Native Image Resizer

If you cannot use react-native link, you must manually configure the Android project by updating settings.gradle, app/build.gradle, and MainApplication.java.

1. Update settings.gradle: Include the project and point to the directory in node_modules.
2. Update app/build.gradle: Add the project to your dependencies block.
3. Update MainApplication.java: Import the package and add ImageResizerPackage to your ReactInstanceManager.Builder configuration.

#### settings.gradle
include ':react-native-image-resizer'
project(':react-native-image-resizer').projectDir = new File(rootProject.projectDir, '../node_modules/@bam.tech/react-native-image-resizer/android')

#### app/build.gradle
dependencies {
  ...
  implementation project(':react-native-image-resizer')
  ...
}

#### MainApplication.java
import com.reactnativeimageresizer.ImageResizerPackage;

// Inside your ReactInstanceManager.Builder configuration:
.addPackage(new ImageResizerPackage())

The createResizedImage method is the primary API for resizing images. It accepts a URI or path and returns a Promise that resolves with an object containing the new image's metadata.

import ImageResizer from '@bam.tech/react-native-image-resizer';

ImageResizer.createResizedImage(
  path,
  maxWidth,
  maxHeight,
  compressFormat,
  quality,
  rotation,
  outputPath
)
  .then((response) => {
    // response.uri is the URI of the new image that can now be displayed, uploaded...
    // response.path is the path of the new image
    // response.name is the name of the new image with the extension
    // response.size is the size of the new image
  })
  .catch((err) => {
    // Handle error
  });

import ImageResizer from '@bam.tech/react-native-image-resizer';

ImageResizer.createResizedImage(
  path,
  maxWidth,
  maxHeight,
  compressFormat,
  quality,
  rotation,
  outputPath
)
  .then((response) => {
    // response.uri is the URI of the new image that can now be displayed, uploaded...
    // response.path is the path of the new image
    // response.name is the name of the new image with the extension
    // response.size is the size of the new image
  })
  .catch((err) => {
    // Oops, something went wrong. Check that the filename is correct and
    // inspect err to get more details.
  });

Resizes an image and returns a Promise resolving to an object containing: path, uri, name, size (bytes), width (pixels), and height of the new file.

Parameters

The createResizedImage function allows you to resize an image from a given URI to specific dimensions, format, and quality. It supports different scaling modes and can optionally scale down only, preserve metadata, or specify a custom output path.

Parameters:

• uri (string): The local URI of the image to resize.
• width (number): The target width.
• height (number): The target height.
• format (ResizeFormat): The desired output image format.
• quality (number): The image quality (typically 0-100).
• rotation (number, optional): The rotation in degrees. Defaults to 0.
• outputPath (string | null, optional): A specific path where the resized image should be saved. If null, a default path is used.
• keepMeta (boolean, optional): Whether to preserve image metadata. Defaults to false.
• options (Options, optional): Configuration for scaling behavior. Defaults to { mode: 'contain', onlyScaleDown: false }.

Returns:

• Promise<Response>: A promise that resolves to a Response object containing the new image details (such as uri, width, height, etc.).