Ascii

Convert imagery to ASCII character art

Props

  • characters

    Characters ordered from dense to sparse. First character is used for bright areas, last for dark areas.

    Type
    string
    Default
    @%#*+=-:.

  • cellSize

    Size of each ASCII character cell (normalized to 1080p reference, scales proportionally at other resolutions)

    Type
    number
    Default
    30

  • fontFamily

    Font family for characters

    Type
    "Azeret Mono" | "Courier Prime" | "Cutive Mono" | "Fira Code" | "Geist Mono" | "IBM Plex Mono" | "JetBrains Mono" | "Major Mono Display" | "Martian Mono" | "Nova Mono" | "Press Start 2P" | "Roboto Mono" | "Share Tech Mono" | "Silkscreen" | "Source Code Pro" | "Space Mono" | "Syne Mono" | "VT323" | "Xanh Mono"
    Default
    JetBrains Mono

  • spacing

    Character size within each cell (1.0 = optimal size, 0.0 = smallest)

    Type
    number
    Default
    1

  • gamma

    Brightness curve adjustment. <1 brightens darks (more light characters), >1 darkens midtones (more dark characters). Use to better fit characters to image brightness range.

    Type
    number
    Default
    1

  • alphaThreshold

    Pixels with alpha below this threshold become fully transparent.

    Type
    number
    Default
    0

  • preserveAlpha

    When enabled, output alpha matches input alpha. When disabled, pixels above the alpha threshold become fully opaque.

    Type
    boolean
    Default
    true

Usage

<Shader>
  <Ascii>
    <Circle />
  </Ascii>
</Shader>