> For the complete documentation index, see [llms.txt](https://infinitypbr.gitbook.io/magic-pig-games/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://infinitypbr.gitbook.io/magic-pig-games/other/portrait-avatars/portrait3d.md).

# Portrait3D

Both `Portrait3D` and `Portrait2D` inherit from Portrait. As you might expect, one handles 3D portraits, while the other handles 2D portraits.

{% hint style="success" %}
`Portrait3D` should be attached to your 3D Avatar prefab. Check the Portrait Avatar object in the prefabs folder for an example. Learn more about [**creating your own Portrait Avatar**](/magic-pig-games/other/portrait-avatars/setup/create-a-portrait-avatar.md).
{% endhint %}

For this page, we will be looking at the **Portrait Avatar - Demo 3D** object, in the `Portraits/Demo/Prefabs` folder. This is the 3D Avatar used in the demo scene.

{% hint style="info" %}
Note that the **Portrait Avatar - Demo** object has a `DemoAvatarLoader` component on it. In the demo scene, this handles the randomization of the 3D avatar when it is created, using the LoadAvatar() method.

Your custom avatar object will likely have a similar method which handles all the custom logic unique to your project.
{% endhint %}

<figure><img src="/files/48tczTGWvLeKsf1etEQJ" alt=""><figcaption></figcaption></figure>

## Render Texture Width/Height

This will generally be equal values, and 256 is a good starting point. If you find your portraits resolution is low, you can increase this -- 512, 1024, etc. The larger the Render Texture, the more resource intensive your portraits will be. For small portraits on a smaller screen, you may be able to reduce the size.

## Lights

If your 3D Avatar is being lit by lights, add any that you'd like to control the color or intensity of via the [**Portrait Avatars**](/magic-pig-games/other/portrait-avatars/portrait-avatars.md) class to this `array`.

The methods on `PortraitAvatars` include an optional `bool` to only affect the first light in the `array`. Therefor, you may wish to put your main key / front light at the top of the `array`.

## Transition Options

When the `Set()` methods are called, they will default to a transition period, based on the time set here. Call the "Instant" version of the `Set()` methods if you want to skip the transition entirely.

## 3D Plumbing

Add a reference to your [**Avatar Camera**](/magic-pig-games/other/portrait-avatars/avatar-camera.md) class, which should be attached to the camera which is tasked with looking at your 3D Avatar.

## Scripting

The `Portrait3D` class has a number of methods which are most generally called by the [**Portrait Avatars**](/magic-pig-games/other/portrait-avatars/portrait-avatars.md) object. While you can call these directly on the `Portrait3D` object, I suggest you instead choose to use the `PortraitAvatars.instance` to call the versions of the methods there.