# 2021.17.0 - August 19, 2021

**Environments**

`Preview`, `Admin-FTS`

###  Catalog

**Stage previews** have been added to Catalog Items so that you can preview products in different Stages within the platform.

Use the `Stage` tab in the player preview to see the list of available Stages and swap them in real time:<br>

<figure><img src="https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2FSzVoRfw6SKgcvEN8t0im%2Fitem-stage.png?alt=media&#x26;token=ed0bb7a8-d20c-47a1-b28f-9b8dfe1b3d4c" alt=""><figcaption></figcaption></figure>

If Stages have attributes, they will be displayed so you can configure the `Stage`:<br>

<figure><img src="https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2Fgh9ZKAtoRgEpGTj72rb2%2Fitem-stage-attr.png?alt=media&#x26;token=c8ab1c7a-a856-4c04-82cd-6b0822282f71" alt=""><figcaption></figcaption></figure>

`Stages` allow you to preview Items by using the `Items` tab. If the Item has attributes, they will be displayed:

![](https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2FGhXBU0uySSfxnF9yjRar%2Fstage-item-attr.png?alt=media\&token=0063609f-5656-4ed8-a9bd-b22c452a43a5)

The `Stage` preview can also be displayed when the player is embeded.

### Virtual Photographer

**Zoom quality** controls have been added for the Virtual Photographer player settings.

In Organization > Player settings, you can set the zoomed image quality and loading behavior:<br>

<figure><img src="https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2FkjPBv6pIaa7jYop8icSN%2Fzoom-settings.png?alt=media&#x26;token=029db6ac-2a6e-40b8-b714-3c0e6333e4ab" alt="" width="563"><figcaption></figcaption></figure>

Besies the resolution and quality settings, you can optionally set a delay for when the zoomed version loads: a number of seconds or upon zoom.

### WebGL

**Glass** can be represented in WebGL using the new Transmission properties in Physical Materials.

![](https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2F6isUUWuaOoa0KjEWA1GK%2Fglass.png?alt=media\&token=97d063e7-8f88-40bb-9131-cef786eaf0c6)

Under `Transparency`, turn on `Full Transmission`:<br>

<figure><img src="https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2FByFgJB8SVRj3O5ZEU6ML%2Ffull-transmission.png?alt=media&#x26;token=2b7495eb-f816-495f-8fba-623f8030c925" alt="" width="515"><figcaption></figcaption></figure>

`Transmission` properties will be displayed:<br>

<figure><img src="https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2FvaB5lxZCvR8WN8NF8K7n%2Ffull-transmission-options.png?alt=media&#x26;token=1c942f34-57d7-4296-978a-4fa4688f83fd" alt="" width="531"><figcaption></figcaption></figure>

**Falloff** properties have been added to Physical Materials as an Operator.<br>

<figure><img src="https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2FYfq1C70nqwUWdbM8hCMe%2Ffall-off-b-a.png?alt=media&#x26;token=cddea4cd-14d8-4812-bbd2-c899bcd904b3" alt=""><figcaption></figcaption></figure>

Add the new `Falloff` operator:<br>

<figure><img src="https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2FAtmUPfZuqRhjmjBg37uv%2Ffalloff-op.png?alt=media&#x26;token=67290598-d5e9-408a-a1a1-a6c9e5015b34" alt="" width="548"><figcaption></figcaption></figure>

### Assets

**Trash** has been added to Assets so that you can easily see what has been deleted and restore Assets.

Use the new `Go to trash` link on the Assets listing page.<br>

<figure><img src="https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2FKJhaRJcMhIGVPlqhCesZ%2Fgo-to-trash.png?alt=media&#x26;token=3d6737b1-f527-4c27-9dee-21aa9c7bd0dc" alt=""><figcaption></figcaption></figure>

Here you'll see a list of all Assets that have been deleted, who deleted them, and when they were deleted. You can also search and filter the listing:<br>

<figure><img src="https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2FTKLP0S6glOmIJgCzgpJq%2Ftrash-search.png?alt=media&#x26;token=3b46fb44-b2a6-434b-8a64-0ff52e82282a" alt=""><figcaption></figcaption></figure>

You can restore multiple Assets using bulk actions:<br>

<figure><img src="https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2FEYoXqgrrqBKZ1afpXPni%2Fbulk-restore.png?alt=media&#x26;token=8e6a18de-230f-452e-b14d-3a4d7d096278" alt="" width="479"><figcaption></figcaption></figure>

You can restore individual assets by right-clicking them and seleting `Restore`:<br>

<figure><img src="https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2FXkGDs9ZY6ykmB8h39P7s%2Fright-click-restore.png?alt=media&#x26;token=54f8c0b5-fa1e-4b2c-926a-9bc12d8bb21a" alt=""><figcaption></figcaption></figure>

You can view deleted Assets by clicking them. You can choose to restore from this page:<br>

<figure><img src="https://631883580-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBdhnsg0wyBQ1RrM9wHPt%2Fuploads%2Fehl12OXt0oYYE7ePXlf2%2Fpreview-restore.png?alt=media&#x26;token=69cdf626-9abb-4f78-a1af-e7add5e7043d" alt=""><figcaption></figcaption></figure>

Assets will be restored to their original folder.

### API

**Global Attributes** can be created, retrieved, and updated via the existing Product Import API: <https://docs.threekit.com/docs/product-import-api>

Sample:

```shell
{
    "attribute": {
      "type": "Asset",
      "name": "item attr test",
      "assetType": "model",
      "values": ["#TEST"],
      "defaultValue": { "assetId": "0e54ce92-39a2-40fc-8694-1611c748099c" }
    }
  }
```

ShellCopy

### Bugs/Cases

* GL7247 - Image unavailable is flashing before render loads
* GL7266 - Asset-Share Link returns a 404 error when used on Windows device
* GL7363 - Vray Dome lights render incorrectly when their rotation is different than 0
* GL7375 - Vray PostEffects are being applied to PNG images instead of EXR images
* GL7383 - Set property by metadata query performance
* GL7412 - Proxy Scene should not load Vray asset in front end
* GL7415 - Embed player shows empty configurator instead of hiding it
* GL7422 - Images not showing on production website