Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel7

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. Initialization

  1. Import the library.

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

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

For example:

Code Block
languagehtml
<!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-tire-_tires/_spins/06026e3d311e72c7df6193ba5efd5f2e',
        size: 500,
      });
    </script>
  </body>
</html>

AutosyncSpin config object parameters:

  • id – The id assigned to the container.

  • pathThe An absolute URL or Path (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 some util methods that can be used utility methods to interact with its rendered content.

  • createCanvas(

    Status
    colourRed
    titleREQUIRED
    containerId: String): This method is used on the constructor to create all. If you want to change the container to other DIV you can use this method. This method has a required parameter, containerId is required and should be a String.setPath(path: String): With this method can change string) – Change container providing a new element ID.

  • setPath(

    Status
    colourRed
    titleREQUIRED
    path: string) – Change the path or URL where images are stored. After set a new path you will reload the visualizer with the method To take effect, reload()must be called.

  • setSize(

    Status
    colourRed
    titleREQUIRED
    size: Number): This method can change number) – Change the size for of the viewer and the container. The size should be a Number value. After set a new size you will reload the visualizer with the method reload()To take effect, reload() must be called.

  • showError(val: Boolean): With this method you can show the error message sending a “true” value as parameter and false to remove itboolean) – Show/hide an error message when loading images fails.

  • reload(): This method will reset – Reset all the variables used to set states state (Not excluding path and size), and will load again the viewer.