# Portraits

Here's an example `Portrait Installer.event`:

```
#include "Tools/Tool Helpers.txt"
//this file defines the macro:
//setMugEntry(number, data, mouth_x, mouth_y, eye_x, eye_y)

Sigurd_Mug:
#incext PortraitFormatter "sigurd.png"
setMugEntry(0x51, Sigurd_Mug, 3, 5, 3, 3)
```

Easy, right?

In free space, you simply label the portrait and use #incext PortraitFormatter to convert the PNG for insertion. Then use setMugEntry to set the portrait ID and the tile locations for the eye and mouth frames.

## Formatting Portraits

Formatting portraits is the same between buildfiles and FEditor.

This is a hackbox. Your portrait should fit in this.

![Hackbox](https://i.imgur.com/2MpEGSA.png)

## Ripping Portraits

You can use FEditor to rip portraits and have them formatted ready to go. Alternatively you can download all the GBA portraits [**right here**](https://doc.feuniverse.us/static/resources/mugs.png).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tutorial.feuniverse.us/gfx/portraits.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.