Nosmai Studio Add text to a filter
Nosmai Studio / Guides / Add text to a filter
Updated October 6, 2026

Add a Text layer in Nosmai Studio to show words over the frame, place them on the Layout view, and choose a font, size, and colour. Text can be fixed words or a value a game script sets live, such as a score. This is how you add captions, labels, and game HUD text to a filter.

Overview

A Text layer shows words over the frame. You add it, place it on the Layout view, and set its font, size, and colour in the inspector. Text can be fixed words you type, or a value a game script sets live (a score, a timer, a counter).

Product: Nosmai Studio · Platform: macOS, Windows · Updated: 6 October 2026 · Reading time: 8 minutes

Prerequisites

  • A project open in the editor.

Add a text layer

  1. In the Layers panel, press +, then choose Text (for a single piece of text) or Text layer (a group that holds several pieces, such as a score and a timer).
  2. The new text appears in the Layers list and the Layout view opens as a drag surface.

Set what it says

Select the text layer to open its inspector:

  • Source: Fixed words draws exactly what you type in the Words box.
  • Source: A value binds the text to a named parameter (a $PARAM), so a game script can set it live. The value has to be a string.

The Text inspector: source, words, font, size, and colour.

Set the font, size, and colour

  • Font: a bundled font, or import a .ttf or .otf.
  • Size: in points. The default is 48.
  • Colour: a hex value such as #ffffff.

Place it on the frame

Open the Layout view. The text shows on a frame surface with a face reference:

  • Drag the text to move it.
  • Drag a corner to resize; hold Command to keep its aspect.
  • Drag the top handle to rotate.

Placing text on the Layout view.

Game HUD text

For a game filter, a script writes to named text slots (a score, lives, a status, a countdown). If a slot has no matching text layer, the value will not show. The Code panel detects these slots and offers a one-click Create the missing text layers. See Add a script or shader.

Verify it worked

  • The text appears in the Layout view and can be dragged, resized, and rotated.
  • The font, size, and colour change the text as you set them.
  • For a bound value, the text layer lists the parameter it reads.

Common problems

What you seeWhyFix
The text is always uppercaseThe chosen font is a caps-style display font whose lowercase glyphs are drawn at cap heightPick a font with a true lowercase, or accept the caps look for that font
Game text does not appearThe script writes a slot with no matching text layerIn the Code panel, create the missing text layers for the detected slots
"A value" is disabled for a parameterThe parameter is not a string, and text needs a stringBind to a string parameter, or declare one
The Layout view is not offeredThe filter has no media or text layerAdd the text layer first; Layout then appears

Next steps

Reference

Nosmai

An AR and AI company. Founded on the idea that the next decade of software will be visual, and that the tools for it should be within reach of anyone building.

Newsletter

Product updates and release notes. No spam.

© 2026 nosmai, inc · all rights reserved