Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zebrajaeger/sphere2cube-js

Converter for images to panoramic viewer
https://github.com/zebrajaeger/sphere2cube-js

equirectangular jpg js pannellum pano panorama partial-panorama png psb psd

Last synced: 9 days ago
JSON representation

Converter for images to panoramic viewer

Host: GitHub
URL: https://github.com/zebrajaeger/sphere2cube-js
Owner: zebrajaeger
License: isc
Created: 2020-07-15T11:04:42.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2022-06-22T17:03:17.000Z (over 2 years ago)
Last Synced: 2024-10-12T19:14:33.271Z (24 days ago)
Topics: equirectangular, jpg, js, pannellum, pano, panorama, partial-panorama, png, psb, psd
Language: JavaScript
Homepage:
Size: 565 KB
Stars: 9
Watchers: 2
Forks: 2
Open Issues: 10
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # @zebrajaeger/createpano

[![NPM Version](https://img.shields.io/npm/v/@zebrajaeger/createpano.svg?style=flat)](https://www.npmjs.org/package/@zebrajaeger/createpano)

[![Install Size](https://packagephobia.now.sh/badge?p=@zebrajaeger/createpano)](https://packagephobia.now.sh/result?p=@zebrajaeger/createpano)

[![License](https://img.shields.io/github/license/zebrajaeger/sphere2cube-js)](https://img.shields.io/github/license/zebrajaeger/sphere2cube-js)

Convert

- full spheric panorama image to viewer (equirectangular)

- 360° panorama image to viewer (y to small for equirectangular)

- partial panorama image to viewer

Reads 

- PSD and PSB with RAW or RLE Encoding

- jpg

- png

Writes

- preview (cubic)

- preview (downscaled)

- tiles (pyramide levels)

- html (pannellum implementation)

- all above as zip file 

## Installation

```bash

$ npm install -g  @zebrajaeger/createpano

```

## Usage

### Minimum

```bash

$ createpano -i sourceimage.psd

```

## Options

```bash

Usage: cli [options]

Options: 
  -V, --version 
  -i, --source 
  -ipa, --panoAngle 
  -ipy, --panoYOffset 
  -o, --output 
  -te, --targetSize 
  -fr, --facesToRender 
  -ti, --tilesIgnore 
  -ts, --tileSize 
  -tq, --tileJpgQuality 
  -tp, --tilePathTemplate 
  -tpt, --tilePathType 
  -c, --renderCube 
  -cp, --cubePath 
  -cq, --cubeJpgQuality 
  -pi, --previewIgnore 
  -pcp, --previewCubePath 
  -pcq, --previewCubeJpgQuality 
  -pfp, --previewFlatPath 
  -pfo, --previewFlatOrder 
  -pfq, --previewFlatJpgQuality 
  -psp, --previewScaledPath 
  -psf, --previewScaledFactor 
  -psq, --previewScaledJpgQuality 
  -pw, --previewWidth 
  -sp, --signaturImagePath 
  -ss, --signaturSide 
  -sb, --signaturBelow 
  -hi, --htmlIgnore 
  -ht, --htmlTitle 
  -hpp, --htmlPannellumFile 
  -hmp, --htmlMarzipanoFile 
  -zi, --zipIgnore 
  -zp, --zipPath 
  -v, --verbose 
  -h, --help 
```

output the version number Source image (mandatory) Angle of pano (default: "360") Y-Offset in degree [-90.0...90.0] (default: "0") Output folder (default: "_dist") Image edge length of a face @ max resolution (default: inputImage.x / 4) Faces To render (default: "flrbud") Dont render tiles Tile size (default: "512") Jpg Image quality of tiles in percent (default: "85") Tile path template (default: "{{levelCount}}/{{face}}{{y}}_{{x}}.{{fileType}}") Tile image type (default: "jpg") Render cube sites in full resolution Cube sites path (default: "{{face}}.jpg") Cube Jpg Image quality (default: "85") Dont render preview Path and name of preview image (default: "preview.q.jpg") Preview quality in percent (default: "85") Path and name of preview image (default: "preview.f.jpg") Face order from left to right (default: "bdflru") Preview quality in percent (default: "85") Path and name of preview image (default: "preview.s.jpg") Factor for one Downscaling (default: "1.4142135623730951") Preview quality in percent (default: "85") Preview width (default: "1000") Signature image Signature side (default: "d") Signature below pano image Don't render html Head-Title-Tag (default: inputImage) Path of Pannellum .html file (default: "index.p.html") Path of Marzipano .html file (default: "index.m.html") Don't zip Path for Zip File (default: "pano.zip") verbose display help for command

## Preview

Made here: 47.162081, 10.923371

### Downscaled

![dsf](./doc/preview.eq.png)

### Cubic

![dsf](./doc/preview.png)

## TODO

- Flat image example

- zip refactoring

- parse exif data (needed?)

- parse xmp (for Autopano Giga, but GoPro seems to let it die. So needed?)

## Many Thanks to

- https://stackoverflow.com/questions/29678510/convert-21-equirectangular-panorama-to-cube-map

- https://de.wikipedia.org/wiki/Alpha_Blending

- https://stackoverflow.com/questions/1726630/formatting-a-number-with-exactly-two-decimals-in-javascript