Skip to content

Customiser Troubleshooting

  • Make sure to check the browser console. Common errors are cleanly reported with a 270 Degrees prefix.
  • Make sure you are running from a server. The 270 Degrees Viewer will not work from a file:// address.

None of the methods are working

This means the Customiser was not loaded or attached properly. The console most likely reports [Method] is not a function.

  • Check the console to make sure the plugin is loaded correctly. Read about Installation.
  • Check if the plugin was attached to your Viewer. The console should read 270 Degrees: Attached TSDCustomiser to [HTMLElement].
  • Check for race conditions. You might be calling the Method before the Viewer is done initialising. Read more about onLoadComplete.

Image set through setTexture() is distorted

By default the image will get scaled to fit the object's texture size. You can mitigate this by passing a scale, like contain, cover or a factor.
Read more about texture scale.

setText() shows the wrong font

The setText() method is dependant on the browser's loaded fonts. Either the passed font is not loaded yet, or not used yet. You can force a browser to load a font by adding a hidden element to the page:

<div id="forceFont"></div>
<style>
  #forceFont { height: 0; width: 0; overflow: hidden; position: fixed; left: -100vw; top: -100vh; }
  #forceFont:before {content: 'abcd', font-family: 'yourFont'; }
</style>

My colors look different than the color codes I passed in setColor()

By default, the viewer uses natural color rendering with cinematic tone mapping for a realistic and visually balanced result. In most cases, this is ideal.
However, if you're showcasing products where exact material colors are important, as in ecommerce, you may want to enable trueColors: true and use lighting: neutral-2 for a more color-faithful presentation.
Read more about trueColors.