> For the complete documentation index, see [llms.txt](https://docs.flatredball.com/gum/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flatredball.com/gum/gum-tool/gum-elements/text/outlinethickness.md).

# Outline Thickness

## Introduction

`Outline Thickness` can be used to create an outline around a font. The outline is saved in the .png of the font itself, so each value for `Outline Thickness` results in a new .fnt file and associated .png files created in the FontCache folder.

## Setting Outline Thickness

The `Outline Thickness` can be set on a Text object like any other variable.

![](/files/YpYSQSu6sukZhMaBxh1c)

`Outline Thickness` changes appear in the Gum window.

![](/files/8lMFaaUOOyTvy3t2WX7m)

## Outline and Color

Fonts with a non-0 Outline Thickness create a font file with a black outline. The inner part of the font is white, which is replaced by the font's color values. The black outline always remains black regardless of the color.

<figure><img src="/files/ZrJHCc3p4XMq66r5Z6lV" alt=""><figcaption><p>Color values change the internal part of the text, the outline stays black</p></figcaption></figure>

To create outline colors other than black, the outline color must be added to the font's PNG file.

One option is to create the desired font by adjusting a Text's properties, then the .fnt and .png files can be copied out of the FontCache folder and modified in an image editing program such as Photoshop or Paint.NET.

Alternatively, fonts with custom outline colors can be created with Hiero.

<figure><img src="/files/jqa2IgGq5IOY4jgKFvIX" alt=""><figcaption></figcaption></figure>

Outline quality tends to be better if it appears before the regular font color. When the outline effect is added, it will appear below the normal color. To move it up, click on the **Up button.**

<figure><img src="/files/x40erQIGb9ngrFVoyeXA" alt=""><figcaption><p>The first Text is using a custom Hiero font, the second is using a default font</p></figcaption></figure>

{% hint style="info" %}
If you are creating fonts in code rather than through the tool, colored outlines can be generated programmatically — no hand-editing of the .png required. See [Advanced Font Effects — Outline Color](/gum/code/files-and-fonts/fonts/advanced-font-effects.md#outline-color).
{% endhint %}

For more information on custom fonts, see the [Use Custom Font](/gum/gum-tool/gum-elements/text/use-custom-font.md) page.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.flatredball.com/gum/gum-tool/gum-elements/text/outlinethickness.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
