> For the complete documentation index, see [llms.txt](https://docs.lightact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lightact.com/content-mapping/throwers.md).

# Throwers

A T*hrower* is a helper virtual object that facilitates the mapping of content onto various V*iewport* objects by taking into account their position in the 3D scene of the V*iewport*.

<div align="left"><figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-4fca764de68bd07377981edefb73d59b8637a083%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure></div>

## Creating and using Throwers

<div align="left"><figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-d551e606914a3b66b3cf2e0dbc48b051cf8eba54%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure></div>

You can create a thrower through Viewport's right click menu or by dragging from the Viewport toolbar.

<div align="left"><figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-4d840a6a02138ac4e3e38ee497403d9843ae5738%2Fthrowers1.gif?alt=media" alt=""><figcaption></figcaption></figure></div>

You can change which thrower is placed by the Toolbar by holding your mouse over the tiny arrow near the Thrower's icon in the Toolbar.

### Mapping content from a Thrower to Viewport objects

<div align="left"><figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-92da4083d112eae476eea2a5e1446277fc2f2e06%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure></div>

If you select any Viewport object, in its Content collapsible, you'll see a Sources section. In there, you can select the Thrower you would want to act as a content source of this Viewport object.

<div align="left"><figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-e1c130a2053366243e9293729b61d05551cd168c%2FmappingFromOrthogonalThrower.gif?alt=media" alt=""><figcaption></figcaption></figure></div>

Alternatively, you can simply drag from a Thrower onto a Viewport object to map it.

## Types of Throwers

There are **5** **types of Throwers**, each one of them projects (or throws) content in a different way: **Perspective**, **Orthogonal**, **Spherical**, **Cubic** and **Cylindrical**.

### Perspective thrower

<figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-6a15a3a524ff815a2c257a45b2a281bd26f067af%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Perspective thrower content as a projector would.

<div align="left"><figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-03764c29e28de6828104a2f64ef4bd27937db442%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure></div>

In its Properties, there is a Frustum collapsible, which adjusts how the thrower projects the content onto the object.

### Orthogonal thrower

<div align="left"><figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-ae44c351f89c888bcec6bfe8b771ac9c87d8e079%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure></div>

Orthogonal thrower projects content in a parallel way.

<div align="left"><figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-cab4b5b8523b5dc6d862c8f4e00955ff28d475e4%2ForthogonalThrower.gif?alt=media" alt=""><figcaption></figcaption></figure></div>

By adjusting its size, you also modify the way the thrower projects the content onto viewport objects.

### Spherical thrower

<div align="left"><figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-d7d2d2e3f1e4b285228010a0d97bde90a5b87030%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure></div>

Spherical thrower throws content in all directions.

<figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-482f1c02f5f3abd2854b27b23e61117b362c8d2e%2Fimage.png?alt=media" alt=""><figcaption><p>An example of equirectangular content.</p></figcaption></figure>

It works best with **equirectangular content**.

{% hint style="info" %}
**Good to know**: if your content appears horizontally flipped, use **Horizontal flip** checkbox.
{% endhint %}

### Cubic thrower

<div align="left"><figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-9ba39daead82362cea7066664fa8f27d79c5d9c4%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure></div>

Cubic thrower throws its content in all directions.

<figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-b2684908f41436134d5d02148fa7db296c9549f3%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

For the content itself it requires a cubemap. A cubemap is a texture where 6 rectangles, each representing one face of a cube, are positioned in a pattern as shown above.

{% hint style="info" %}
**Good to know**: make sure the resolution of your cubemap is the same as the resolution of your Thrower.
{% endhint %}

<div align="left"><figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-0816e03447d79eeb2cc69ff2d98053335839395e%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure></div>

This cube map then results in mapping as shown above.

{% hint style="info" %}
**Good to know**: if your content appears horizontally flipped, use **Horizontal flip** checkbox.
{% endhint %}

<figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fgit-blob-b16fab138af21e792808accd6e83ae60ab33f167%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

If your content is split into 6 square textures, you can use **To Cube Map** node to combine them into a suitable cube map.
