AutoSync Spin Images Library

1. Distribution

This library is available through autosyncstudio.com website.

There are two version:

  1. Javascript module
    https://vvs.autosyncstudio.com/lib/autosync-spin.module.js – recommended for JavaScript frameworks or websites built with NodeJS.

  2. Plain old JavaScript file
    https://vvs.autosyncstudio.com/lib/autosync-spin.js – recommended in all other cases

2. How to Use It

  1. Import the library.

  2. Create a div to use it as a container and assign an id to it.

  3. Instantiate AutosyncSpin passing a config object with the id, along with a path to spin images and a desired size.

For example:

<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Example</title> <script src="https://vvs.autosyncstudio.com/lib/autosync-spin.js"></script> </head> <body> <div id="spin-360-viewer"></div> <script> const autosyncSpin = new AutosyncSpin({ id: 'spin-360-viewer', path: 'https://storage.googleapis.com/autosync_tires/_spins/06026e3d311e72c7df6193ba5efd5f2e', size: 500, }); </script> </body> </html>

AutosyncSpin config object parameters:

  • id – The id assigned to the container.

  • path – An absolute URL (or a relative path under the same domain) where images are stored. All the images used for this library must be named from 1 to (24 or 36) and be in WebP format.

  • size – The desired size of the viewer (in pixels).

3. Method Reference

The library comes with utility methods to interact with its rendered content.

  • createCanvas(REQUIRED containerId: string) – Change container providing a new element ID.

  • setPath(REQUIRED path: string) – Change the path or URL where images are stored. To take effect, reload() must be called.

  • setSize(REQUIRED size: number) – Change the size of the viewer and the container. To take effect, reload() must be called.

  • showError(val: boolean) – Show/hide an error message when loading images fails.

  • reload() – Reset all the variables used to set state (excluding path and size), and load again the viewer.

 

AutoSync © 2019-2021 All Rights Reserved