flutter-plugin-camera360

KO | EN

gitlite — search

#javascript #python #ai #golang #machine-learning #rust #docker #macos #nodejs #java #cli #awesome-list #security #ios

flutter-plugin-camera360

(★ 17)

360 Camera Flutter plugin

flutter-plugin-camera360 Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 360 Camera

This plugin allows the users to take 360 Panoramic Images using the phone's Camera. It uses OpenCV to stitch the images together.
A simple UI guides the user throughout the process, by displaying dots on the screen that the user should follow.

### Demo
Checkout [Tridiar - Virtual Tours](https://tridiar.com) application on [iOS](https://apps.apple.com/us/app/tridiar/id1593706196) and [Android](https://play.google.com/store/apps/details?id=com.tridiar.agent)

![Demo](https://raw.githubusercontent.com/maxal-studio/flutter-plugin-camera360/main/doc/demo.gif)

# Installation

### IOS
Add these lines into `Info.plist`
```plist
<key>NSCameraUsageDescription</key>
<string>This application needs access to your Camera in order to capture 360 Images</string>
<key>NSMicrophoneUsageDescription</key>
<string>This application needs access to your Microphone in order to capture videos</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>This application needs access to your Photo Library in order to save the captured images</string>
```

Change the minimum Android sdk version to 21 (or higher) in your `android/app/build.gradle` file.

```properties
minSdkVersion 21
```

`AndroidManifest.xml`

```xml
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 ```

### Dart
```dart
import 'package:camera_360/camera_360.dart';
import 'package:image_picker/image_picker.dart';
Camera360(
  // Determines when image stitching is performed.
  // If set to true, the application will check if each newly captured image
  // can be stitched with the previous one immediately after capture.
  // If set to false, all images will be captured first,
  // and stitching will be performed at the end.
  userCheckStitchingDuringCapture: true,
  // Text shown while panorama image is being prepared
  userLoadingText: "Preparing panorama...",
  // Text shown on while taking the first image
  userHelperText: "Point the camera at the dot",
  // Text shown when user should tilt the device to the left
  userHelperTiltLeftText: "Tilt left",
  // Text shown when user should tilt the device to the right
  userHelperTiltRightText: "Tilt Right",
  // Suggested key for iPhone >= 11 is 2 to select the wide-angle camera
  // On android devices 0 is suggested as at the moment Camera switchingis not possible on android
  userSelectedCameraKey: 2,
  // Camera selector Visibilitiy
  cameraSelectorShow: true,
  // Camera selector Info Visibilitiy
  cameraSelectorInfoPopUpShow: true,
  // Camera selector Info Widget
  cameraSelectorInfoPopUpContent: const Text(
    "Select the camera with the widest viewing angle below.",
    textAlign: TextAlign.center,
    style: TextStyle(
      color: Color(0xffEFEFEF),
    ),
  ),
  // Customizable message if camera is not found or not ready
  cameraNotReadyContent: const Center(
    child: Padding(
      padding: EdgeInsets.symmetric(horizontal: 10, vertical: 20),
      child: Text(
        "Camera not ready",
        style: TextStyle(fontWeight: FontWeight.bold),
      ),
    ),
  ),
  // Callback function called when 360 capture ended
  onCaptureEnded: (data) {
    // Returned data will be a map like below
    //{
    //  'success': true or false
    //  'panorama': XFile or null,
    //  'options': {
    //    'selected_camera': int KEY,
    //    'vertical_camera_angle': int DEG,
    //  }
    //}
    if (data['success'] == true) {
      XFile panorama = data['panorama'];
      print("Final image returned $panorama.toString()");
    } else {
      print("Final image failed");
    }
  },
  // Callback function called when the camera lens is changed
  onCameraChanged: (cameraKey) {
    print("Camera changed ${cameraKey.toString()}");
  },
  // Callback function called when capture progress is changed
  onProgressChanged: (newProgressPercentage) {
    debugPrint("'Panorama360': Progress changed: $newProgressPercentage");
  },
),
```

> `onCaptureEnded` will return `XFile` or `null`  
> - `XFile` if the panorama has been captured successfully   
> - `null` if the panorama has failed

## [Developer Documentation](doc/developer.md)

flutter-plugin-camera360

flutter-plugin-camera360 Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

flutter-plugin-camera360

flutter-plugin-camera360 Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README