ResourceImporterImageFont

Hereda: ResourceImporter < RefCounted < Object

Importa una fuente de mapa de bits donde todos los glifos tienen el mismo ancho y alto.

Descripción

Este flujo de trabajo basado en imágenes puede ser más fácil de usar que ResourceImporterBMFont, pero requiere que todos los glifos tengan el mismo ancho y alto, los avances de glifo y los desplazamientos de dibujo se pueden personalizar. Esto hace que ResourceImporterImageFont sea más adecuado para fuentes de ancho fijo.

Véase también ResourceImporterDynamicFont.

Tutoriales

Propiedades

int

ascent

0

Rect2i

character_margin

Rect2i(0, 0, 0, 0)

PackedStringArray

character_ranges

PackedStringArray()

int

columns

1

bool

compress

true

int

descent

0

Array

fallbacks

[]

Rect2i

image_margin

Rect2i(0, 0, 0, 0)

PackedStringArray

kerning_pairs

PackedStringArray()

int

rows

1

int

scaling_mode

2


Descripciones de Propiedades

int ascent = 0 🔗

Ascenso de la fuente (número de píxeles por encima de la línea de base). Si se establece en 0, se utiliza la mitad de la altura del carácter.


Rect2i character_margin = Rect2i(0, 0, 0, 0) 🔗

Margen aplicado alrededor de cada glifo importado. Si tu imagen de fuente contiene guías (en forma de líneas entre glifos) o si el espaciado entre caracteres parece incorrecto, intenta ajustar character_margin.


PackedStringArray character_ranges = PackedStringArray() 🔗

Los rangos de caracteres a importar desde la imagen de la fuente. Este es un array que mapea cada posición en la imagen (en coordenadas de tile, no píxeles). El atlas de la fuente se recorre de izquierda a derecha y de arriba a abajo. Los caracteres se pueden especificar con números decimales (127), números hexadecimales (0x007f, o U+007f) o entre comillas simples ('~'). Los rangos se pueden especificar con un guión entre caracteres.

Por ejemplo, 0-127 representa el rango ASCII completo. También se puede escribir como 0x0000-0x007f (o U+0000-U+007f). Como otro ejemplo, ' '-'~' es equivalente a 32-127 y representa el rango de caracteres ASCII imprimibles (visibles).

Para cualquier rango, el avance y el desplazamiento del carácter se pueden personalizar añadiendo tres valores enteros separados por espacios (avance adicional, desplazamiento x, desplazamiento y) al final. Por ejemplo, 'a'-'b' 4 5 2 establece el avance a char_width + 4 y el desplazamiento a Vector2(5, 2) para ambos caracteres a y b.

Nota: El número total de caracteres no debe exceder el número de columns multiplicado por rows. De lo contrario, la importación de la fuente fallará.

Note: The returned array is copied and any changes to it will not update the original property value. See PackedStringArray for more details.


int columns = 1 🔗

El número de columnas en la imagen de la fuente. Véase también rows.


bool compress = true 🔗

Si es true, utiliza compresión sin pérdidas para la fuente resultante.


int descent = 0 🔗

El descenso de la fuente (número de píxeles por debajo de la línea de base). Si se establece en 0, se utiliza la mitad de la altura del carácter.


Array fallbacks = [] 🔗

Lista de fuentes de respaldo a usar si no se encuentra un glifo en esta fuente de mapa de bits. Se intentará primero con las fuentes al principio del array.


Rect2i image_margin = Rect2i(0, 0, 0, 0) 🔗

El margen a cortar en los lados de toda la imagen. Esto se puede usar para cortar partes de la imagen que contienen información de atribución o similar.


PackedStringArray kerning_pairs = PackedStringArray() 🔗

Pares de kerning para la fuente. El par de kerning ajusta el espaciado entre dos caracteres.

Cada string consiste en tres valores separados por espacios: string "desde", string "hasta" y un desplazamiento entero. Cada combinación forma las dos strings para un par de kerning, por ejemplo, ab cd -3 creará pares de kerning ac, ad, bc, y bd con un desplazamiento de -3. Las secuencias de escape \uXXXX se pueden usar para añadir caracteres Unicode.

Note: The returned array is copied and any changes to it will not update the original property value. See PackedStringArray for more details.


int rows = 1 🔗

Número de filas en la imagen de la fuente. Véase también columns.


int scaling_mode = 2 🔗

Modo de escalada de fuente.