maxim-kolesnikov / react-native-heic-converter

Convert your HEIC files with React Native
MIT License
70 stars 23 forks source link
image-processing javascript javascript-library objective-c react reactnative

react-native-heic-converter

npm version npm MIT Platform - iOS issues

Contribution

Issues are welcome. Please add a code snippet. Quickest way to solve issue is to reproduce it on one of the examples in DEMO.

Pull requests are welcome. If you want to change API or making something big better to create issue and discuss it first. Before submiting PR please run eslint . Also all eslint fixes are welcome.

Getting started

$ npm install react-native-heic-converter --save

Features

Mostly automatic installation

$ react-native link react-native-heic-converter

Manual installation

iOS (via CocoaPods) Add the following lines to your build targets in your `Podfile` ``` pod 'react-native-heic-converter', :path => '../node_modules/react-native-heic-converter' ``` Then run `pod install`
iOS (without CocoaPods) 1. In XCode, in the project navigator, right click `Libraries` ➜ `Add Files to [your project's name]` 2. Go to `node_modules` ➜ `react-native-heic-converter` and add `RNHeicConverter.xcodeproj` 3. In XCode, in the project navigator, select your project. Add `libRNHeicConverter.a` to your project's `Build Phases` ➜ `Link Binary With Libraries` 4. Run your project (`Cmd+R`)<

Static Methods

RNHeicConverter.convert(options{}).then(result{})

Options

Property Type Default Description
path string Path to your .HEIC file
quality number 1 Set quality 0 to 1, for jpg extension only
extension string jpg File extension that you want get when convert: jpg or png or base64

Usage

import RNHeicConverter from 'react-native-heic-converter';

RNHeicConverter
    .convert({ // options
        path: '/path/to/file.heic',
    })
    .then((result) => {
        console.log(result); // { success: true, path: "path/to/jpg", error, base64, }
    });

Please have a look at my example usage.

CHANGELOG