MiSphere Converter for iOS

What is MiSphere Converter?

MiSphere Converter is an iOS/Android app to stitch images captured by Xiaomi Mijia Mi Sphere 360 or Madventure 360.

What's the difference from official app?

Supported format

• Not only JPG straight out of camera, JPG edited with other apps is also supported.

*Image size must be 6912x3456.

Leveling with manual fine-tuning

corrects residual leveling error (wavy lines) caused by the limitation of sensor accuracy.

You can also shift horizontal center as well

Advanced image quality

• adaptive (= distance-aware) stitching to avoid texture duplication
• adaptive color blending for seamless texture

How to use

1. Copy unstitched images to your phone

The unstitched image is stored in the camera, but you cannot download it via the official app (it automatically stitches when downloaded). Use wifi downloading in this app.

2. Stitching

1. Open the app and select unstitched images from your gallery.

2. Image is automatically converted to equirectangular format and leveled based on exif data.

3. (optional) You can manually fine-tune until it's perfectly leveled. Horizontal center can be also changed.

4. Hit the save icon then stitched image is saved in /MiSphereConverter folder. It takes 10~20 sec on decent devices.

3. Lens calibration (1st time only)

Probably you've got terrible stitching result. For best stitching, lens calibration is needed for each camera. Seeing is believing. Please refer to the great tutorial video by Janis. Although this video is made for Android, basically same.

4. Batch processing

If you select multiple images, all images are automatically stitched w/o interruption.

FAQ

Q: Stitching result is always terrible. I'm ripped off.

Yes, this is the toughest part if you have never used any stitching tools (e.g. Ptgui, hugin). There are two suggestions.

1. Please check your calibration image. Good / bad example is available in the app instruction.
2. Find corresponding points carefully. You might be selecting different objects, but looks similar.

If you still couldn't get good results, please contact me (mail). That's the fastest.

Q: It says "This image is not supported"

Make sure the image has correct resolution (6912x3456), and format (JPG). Some of your apps may automatically convert to unsupported one (e.g. GooglePhotos backup).

Q: Can I use protector?

No. Since this app uses entire image circle, narrowing FOV will cause significant stitching error.

Q: Supports two or more cameras?

Not supported.

Tips

Stitching after editing to reduce seam

Overall, "stitching after editing" gives better result because "editing after stitching" tends to cause hard seam issue. However you may still see soft seam issue in "stitching after editing" if you modified image drastically (e.g. HDR-effect).

License

OpenCV

By downloading, copying, installing or using the software you agree to this license. If you do not agree to this license, do not download, install, copy or use the software.

License Agreement

For Open Source Computer Vision Library

(3-clause BSD License)

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

Neither the names of the copyright holders nor the names of the contributors may be used to endorse or promote products derived from this software without specific prior written permission.

This software is provided by the copyright holders and contributors “as is” and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall copyright holders or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.

BSImagePicker

Copyright (c) 2015 Joakim Gyllstrom <joakim@backslashed.se>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

Swiftsoup

Copyright (c) 2016 Nabil Chatbi

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: