Interfaces em pixel art: caixas de texto, fontes e japonês

A caixa de diálogo de Pokémon Emerald é uma moldura de 30 por 6 tiles, a largura inteira de 240 pixels da tela e 30% da sua altura, em volta de uma janela de texto de 27 por 4 tiles que comporta duas linhas de uma fonte de 16 pixels; a de Crystal tem 20 por 6 tiles, duas linhas de 18 caracteres.¹²³ Emerald imprime um caractere a cada 8, 4 ou 1 quadros conforme o ajuste de velocidade, 7,5, 15 ou 60 por segundo a 60 hertz; o ajuste rápido de Crystal e Final Fantasy VI também imprimem um por quadro.¹⁴ Os roteiristas de Emerald quebraram cada linha à mão: em 24.100 linhas de texto de script, a mais larga tem 208 pixels contra uma janela de 216, e nenhuma transborda.¹ Uma fonte pixelada japonesa que cobre o conjunto padrão desenha cerca de sete mil caracteres: o JIS X 0208 tem 6.879, Misaki desenha todos numa célula de 8 por 8, PixelMplus10 todos menos três pontos de código numa grade de 10 pixels, e o produtor de Final Fantasy Pixel Remaster estimou a nova fonte japonesa da equipe em “around 7,500 characters” (cerca de 7.500 caracteres).⁵⁶⁷⁸ No meu Mac, com a suavização de fontes desligada, o Core Text desenhou as fontes pixeladas TrueType cuja grade fica sobre a linha de base e cujos avanços são de pixels inteiros (Misaki, PixelMplus10 e Press Start 2P) sem nenhum pixel parcial nos múltiplos inteiros da grade, e com 19,4% a 82,2% dos pixels com tinta borrados entre eles; PixelMplus12, cuja grade fica deslocada da linha de base, Silkscreen, com pontos de contorno soltos, e DotGothic16, sem grade, saíram com pixels parciais em todos os tamanhos medidos, e k8x12 em todos os tamanhos assim que seus glifos foram posicionados com exatidão; com a suavização padrão do contexto de desenho, até PixelMplus10 nos seus próprios 10 pixels saiu com 178 de 272 pixels com tinta parciais.⁷⁹ A 3×, um em de 10 pixels cai em pixels de dispositivo inteiros em apenas um dos doze tamanhos de Body do iOS, 40 pontos.⁷¹⁰ Hoje o Kiradex World compõe cada palavra na fonte monoespaçada do sistema, fala só inglês e entrega ao VoiceOver as coordenadas dos testes de caminhada.¹¹ Então medi as caixas, as fontes e as velocidades do cânone nas descompilações, medi cinco fontes pixeladas japonesas e duas latinas no Core Text e escrevi um briefing: uma única fonte licenciada para os dois idiomas, Dynamic Type arredondado à grade da fonte, uma moldura desenhada pela forja, duas linhas e páginas, e um palco que o VoiceOver consegue descrever.

Resumo

• A caixa é o terço inferior e duas linhas. A moldura de diálogo de Emerald tem 30 por 6 tiles (240 por 48 pixels, 30% da altura da tela) em volta de uma janela de 27 por 4 tiles com duas linhas de 16 pixels; a caixa de Crystal tem 20 por 6 tiles, 33% da altura, duas linhas de 18 caracteres, e a de Red é a mesma de 20 por 6. A caixa de Emerald não tem campo de nome, e 934 dos seus 14.412 parágrafos de script (6,5%) dizem quem fala dentro do próprio texto.¹²³¹²
• Velocidade é uma contagem de quadros. Emerald e FireRed levam 8, 4 ou 1 quadros por caractere (7,5, 15 ou 60 por segundo a 60 hertz), e um quadro enquanto A ou B fica pressionado depois de apertado durante a impressão; Crystal e Red esperam 5, 3 ou 1 quadro (12, 20 ou 60); Final Fantasy VI desenha o diálogo de campo a uma letra por quadro, sem ajuste para isso (a velocidade de mensagens em seis níveis é quanto tempo espera uma mensagem de batalha). A seta de avanço de Emerald se desloca 0, 1, 2 e 1 pixels a partir do repouso, um passo a cada 9 quadros, num ciclo de 0,6 segundo; o ▼ de Crystal pisca alternando com o tile da borda.^1131415164
• Cinco fontes gratuitas já desenham o japonês de que um jogo precisa. Misaki desenha todos os 6.879 caracteres do JIS X 0208 em 8 por 8, com cada kanji dentro de 7 por 7; k8x12, em 8 por 12; PixelMplus12 e PixelMplus10 desenham todos menos três pontos de código em 12 e 10 pixels; DotGothic16 desenha todos, mas sem grade de pixels. A licença de três frases de Misaki, k8x12 e PixelMplus concede uso, cópia e distribuição “either commercially or noncommercially” (comercialmente ou não).^5671718
• Uma fonte pixelada só é nítida com pixels de dispositivo inteiros por pixel de fonte, e só se o arquivo estiver limpo. Medido com o Core Text no macOS 27.0, não num iPhone, com a suavização de fontes desligada: 0,0% de pixels parciais nos múltiplos inteiros de uma grade sobre a linha de base e com avanços de pixels inteiros (Misaki, PixelMplus10, Press Start 2P), de 19,4% a 82,2% entre eles.⁷ Com a suavização padrão do contexto de desenho, PixelMplus10 nos seus próprios 10 pixels saiu com 178 de 272 pixels com tinta parciais, então o resultado limpo nos múltiplos inteiros só vale com a suavização desligada.⁹ A grade de PixelMplus12 fica 0,39 pixel abaixo da linha de base e, com a suavização desligada, borra em todos os tamanhos; o avanço de kana de k8x12, de 8,01 pixels, borra assim que os glifos são posicionados com exatidão.⁷¹⁹
• Dynamic Type precisa ser arredondado, não seguido. Dos doze tamanhos de Body do iOS, de 14 a 53 pontos, um em de 10 pixels é inteiro a 3× só em 40 pontos, um em de 8 pixels em 16 e 40, e um em de 12 pixels em 16, 28 e 40. A Apple pede que uma fonte personalizada implemente os comportamentos que as fontes do sistema têm, entre eles o Dynamic Type, e, para o texto de um app, que de preferência as pessoas possam ampliá-lo em pelo menos 200 por cento.⁷¹⁰²⁰
• A quebra de linha japonesa é estrita sem marcação e frouxa com marcação. No Core Text do macOS, um parágrafo de 131 caracteres quebrou sem que nenhuma linha começasse com um caractere da lista de início de linha da sonda (uma lista parcial, na maior parte caracteres do JLREQ, com sete nas formas de largura total) em nenhuma das larguras medidas, sem marcação; marcado com ja, um kana pequeno abriu uma linha em 6 de 7 larguras em Hiragino Sans, Misaki, PixelMplus e DotGothic16, a regra menos estrita que os requisitos de composição japonesa do W3C descrevem.⁷²¹
• O que isso dá ao Kiradex. Um briefing, não um build: PixelMplus10 para cada palavra desenhada sobre o mundo (das duas fontes medidas com japonês, grade limpa e avanços de pixels inteiros, Misaki e PixelMplus10, a maior), tamanhos arredondados a pixels de dispositivo inteiros por pixel de fonte (16,67 pontos no tamanho padrão nos iPhones de 3×, 15 nos de 2×), uma moldura própria desenhada pela forja, duas linhas e páginas, uma revelação de 30 caracteres por segundo com uma marca que avança em passos, balões de uma linha dimensionados para caber no iPhone mais estreito que o simulador do iOS 27.0 lista quando as laterais não têm margens, uma linha que não cabe indo para a caixa, linhas em japonês revisadas por um falante de japonês e um palco que o VoiceOver descreve com palavras em vez de coordenadas, cada item com uma verificação que um script, uma linha de log ou uma captura podem aprovar ou reprovar, com exceção de uma verificação manual do VoiceOver.²²¹¹

1. Emerald e FireRed: uma moldura de lado a lado, duas linhas, escritas à mão

Esta série começou pelo mundo e vem trabalhando de fora para dentro. Mundos em pixel art no iPhone definiu o sistema de tiles, a receita de RealityKit e uma direção para o texto numa regra, “Text is art” (texto é arte), e numa frase de plano: “m5x7 at integer multiples in a 24-by-24 nine-slice box, two lines, typewriter reveal, a two-frame advance arrow” (m5x7 em múltiplos inteiros numa caixa nine-slice de 24 por 24, duas linhas, revelação de máquina de escrever, uma seta de avanço de dois quadros).²³ Os posts seguintes construíram o colecionador, os prédios, o movimento, a vida própria da cidade, os cômodos e as estradas. O texto ficou naquela frase. Este post mede de onde vêm os números dela, encontra quatro pontos em que o post do mundo está errado ou impreciso e acrescenta o que ele não tinha: japonês em matrizes de 8, 10 e 12 pontos, o que o Core Text realmente faz com uma fonte pixelada TrueType, como o Dynamic Type e uma grade de pixels podem chegar a um acordo, a quebra de linha japonesa e o VoiceOver sobre um palco de RealityKit.

O texto do Kiradex World hoje é simples. Cada palavra é SwiftUI na fonte monoespaçada do sistema definida pelo tema. Os balões sobre a cabeça dos colecionadores são uma linha do papel caption do kit em negrito, sobre papel creme com uma borda de tinta de 2 pontos, exibida enquanto a linha tem menos de 4 segundos. A linha do lugar fica numa caixa de texto creme na parte de baixo da tela. O app é só em inglês, as linhas predefinidas ficam no servidor em inglês, a placa da forja é uma tábua de 12 por 11 com rabiscos de tinta e nenhuma letra, e o VoiceOver lê o palco como um único elemento cujo valor é o rastro de passos dos testes de caminhada.^{11242526272829} A seção 10 tem os detalhes; o briefing da seção 12 está escrito como um diff em relação a isso.

Cada número de Pokémon abaixo foi medido em clones rasos das descompilações do pret, em pokeemerald 731ad5b (1º de outubro de 2026), pokefirered 037335f, pokecrystal 5beda23 e pokered d2704a6, por um único script em Python, measure_gen_text.py, cuja saída está salva ao lado; os números de Final Fantasy VI vêm de um segundo script sobre o disassembly everything8215/ff6. Os dois rodam de novo em segundos, e as notas indicam o arquivo-fonte por trás de cada número.³⁰¹⁴

As fontes

Emerald declara suas fontes numa única tabela, sFontInfos em src/text.c, cada uma com largura e altura máximas de letra em pixels. A fonte pequena tem 5 por 12; a normal, que a caixa de diálogo usa, 6 por 16; a curta, 6 por 14, declarada quatro vezes (ela mesma e três cópias); a estreita, 5 por 16; a pequena estreita, 5 por 8; a negrito, 8 por 8; e a de braile, 8 por 16 com 8 pixels de entrelinha. Todas as outras têm entrelinha 0: a célula de 16 pixels é a linha.¹¹³

A fonte latina normal é proporcional. Indexadas pelo charmap.txt do jogo em gFontNormalLatinGlyphWidths de src/fonts.c, as minúsculas de a a z têm em média 5,77 pixels de largura, de 4 a 6; as maiúsculas de A a Z e os dígitos de 0 a 9 têm todos 6; o espaço e o ponto final, 3, e o ponto de exclamação, 4.¹³¹ Em texto corrido, isso dá uma média de 5,25 pixels por caractere, medida sobre cada linha do script do jogo analisado mais abaixo.¹

Velocidade é uma contagem de quadros

Em Emerald, a velocidade do texto é um atraso em quadros. As três velocidades da tela de Opções passam por sTextSpeedFrameDelays em src/menu.c e viram atrasos de 8 (lenta), 4 (média) e 1 (rápida). AddTextPrinter, em src/text.c, guarda o atraso menos um como a velocidade da impressora de texto; a impressora põe o contador nessa velocidade guardada quando imprime um caractere e o decrementa de um em um a cada quadro, e o próximo caractere sai no quadro seguinte àquele em que o contador chega a 0. Assim, um caractere leva o próprio atraso: 8, 4 e 1 quadros. A 60 hertz, isso dá 7,5, 15 e 60 caracteres por segundo.¹²¹³ Essa contagem é a minha leitura da máquina de estados da impressora (AddTextPrinter e o caso RENDER_STATE_HANDLE_CHAR em src/text.c), que o script afirma em vez de executar.¹ O Game Boy Advance não roda a exatos 60 hertz: o GBATEK dá o quadro dele como “Total 228 lines, 16.743 ms, 280896 cycles - ca. 59.737 Hz” (228 linhas no total, 16,743 ms, 280.896 ciclos, cerca de 59,737 Hz), 160 dessas linhas visíveis, cada uma com 240 pontos de largura, então o ajuste rápido dá cerca de 59,7 caracteres por segundo no hardware.³²³³

Segurar um botão acelera os ajustes mais lentos. Um novo aperto de A ou B enquanto o atraso de um caractere está sendo contado, numa mensagem que permita isso (gTextFlags.canABSpeedUpPrint), ativa hasPrintBeenSpedUp. A partir daí, a impressora verifica JOY_HELD(A_BUTTON | B_BUTTON) && subStruct->hasPrintBeenSpedUp e, quando a condição vale, baixa o contador para 0: um caractere por quadro, 60 por segundo, a mesma cadência do ajuste rápido.¹³¹

O texto com rolagem automática tem seu próprio atraso. Quando gTextFlags.autoScroll está ligado, a impressora põe o contador em 3 em vez da velocidade guardada, 4 quadros por caractere, exceto em batalhas gravadas: a condição é if (!(gBattleTypeFlags & BATTLE_TYPE_RECORDED) && gTextFlags.autoScroll).¹³¹ As mensagens de batalha ligam a rolagem automática em batalhas por cabo e em batalhas gravadas, e o comando de script messageautoscroll a liga e força a velocidade média.³⁴ Assim, o atraso de 3 pode valer para outras janelas de batalha em batalhas por cabo e para mensagens de script com rolagem automática, e nunca em batalhas gravadas, cujas mensagens saem na velocidade que a impressora recebeu: nas mensagens de batalha, a velocidade de texto salva com a gravação, exceto numa batalha por cabo gravada, cuja janela de mensagens recebe 1, como a de uma batalha por cabo.³⁴¹ Na minha leitura, o contador só corre enquanto a velocidade guardada da impressora é maior que 0, e a janela de mensagens de uma batalha por cabo recebe o atraso de 1, o que deixa o texto a um caractere por quadro com a rolagem automática ligada.¹³³⁴

Os três códigos de quebra fazem três coisas diferentes. \n leva a impressora para a segunda linha; \l espera sob a seta de avanço por um aperto e então rola a caixa uma linha para cima; \p espera do mesmo jeito e então limpa a caixa e recomeça do topo.¹³³⁵ Numa rolagem, a linha de 16 pixels sobe 1, 2 ou 4 pixels por quadro conforme o ajuste de velocidade (sWindowVerticalScrollSpeeds), então uma rolagem leva 16, 8 ou 4 quadros.¹¹³

A velocidade do texto em cada jogo medido e os dois ajustes propostos pelo briefing; desenhado por figures/make_figures.py a partir das saídas das medições.

A seta

Quando uma página está cheia, a caixa espera sob uma pequena seta. Emerald copia uma célula de seta de 8 por 16 com deslocamentos verticais de { 0, 1, 2, 1 } pixels (sDownArrowYCoords) e a redesenha quando o atraso dela, reiniciado em 8, se esgota. Isso dá um passo a cada 9 quadros e um ciclo de 36 quadros, 0,60 segundo a 60 hertz.¹¹³ A seta não pisca; ela balança, por três posições e de volta.

A caixa e sua moldura

A caixa de texto de campo de Emerald é definida por sStandardTextBox_WindowTemplates em src/menu.c. A janela de texto fica na coluna de tiles 2, linha 15, e tem 27 por 4 tiles: 216 por 32 pixels, duas linhas da fonte normal de 16 pixels. A moldura, desenhada por WindowFunc_DrawDialogueFrame e avaliada pelo script para essa janela, vai da coluna 0 à 29 e da linha 14 à 19: 30 por 6 tiles, 240 por 48 pixels, a largura inteira da tela e 30% dos seus 160 pixels de altura.¹²

Essa moldura não é um nine-slice. LoadMessageBoxGfx a carrega de message_box.png, uma tira de 56 por 16 pixels, 14 tiles, e a moldura é desenhada a partir de oito posições de tile, com a linha de baixo sendo a de cima espelhada verticalmente com BG_TILE_V_FLIP.¹³⁶² O script mede a extensão da moldura e o tamanho do PNG; o espelhamento é lido nas chamadas de preenchimento.¹

As molduras escolhidas pelo jogador são para as outras janelas: os menus e as caixas de sim ou não. WINDOW_FRAMES_COUNT vale 20, e as vinte molduras são PNGs de 24 por 24 pixels, três por três tiles de 8, carregados por LoadUserWindowBorderGfx a partir do tipo de moldura salvo pelo item FRAME da tela de Opções.¹³⁶

Isso corrige o post do mundo. A regra 10 dele diz “Pokémon Emerald’s text-window frame is a 24-by-24 image, three by three hardware tiles, which is a nine-slice” (a moldura da janela de texto de Pokémon Emerald é uma imagem de 24 por 24, três por três tiles de hardware, ou seja, um nine-slice).²³ As vinte imagens de 24 por 24 em graphics/text_window/ são as molduras selecionáveis das janelas de menu. A caixa de diálogo, a caixa de texto que os jogadores lembram, é desenhada a partir do message_box.png de 56 por 16 pixels como uma moldura de 30 por 6 tiles com a borda de baixo espelhada, não como um nine-slice de uma imagem de 24 por 24.¹³⁶ A ideia do nine-slice continua de pé, e os menus a usam; a atribuição à caixa de diálogo, não.

As duas caixas de diálogo como grades de tiles, sem arte dos jogos; desenhado por figures/make_figures.py, que confere cada extensão contra measure_gen_text.out.

O texto foi escrito para a caixa

Para ver quão cheia a caixa fica, o script leu cada linha do texto de script de Emerald: 504 arquivos, os 36 de data/text/*.inc e os scripts.inc dos 468 mapas, 24.100 linhas sem marcador de substituição e 3.000 com um, divididas nos três códigos de quebra do jogo, \n, \l e \p. A linha mediana tem 29 caracteres e 150 pixels; o percentil 95, 38 caracteres e 196 pixels; a mais longa, 53 caracteres, e a mais larga, 208 pixels. Nenhuma passa dos 216 pixels da janela, e o caractere médio tem 5,25 pixels de largura.¹³⁷

A 5,25 pixels por caractere, a janela comporta 41; os roteiristas pararam em 38 em 95% das linhas.³³¹ Cada quebra é um código posto à mão. O jogo nunca quebra uma linha sozinho; ele confia em quem escreve.

A caixa tem uma janela e nenhum campo de nome. Quando os roteiristas queriam indicar quem fala, digitavam o nome e dois-pontos dentro da linha, como no “MOM: {PLAYER}, we’re here, honey!” (MÃE: {PLAYER}, chegamos, querido!) de Littleroot Town. Dos 14.412 parágrafos, 934, ou 6,5%, começam com um nome em maiúsculas e dois-pontos.¹³⁷ Que não exista um campo de nome separado é a minha leitura do modelo de janela, que tem espaço para as duas linhas de texto e nada mais.²

Japonês no jogo em inglês

O Emerald em inglês ainda carrega glifos japoneses, para os nomes de criaturas e treinadores que vêm de cartuchos japoneses. A impressora troca de conjunto de glifos com o código de controle EXT_CTRL_CODE_JPN e volta com EXT_CTRL_CODE_ENG, que esses nomes carregam (international_string_util.c, contest.c e battle_tower.c os inserem). Nesse modo, a fonte normal tem 8 pixels de largura para cada caractere e 15 de altura (DecompressGlyph_Normal, e GetGlyphWidth_Normal retorna 8).¹¹³³⁸

As folhas a partir das quais a ROM em inglês é montada: japanese_normal.png tem 128 por 512 pixels em células de 8 por 16, com 302 das suas 512 células desenhadas; japanese_small.png, do mesmo tamanho, 307 desenhadas; japanese_bold.png, 128 por 256, 246 de 256 desenhadas; e o japanese_frlg_male.png de FireRed, também na árvore de Emerald, 256 por 512 pixels em células de 16 por 16, 269 de 512 desenhadas, com uma tabela de larguras de 512 entradas de 0 a 10 pixels, 10 em 408 delas.¹³⁸ O pret monta os jogos em inglês, então estas são as folhas para nomes numa ROM em inglês; não foram lidas a caixa, as velocidades nem a fonte próprias de nenhuma ROM japonesa (seção 11).³⁰

Então, nos próprios termos do cânone, um caractere japonês numa linha de 16 pixels tem 8 pixels de largura em Emerald e quase sempre 10 na folha de FireRed, contra uma letra latina de 4 a 6.¹

FireRed

FireRed mantém os atrasos de Emerald, 8, 4 e 1, guardados menos um pelo seu próprio AddTextPrinter em src/text_printer.c como os de Emerald, e uma janela de texto padrão de 26 por 4 tiles na coluna 2 (src/new_menu_helpers.c), um tile mais estreita que a de Emerald.¹³⁹ A impressora dele também tem o recurso de segurar de Emerald: if (JOY_HELD(A_BUTTON | B_BUTTON) && subStruct->hasPrintBeenSpedUp) baixa o contador para 0, e um novo aperto de A ou B enquanto o atraso de um caractere está sendo contado, numa mensagem que permita isso, ativa hasPrintBeenSpedUp.¹⁴

2. Crystal e Red: dezoito caracteres e uma marca que pisca

A caixa do Game Boy é a ancestral da caixa do Game Boy Advance numa resolução menor. A tela de Crystal tem 20 por 18 tiles (SCREEN_WIDTH 20, SCREEN_HEIGHT 18), 160 por 144 pixels. A caixa de texto é TEXTBOX_WIDTH = SCREEN_WIDTH por TEXTBOX_HEIGHT 6: a largura inteira e um terço da altura, 33%. Com BORDER_WIDTH 2, o interior tem 18 por 4 tiles, e a fonte de 8 por 8 dá 18 caracteres por linha. O texto começa duas linhas para dentro da caixa, TEXTBOX_INNERY = TEXTBOX_Y + 2, e as linhas ficam a duas fileiras uma da outra, então a caixa mostra duas linhas com uma fileira em branco entre elas; o layout de duas linhas é a minha leitura dessas constantes.¹³ A caixa de mensagens de Red é db MESSAGE_BOX, 0, 12, 19, 17: os mesmos 20 por 6 tiles embaixo.¹¹²

Os dois jogos também contam a velocidade em quadros. Os atrasos são TEXT_DELAY_FAST 1, médio 3 e lento 5 quadros por letra: 60, 20 e 12 letras por segundo a 60 hertz. O PrintLetterDelay de Crystal diz isso sem rodeios: “The text speed setting in wOptions is actually a frame count” (o ajuste de velocidade do texto em wOptions é na verdade uma contagem de quadros). Enquanto A ou B fica pressionado, ele espera um quadro por letra.¹¹⁵ Então o ajuste rápido de Crystal bate com o de Emerald, 60 por segundo, e segurar A ou B em Emerald dá a mesma cadência; os ajustes médio e lento de Crystal, 20 e 12, são mais rápidos que os 15 e 7,5 de Emerald.¹ O Pan Docs dá o quadro do Game Boy como “One frame: 70224 dots @ 59.7 fps” (um quadro: 70.224 pontos a 59,7 fps) e observa que um quadro “takes ~16.74 ms instead of ~16.67” (leva cerca de 16,74 ms em vez de cerca de 16,67).⁴⁰

Crystal deixa o jogador escolher entre oito molduras, de FRAME_1 a FRAME_8, cada uma com TEXTBOX_FRAME_TILES, 6 tiles de 1 bit, guardadas como PNGs de 24 por 16 pixels; uma nona moldura está na ROM sem uso. A folha da fonte, gfx/font/font.png, tem 128 por 64 pixels, 128 células de 8 por 8, e a de Red tem o mesmo tamanho.¹⁴¹

A marca pisca

A marca de avanço de Crystal faz parte da moldura. WaitPressAorB_BlinkCursor espera A ou B enquanto BlinkCursor alterna o tile em (18, 17), na própria linha de baixo da moldura, entre '▼' e o tile de borda '─'.¹⁶ Os dois estados são lidos no código; o período do piscar não foi derivado (seção 11).

Essa é a segunda imprecisão do post do mundo. O plano de texto dele pede “a two-frame advance arrow” (uma seta de avanço de dois quadros).²³ Uma marca de dois estados é o piscar de Crystal. A seta de Emerald, aquela que o resto do plano segue (a linha de 16 pixels, a caixa embaixo), não pisca: ela passa por três posições, 0, 1, 2 e 1 pixels a partir do repouso, num ciclo de 36 quadros (o código desloca as linhas de origem do bitmap, o que, na minha leitura, ergue a cunha na tela; não executei isso).¹¹³ O briefing da seção 12 segue os passos de Emerald, não a direção deles.

3. Final Fantasy VI: uma janela que se repinta, uma fonte que quebra sozinha

Final Fantasy VI trata a janela como coisa do jogador. Os números dele aqui vêm do disassembly everything8215/ff6 em 8130132 (14 de setembro de 2026), que contém código e listas de extração em vez dos gráficos da ROM, então os tamanhos vêm de intervalos de bytes e do código que os lê.³⁰⁴

Oito janelas, sete cores cada

As listas de extração em inglês e em japonês dão os gráficos de janela como 0xED0000 a 0xED1BFF, 7.168 bytes: oito estilos de 896 bytes, cada um com 28 tiles de 8 por 8 a 4 bits por pixel. As paletas vêm em seguida, de 0xED1C00 a 0xED1CFF, oito paletas de 16 cores.⁴⁴² A tela de configuração lista 8 padrões de janela (ConfigWindowNumPos).⁴⁴³

A cor da janela é o jogador quem define. LoadWindowPal lê as cores do padrão na memória de save em $1d57, 14 bytes por padrão, ou seja, sete cores de dois bytes, e a tela de configuração as edita em barras de R, G e B (ConfigColorBarTextList); mais uma cor, a da fonte, fica em $1d55.⁴⁴³ O passo é lido no código, e os três canais, na lista de barras.⁴

A velocidade de mensagens da tela de configuração tem seis ajustes, de 1 a 6 (ChangeConfigOption_02 para em $05), e um save novo começa com “message speed = 3, battle speed = 3” (velocidade de mensagens = 3, velocidade de batalha = 3), como diz o comentário em menu_sram.asm.⁴⁴³ É a velocidade das mensagens de batalha, como config.asm a chama num comentário, “battle speed, battle message speed, magic order, and window pattern” (velocidade de batalha, velocidade das mensagens de batalha, ordem da magia e padrão de janela). Fora da tela de configuração, o único código que lê os bits dela no byte de configuração, $1d4d, é mess_wait em src/btlgfx/gfx_cmd.asm, que procura o ajuste em MsgSpeedTbl, “wait duration for each battle message speed” (duração da espera para cada velocidade de mensagem de batalha), e espera esse número de quadros: 32, 48, 64, 80, 96 ou 112 para os ajustes de 1 a 6. Nenhum arquivo do código de campo lê $1d4d, então o diálogo de campo não tem ajuste de velocidade; ele sai na cadência única descrita abaixo.⁴⁴⁴

Uma janela sombreada sem um tile

A janela de diálogo é sombreada ao longo da altura pela matemática de cores do hardware. DlgWindowFixedColorTbl, em src/field/hdma.asm, são 200 bytes de $E0 a $E7, uma cor fixa nos três canais com intensidades de 0 a 7, e a primeira sequência são 72 valores descendo a partir de 7, depois até 0 e depois de volta até 7.⁴⁴⁵ A janela abre perto do topo ou da base da tela, “dialog window y position (1 or 18)” (posição y da janela de diálogo, 1 ou 18) no comentário de event.asm.⁴⁵ Que a tabela é consumida a um valor por linha de varredura vem dos comentários, não foi rastreado, e a aparência do degradê não foi vista, já que o disassembly não tem pixels (seção 11).

A fonte

A fonte de diálogo tem 1 bit por pixel, 22 bytes por letra: 11 fileiras de 16 bits, uma célula de 16 pixels de largura e 11 de altura. A sombra não é desenhada: LoadLetterGfx a cria deslocando cada fileira um pixel (lsr).⁴⁴⁶ As larguras em inglês, de FontWidth, são proporcionais: as maiúsculas têm em média 8,04 pixels (de 5 a 12), as minúsculas 7,73 (de 4 a 12), os dígitos 7,80 (de 5 a 9), e o espaço, 5.⁴⁴⁶

A fonte de diálogo da ROM japonesa, de 0xC494C0 a 0xC4FFFF na lista de extração dela, ocupa 27.456 bytes: 1.248 letras de 22 bytes. A tabela de larguras tem 1.280 entradas, em sequências de 1.056 a 12 pixels, 180 a 8 e 44 a 12, e as tabelas de caracteres do disassembly listam 1.010 kanji e 173 kana.⁴⁴⁷ O intervalo da fonte grande em inglês, 5.120 bytes, não é um número inteiro de letras de 22 bytes (232,7), o que não consigo explicar a partir do disassembly (seção 11).⁴

Uma linha, uma quebra automática, uma letra por quadro

Uma linha de diálogo vai do x 4 até um x máximo de $e0, 224: 220 pixels, 18 letras japonesas de 12 pixels.⁴⁴⁶ O texto em inglês quebra por palavra no código. CalcTextWidth soma a largura da próxima palavra, e NewLine é chamada quando ela passaria do máximo, então o script em inglês não precisa de quebras postas à mão; o script de medição afirma as chamadas, e a leitura é de UpdateDlgTextOneLine.⁴⁴⁶

O texto sai a uma letra por quadro. O loop de campo espera o vertical blank e chama UpdateDlgText uma vez por passagem, e UpdateDlgTextOneLine desenha uma letra e retorna: 60 letras por segundo a 60 hertz.⁴⁴⁸ Uma passagem por quadro é a minha leitura do loop. Como uma única fonte gera as duas ROMs, os dois idiomas compartilham esse loop, o que, na minha leitura, significa as mesmas letras por segundo em inglês e em japonês.⁴⁸

O título de um mapa é centralizado, ($e0 - width) / 2, e exibido por 100 quadros, 1,67 segundo.⁴⁴⁶

Ao lado de Emerald, Final Fantasy VI mostra o outro jeito de construir a mesma caixa: Emerald escreve cada quebra à mão e deixa o jogador escolher a moldura dos menus, nunca a da caixa de diálogo; Final Fantasy VI quebra no código, deixa o jogador repintar a janela e a sombreia no hardware. A caixa de campo de Emerald fica embaixo, a de Final Fantasy VI em cima ou embaixo, e os dois imprimem numa contagem fixa de quadros.

Chrono Trigger

Eu pretendia pôr Chrono Trigger ao lado de Final Fantasy VI e não consegui. Nenhum disassembly público foi clonado, e o mapa da ROM do jogo no Data Crystal retornou HTTP 403 ao ser buscado, então nada neste post sobre caixas de texto vem dele (seção 11).⁴⁹

4. Japonês em matrizes de 8, 10 e 12 pontos

O Kiradex é um app para colecionadores de cartas, e a Dex já mostra os nomes japoneses das cartas com o inglês embaixo, nas fontes do sistema.⁵⁰ O texto do mundo também vai precisar de japonês, e uma fonte pixelada que não consegue desenhá-lo não é candidata. A pergunta é quão pequeno um kanji pode ser e quem já desenhou sete mil deles.

O tamanho do trabalho

O JIS X 0208, o conjunto de caracteres contra o qual se mede a cobertura das fontes pixeladas japonesas, tem 6.879 caracteres segundo a tabela de mapeamento do Unicode Consortium: 524 que não são kanji, 169 deles os kana das linhas 4 e 5; 2.965 kanji de nível 1 nas linhas 16 a 47; e 3.390 kanji de nível 2 nas linhas 48 a 84.⁵⁷⁶ A tabela é a versão 2.0, e o consórcio a arquiva entre os mapeamentos obsoletos; ainda é a lista contra a qual é mais fácil contar a cobertura de uma fonte.⁵

Misaki: 8 por 8

Misaki (美咲フォント), de Num Kadoma, é a menor. A página dela a chama de “8×8 ドットの日本語ビットマップフォント” (uma fonte bitmap japonesa de 8 por 8 pontos) com suporte a “JIS 第一・第二水準” (os níveis 1 e 2 do JIS), e diz “一部の記号を除いた全ての文字は 7×7 ドットの範囲に収まっている” (todos os caracteres, exceto alguns símbolos, cabem dentro de 7 por 7 pontos), de modo que, continua a página, caracteres postos lado a lado ainda mantêm o espaçamento entre linhas e entre letras.⁵¹ Segundo o histórico da página, ela foi feita para um driver de tela japonês dos computadores de bolso PC-E500.⁵¹

Medida nos arquivos BDF da versão 2021-05-05, Misaki Gothic tem 7.171 caracteres: 168 de meia largura, com 4 pixels, e 7.003 de largura total, com 8 pixels, numa célula de 8 por 8 com ascendente de 6 e descendente de 2. Dos seus 6.356 glifos de U+4E00 a U+9FFF (um intervalo de código, daí uma contagem diferente dos 6.355 kanji dos dois níveis do JIS), nenhum preenche a célula de 8 pontos em nenhuma direção, enquanto 53 glifos de largura total, símbolos, preenchem. Ela desenha todos os 6.879 caracteres do JIS X 0208.⁶ Misaki Mincho, que a página descreve como Misaki Gothic com os caracteres que não são kanji redesenhados em estilo Mincho, mede o mesmo em todas as contagens. Misaki Gothic 2nd, que segundo a página usa os 3 por 7 pixels completos para caracteres de meia largura e 7 por 7 para kana de largura total, tem 7.170 caracteres (167 de meia largura), ascendente de 7 e descendente de 1, e mede o mesmo no resto.⁶⁵¹

k8x12: 8 por 12

k8x12, do mesmo autor, mantém a largura de 8 pontos e acrescenta altura: “8×12 ドットの日本語ビットマップフォント” (uma fonte bitmap japonesa de 8 por 12 pontos), níveis 1 e 2 do JIS. Ela tem duas variantes: k8x12L, cujos kana são desenhados altos, e k8x12S, cujos caracteres que não são kanji têm 8 pontos de altura, feita, diz a página, pensando nos limites dos consoles antigos: “8×8 ドット単位でグラフィックを扱うような、昔のゲーム機等の制限を意識しています” (pensada nos limites de máquinas de jogo antigas que tratam os gráficos em unidades de 8 por 8 pontos).⁵²

Medida no BDF, k8x12 é uma célula de 8 por 12 com ascendente de 10 e descendente de 2: 7.170 caracteres, 168 com 4 pixels e 7.002 com 8. Nenhum kanji preenche a célula; 53 glifos de largura total preenchem em k8x12 e k8x12L, e 45 em k8x12S. As três desenham todos os 6.879 caracteres do JIS X 0208.⁶

PixelMplus: 10 e 12, como contornos

PixelMplus, de itouhiro (2013), é a outra abordagem: contornos TrueType com cara de fonte bitmap, sem bitmaps embutidos (“埋め込みビットマップは なし”, sem bitmaps embutidos), com todos os kanji dos níveis 1 e 2 do JIS (“JIS第1・第2水準のすべての漢字を収録”, inclui todos os kanji dos níveis 1 e 2 do JIS) mais ISO-8859-1, num peso regular e num negrito e em dois tamanhos, PixelMplus12 e PixelMplus10, contornados a partir das M+ BITMAP FONTS.¹⁸ Medida com o Core Text, cada uma tem 7.253 glifos e desenha 6.876 dos 6.879 do JIS X 0208. Os três que ela não mapeia são U+301C 〜, U+2016 ‖ e U+2212 −.⁷ São caracteres cujo mapeamento Unicode difere entre o JIS0208.TXT do consórcio e as tabelas de outros fabricantes, então, na minha leitura, as fontes provavelmente trazem esses glifos nos outros pontos de código; isso não foi verificado (seção 11).⁵

DotGothic16: uma fonte de pontos sem grade

DotGothic16, da Fontworks, está no Google Fonts sob a SIL Open Font License 1.1 sem Reserved Font Name, listada com os subconjuntos cyrillic, japanese, latin e latin-ext, e adicionada em 2020-12-15.⁵³ Ela tem 9.362 glifos e desenha todos os 6.879 caracteres do JIS X 0208.⁷ Mas é desenhada como pontos separados, não como pixels. No A dela, as bordas x do contorno vêm em pares, 91 e 102, 153 e 163, 214 e 225, 276 e 287, 338 e 349, 400 e 410 unidades de 1.000: pontos a cerca de 62 unidades uns dos outros, com vãos de 10 ou 11 unidades entre eles. Nenhuma grade de pixels inteiros se encaixa nisso, e a sonda não encontrou nenhuma de 4 a 40 pixels por em.¹⁹⁷ Um passo de cerca de 62 unidades fica perto de 16 pontos por em, o número do nome da fonte, então a sonda a desenha a 16 pontos por em nominais e em múltiplos disso; a escolha de tamanho é minha, não uma grade que a fonte declara. O Core Text no macOS 27.0 a desenhou com 82,3% de pixels parciais a 16 pixels e 37,3% a 64, e parcial em todos os tamanhos medidos (seção 6).⁷

O que as fontes gratuitas medem

A grade de projeto na tabela é o menor número de pixels por em em que 95% dos pontos de contorno de uma amostra de glifos ficam a menos de 0,04 pixel, com um deslocamento constante permitido em cada eixo; o script que a encontra, measure_coretext.swift, foi compilado com swiftc -O e executado no macOS 27.0 (build 26A428), então estes são números do Core Text de um Mac, não de um iPhone.⁷

Por essa medida, PixelMplus10 Regular tem 0 de 1.032 coordenadas de contorno amostradas fora da sua grade de 10 pixels, e a Bold, 0 de 1.000; Misaki Gothic, 0 de 848; k8x12, 0 de 988; PixelMplus12, 0 de 1.192 depois de permitido o seu deslocamento de 0,39 pixel, e DotGothic16 tem todas as 1.544 fora.⁷ O deslocamento de PixelMplus12 aparece nas coordenadas brutas: o H dela vai de y −33 a 717 unidades de 1.000, numa grade de 83,3 unidades por pixel, então a linha de base cai 0,396 pixel para dentro de uma fileira da grade; a estimativa da sonda, 0,39, vem de distribuir as frações das coordenadas em faixas de um cinquenta avos de pixel, e é o valor pelo qual os renderizados abaixo foram deslocados.¹⁹⁷³³

Em todas as fontes com japonês medidas, um caractere japonês tem o dobro de um latino: 8 contra 4 em Misaki e k8x12, 10 contra 5 e 12 contra 6 em PixelMplus.⁷ O cânone fica na mesma faixa: o japonês de Emerald tem 8 pixels de largura numa linha de 16, a folha de FireRed quase sempre 10, o de Final Fantasy VI, 12.¹⁴

As licenças

Tudo isso é gratuito nos termos mais simples. A licença de Misaki e k8x12, na página de fontes do autor, são três frases: “These fonts are free software. Unlimited permission is granted to use, copy, and distribute them, with or without modification, either commercially or noncommercially. THESE FONTS ARE PROVIDED “AS IS” WITHOUT WARRANTY.” (estas fontes são software livre; é concedida permissão ilimitada para usá-las, copiá-las e distribuí-las, com ou sem modificações, comercialmente ou não; elas são fornecidas no estado em que se encontram, sem garantia). O leia-me de cada pacote traz os mesmos termos em palavras um pouco diferentes, e a página de Misaki indica que a licença usada é a licença das M+ FONTS.¹⁷⁵¹ PixelMplus está sob a M+ FONT LICENSE, cujo texto em inglês, LICENSE_E, são as mesmas três frases.¹⁸ DotGothic16 está sob a SIL Open Font License 1.1, cujas condições ficam no seu próprio OFL.txt.⁵³ Na minha leitura, a licença de três frases não pede nada em troca; dar crédito aos autores continua sendo o certo, e o briefing faz isso (seção 12). São leituras, não aconselhamento jurídico.

O que a legibilidade custa

Um kana em Misaki tem 8 pixels de fonte de largura; em PixelMplus12, doze. Na densidade do próprio mundo no iPhone 18 Pro Max, onde um texel são 8 pixels de dispositivo, uma linha da caixa desenhada em Misaki comporta 36 caracteres latinos ou 18 japoneses.¹¹ A linha japonesa carrega mais por caractere, então a caixa não precisa comportar tantos caracteres para dizer a mesma coisa; isso é minha leitura, não uma medição.

5. Fontes pixeladas latinas, e as que não consegui medir

Duas fontes pixeladas latinas do Google Fonts foram medidas junto com as japonesas.³⁰

Press Start 2P, de CodeMan38, está sob a SIL Open Font License 1.1 “with Reserved Font Name “Press Start 2P”” (com o nome de fonte reservado “Press Start 2P”).⁵⁴ Ela tem 658 glifos numa grade de 8 pixels sobre a linha de base, cada caractere latino com 8 pixels de largura, e todos os 95 caracteres ASCII imprimíveis. Não tem kana nem kanji: do JIS X 0208, desenha 150 caracteres que não são kanji (o grego, o cirílico e os símbolos dela) e nenhum dos 6.355 kanji.⁷

Silkscreen, de Jason Kottke, está sob a SIL Open Font License 1.1 sem Reserved Font Name.⁵⁵ Ela tem 228 glifos numa grade de 8 pixels, com 10 de 588 coordenadas de contorno amostradas fora dela (o A e o o dela têm valores y de 495 e 130 unidades numa grade de 125 unidades), e o A tem 6 pixels de largura. Do JIS X 0208, desenha 21 caracteres que não são kanji.⁷¹⁹

Outras três fontes muito recomendadas para jogos pixelados não foram medidas, e digo isso em vez de descrevê-las de memória.

Pixel Operator, de Jayvee Enaguas: as notas do autor no DaFont dizem “Changed licence to Creative Commons Zero (CC0) 1.0” (licença alterada para Creative Commons Zero, CC0, 1.0) e que a fonte está “licensed under a Creative Commons Zero (CC0) 1.0” (licenciada sob Creative Commons Zero, CC0, 1.0). O DaFont a lista como “Bitmap (16 px)”, em 15 arquivos de fonte, com 241 glifos. O repositório do próprio autor, que as notas indicam no NotABug, retornou HTTP 404, e a fonte não foi baixada nem medida. Tudo aqui vem dessa única página.⁵⁶

m5x7, de Daniel Linssen: a página dela no itch.io diz “use font size 16, 32, 48, etc” (use tamanhos de fonte de 16, 32, 48 etc.) e “free to use but attribution appreciated” (de uso livre, mas a atribuição é bem-vinda), informa “Asset license Creative Commons Zero v1.0 Universal” (licença do recurso: Creative Commons Zero v1.0 Universal) e dá largura média de 5, ascendente de 7, descendente de 2 e altura-x de 5. Descreve seus caracteres como “uppercase and lowercase letters, including many accented letters, numbers and most common symbols” (maiúsculas e minúsculas, incluindo muitas letras acentuadas, números e os símbolos mais comuns).⁵⁷

m3x6, do mesmo autor: “use font size 16, 32, 48, etc” e “free to use with attribution” (de uso livre com atribuição); a página não mostra nenhum campo de licença do recurso.⁵⁸ Nenhum dos dois arquivos foi baixado, porque ambos ficam atrás de um download de pague quanto quiser, então nenhum foi medido.⁵⁷⁵⁸

Essa é a terceira imprecisão do post do mundo. O plano de texto dele indica m5x7 como a fonte.²³ Pela descrição da própria página, m5x7 é uma fonte latina, e nada na página diz que ela tem kana ou kanji; um app que vai mostrar japonês não pode compor o texto do seu mundo nela.⁵⁷ O briefing troca a fonte por PixelMplus10, uma das duas fontes medidas com japonês, grade limpa e avanços de pixels inteiros (a outra é Misaki), e a maior das duas (seções 6 e 12). A própria m5x7 continua sem medição.

6. O que o Core Text faz com uma fonte pixelada

O post do mundo afirmava que “Bitmap fonts render at integer multiples only” (fontes bitmap só renderizam em múltiplos inteiros).²³ É a regra que todo guia de pixel art repete, e eu queria vê-la, com números, no próprio motor de texto da Apple.

A medição

O Core Text é a camada da Apple para “Create text layouts, optimize font handling, and access font metrics and glyph data” (criar layouts de texto, otimizar o tratamento de fontes e acessar métricas de fonte e dados de glifos), disponível desde o iOS 3.2 e o macOS 10.8.⁵⁹ measure_coretext.swift carrega cada arquivo TrueType candidato, desenha uma linha de amostra (“Nice card! Which set? 0123” para as fontes latinas, “カードを見せて！ Nice card!” para as japonesas) num bitmap cinza de 8 bits em tamanhos que são múltiplos inteiros e fracionários da grade de cada fonte, e conta os pixels com tinta que são parciais: entre 8 e 247 de 255, a mais de 3% de cheio ou de vazio. Ele desenha cada tamanho de três jeitos: com o antialiasing padrão do Core Text, com o antialiasing desligado, e com o posicionamento de subpixel ligado e a quantização desligada, para que os glifos caiam exatamente onde seus avanços os colocam.⁷

Dois limites importam antes de qualquer número. A execução é no macOS 27.0, build 26A428, no meu Mac, não no iOS, e desenha com o Core Text num contexto de bitmap, não com o Text do SwiftUI; o que um iPhone desenha é uma previsão até que as verificações por captura do briefing rodem em um (seção 11).⁷ E o script desenha com a suavização de fontes desligada (setAllowsFontSmoothing(false)). Quando desenhei a figura abaixo com o padrão do contexto de bitmap, 178 dos 272 pixels com tinta de “Nice card!” em PixelMplus10 a 10 pixels saíram parciais, contra 0 de 94 com a suavização desligada.⁹ A suavização de fontes é um ajuste do macOS; se algo parecido se aplica no iOS, quem decide são as verificações por captura.

Múltiplos inteiros saem limpos

Nos múltiplos inteiros da grade, com o antialiasing ligado (o padrão do contexto) e a suavização de fontes desligada, Misaki a 8, 16, 24 e 32 pixels, PixelMplus10 Regular e Bold a 10, 20, 30 e 40, e Press Start 2P a 8, 16, 24 e 32 renderizam com 0,0% de pixels parciais.⁷ Cada pixel é tinta ou papel. Isso depende do ajuste de suavização: com a suavização padrão do contexto de bitmap, PixelMplus10 nos seus próprios 10 pixels desenhou parciais 178 dos 272 pixels com tinta de “Nice card!”, então, no Mac, um múltiplo inteiro sozinho não deixou o texto nítido.⁹

PixelMplus10 Regular desenhada pelo Core Text no macOS 27.0 a um pixel de dispositivo por pixel de fonte, mostrada com o antialiasing desligado. Com o antialiasing ligado e a suavização de fontes desligada, 0 dos 94 pixels com tinta de “Nice card!” são parciais; com a suavização padrão do contexto de bitmap, 178 de 272 são. A fonte está sob a M+ FONT LICENSE, que permite cópia e distribuição; desenhado por figures/dump_glyphs.swift e figures/make_figures.py.

Entre eles, borram

Entre os múltiplos inteiros, as mesmas fontes borram, com a suavização desligada como em toda a sonda. Misaki tem 57,7% de pixels parciais a 12 pixels (1,5 vez a grade), 39,9% a 20 (2,5 vezes) e 82,2% a 10 (1,25 vez). PixelMplus10 tem 60,1% a 15 pixels. Press Start 2P, 44,0% a 12 pixels, 29,1% a 20 e 21,7% a 28.⁷ Nos 40 renderizados a 1,25, 1,5, 1,75, 2,5 e 3,5 vezes a grade das oito fontes cuja grade fica sobre a linha de base (as duas Misaki, k8x12 e k8x12S, PixelMplus10 Regular e Bold, Press Start 2P e Silkscreen), a parcela de parciais vai de 19,4%, PixelMplus10 Bold a 35 pixels, a 82,2%, Misaki a 10.⁷ O borrão não cai de forma contínua com o tamanho: em cada uma das oito, 1,75 vez a grade borra mais do que 1,5 vez (Misaki, 65,7% a 14 pixels contra 57,7% a 12). Na mesma fração, ele cai: a 1,5, 2,5 e 3,5 vezes a grade, cada uma das oito fica mais baixa a cada passo (Misaki, 57,7%, 39,9% e 30,4%). Em nenhum renderizado medido entre múltiplos inteiros ele chega a zero; na minha leitura, a queda numa fração fixa se deve a que um erro de meio pixel na borda de um glifo é uma parte menor de um glifo maior.⁷

Desligar o antialiasing (setShouldAntialias(false)) deixa cada pixel cheio ou vazio em qualquer tamanho, mas as formas são reamostradas de modo desigual. Os 191 pixels com tinta de Misaki a 8 pixels viram 377 a 10; uma escala uniforme de 1,25 em cada direção daria cerca de 298.⁷³³ Algumas fileiras e colunas são duplicadas e outras não, então traços que tinham um pixel de largura saem com um ou dois.

Pixels parciais por tamanho, Core Text no macOS 27.0 com a suavização de fontes desligada, não o iOS; desenhado por figures/make_figures.py a partir de measure_coretext.out.

Um tamanho limpo não basta: o arquivo precisa estar limpo

Duas falhas mais discretas importam mais na escolha de uma fonte do que os múltiplos.

Uma grade fora da linha de base borra em todos os tamanhos. Os contornos de PixelMplus12 ficam 0,39 pixel abaixo da grade da linha de base, e ela renderiza com 66,6% de parciais nos seus próprios 12 pixels, 40,0% a 24 e 29,8% a 36. Mover a linha de base pelo deslocamento, na transformação do contexto com o posicionamento de subpixel ligado, leva 12 pixels a 0,0%, mas deixa 14,3% a 24 e 19,0% a 36, embora o deslocamento tenha sido escalado com o tamanho (0,78 pixel a 24, 1,17 a 36).⁷ Por que o deslocamento escalado não limpa os tamanhos maiores, a saída não diz, e eu não rastreei.

Um avanço fora da grade borra assim que os glifos são posicionados com exatidão. O avanço de kana de k8x12 é de 8,01 pixels, não 8. Com os ajustes padrão do contexto de bitmap, que põem cada glifo num pixel inteiro, ela renderiza com 0,0% de parciais a 12, 24 e 36 pixels. Com o posicionamento de subpixel ligado e a quantização desligada, os mesmos tamanhos dão 62,3%, 42,8% e 32,6% de parciais.⁷ Na minha leitura, cada kana cai então um centésimo de pixel mais longe da grade do que o anterior.

Pontos de contorno soltos deixam um pouco. As dez coordenadas fora da grade de Silkscreen aparecem como 4,5% de parciais a 8 pixels e 1,2% a 32.⁷

Uma fonte de pontos nunca se alinha. DotGothic16 não tem uma grade da qual tirar múltiplos, então a sonda a desenha a 16 pontos por em nominais e a 1,25 a 4 vezes isso (seção 4). Com o antialiasing ligado e a suavização desligada, ela tem 82,3% de parciais a 16 pixels, 52,5% a 32, 48,8% a 48 e 37,3% a 64, e é parcial em cada um dos nove tamanhos de 16 a 64 pixels, incluindo os múltiplos inteiros de 16; os pontos dela não ficam em nenhuma grade de pixels (seção 4).⁷¹⁹

Misaki e k8x12 trazem tabelas de bitmap embutidas (EBDT e EBLC, lidas com CTFontCopyAvailableTables). Os resultados medidos acima são o que o Core Text desenhou; se ele desenhou esses bitmaps ou os contornos, não foi determinado (seção 11).⁷

Misaki, PixelMplus10 e Press Start 2P não têm nenhuma das duas falhas discretas. A regra que daí decorre diz respeito ao arquivo da fonte tanto quanto ao tamanho: múltiplos inteiros, uma grade sobre a linha de base e avanços de pixels inteiros.

Dynamic Type e a grade

As Human Interface Guidelines da Apple dão ao iOS um tamanho de texto padrão de 17 pontos e um mínimo de 11, e uma tabela para cada tamanho de Dynamic Type. Body percorre, de xSmall a AX5, 14, 15, 16, 17, 19, 21, 23, 28, 33, 40, 47 e 53 pontos; Caption 1, de 11 a 43.⁶⁰¹⁰

Numa tela de 3×, um pixel de fonte é um número inteiro de pixels de dispositivo só quando o tamanho em pontos vezes 3, dividido pelo em em pixels de fonte, dá um número inteiro. Dos doze tamanhos de Body, um em de 12 pixels cai inteiro em 3 deles (16, 28 e 40 pontos), um em de 8 pixels em 2 (16 e 40) e um em de 10 pixels em 1 (40). Dos doze tamanhos de Caption 1, um em de 12 pixels cai inteiro em 3 (12, 16 e 32).⁷⁶⁰

Quais tamanhos de Body caem em pixels de dispositivo inteiros a 3×, e o arredondamento do briefing; desenhado por figures/make_figures.py a partir de measure_coretext.out e measure_kiradex_text.out.

Então uma fonte pixelada não pode simplesmente seguir o Dynamic Type. Se escalar continuamente com os tamanhos do sistema, ela fica fora da grade em todos os tamanhos menos os poucos inteiros: 11 de 12 tamanhos de Body para um em de 10 pixels, 9 de 12 para um de 12.⁷³³ Fora da grade, o Core Text no Mac, com o antialiasing ligado, borrou todas as fontes medidas; se o SwiftUI num iPhone faz o mesmo depende da renderização e do posicionamento dele, e isso as capturas do briefing decidem. A fonte precisa pegar o tamanho que o sistema pede e arredondá-lo à grade, algo que a seção 10 transforma numa receita de API e a seção 12 na regra do briefing.

7. Quebra de linha japonesa

Uma linha predefinida curta nunca quebra. Uma caixa de texto quebra, e o japonês tem regras sobre onde.

As regras

Os Requirements for Japanese Text Layout do W3C (uma Working Group Note de 11 de agosto de 2020) definem no item 3.1.7 a regra de início de linha: “In principle, no line should begin with closing brackets (cl-02), hyphens (cl-03), dividing punctuation marks (cl-04), middle dots (cl-05), full stops (cl-06), commas (cl-07), iteration marks (cl-09), a prolonged sound mark (cl-10), small kana (cl-11) or warichu closing brackets (cl-29)” (em princípio, nenhuma linha deve começar com colchetes de fechamento, hífens, sinais de pontuação divisórios, pontos médios, pontos finais, vírgulas, marcas de iteração, a marca de som prolongado, kana pequenos ou colchetes de fechamento de warichu). O documento também registra a prática mais frouxa: “Not a small number of books adopt a less strict set of rules which allow IDEOGRAPHIC ITERATION MARK “々” (one of the iteration marks (cl-09)), prolonged sound mark (cl-10) and small kana (cl-11) to start a line.” (não poucos livros adotam um conjunto de regras menos estrito, que permite começar uma linha com a marca de iteração ideográfica 々, a marca de som prolongado e kana pequenos).²¹

O algoritmo de quebra de linha do Unicode, o UAX #14 (revisão 57, para o Unicode 18.0.0, datado de 2026-09-01), põe os hiragana e katakana pequenos e a marca de som prolongado na classe CJ e diz: “Treating characters of class CJ as class NS will give CSS strict line breaking; treating them as class ID will give CSS normal breaking.” (tratar os caracteres da classe CJ como classe NS dá a quebra de linha estrita do CSS; tratá-los como classe ID dá a quebra normal do CSS).⁶¹

O que o Core Text fez

measure_coretext.swift, executado no macOS 27.0 (não no iOS), compõe um parágrafo japonês de 131 caracteres com CTFramesetter nas larguras de 8, 10, 12, 14, 16, 18 e 20 em, e confere o primeiro caractere de cada linha depois da primeira contra a sua própria lista de caracteres proibidos no início de linha: alguns dos colchetes de fechamento, a vírgula e o ponto final japoneses, o ponto médio, os dois-pontos e o ponto e vírgula, os pontos de interrogação e exclamação, a marca de som prolongado, os kana pequenos e 々.⁷ Essa lista não é um subconjunto das classes que a regra do JLREQ nomeia, apenas se sobrepõe a elas. Sete dos seus 40 caracteres, ，．：；？！ e ）, são as formas de largura total que o texto japonês usa onde o JLREQ lista as ASCII; os outros 33 são do próprio JLREQ. Dos colchetes de fechamento, ela tem 」』】〉》〕 e o ） de largura total, deixando de fora ’ ” ] } » 〟 ⦆ 〙 〗 e o ) ASCII; dos 40 kana pequenos, tem 22, deixando de fora ゕ, ゖ e de ㇰ a ㇿ; e deixa de fora os hífens (cl-03), entre eles ‐, 〜, ゠ e a meia-risca, ‼ ⁇ ⁈ ⁉ de cl-04, e todas as marcas de iteração (cl-09) menos 々, entre elas ヽ, ヾ, ゝ, ゞ e 〻.⁷²¹ Os resultados abaixo valem para a lista da sonda, e é o texto do parágrafo de teste que decide quais caracteres chegam a um início de linha.

Sem marcação, nenhuma linha começou com um caractere da lista da sonda em nenhuma largura, nem em Hiragino Sans (a fonte japonesa do sistema, usada como controle) nem em nenhuma das oito fontes pixeladas: Misaki Gothic, Misaki Gothic 2nd, k8x12, k8x12S, PixelMplus10 Regular e Bold, PixelMplus12 e DotGothic16 nos seus 16 pontos nominais.⁷

Com kCTLanguageAttributeName definido como ja, a regra afrouxou. Em Hiragino Sans, nas duas Misaki, nas duas PixelMplus10, em PixelMplus12 e em DotGothic16, uma linha começou com um kana pequeno (っ, ョ ou ァ) em 6 das 7 larguras, todas menos 18 em.⁷ Em k8x12 e k8x12S, uma linha começou com um kana pequeno (っ, ョ ou ょ) em 4 das 7 larguras, e com a marca de som prolongado ー em duas, 10 em (ao lado de ョ) e 18 em, uma quinta largura.⁷

Na minha leitura dessas contagens diante das duas citações, a marcação ja dá a regra menos estrita que o JLREQ descreve, a que o UAX #14 chama de quebra normal do CSS, e a execução sem marcação se comporta de forma estrita.²¹⁶¹ É o contrário do que eu esperava, já que a marcação nomeia o idioma, e é por isso que o briefing não marca o texto da caixa sem uma captura.

Duas notas sobre a própria medição, ambas de ler o script contra a saída dele. As larguras estão em em, o tamanho cheio da fonte, então, para k8x12, cujos kana têm 8 pixels num em de 12, cada largura comporta uma vez e meia os kana que o número indica; o parágrafo de k8x12 ocupou 12 linhas a 8 em, onde os outros ocuparam 17.⁷ E DotGothic16, que não tem grade, foi composta no dobro dos seus 16 pontos nominais, 32 pixels por em; nesse tamanho, ela ocupou o mesmo número de linhas que Hiragino Sans em cada largura, de 17 a 8 em a 7 a 20, e os mesmos kana pequenos abriram as linhas dela com a marcação.⁷

8. Os jogos pixelados que vieram depois: caixas, balões, japonês e chinês

Stardew Valley: duas formas de fala

Stardew Valley tem as duas formas que o Kiradex já tem. A caixa de diálogo dele passa de página com um comando, $b, que a página de modding sobre diálogo da Stardew Valley Wiki (editada pela última vez em 20 de maio de 2026) descreve como um que “Indicates pauses in dialogue, where the player will need to click for the next part to load in a new dialogue box” (indica pausas no diálogo, em que o jogador precisa clicar para a próxima parte carregar numa nova caixa de diálogo), e comandos de retrato que “set the portrait shown in the dialogue box for the current line of dialogue” (definem o retrato mostrado na caixa de diálogo para a linha atual).⁶² E tem balões de fala, Strings\SpeechBubbles, para o “dialogue spoken by NPCs through speech bubbles when the player enters a given location” (diálogo falado pelos NPCs em balões quando o jogador entra num determinado lugar).⁶² A caixa é para conversas, com um rosto à frente; os balões são o que uma cidade diz quando você entra.

Os idiomas não latinos dele usam fontes bitmap. A página da wiki sobre idiomas personalizados (editada pela última vez em 3 de janeiro de 2026) manda um idioma novo definir UseLatinFont como false e fornecer um arquivo .fnt, tomando como modelo “the Chinese, Japanese, Korean, and Russian fonts in the Fonts folder” (as fontes chinesa, japonesa, coreana e russa da pasta Fonts). O FontPixelZoom é “A factor by which to multiply the font size. The recommended baseline is 1.5” (um fator pelo qual multiplicar o tamanho da fonte; a base recomendada é 1.5), e FontApplyYOffset define “Whether to shift the font up by four pixels” (se a fonte deve subir quatro pixels), para alinhar “languages with larger characters like Chinese and Japanese” (idiomas com caracteres maiores, como chinês e japonês).⁶³ Um zoom de 1,5 não é um múltiplo inteiro, mas a página o dá como ponto de partida para um idioma que um modder acrescenta, não como o que as fontes chinesa, japonesa e coreana que vêm com o jogo usam, e se um zoom reamostra na tela depende também da escala do jogo em relação aos pixels de dispositivo; então isso não diz nada certo sobre como o Stardew desenha o próprio japonês.⁶³

Final Fantasy Pixel Remaster: o trabalho foi a fonte

A versão para consoles do Pixel Remaster acrescentou uma opção de fonte pixelada, e o produtor, Naofumi Takuma, contou à Siliconera (Jenni Lada, 2 de junho de 2023) como ela foi feita. Para os idiomas ocidentais, a equipe encontrou dados de fonte produzidos internamente e os usou. Para o japonês: “We didn’t have any alternative data saved on file in-house for the Japanese language font, so we decided to create a new one.” (não tínhamos nenhum dado alternativo salvo internamente para a fonte do idioma japonês, então decidimos criar uma nova). E: “While the Western language font required us to create only a few hundred characters, with the Japanese font, we had to create around 7,500 characters.” (enquanto a fonte dos idiomas ocidentais exigiu criar só algumas centenas de caracteres, na fonte japonesa tivemos de criar cerca de 7.500).⁸

Essa é a quarta imprecisão do post do mundo. Ele dava o mesmo número, “about 7,500 Japanese characters” (cerca de 7.500 caracteres japoneses), e citava a reportagem do GoNintendo sobre o trabalho; a fonte primária é a própria entrevista do produtor à Siliconera, que diz “around 7,500 characters”.²³⁸ Mesmo número, fonte melhor.

Sete mil e quinhentos é mais ou menos o tamanho dos 6.879 caracteres do JIS X 0208, a meta de cobertura habitual; a comparação é minha.⁵³³ Um jogo cujas linhas ficam todas fixadas antes do lançamento pode desenhar menos, como fez a ROM japonesa de Final Fantasy VI com 1.248 letras de diálogo (seção 3), e aí cada string precisa ser conferida contra a fonte; uma fonte que cobre o conjunto inteiro não precisa dessa conferência para nenhuma string tirada dele.⁴ A lição para um app pequeno é a mesma que as fontes gratuitas da seção 4 ensinam pelo outro lado: para um texto que vai continuar crescendo, a tipografia pixelada japonesa só é um problema resolvido se alguém já desenhou os sete mil caracteres e a licença deixa você distribuí-los.

O que os jogos pixelados modernos trazem

Na Steam, em 5 de outubro de 2026, Stardew Valley lista 12 idiomas, entre eles japonês, chinês simplificado e coreano; Celeste, 9, entre eles japonês e chinês simplificado; Sea of Stars, 11, entre eles japonês, coreano e chinês simplificado e tradicional; e Eastward, 7, entre eles os dois chineses e o japonês.⁶⁴ Todos os quatro trazem japonês.

Como Celeste, Sea of Stars e Eastward desenham o texto em japonês e em chinês, não encontrei em nenhuma fonte dos desenvolvedores, então este post não diz nada sobre isso além das listas de idiomas (seção 11).

Duas formas de fala no Kiradex

O Kiradex já tem as duas formas do Stardew: a caixa do WorldHUD na parte de baixo da tela e os balões da praça sobre as cabeças.²⁶²⁵ O que falta é a tipografia do cânone dentro deles, e um jeito de o VoiceOver ouvir qualquer um dos dois. O próprio comentário do balão no código diz o que ele buscava: “A line said, as the old games drew it: a cream box with a dark border.” (uma fala, como os jogos antigos a desenhavam: uma caixa creme com uma borda escura).²⁵

9. O ofício, como regras com números

Estas são as regras que as medições sustentam, cada uma com a sua origem. Onde uma regra transforma um fato medido numa recomendação, a recomendação é minha, e a regra deixa isso claro pelo verbo.

Cada número da tabela vem das seções 1 a 8 e tem lá a sua nota.^1467921862

10. Do jeito da Apple: tipografia, tamanhos, quebras de linha e VoiceOver

O Kiradex World é uma cena de RealityKit usada como renderizador 2D, com uma câmera ortográfica a um número inteiro de pixels de dispositivo por texel e SwiftUI por cima para tudo o que uma pessoa lê.²³ O post do mundo decidiu que o texto de diálogo “lives in SwiftUI at UI scale rather than in the world” (vive no SwiftUI em escala de interface, e não no mundo), e esta seção mantém essa decisão e preenche as APIs: o que a Apple pede da tipografia personalizada, como entra uma fonte pixelada incluída no app, como o Dynamic Type pode ser respeitado por arredondamento, como o japonês quebra e como o VoiceOver pode ler um palco que é uma única view de RealityKit. Cada disponibilidade abaixo vem das páginas de documentação da Apple, salvas em 5 de outubro de 2026; nada do código foi compilado, e nenhum custo desta seção foi medido num telefone.⁶⁵

O que a Apple pede do texto

A página Typography das Human Interface Guidelines dá ao iOS e ao iPadOS um tamanho de texto padrão de 17 pontos e um mínimo de 11, e pede que os apps “Follow the recommended default and minimum text sizes for each platform” (sigam os tamanhos de texto padrão e mínimo recomendados para cada plataforma), tanto para fontes personalizadas quanto para as do sistema.¹⁰⁶⁰ As fontes do sistema dão suporte por conta própria ao Dynamic Type e a recursos de acessibilidade como Texto em Negrito; para o resto, a página diz: “If you use a custom font, make sure it implements the same behaviors.” (se você usar uma fonte personalizada, garanta que ela implemente os mesmos comportamentos).¹⁰

A página Accessibility define o tamanho do trabalho: “Ideally, give people the option to enlarge text by at least 200 percent (or 140 percent in watchOS apps).” (de preferência, dê às pessoas a opção de ampliar o texto em pelo menos 200 por cento, ou 140 por cento em apps de watchOS).²⁰ A página sobre jogos acrescenta a legibilidade: “To keep text comfortably legible on each device, ensure that it contrasts well with the background and uses at least the recommended minimum text size in each platform.” (para manter o texto confortavelmente legível em cada dispositivo, garanta que ele contraste bem com o fundo e use pelo menos o tamanho mínimo de texto recomendado em cada plataforma).⁶⁶

A faixa de Body, de 14 a 53 pontos, vai de cerca de 82% a cerca de 312% do padrão de 17; os tamanhos arredondados da caixa a 3×, de 13,33 a 53,33 pontos, vão de 80% a 320% do seu próprio padrão de 16,67, além dos 200% que a página Accessibility pede.⁶⁰¹¹³³

Escalar uma fonte personalizada

A Apple tem três jeitos de escalar um valor com o Dynamic Type, e um para impedir isso.

• UIFontMetrics, “A utility object for obtaining custom fonts that scale to support Dynamic Type” (um objeto utilitário para obter fontes personalizadas que escalam para dar suporte ao Dynamic Type), disponível desde o iOS 11.0, com scaledFont(for:), scaledFont(for:maximumPointSize:) e scaledValue(for:), que “Scales an arbitrary layout value based on the current Dynamic Type settings” (escala um valor de layout arbitrário com base nos ajustes atuais do Dynamic Type).⁶⁷
• Font.custom(_:size:relativeTo:), no SwiftUI, cria uma fonte personalizada “that scales relative to the given textStyle” (que escala em relação ao textStyle informado), desde o iOS 14.0.⁶⁸
• ScaledMetric, “A dynamic property that scales a numeric value” (uma propriedade dinâmica que escala um valor numérico), desde o iOS 14.0.⁶⁹
• Font.custom(_:fixedSize:) cria uma fonte personalizada “that does not scale with Dynamic Type” (que não escala com o Dynamic Type), desde o iOS 14.0.⁶⁸

Uma fonte pixelada precisa da primeira ou da terceira junto com a última: ler o tamanho que o sistema usaria, arredondá-lo à grade da fonte e aplicar o tamanho arredondado como tamanho fixo, para que o sistema não o escale de novo. O arredondamento em si é aritmética, e está no briefing da seção 12: um pixel de fonte vira m pixels de dispositivo, m = max(m₀, ⌊size × displayScale / 10 + 0.5⌋) para um em de 10 pixels, o inteiro mais próximo com a metade arredondando para cima, onde m₀, o menor m com pelo menos 11 pontos, vale 4 a 3× e 3 a 2×, e o tamanho em pontos é 10 × m / displayScale. A 3×, isso leva os doze tamanhos de Body a valores de m de 4, 5, 5, 5, 6, 6, 7, 8, 10, 12, 14 e 16 (Small, de 15 pontos, é a única metade exata: 4,5 arredonda para 5): 16,67 pontos no tamanho padrão e 53,33 em AX5.¹¹

Para limitar o tamanho dentro de uma view, dynamicTypeSize(_:) (iOS 15.0) define ou limita o tamanho do Dynamic Type, e a página dele aconselha: “When limiting the Dynamic Type size, consider if adding a large content view with accessibilityShowsLargeContentViewer() would be appropriate.” (ao limitar o tamanho do Dynamic Type, considere se seria apropriado acrescentar uma visualização de conteúdo grande com accessibilityShowsLargeContentViewer()).⁷⁰ Esse modificador, também do iOS 15.0, traz o seu próprio aviso: “Don’t use the large content viewer as a replacement for proper Dynamic Type support.” (não use o visualizador de conteúdo grande como substituto de um suporte adequado ao Dynamic Type).⁷¹ O briefing limita só os balões, que precisam continuar com uma linha, e nunca a caixa.

Incluir a fonte

Uma fonte vai no bundle do app e é nomeada em UIAppFonts, “App-specific font files located in the bundle and that the system loads at runtime” (arquivos de fonte específicos do app, localizados no bundle e que o sistema carrega em tempo de execução) (iOS 3.2), ou registrada em código com CTFontManagerRegisterFontsForURL(_:_:_:) (iOS 4.1).⁷²⁷³

Desenhar a moldura e posicionar a linha de base

Uma moldura desenhada a partir de poucos tiles é uma imagem redimensionada sem suavização. Image.interpolation(_:), do SwiftUI, define a qualidade da interpolação desde o iOS 13.0, e Image.resizable(capInsets:resizingMode:), que “Sets the mode by which SwiftUI resizes an image to fit its space” (define o modo pelo qual o SwiftUI redimensiona uma imagem para caber no espaço dela), estica ou repete em mosaico tudo menos os cantos, também desde o iOS 13.0.⁷⁴⁷⁵ O briefing desenha a moldura num Canvas, para que cada pixel de origem tenha exatamente m por m pixels de dispositivo; na minha leitura, resizable(capInsets:) com .tile serviria igualmente só se o mosaico dele caísse em pixels de dispositivo inteiros, o que ninguém mediu.

Text.baselineOffset(_:), que “Sets the vertical offset for the text relative to its baseline” (define o deslocamento vertical do texto em relação à linha de base) (iOS 13.0), é a ferramenta para uma fonte cuja grade fica fora da linha de base, como a de PixelMplus12; a seção 6 mediu que um deslocamento conserta uma fonte assim num único tamanho, que é um dos motivos de o briefing não usá-la.⁷⁶⁷

Quebra de linha japonesa no SwiftUI e no UIKit

typesettingLanguage(_:isEnabled:) (iOS 17.0) serve para um Text que “may contain text of a particular language which doesn’t match the device UI language. In that case it’s useful to specify a language so line height, line breaking and spacing will respect the script used for that language” (pode conter texto de um idioma específico que não coincide com o idioma da interface do dispositivo; nesse caso, é útil especificar um idioma para que a altura de linha, a quebra de linha e o espaçamento respeitem a escrita desse idioma). A página dele acrescenta: “this language does not affect text localization.” (esse idioma não afeta a localização do texto).⁷⁷

O NSParagraphStyle.LineBreakStrategy do UIKit (iOS 9.0) tem três estratégias nomeadas. standard (iOS 14.0) “uses the same configuration of line-break strategies that it uses for standard UI labels” (usa a mesma configuração de estratégias de quebra de linha que usa para os rótulos padrão da interface) e “may be unsuitable for large amounts of text” (pode não ser adequada para grandes quantidades de texto); pushOut (iOS 9.0) existe para evitar “an orphan word on the last line” (uma palavra órfã na última linha); hangulWordPriority (iOS 14.0) é para o coreano.⁷⁸

A seção 7 mediu que o Core Text no macOS, marcado com ja, deixou kana pequenos começarem linhas em 6 de 7 larguras na maioria das fontes (4 de 7 em k8x12 e k8x12S), e sem marcação não.⁷ O que o Text do SwiftUI faz com o japonês quando o idioma do dispositivo é japonês, e se typesettingLanguage define o mesmo atributo que a medição definiu, não foi medido (seção 11). Por isso o briefing mantém o texto da caixa sem marcação, a menos que uma captura mostre a regra estrita valendo com a marcação.

VoiceOver sobre um palco

Os modificadores de acessibilidade do SwiftUI descrevem uma view: accessibilityLabel(_:) a nomeia, e accessibilityValue(_:) acrescenta o valor dela, com uma regra na documentação: “Use this method to describe the value represented by a view, but only if that’s different than the view’s label.” (use este método para descrever o valor representado por uma view, mas só se ele for diferente do rótulo da view). Os dois são do iOS 16.0 na forma com LocalizedStringResource que as páginas listam.⁷⁹

O palco de um jogo precisa de mais do que um rótulo. accessibilityDirectTouch(_:options:) (iOS 17.0) cria uma área em que “Direct touch areas passthrough touch events to the app rather than being handled through an assistive technology, such as VoiceOver” (áreas de toque direto repassam os eventos de toque ao app em vez de serem tratadas por uma tecnologia assistiva, como o VoiceOver), depois que o usuário a ativa.⁸⁰ AccessibilityTraits.updatesFrequently (iOS 13.0) é para um elemento que muda: “Use this trait when you want an assistive technology to poll for changes when it needs updated information.” (use este traço quando quiser que uma tecnologia assistiva consulte as mudanças quando precisar de informação atualizada).⁸¹ AccessibilityNotification.Announcement (iOS 17.0) publica um anúncio falado, com um atributo accessibilitySpeechAnnouncementPriority que define como ele entra na fila em relação a outras falas.⁸² E accessibilityReduceMotion (iOS 13.0) informa o ajuste Reduzir Movimento (Reduce Motion), que, segundo a página dele, significa que a “UI should avoid large animations” (interface deve evitar animações grandes).⁸³

O RealityKit consegue descrever as próprias entidades. AccessibilityComponent (iOS 17.0) é “A component that stores accessibility information for an entity” (um componente que guarda informações de acessibilidade de uma entidade), cujo nome o “VoiceOver says aloud when it describes the entity” (VoiceOver diz em voz alta ao descrever a entidade).⁸⁴ O artigo da Apple “Improving the Accessibility of RealityKit Apps” manda “set the properties on each visible Entity in your scene” (definir as propriedades em cada Entity visível da cena): as propriedades de acessibilidade da própria Entity, isAccessibilityElement, accessibilityLabel e accessibilityDescription, que o artigo data do iOS 14 e cujas páginas agora estão marcadas como obsoletas, todas menos isAccessibilityElement (a página também lista accessibilityLabelKey, um rótulo como chave de string localizada), um caminho mais antigo ao lado do componente.⁸⁵ RealityView, a view de SwiftUI que o palco do Kiradex usa, é do iOS 18.0.⁸⁶ Se uma RealityView com uma câmera ortográfica virtual, como o Kiradex a configura, expõe essas entidades ao VoiceOver, não está documentado nessas páginas e não foi testado (seção 11).

Testar isso já pode ser automatizado. XCUIVoiceOverService “Provides programmatic control of VoiceOver for UI testing” (oferece controle programático do VoiceOver para testes de interface), disponível desde o iOS 27.0, e é acessado pela propriedade voiceOverService de XCUIDevice.⁸⁷

O Kiradex hoje

Lido no repositório em 5 de outubro de 2026, no commit 334fbfe com as edições não commitadas daquele dia, sem que eu o executasse ou alterasse; o app estava sendo editado enquanto eu o lia (seção 11):¹¹

• Uma fonte só, a do sistema. A família de fontes do tema é .systemDesign(.monospaced), e as views do mundo usam os papéis do kit: caption em 10 chamadas distribuídas em quatro arquivos, label em 3, body em 3 e title em 3.²⁴¹¹
• Um caminho de fonte personalizada que escala continuamente. O Kit941.FontFamily.custom(named:) do kit compartilhado resolve para Font.custom(_:size:relativeTo:) em 34, 22, 17, 13 e 12 pontos para display, title, body, label e caption.⁸⁸ Com uma fonte pixelada, isso escalaria por todos os tamanhos de Dynamic Type, o que a seção 6 conta como fora da grade em 9 de 12 tamanhos de Body para um em de 12 pixels e em 11 de 12 para um em de 10.⁷
• O balão. Text(text).kit941Font(.caption, weight: .bold), tinta sobre WorldInk.paper (uma superfície de arte com duas cores fixas), com o espaçamento pequeno do kit como preenchimento na horizontal e o extrapequeno na vertical, com uma borda de tinta de 2 pontos e .fixedSize(), então uma linha. Ele fica um passo de espaçamento grande acima de rig.headPoint, aparece enquanto a linha tem menos de 4 segundos e tem o rótulo "Said: \(text)" dentro de uma sobreposição com o hit testing desligado. Essa sobreposição fica dentro do palco, sob as duas sobreposições que o palco põe sobre a cena inteira: scanlines, uma linha preta com 16% de opacidade a cada 3 pontos, e uma vinheta.²⁵¹¹
• A caixa. WorldHUD põe o título do lugar (caption, negrito, em maiúsculas) e o status dele (caption, seminegrito) numa caixa creme com a mesma borda de 2 pontos na parte de baixo da tela; com o Duo meio aberto, ela fica do lado mais largo da dobra. Ela não recebe toques (.allowsHitTesting(false), “Taps go through to the ground under it”, os toques passam para o chão embaixo dela) e fica sobreposta ao palco inteiro, acima das scanlines e da vinheta.²⁶
• O que se diz. 23 linhas predefinidas no servidor, de 3 a 40 caracteres, com mediana de 16; a mais longa é “Anyone have a card from the first years?” (alguém tem uma carta dos primeiros anos?). Os apelidos são duas palavras de listas de 20 e 20 e quatro dígitos, com no máximo 20 caracteres (“Glacier Shuffle 0000”). Nada é desenhado sobre a cabeça de um colecionador além do balão; o apelido aparece no painel que um toque abre.²⁸⁸⁹¹¹ O post desta série sobre a vida própria da cidade contou as mesmas 23 linhas e um limite do servidor de uma linha a cada 2,0 segundos por jogador.⁹⁰⁹¹
• Nenhuma fonte, um idioma. Nenhum arquivo de fonte é incluído (o único .ttf do repositório é scripts/screenshots/MartianMono-latin.ttf, para a ferramenta de capturas de tela); as knownRegions do projeto são Base e en, e não há nenhum arquivo .xcstrings ou .lproj.¹¹²⁷
• O VoiceOver ouve coordenadas. O palco é um elemento só, .accessibilityLabel("The plaza") e .accessibilityValue(stepTrace), em que stepTrace é o último passo como “x,y facing” (x,y direção), mantido porque “the walks read it, since nothing else the simulator logs reaches them” (os testes de caminhada o leem, já que nada mais do que o simulador registra chega até eles). Nenhum AccessibilityComponent, accessibilityDirectTouch, AccessibilityNotification, typesettingLanguage, UIFontMetrics, ScaledMetric ou dynamicTypeSize aparece em nenhum lugar do código do app.²⁵¹¹
• Placas sem letras. O sign() da forja é “A hanging sign on a bracket, 12 × 11” (uma placa pendurada num suporte, 12 × 11) cuja face são duas fileiras de marcas de tinta, não letras; o mapa da praça tem um tile de placa, S. Um dedo no chão leva o jogador na hora até o tile embaixo dele e é seguido de tile em tile; um toque num colecionador abre o painel dele quando o dedo sobe, e um no quiosque abre o quadro da cidade; um tile de placa é chão como qualquer outro, sem toque próprio.²⁹⁹²
• A escala do mundo. Pela regra de PlazaRig.fit, a parte inteira da altura em pixels da view dividida por 320, um texel são 8 pixels de dispositivo no iPhone 18 Pro Max (440 por 956 pontos) e na tela interna do Duo em retrato, 6 na tela externa do Duo em retrato e na interna em paisagem, e 4 na externa em paisagem: 2,67, 2,00 ou 1,33 pontos.⁹³¹¹

Por que o texto fica fora do mundo

A aritmética do post do mundo sobre isso está certa: “At k = 8 on a 3× display a five-texel font is 13.3 points and at k = 6 it is 10 points, under the HIG’s 11-point minimum” (com k = 8 numa tela de 3×, uma fonte de cinco texels tem 13,3 pontos e com k = 6 tem 10 pontos, abaixo do mínimo de 11 pontos das HIG).²³ Isso só restringe fontes abaixo de 5,5 texels com k = 6 (11 pontos a 2 pontos por texel); um em de 8 texels com k = 6 tem 16 pontos.¹¹³³ A conclusão, texto em escala de interface no SwiftUI, se sustenta por outro motivo: na densidade do mundo, um em de 10 pixels tem 26,67 pontos num telefone a 8 pixels de dispositivo por texel, o que deixa 29 caracteres latinos por linha da caixa no 18 Pro Max.¹¹ Medida em tiles, a caixa do cânone é estreita. Uma caixa de 16 tiles de hardware de largura, 128 pixels, comporta 16 caracteres de uma fonte de 8 por 8, cerca de 24 dos latinos de Emerald com a média de 5,25 pixels (21 no pior caso, de 6), 16 dos japoneses de 8 pixels de Emerald e 10 dos japoneses de 12 pixels de Final Fantasy VI. Dezesseis dos tiles de 16 texels do Kiradex são 256 texels, que na densidade do próprio mundo comportam 42 caracteres latinos e 21 kana de PixelMplus12, ou 64 e 32 de Misaki.¹¹ E uma caixa medida nos próprios tiles do Kiradex não cabe em três das cinco views medidas: 16 tiles de 16 texels são 683 pontos a 8 pixels de dispositivo por texel, mais largos que o iPhone 18 Pro Max (440 pontos) e que a tela interna do Duo em retrato (669), e 512 pontos a 6, mais largos que a tela externa do Duo em retrato (466). Ela só cabe nas duas views em paisagem: 512 pontos nos 951 da tela interna, e 341 pontos a 4 pixels de dispositivo por texel nos 678 da externa.¹¹ Uma caixa do Kiradex é dimensionada em pontos, não em tiles.

A mesma aritmética no tamanho do briefing: PixelMplus10 com m = 5, 16,67 pontos, comporta 47 caracteres latinos ou 23 japoneses por linha na caixa de um 18 Pro Max em retrato, depois da margem atual de 48 pontos, 16 pontos de margem e 8 de preenchimento de cada lado, contados a partir da largura inteira, sem margens laterais (suposto, não medido). A caixa fica dentro da área segura, então, na tela externa do Duo em retrato, a contagem depende da margem lateral: 50 ou 25 sem margem, e 40 ou 20 com a margem final de 84 pontos, o trilho lateral, que esta série mediu na tela fechada (seção 11). Com a moldura do briefing (seção 12, item 3), que ocupa 8 pixels de fonte de cada lado no lugar do preenchimento e arredonda a caixa para baixo a pixels de fonte inteiros, as mesmas linhas comportam 45 ou 22 no 18 Pro Max, e 48 ou 24, ou 38 ou 19 com o trilho, no Duo.¹¹⁹⁴⁹⁵

Custos

Nada disso foi medido num dispositivo. Incluir uma fonte de 7.253 glifos acrescenta o arquivo dela ao app;⁷ desenhar texto pelo SwiftUI com uma fonte personalizada custa o que qualquer Text custa; e a moldura do briefing é um Canvas que se redesenha quando o tamanho muda. Na minha leitura, nada disso é grande perto de uma cena de RealityKit, mas é uma leitura, e as capturas do briefing são onde ela é conferida.

11. O que está medido e o que não está

Tudo o que tem número neste post vem de scripts que rodam de novo sobre fontes salvas, de páginas salvas em 5 de outubro de 2026 ou de leituras datadas do código do Kiradex; as notas dizem qual. Esta seção é a lista do que isso não cobre.³⁰

Medido no código, reexecutável. measure_gen_text.py sobre as quatro descompilações do pret: a tabela de fontes de Emerald (dez entradas, sete fontes); a velocidade do texto em quadros e caracteres por segundo; a rolagem; a seta de avanço; a janela de 27 por 4 e a moldura de 30 por 6; as 20 molduras selecionáveis; as larguras dos glifos latinos; 24.100 linhas de script em caracteres e pixels; 934 de 14.412 parágrafos que dizem quem fala; as folhas de glifos japoneses; os atrasos e a janela de FireRed; as telas, caixas, atrasos, molduras e folhas de fonte de Crystal e Red.¹ measure_ff6.py sobre o disassembly de ff6: estilos e paletas de janela, a célula e as larguras da fonte de diálogo, o tamanho e as sequências de largura da fonte japonesa, a linha de 220 pixels, uma letra por quadro, o título de 100 quadros, a quebra por palavra, a tela de configuração e a tabela do degradê da janela.⁴ measure_bdf.py sobre os arquivos BDF de Misaki e k8x12.⁶ measure_coretext.swift e measure_outline_coords.swift, compilados e executados no macOS 27.0, sobre dez arquivos TrueType e Hiragino Sans.⁷¹⁹ measure_kiradex_text.py sobre o Kiradex como estava em disco no commit 334fbfe (reexecutado em 15 de outubro contra a árvore atual, com as linhas anteriores inalteradas), e measure_figure_width.py sobre a folha de corpo dele.¹¹⁹⁶ measure_hig.py, measure_steam_languages.py e measure_apple_docs.py sobre as páginas salvas.⁶⁰⁶⁴⁶⁵ measure_ios27_iphones.py sobre a lista de iPhones do runtime do simulador do iOS 27.0, e probe_line_start_glyphs.swift, compilado e executado no macOS 27.0, sobre as tabelas de classes do JLREQ e PixelMplus10.⁹⁷⁹⁸ measure_cell_masks.py sobre as folhas do pret salvas: a referência de máscaras de célula do briefing.⁹⁹ São treze scripts; um décimo quarto, dump_glyphs.swift, guardado com as figuras deste post, desenhou PixelMplus10 no próprio tamanho com a suavização de fontes ligada e desligada.⁹

Não medido, ou mais fraco do que parece.

• O Core Text do macOS faz as vezes do iOS. Cada número de renderização e de quebra de linha das seções 6 e 7 vem do Core Text do macOS 27.0 desenhando num contexto de bitmap, com a suavização de fontes desligada, não do SwiftUI num iPhone. As verificações por captura do briefing são a medição que conta; até que rodem, o que um iPhone desenha é uma previsão.⁷⁹
• Bitmaps embutidos. Misaki e k8x12 trazem tabelas EBDT e EBLC; se o Core Text desenhou esses bitmaps ou os contornos a 8 e 12 pixels, não foi determinado.⁷
• O posicionamento do próprio SwiftUI. Se o SwiftUI posiciona as origens de Text em pixels de dispositivo inteiros, e qual regra de quebra de linha ele aplica ao japonês quando o idioma do dispositivo é japonês, não foi medido.
• Pesos. PixelMplus10 Bold é o único negrito medido; negrito sintético em qualquer fonte pixelada não foi.⁷
• Legibilidade. Grades e cobertura estão medidas; se kanji de 10 por 10 são bem legíveis para um leitor japonês a 16,67 pontos não está, e isso precisa de um leitor japonês com um dispositivo.
• ROMs japonesas. O pret monta os jogos em inglês. A caixa, as velocidades e a fonte próprias do Emerald japonês não foram lidas; as folhas japonesas da seção 1 são as que a ROM em inglês carrega para nomes. Crystal e Red em japonês não foram lidos.³⁰
• Os gráficos de Final Fantasy VI. O disassembly tem intervalos e código, não pixels; o layout dos tiles da janela e a aparência do degradê não foram vistos. O intervalo da fonte grande em inglês, 5.120 bytes, não é um número inteiro de letras de 22 bytes, sem explicação. Que a tabela do degradê é consumida a um valor por linha de varredura vem dos comentários, não foi rastreado.⁴
• O período do piscar de Crystal não foi derivado; os dois estados foram lidos no código.¹⁶
• Chrono Trigger não foi medido de forma alguma. Nenhum disassembly público foi clonado, e o mapa da ROM do Data Crystal retornou HTTP 403.⁴⁹
• Celeste, Sea of Stars e Eastward. Só as listas de idiomas na Steam; como eles desenham texto em japonês e em chinês não foi encontrado em nenhuma fonte dos desenvolvedores.⁶⁴
• Pixel Operator, m5x7 e m3x6 não foram baixadas nem medidas, e o repositório do próprio Pixel Operator retornou HTTP 404; as licenças delas são como as páginas as descrevem, a de Pixel Operator só pelo DaFont.⁵⁶⁵⁷⁵⁸
• Os três pontos de código do JIS que PixelMplus não mapeia não foram conferidos nos pontos de código alternativos.⁷
• O tamanho de DotGothic16. Ela não tem grade de pixels, então foi desenhada e composta a 16 pontos por em nominais e em múltiplos disso, escolha minha a partir do nome e do passo dos pontos; nenhum outro tamanho nominal foi testado, e os números dela nas seções 6 e 7 valem só para esses tamanhos.⁷¹⁹
• Suavização de fontes. Todos os renderizados da seção 6 impedem a suavização de fontes; com o padrão do contexto de bitmap, só uma fonte num tamanho foi desenhada, PixelMplus10 a 10 pixels, com 178 de 272 pixels com tinta parciais. As outras fontes e tamanhos não foram desenhados com a suavização ligada.⁹
• O app mudou enquanto eu o lia. O Kiradex estava sendo editado em 5 de outubro enquanto este post era escrito. Mais cedo naquele dia, o tratamento de toques do palco foi reescrito e as linhas dele se moveram de 30 a 144, e três dos arquivos Swift do mundo ainda não estavam em nenhum commit; catorze minutos depois da minha leitura, o palco e o rig tinham mudado de novo. O post lê o commit 334fbfe com as edições não commitadas daquele dia como estavam quando as li: os arquivos do app às 12:28, horário do Pacífico (os colecionadores do servidor e o mapa da cidade às 12:33), os scripts que o medem às 12:34 e 12:36. As notas dão as linhas de cada arquivo nessa leitura; o briefing nomeia símbolos em vez de linhas, e às 12:42 conferi que cada símbolo que ele nomeia ainda estava lá.¹¹
• Os iPhones em que o app roda. A lista de 33 iPhones, três deles de 2×, é a do runtime do simulador do iOS 27.0, lida do Xcode no meu Mac; a página da Apple com os iPhones compatíveis com o iOS 27 não foi buscada.⁹⁷
• Margens da área segura. O post desta série sobre o simulador do iPhone Duo mediu a tela externa fechada, com 466 pontos de largura, com o conteúdo de 382 pontos de largura dentro de uma margem final de 84 pontos, o trilho lateral, numa sonda que mostrava a barra de status, uma barra de ferramentas e uma barra de abas.⁹⁵ O mundo do Kiradex esconde a barra de status e o indicador de início e não mostra barras; o código põe os controles do mundo dentro da área segura e diz que isso os mantém longe das câmeras e do trilho lateral, mas nem o código nem aquela medição dizem qual é a largura da margem com a barra de status escondida, então os números do Duo nas seções 10 e 12 aparecem das duas formas, sem margem lateral e com os 84 pontos medidos. As margens laterais dos outros iPhones em retrato não foram medidas; os números do briefing para eles supõem nenhuma.⁹⁴
• Acessibilidade do RealityKit na configuração do Kiradex. AccessibilityComponent está documentado para o iOS 17.0; se uma RealityView com uma câmera ortográfica virtual expõe elementos de entidade ao VoiceOver não foi verificado.⁸⁴
• Os números do briefing. O arredondamento de m, o balão um passo menor que a caixa e mantido abaixo de um teto definido por cada view, a margem de 32 pontos, a fila da caixa e suas três linhas, os 8 pixels de fonte da moldura no lugar do preenchimento da caixa, os passos de 150 milissegundos da marca, quatro molduras e seis células para os anúncios são propostas, não fatos.

Onde este post diverge do post do mundo. As seções 1, 2, 5 e 8 corrigem, cada uma, uma afirmação dele, com a medição; a aritmética de tamanhos dele está certa (seção 10). Três fatos que este post toma dos outros posts da série foram conferidos contra o app: as 23 linhas predefinidas da cidade batem com lines.py; a nota do post dos personagens de que o balão ainda tira a posição da altura da célula bate com PlazaRig.headPoint, que soma metade da altura do quadro da folha e 4 à posição de quem caminha; e a figura sob o balão é a que a atualização daquele post descreve, com 30 texels de altura numa célula de 32 por 40, o que o manifesto do app, rig.py e a folha de corpo confirmam. Aquele post só dá uma largura para a figura anterior, de 26 texels, cerca de 14 nos ombros; a seção 12 mede a largura da figura atual na folha.^90100289396

Fontes não alcançadas. O mapa da ROM de Chrono Trigger no Data Crystal (HTTP 403); o repositório do Pixel Operator no NotABug (HTTP 404); os arquivos de fonte de m5x7 e m3x6 (atrás de um download de pague quanto quiser, não tentado); e uma fonte dos desenvolvedores sobre o texto em japonês e em chinês de Celeste, Sea of Stars ou Eastward (não encontrada).^49565758

12. O briefing: o que o Kiradex constrói e as verificações que precisa passar

O app andou desde então. No commit fc9d4876, de 15 de outubro, o rótulo e o valor do palco são definidos num modificador de view StageAccessibility (PlazaStage.swift, aplicado na linha 373, definido a partir da linha 520), ainda “The plaza” com o rastro de passos como valor, e o elemento some enquanto um lugar cobre o palco. As verificações abaixo leem o build de 5 de outubro, e cada “hoje” se refere a esse build; o item 8 vale para os dois.¹⁰¹

Síntese do autor. O que segue é a minha proposta, derivada das seções 1 a 11 e escrita como um diff em relação ao Kiradex como ele estava em 5 de outubro de 2026, no commit 334fbfe com as edições não commitadas daquele dia na árvore de trabalho (seção 11): texto monoespaçado do sistema em cada view do mundo, um balão de uma linha em caption negrito, a caixa do WorldHUD embaixo, um app só em inglês com linhas predefinidas em inglês no servidor, um sprite de placa sem letras e um palco que o VoiceOver lê como coordenadas.²²¹¹ A direção do post do mundo continua de pé: texto é arte; o diálogo vive no SwiftUI em escala de interface, não nos texels do mundo; uma caixa construída com tiles; duas linhas; uma máquina de escrever; uma marca de avanço.²³ O que muda é a fonte, pelo motivo que a seção 5 dá, e a aritmética, porque o Dynamic Type precisa ser arredondado à grade da fonte.⁷ Nada aqui desenha um glifo, uma moldura, uma marca ou uma palavra de uma franquia; tudo é desenhado pela forja ou composto numa fonte cuja licença é citada na seção 4. As notas jurídicas são leituras minhas, não aconselhamento jurídico. Nada disso foi construído.

Cada verificação abaixo é uma que um script, uma linha de log de um teste ou uma captura podem aprovar ou reprovar, com exceção de uma verificação manual datada num dispositivo, no item 8. Onde o resultado de uma verificação depende do dispositivo, do tamanho do texto, da linha escolhida ou do que mais a caixa está mostrando, ela os nomeia. O briefing nomeia o código do app pelos símbolos, não pelos números de linha, porque o código se moveu enquanto eu o lia; as notas dão as linhas como eu as li, com o commit e a hora. Onde a evidência por trás de um item é uma medição no meu Mac e a verificação roda num iPhone ou no simulador dele, quem decide é a verificação, não o Mac.

1. Uma fonte para os dois idiomas: PixelMplus10

O quê. Incluir PixelMplus10-Regular.ttf e PixelMplus10-Bold.ttf (de itouhiro, a partir das M+ BITMAP FONTS do M+ FONTS PROJECT; licença: M+ FONT LICENSE, https://github.com/itouhiro/PixelMplus/blob/master/misc/mplus_bitmap_fonts/LICENSE_E) via UIAppFonts, com LICENSE_E no bundle, e acrescentar aos Ajustes uma seção de agradecimentos, que hoje não existe, nomeando itouhiro e o M+ FONTS PROJECT.¹⁸⁷² Usá-la para cada palavra desenhada sobre o mundo: os balões, a caixa do WorldHUD, o texto das placas, o quadro de missões e as plaquinhas da exposição. O resto do app, a Dex, o scanner e os Ajustes, mantém a fonte do sistema.

Por que esta. Duas fontes medidas têm as três coisas que as regras da seção 9 pedem: japonês, uma grade limpa e avanços de pixels inteiros. Misaki Gothic e Misaki Gothic 2nd desenham todos os 6.879 caracteres do JIS X 0208 numa grade de 8 pixels sobre a linha de base, com 0 de 848 e 0 de 860 coordenadas de contorno amostradas fora dela e avanços de 4 e 8. PixelMplus10 desenha 6.876 dos 6.879, todos os kanji dos dois níveis, numa grade de 10 pixels sobre a linha de base, com 0 de 1.032 coordenadas de contorno amostradas fora dela na Regular e 0 de 1.000 na Bold, e avanços de 5 para o latim e 10 para os kana.⁷ O briefing escolhe PixelMplus10, escolha minha: é a maior das duas, 10 pixels contra os 8 de Misaki, e os kanji de 8 por 8 de Misaki são aqueles cuja legibilidade para um leitor japonês está mais em dúvida (seção 11); e ela vem com uma Bold que foi medida, então o texto em negrito não precisa de síntese. Recusadas, cada uma com a medição que a recusa:

• PixelMplus12 (M+ FONT LICENSE): a grade dela fica 0,39 pixel abaixo da linha de base, e o Core Text no macOS 27.0 a borrou em todos os tamanhos.⁷
• k8x12 (a licença de três frases em littlelimit.net, https://littlelimit.net/font.htm#license): o avanço de kana dela é de 8,01 pixels, e as letras latinas têm 4 pixels de largura.⁷¹⁷
• Misaki (a mesma licença, https://littlelimit.net/font.htm#license): tem as três coisas, mas os kanji dela são os menores medidos, 8 por 8, e aqueles cuja legibilidade para um leitor japonês está mais em dúvida (seção 11).⁶¹⁷
• DotGothic16 (SIL Open Font License 1.1, https://github.com/google/fonts/blob/main/ofl/dotgothic16/OFL.txt): os pontos dela não ficam em nenhuma grade, e o Core Text no macOS 27.0 a desenhou com 37,3% a 82,3% de parciais de 16 a 64 pixels.⁷⁵³
• Press Start 2P (SIL Open Font License 1.1 com um Reserved Font Name, https://github.com/google/fonts/blob/main/ofl/pressstart2p/OFL.txt) e Silkscreen (SIL Open Font License 1.1, https://github.com/google/fonts/blob/main/ofl/silkscreen/OFL.txt): sem japonês.⁷⁵⁴⁵⁵
• m5x7 (a página dela: “Creative Commons Zero v1.0 Universal”, https://managore.itch.io/m5x7) e m3x6 (a página dela: “free to use with attribution”, de uso livre com atribuição, sem campo de licença, https://managore.itch.io/m3x6): não medidas; latinas pelas descrições das próprias páginas; atrás de um download de pague quanto quiser.⁵⁷⁵⁸
• Pixel Operator (CC0 1.0 pelas notas do autor no DaFont, https://www.dafont.com/pixel-operator.font): não medida; 241 glifos no DaFont, poucos demais para o japonês.⁵⁶

O kit. O kit compartilhado dos meus apps encaminha cada estilo de texto por .kit941Font(role), e o caminho de fonte personalizada dele escala uma fonte continuamente, o que deixaria esta fonte fora da grade em 11 de 12 tamanhos de Body, a condição em que o Core Text no Mac a borrou.⁸⁸⁷ O mundo já é uma superfície de arte declarada, WorldInk, com as suas próprias duas cores.²⁵ Acrescentar um modificador PixelText local do Kiradex, declarado com um comentário como a exceção dessa superfície de arte, que recebe um papel do kit e aplica o arredondamento do item 2; propô-lo para o kit como um caso de família de fontes só depois que ele for lançado.

Sem pesos sintéticos. O texto em negrito usa PixelMplus10-Bold; nada de .weight(_:) na fonte pixelada, porque o que o Core Text faz com um peso que precisa sintetizar não foi medido (seção 11).

Verificações. - Um teste unitário, já que o Core Text existe no iOS, carrega os dois arquivos incluídos e afirma: 1.000 unidades por em; cada glifo que as strings do mundo e as linhas predefinidas usam, nos dois idiomas, tem um avanço múltiplo de 100 unidades; os pontos de contorno dos glifos de amostra ficam a até 4 unidades da grade de 100 unidades (0,04 de pixel de fonte, a tolerância que a sonda da seção 4 usou). Uma fonte que falhe não pode ser lançada. - Um teste de que cada string que o mundo pode mostrar (linhas predefinidas, as chaves do mundo no String Catalog, os textos das placas) tem glifos na fonte, sem fonte de fallback. - Um script de fase de build que encontra LICENSE_E no bundle do app compilado, e um teste de interface que encontra o nome da fonte, o autor e a licença na nova seção de agradecimentos dos Ajustes.

2. Tamanhos: Dynamic Type, arredondado à grade

O quê. Um pixel de fonte é sempre um número inteiro m de pixels de dispositivo. Para um papel, ler o tamanho de Dynamic Type que o sistema usaria (UIFontMetrics(forTextStyle:).scaledValue(for:), ou @ScaledMetric(relativeTo:) sobre o tamanho base do papel), arredondar esse tamanho ao centésimo de ponto, para que um valor escalado um fio abaixo de um tamanho da tabela, 14,999… no lugar de 15, arredonde como o tamanho da tabela, e então definir m = max(m₀, ⌊size × displayScale / 10 + 0.5⌋), o inteiro mais próximo com a metade arredondando para cima, onde m₀ = ⌈11 × displayScale / 10⌉ é o menor m com pelo menos 11 pontos, e pointSize = 10 × m / displayScale, e aplicá-lo com Font.custom(_:fixedSize:) para que o sistema não o escale de novo.⁶⁷⁶⁹⁶⁸ O título e o texto da caixa passam do papel caption que usam hoje para o papel body, para que a 3× a caixa leve os doze tamanhos de Body a m = 4, 5, 5, 5, 6, 6, 7, 8, 10, 12, 14 e 16: 16,67 pontos no tamanho padrão e 53,33 em AX5.²⁶¹¹ O menor, m₀ = 4 a 3×, são 13,33 pontos, acima do mínimo de 11.¹⁰³³ A 2×, que o simulador do iOS 27.0 lista para três iPhones (item 4), m₀ vale 3, 15 pontos, e os doze tamanhos de Body dão 3, 3, 3, 3, 4, 4, 5, 6, 7, 8, 9 e 11: 15 pontos no tamanho padrão.⁹⁷¹¹ Os balões usam um passo a menos, nunca abaixo de m₀ e nunca acima de um teto que cada view define (item 4).

Posicionamento. Uma fonte pixelada só é nítida se a linha de base dela cai num pixel de dispositivo (seção 6). Arredondar cada origem calculada na sobreposição do mundo à grade de pixels de dispositivo, (x × scale).rounded() / scale, incluindo a .position de PlazaStage.bubbles, e dar às views de texto larguras em pixels de dispositivo inteiros, e à caixa largura e altura em pixels de fonte inteiros (item 3).

Passo de linha. PixelMplus10 tem 9 pixels de fonte para cima e 2 para baixo; definir o passo de linha em 12 pixels de fonte, uma fileira em branco entre as linhas, como os glifos japoneses de 15 pixels e a célula latina de 16 de Emerald cabem numa linha de 16.⁷¹ Com m = 5, isso dá 20 pontos por linha.³³

Verificações. - Um teste de função pura do arredondamento para cada DynamicTypeSize nas escalas de tela 2 e 3: o resultado é um número inteiro de pixels de dispositivo por pixel de fonte, nunca abaixo de 11 pontos e nunca menor para um tamanho maior. O teste alimenta a função diretamente com os tamanhos de Body da tabela das HIG, não com valores lidos de scaledValue(for:), cuja saída exata eu não vi: a 3×, os doze dão os doze valores acima, com o 4,5 de Small arredondando para 5, e a 2× os doze valores de 2×; cada tamanho menos um bilionésimo de ponto dá o mesmo m, graças ao arredondamento ao centésimo.¹¹ - Capturas da praça com um balão e a caixa em Large, xxxLarge e AX3 no simulador do iPhone 18 Pro Max, e em Large no simulador do iPhone SE (3ª geração) a 2×, com a sobreposição dos balões movida para cima das sobreposições de scanlines e vinheta do palco (item 4), e um script que recorta o texto e conta os pixels parciais em relação às duas cores, tinta e papel: 0 dentro das caixas dos glifos, no balão e na caixa. Cada captura precisa do servidor da praça rodando (KIRADEX_PLAZA=1) e é feita até 4 segundos depois que o jogador diz a linha mais longa de hoje pelo menu Say, porque toda linha volta da sala¹⁰² e um balão só aparece enquanto a linha dele tem menos de 4 segundos.²⁵¹⁰³ O mesmo script, rodado no build atual, registra a linha de base que ele substitui. O 0,0% da seção 6 é o Core Text de um Mac com a suavização de fontes desligada; esta captura é a verificação que decide se um iPhone desenha igual.

3. A caixa: uma moldura desenhada pela forja, duas linhas, páginas

O quê. A caixa do WorldHUD mantém o seu lugar: embaixo, dentro da área segura, e do lado mais largo da dobra quando o Duo está meio aberto.²⁶ O retângulo traçado de 2 pontos vira uma moldura desenhada pela forja: frame-paper.png, de 24 por 24 pixels de fonte, três por três tiles de 8 (um canto, uma borda e um centro), nas duas cores de WorldInk mais um tom, original do Kiradex. Uma view PixelFrame a desenha num Canvas, cada pixel de origem um quadrado de m por m pixels de dispositivo: os tiles de canto nos quatro cantos, e os de borda e centro repetidos para fora a partir do canto superior esquerdo, com o último tile cortado onde encontra o lado oposto, para que os pixels da moldura sejam os pixels do texto. Para que cada pixel de origem seja um quadrado inteiro, a largura da caixa é a largura da área segura, onde o WorldHUD a dispõe hoje, menos 16 pontos de cada lado, arredondada para baixo a pixels de fonte inteiros, um múltiplo de m pixels de dispositivo, e a altura também é em pixels de fonte inteiros: no 18 Pro Max em retrato com m = 5, sem margens laterais (suposto, não medido), 1.224 pixels de dispositivo, que são 244,8 pixels de fonte, arredondados para baixo a 1.220, 244 pixels de fonte.¹¹⁹⁴ O texto fica dentro da moldura, a 8 pixels de fonte da borda da caixa de cada lado, no lugar dos 8 pontos de preenchimento de hoje (escolha minha), o que deixa ali 228 pixels de fonte por linha, 45 caracteres latinos ou 22 de largura total.¹¹ O título do lugar fica numa linha própria no topo de cada página; abaixo dele, o texto mostra duas linhas por vez, como em Emerald e Crystal.¹ Texto com mais de duas linhas passa de página, e cada página espera sob a marca de avanço (item 6); onde uma página termina num espaço, o espaço é descartado. A box de WorldHUD (em WorldHUD.swift) recebe as páginas no lugar da sua única string de status.

A fila. Regras minhas, para que o que a caixa mostra nunca dependa do tamanho do status:

• As páginas do status são as próprias páginas da caixa. Quando o status muda (na praça, quando qualquer coisa nele muda: o estado da conexão, a contagem de quem está aqui, a hora do dia, a estação, as fitas ganhas), as páginas dele são substituídas e a caixa mostra o novo status a partir da primeira página, a menos que uma página da regra seguinte esteja sendo mostrada.
• O texto de uma placa (item 5) e uma linha dita por perto em tamanhos grandes (item 4) são páginas à frente do status: mostradas na hora, cada uma depois de qualquer página desse tipo que já esteja esperando, na ordem em que chegaram, e, depois da última delas, de novo o status a partir da primeira página. A caixa guarda as páginas de no máximo as três linhas mais recentes; quando chega uma quarta, é descartada a mais antiga ainda em espera que não seja do próprio jogador (a mais antiga das do jogador só quando todas as linhas em espera são dele), então um jogador que diz uma linha nunca a perde. Uma placa nova substitui as páginas de uma placa que ainda estejam esperando.
• O texto do status mantém o status inteiro como rótulo de acessibilidade, seja qual for a página mostrada, como hoje, para que o VoiceOver o leia inteiro, e os testes de interface existentes que leem plaza-status, room-status e hall-status (uma frase de abertura, uma contagem de quem está aqui, as primeiras palavras de uma sala) leiam o que leem agora. A página mostrada, até onde já foi revelada, é o valor de um elemento oculto, plaza-page na praça (<name>-page, nome meu). Ele contém as linhas de texto da página sem o título do lugar, e só existe com o argumento de inicialização dos testes de caminhada, -worldTrace (item 8); as verificações abaixo o leem, e cada uma passa -worldTrace.¹⁰³

Molduras como escolha. Emerald deixa o jogador escolher a moldura dos menus entre 20 (a caixa de diálogo mantém uma moldura só), e Final Fantasy VI a da janela entre 8 com cores editáveis.¹⁴ Oferecer nos Ajustes quatro molduras desenhadas pela forja, todas gratuitas, as três primeiras desde o início e a quarta ao atingir um nível; nenhuma moldura jamais é vendida. Se alguma moldura algum dia vai ser recompensa para apoiadores é uma decisão que não tomei.

Verificações. Uma verificação da forja de que frame-paper.png e cada alternativa têm 24 por 24, usam só índices da paleta e têm bordas opostas idênticas onde o design manda; no simulador do iPhone 18 Pro Max, uma captura da caixa com m = 4 (xSmall) e m = 5 (o tamanho padrão), em que um script encontra a largura e a altura da caixa em pixels de dispositivo como múltiplos de m e compara a moldura dela, os 8 pixels de fonte externos de cada lado, pixel a pixel com uma moldura que ele mesmo compõe a partir do PNG no tamanho da caixa capturada pela mesma regra (cantos nos cantos, tiles de borda e centro repetidos a partir do canto superior esquerdo e cortados no lado oposto), cada pixel de origem um quadrado de m por m, deixando de fora qualquer pixel que o PNG deixe transparente, onde o mundo aparece; e um teste de interface no mesmo simulador no tamanho padrão, sem o servidor da praça, para que nenhuma linha seja dita, iniciado com -worldTrace e -worldBoxSample e um status de três linhas de 30 a 40 caracteres unidas por quebras de linha, cada uma dentro dos 45 caracteres que uma linha comporta ali, que espera plaza-page ficar igual às duas primeiras linhas, desconsiderando espaços em branco, e só então, com a primeira página inteira, toca a caixa e encontra a terceira, com uma captura da primeira página em que um script encontra a marca no canto inferior direito da caixa.¹¹ -worldBoxSample é um argumento de teste com nome meu, lido em PlazaView como -plazaTell é (o tellOnArrival dele) e entregue ao WorldHUD como status no lugar do status da própria praça.⁹²

4. Balões: uma linha, sem nome, os dois idiomas

O quê. Manter a forma do balão: creme, uma borda de tinta, sobre a cabeça, menos de 4 segundos.²⁵ Compô-lo na fonte pixelada no m do balão, com os pixels de canto da moldura no lugar de um retângulo traçado, desenhados dentro dos 8 pontos de preenchimento de cada lado do balão, para que, como a borda de hoje, não acrescentem largura. Nenhum nome dentro ou acima do balão: quem fala é a cabeça sob ele, e o VoiceOver diz o nome (item 8). Uma linha predefinida nunca quebra; .fixedSize() fica.

Acima das scanlines. Hoje os balões são uma sobreposição dentro do palco, sob as scanlines dele, uma linha preta com 16% de opacidade a cada 3 pontos (a 3×, uma faixa de 3 pixels de dispositivo a cada 9), e sob a vinheta, enquanto a caixa fica sobreposta ao palco inteiro.²⁵²⁶ Sob essas camadas, o papel de um balão escurece em faixas que atravessam os glifos, então o texto dele não é tinta e papel em nenhum tamanho. O briefing move a sobreposição dos balões para cima das sobreposições de scanlines e vinheta, onde a caixa já está, em vez de restringir à caixa a verificação do item 2: escolha minha, a partir da regra da seção 6 de que uma fonte pixelada só é nítida como pixels de dispositivo inteiros de tinta e papel, aplicada igualmente às duas formas de fala. Em PlazaStage.swift, o .overlay dos balões, o último modificador dentro do GeometryReader do palco, passa para depois do .overlay da vinheta (o RadialGradient), com um GeometryReader próprio para o tamanho da view.²⁵

Na tela. Hoje um balão fica centralizado sobre a cabeça de quem fala, sem nada que o mantenha na tela, então quem fala perto de uma borda empurra parte dele para fora.²⁵ Limitar o frame do balão à área segura menos 16 pontos de cada lado, a margem que a regra de largura abaixo deixa, afastando-o do centro sobre a cabeça só o quanto o limite exigir. A área segura, não a view: o palco ignora a área segura (.ignoresSafeArea()), então a geometria dele se estende sob tudo o que a área segura mantém livre, que no Duo são as câmeras e o trilho lateral, como diz o comentário do WorldHUD sobre o próprio lugar dele dentro da área segura.⁹⁴ Hoje nada passa as margens para o palco. PlazaView as lê fora do palco e as repassa, como CardViewer já faz para a carta dele (proxy.safeAreaInsets para CardStage); o limite é uma função pura, BubblePlacement.frame(head:size:view:insets:), chamada a partir de PlazaStage.bubbles(of:in:), e as mesmas margens definem o teto do balão descrito abaixo (os nomes são meus). O mundo esconde a barra de status e o indicador de início (.statusBarHidden() e .persistentSystemOverlays(.hidden) na view raiz); se isso estreita as margens não está no código, então o app as lê em vez de supô-las.⁹⁴

A regra de largura. Toda linha, nos dois idiomas, cabe como balão de uma linha em todo iPhone em que o app pode rodar quando a área segura não tem margens laterais; é isso que o limite do servidor descrito abaixo garante. Uma margem pode deixar espaço pequeno demais até para m₀. Para a linha mais longa de hoje, de todas as larguras que o simulador do iOS 27.0 lista, isso acontece em cada largura de 3× até 393 pontos e nas duas larguras de 2× com a margem de 84 pontos do Duo, e nos telefones de 2× de 375 pontos com 16 pontos de cada lado. Uma linha no limite do servidor falha em mais casos: uma japonesa também nos telefones de 402 pontos com a margem do Duo (286 pontos de espaço contra 296 com m₀), e uma latina ali (302,67), no telefone de 3× de 414 pontos com a margem (298) e nos telefones de 360 pontos com 16 pontos de cada lado (296): dos 36 casos de doze larguras e três margens, 7 para a linha de hoje, 8 para uma linha japonesa no limite e 10 para uma latina. Ali essa linha não ganha balão e vai para a caixa, enquanto as linhas mais curtas mantêm o seu (abaixo).¹¹ O app é feito só para iPhone, a partir do iOS 27.0, e o runtime do simulador do iOS 27.0 instalado com o Xcode no meu Mac lista 33 iPhones: o mais estreito a 3× tem 360 pontos de largura (o iPhone 12 mini e o 13 mini), e três são de 2×, o iPhone SE de 2ª e 3ª geração, com 375 pontos, e o iPhone 11, com 414.⁹⁷ Essa é a lista do SDK dos dispositivos que ele simula; não busquei a lista da própria Apple dos iPhones compatíveis com o iOS 27. O espaço para um balão é a largura da área segura menos 32 pontos, os 16 de cada lado que o limite mantém. Nos telefones em retrato, sem margens laterais (suposto; nenhuma foi medida), isso dá 408 no iPhone 18 Pro Max, a mais estreita das cinco views que esta série mediu, mas 328 num telefone de 360 pontos e 343 nos telefones de 2× de 375 pontos. Na tela externa do Duo em retrato, são 434 sem margem lateral, e 350 se o mundo mantiver a margem final de 84 pontos, o trilho lateral, que esta série mediu na tela fechada (seção 11).^11979533 A linha mais longa de hoje, “Anyone have a card from the first years?”, com 40 caracteres, mede 283 pontos de largura como balão com m = 4, 349 com 5, 416 com 6 e 549 com 8 a 3×, os glifos mais os 8 pontos de preenchimento de cada lado de hoje; a borda de 2 pontos é desenhada dentro do balão e não acrescenta largura. A 2×, a mesma linha mede 316 pontos com m = 3 e 416 com 4.¹¹²⁵ Então o m do balão tem um teto em cada view, o maior com que a linha predefinida mais longa, em qualquer dos dois idiomas, cabe no espaço. Para as linhas de hoje, todas em inglês, é 5 no 18 Pro Max (349 em 408) e em cada iPhone de 3× listado de 390 a 440 pontos, 4 nos telefones de 3× de 360 e 375 pontos, e 3, o menor que o 2× permite, nos telefones de 2×; na tela externa do Duo em retrato, é 6 sem margem lateral (416 em 434) e 5 com o trilho medido (349,33 em 350). Uma linha japonesa no limite do servidor descrito abaixo, 21 caracteres de largura total, 210 pixels de fonte de avanços, baixaria o do Duo para 5 e 4 e o dos telefones de 390 e 393 pontos para 4 (sete dos iPhones listados têm 390 pontos de largura e quatro, 393), e deixaria os outros como estão.¹¹⁹⁷ O app calcula o teto a partir da largura segura que PlazaView repassa e das linhas que o servidor envia, então uma área segura mais estreita ou uma linha mais longa, japonesa entre elas, pode baixá-lo. O teto é um único valor para todas as linhas; o que acontece onde não há teto é decidido linha a linha, escolha minha: onde nem m₀ comporta a linha mais longa, uma linha que cabe com m₀ mantém o balão com m₀, e uma que não cabe fica sem balão e vai para a caixa, como páginas próprias, como em tamanhos grandes (abaixo). Manter com m₀ o balão dessa linha quebraria o limite: numa view de 360 pontos com uma margem final de 84 pontos, o espaço é de 244 pontos, e a linha mais longa de hoje com m₀ mede 282,67.¹¹ O servidor, por sua vez, limita cada linha ao que cabe no telefone mais estreito de cada escala no menor tamanho, sem margens laterais: no máximo 218 pixels de fonte de avanços, 43 caracteres latinos ou 21 de largura total, o menor entre (360 − 48) × 3 ÷ 4 = 234 a 3× e (375 − 48) × 2 ÷ 3 = 218 a 2×. Uma linha japonesa nesse limite mede 296 pontos como balão com m = 4 a 3×, e 331 com m = 3 a 2×; uma latina, 302,67 e 338,50; as duas cabem nos 350 do Duo com o trilho.¹¹³³ As margens laterais dos telefones em retrato não foram medidas; as capturas abaixo, que afirmam o balão dentro da área segura, são onde alguma apareceria.

A linha predefinida mais longa como balão, por tamanho, a 3×, contra o espaço de cada view; desenhado por figures/make_figures.py a partir de measure_kiradex_text.out.

Texto maior. O m do balão acompanha o da caixa, um passo a menos, nunca abaixo de m₀ e nunca acima do teto da view: no 18 Pro Max ele chega a 5 quando a caixa está em xLarge (m = 6), e de xxxLarge para cima, onde o m da caixa é 7 ou mais, fica em 5. Onde quer que o teto segure o balão dois ou mais passos abaixo da caixa (no 18 Pro Max de xxxLarge para cima, num telefone de 360 pontos de xLarge para cima), quem lê recebe também na caixa cada linha dita a até seis células do jogador, como páginas próprias no tamanho da caixa: o apelido de quem fala, dois-pontos e a linha, como Emerald diz quem fala dentro da linha (o item 3 a pagina; o item 8 a anuncia). PlazaView, que guarda as linhas da sala e hoje compõe o status da caixa, compõe essas páginas e as põe à frente do status, pela fila do item 3: mostradas na hora, depois das páginas de qualquer linha que já estejam esperando, com no máximo três linhas guardadas. Ele põe as páginas de uma linha na fila da caixa na mesma atualização que acrescenta o balão dela, então o balão de uma linha dessas na tela significa que as páginas dela estão na fila. Nem sempre é uma página só. Um apelido tem de 14 a 20 caracteres, então “apelido: linha” vai de 19 a 62, e com a moldura do item 3 uma linha da caixa no 18 Pro Max comporta 31 caracteres latinos em xxxLarge, 17 em AX3 e 12 em AX5: considerando todo apelido que names.py pode gerar e toda linha predefinida, uma ou duas páginas de xxxLarge a AX3 e até três em AX4 e AX5, e até quatro nos telefones de 360 pontos e de 2× nos maiores tamanhos e na tela externa do Duo, com o trilho medido, em AX4 e AX5.¹¹⁸⁹ A caixa em si nunca é limitada; ela quebra linhas e passa de página. A página de dynamicTypeSize(_:) sugere uma visualização de conteúdo grande para um tamanho limitado; o briefing não depende dela, porque a própria página desse visualizador adverte contra usá-lo “as a replacement for proper Dynamic Type support” (como substituto de um suporte adequado ao Dynamic Type), e nenhuma das duas páginas diz se ele abre a partir de uma sobreposição com o hit testing desligado, como a dos balões.⁷⁰⁷¹²⁵ Minhas notas de pesquisa tinham proposto parar o balão em m = 8, mas a linha mais longa com 8 mede 549 pontos de largura (as notas dão 553, contando a borda que fica dentro do balão), mais larga que o iPhone 18 Pro Max (440 pontos) e que a tela externa do Duo em retrato (466), e as notas mediram o limite contra a tela externa do Duo quando o 18 Pro Max, com 440, é o mais estreito; o briefing aqui segue as larguras.²²¹¹

Verificações. - O teste de fonte do app (item 1) também afirma que uma tabela dos avanços de PixelMplus10 guardada no repositório, com uma entrada para cada caractere que as linhas predefinidas usam em qualquer dos dois idiomas, bate com a fonte incluída. A suíte de testes do servidor, que não tem parser de fontes (as dependências dele são FastAPI, uvicorn, websockets, httpx e pytest), lê essa tabela, recusa uma linha que contenha um caractere ausente da tabela e recusa uma linha, em qualquer dos dois idiomas, cujos avanços somem mais de 218 pixels de fonte, o limite acima.¹⁰⁴¹¹ - Um teste unitário do teto, uma função pura da largura segura, da escala de tela e dos avanços das linhas: a 3× ele dá, com a linha mais longa de hoje, 5 para cada largura listada de 390 a 440 pontos, 4 para 360 e 375, 6 para 466 e 5 para 382 (a tela externa do Duo, sem e com o trilho medido), e a 2× 3 para 375 e 414; com uma linha japonesa de 210 pixels de fonte entre as linhas, 5 para 466, 4 para 382 e 4 para 390 e 393; e nenhum para um espaço de 244 pontos (360 pontos menos a margem de 84 e 32) a 3× com a linha mais longa de hoje; e um teste do compositor em PlazaView que, nesse espaço, não desenha balão para a linha mais longa de hoje e põe as páginas dela na caixa, e desenha “Hi!” como balão com m₀ (36 pontos de largura, em 244).¹¹ - Um teste unitário de BubblePlacement põe a cabeça de quem fala em cada borda, em cada canto e no centro de views de 360, 375, 440 e 466 pontos de largura, cada uma sem margens de área segura, com 16 pontos nos lados inicial e final, e com a margem final de 84 pontos do Duo, e balões de várias larguras até a largura segura daquele caso menos 32 (de 244 pontos, 360 menos 84 e 32, até 434), e encontra cada balão dentro da área segura menos 16 pontos de cada lado e, sempre que o x da cabeça estiver dentro dessa faixa, abrangendo o x da cabeça.¹¹ - Nos simuladores do iPhone 18 Pro Max, do iPhone 13 mini e do iPhone SE (3ª geração), e na tela externa do iPhone Duo no simulador dele, quatro capturas em cada um (inglês e japonês, cada um no tamanho padrão e em AX3), com o servidor da praça rodando (KIRADEX_PLAZA=1) e o app iniciado com -worldTrace, cada uma com a linha mais longa daquele idioma dita pelo jogador; em cada uma, um script encontra a borda de tinta do balão e afirma que ele tem a altura de uma linha de texto, não é mais largo que a largura da área segura menos 32 pontos e fica dentro da área segura menos 16 pontos de cada lado. O script pega as margens do teste de interface que faz a captura, que as lê de um elemento oculto que -worldTrace ativa (item 8), onde PlazaView escreve as margens que leu (proposta minha); o script também encontra o m do balão a partir dos pixels dos glifos e afirma que ele é o menor entre o m da caixa menos um (nunca abaixo de m₀) e o teto para aquela largura segura, calculado a partir das linhas do build nos dois idiomas, de modo que ele só é igual ao teto onde o teto o limita. No tamanho padrão, isso dá 4 nos telefones de 3× e no Duo, seja qual for o teto, e 3 no telefone de 2×; em AX3 é o teto, e no Duo as margens decidem: com as linhas em inglês de hoje, 6 sem margem lateral e 5 com o trilho, e com uma linha japonesa no limite do servidor, 5 e 4.¹¹⁹⁵⁹⁷ - Um teste de interface no simulador do iPhone 18 Pro Max em AX3, onde o m da caixa é 12 e uma linha comporta 17 caracteres latinos, precisa do servidor da praça (KIRADEX_PLAZA=1) e de nenhum outro jogador, e é iniciado com -worldTrace e a velocidade do texto em Instantânea (item 6) pela chave world.textSpeed que o item 5 nomeia, para que cada página apareça inteira no momento em que abre e um toque na caixa passe exatamente uma página. Ele lê o apelido do jogador na aba Me, escolhe “Hi!” no menu Say e espera, dentro dos 5 segundos que o teste de companhia existente permite, pelo balão Said: Hi!, de modo que a linha voltou da sala e, pela regra do item 4, as páginas dela estão na fila da caixa, à frente do status, seja qual for o tamanho do status. Uma linha dos quatro colecionadores da cidade, que dizem cada um no máximo uma a cada 20 segundos, pode estar à frente dela; a fila guarda no máximo três linhas e nunca descarta a única linha de um jogador (item 3), então no máximo duas linhas ficam à frente, de no máximo duas páginas cada ali, e as linhas ditas depois esperam atrás. O teste lê plaza-page antes de cada toque e só toca a caixa enquanto a página não for o apelido, dois-pontos, um espaço e “Hi!”, com um segundo entre toques e no máximo quatro vezes, e passa se uma leitura encontrar essa página, sendo a última leitura um segundo depois do quarto toque. Ele usa essa linha porque “apelido: Hi!” é uma página só ali para todo apelido que names.py pode gerar, enquanto a linha mais longa pode ocupar duas. Ele registra cada página que leu.^11103102

5. Placas e nomes

Placas. A arte da placa continua sem letras, como kit.py a desenha, para que um único atlas sirva aos dois idiomas.²⁹ Um toque num tile de placa abre a caixa do WorldHUD com o texto da placa, como páginas à frente do status (item 3), em vez de levar o jogador até lá como acontece hoje. Hoje o palco lê os toques por um DragGesture: touched(_:in:) leva o jogador na hora até o chão sob o dedo, exceto sobre um colecionador ou o quiosque, que esperam o dedo subir, e lifted(_:in:) lê essa subida como um toque. Um tile de placa se junta ao colecionador e ao quiosque nos dois: espera o dedo subir, e lifted(_:in:) chama para ele uma closure onSign como chama onKiosk para o quiosque (o nome é meu).⁹² Os textos das placas ficam com o mapa: town.json ganha signs: { "7,10": { "en": ..., "ja": ... } }, com a célula como chave, e as verificações da forja recusam uma célula de placa sem os dois idiomas.

Nomes. Nada de rótulos de nome permanentes sobre as cabeças. A caixa do cânone diz quem fala dentro da linha, Emerald em 6,5% dos parágrafos.¹ Os apelidos do Kiradex chegam a 20 caracteres; no menor tamanho do balão, m = 4 a 3× e 3 a 2×, um apelido de 20 caracteres mede 133 pontos de largura a 3× e 150 a 2×; a 3×, isso fica sobre uma figura de 16 texels de largura de frente para a câmera e 13 de perfil (30 de altura, numa célula de 32 por 40), que são 42,7 pontos, ou 34,7, no 18 Pro Max.^119610033 O apelido aparece no painel que um toque abre, como agora, e o VoiceOver o lê (item 8).

Verificações. Um teste de interface não tem como saber onde na tela a célula da placa é desenhada, já que a câmera segue o jogador, então o teste inicia a praça com -worldTrace e -plazaTapCell 7,10, um argumento de teste com nome meu, lido no corpo de PlazaStage como -plazaFacingDemo é (num .task), que envia a célula pelo mesmo tratamento, extraído de lifted(_:in:) para um único método. No simulador do iPhone 18 Pro Max no tamanho padrão, sem o servidor da praça, para que nenhuma linha seja dita, o teste também passa o -worldBoxSample do item 3 com um status de uma página, “Sample.”, e a velocidade do texto em Instantânea (item 6) pela chave dela nos Ajustes, nos argumentos de inicialização (a chave, world.textSpeed, é minha, ao lado da world.stick do direcional). Ele espera até 5 segundos que plaza-page mude de “Sample.” para a primeira página da placa, então a lê, toca a caixa e lê de novo, no máximo um toque para cada palavra do texto da placa (cada caractere, em japonês), mais um, até plaza-page mostrar “Sample.”, e confere que as páginas anteriores, unidas em ordem, são iguais ao texto em inglês da placa, desconsiderando espaços em branco, para que um texto de placa longo o bastante para paginar passe tão bem quanto um curto; reiniciado com o japonês como idioma do app, o texto em japonês.⁹² A verificação da forja recusa um town.json com uma célula S sem algum dos dois idiomas.

6. Velocidade do texto e a marca de avanço

O quê. Uma revelação de máquina de escrever cuja contagem é tempo, não quadros: shown = floor(elapsed × cps), uma função pura do tempo decorrido, da velocidade e de dois ajustes, Reduzir Movimento e VoiceOver em execução, para que 60 e 120 hertz revelem na mesma velocidade. Os Ajustes oferecem Lenta, 12 caracteres por segundo, a lenta de Crystal; Normal, 30, o padrão, escolha minha entre os ajustes médios do cânone (os 15 de Emerald, os 20 de Crystal) e o ajuste rápido dele, de 60; e Instantânea. Um toque durante a revelação completa a página; um toque numa página completa a vira.¹ Para isso, a caixa recebe toques enquanto está revelando ou tem uma página depois da que está à mostra; na última página, mostrada inteira, ela deixa os toques passarem para o chão, como faz o tempo todo hoje.²⁶ A mesma velocidade nos dois idiomas, como Final Fantasy VI imprime os dois a uma letra por quadro.⁴ Com Reduzir Movimento ligado, ou com o VoiceOver em execução, a função devolve a página inteira de uma vez; isso é escolha minha, a partir da frase da documentação de que, com Reduzir Movimento, a “UI should avoid large animations”.⁸³

A marca. Uma marca própria do Kiradex desenhada pela forja, uma cunha para baixo de 5 por 3 pixels de fonte, no canto inferior direito da caixa, descendo 0, 1, 2 e 1 pixels de fonte (a direção é escolha minha; a de Emerald, na minha leitura, sobe) a cada 150 milissegundos, num ciclo de 600 milissegundos: o passo de 9 quadros de Emerald a 60 hertz.¹³³

Verificações. Um teste unitário da função de revelação a 30 caracteres por segundo: 0 caracteres em t = 0 e 30 em 1,000 segundo, com o tempo decorrido calculado a partir de uma contagem de ticks, os ticks divididos pela frequência, a 60 e a 120 ticks simulados por segundo, não somado a partir de deltas por tick (120 deltas de 1/120 somados em precisão dupla dão 0,9999999999999989, que, vezes 30, dá 29,999999999999968 e arredonda para baixo para 29); a mesma função com Reduzir Movimento ligado, e separadamente com o VoiceOver em execução, devolve a página inteira em t = 0; um teste de interface no simulador do iPhone 18 Pro Max no tamanho padrão e em Lenta, sem o servidor da praça, iniciado com -worldTrace e o status -worldBoxSample do item 3, cuja primeira página são duas linhas de 30 a 40 caracteres, pelo menos 60 caracteres e portanto pelo menos 5 segundos de revelação a 12 por segundo, que confere que um toque na caixa um segundo depois do início da revelação faz plaza-page virar a página inteira em meio segundo, quando a revelação sozinha mostraria 18 caracteres (12 no momento do toque); um teste unitário do deslocamento da marca em função do tempo decorrido, 0, 1, 2, 1 e 0 pixels de fonte a 0, 150, 300, 450 e 600 milissegundos; e uma gravação de tela de dois segundos da marca no simulador em que os deslocamentos dela, sem repetições, seguem 0, 1, 2, 1 em ordem cíclica.³³

7. Japonês

O quê. Japonês primeiro para o texto do mundo, o resto do app depois. server/app/lines.py mantém a ordem dos índices, como diz o comentário dele, “add at the end only” (acrescentar só no final), e cada linha vira uma string em inglês e uma em japonês; o servidor envia as duas, e cada cliente mostra o idioma que o seu usuário lê, então uma linha dita numa praça mista é lida em dois idiomas a partir de um único índice.²⁸ Esse é, na minha leitura, o melhor argumento a favor das linhas predefinidas neste app. As strings do mundo, os títulos e status do WorldHUD e os títulos das missões, vão para um String Catalog com ja; os textos das placas ficam com o mapa (item 5). Cada string em japonês é escrita ou revisada por um falante de japonês; nenhuma é lançada com tradução automática sem revisão.

Quebra de linha. As linhas predefinidas nunca quebram (item 4). O texto da caixa é escrito para caber em duas linhas por página no tamanho padrão, como o script de Emerald foi quebrado à mão.¹ Onde precisar quebrar, manter a regra estrita: não marcar o texto da caixa com um idioma de composição ja, a menos que uma captura mostre a regra estrita valendo com ele, porque o Core Text no macOS, marcado com ja, deixou kana pequenos começarem linhas em 6 de 7 larguras na maioria das fontes (4 de 7 em k8x12 e k8x12S).⁷⁷⁷ Se um padrão do sistema aplicar a regra frouxa mesmo assim, a correção escrita é um U+2060 WORD JOINER antes do kana pequeno nas poucas strings que precisarem.

Verificações. Um teste de que cada linha e cada chave do mundo no String Catalog tem os dois idiomas; o teste do servidor do item 4, que recusa uma linha predefinida em japonês acima do limite de 218 pixels de fonte, 21 caracteres de largura total; e, no simulador do iPhone 18 Pro Max no tamanho padrão com o idioma do dispositivo em japonês, sem o servidor da praça e na velocidade Instantânea, iniciado com -worldTrace, uma captura de cada página de um parágrafo de teste na caixa, passado como o status -worldBoxSample do item 3 e escrito de modo que, com os 22 caracteres de largura total por linha que cabem ali, uma quebra cairia antes de um kana pequeno, em que nenhuma linha depois da primeira do parágrafo começa com um caractere da lista de início de linha do JLREQ ou com uma forma de compatibilidade de um deles.¹¹ Essa lista é a completa, as 83 entradas das dez classes que a regra do 3.1.7 nomeia (três caracteres estão em duas classes), guardada no target de testes; a sonda da seção 7 usou uma lista parcial (seção 7). O software de composição japonês costuma usar, no lugar deles, as formas de compatibilidade que o Unicode codifica para a conversão de ida e volta com padrões mais antigos, como o JLREQ observa sobre o parêntese de abertura: “the compatibility counterpart U+FF08 FULLWIDTH LEFT PARENTHESIS is used in the Japanese context in most Japanese text layout software” (a contraparte de compatibilidade U+FF08 FULLWIDTH LEFT PARENTHESIS é usada no contexto japonês na maioria dos softwares de composição de texto japonês).²¹ Então a lista acrescenta cada caractere do bloco Halfwidth and Fullwidth Forms do Unicode cuja normalização de compatibilidade (NFKC) é uma das 83, 24 deles, entre eles ！ (U+FF01), ？ (U+FF1F), ） (U+FF09), ：, ；, ， e ．, e os de meia largura ｡, ､, ｰ e os katakana pequenos a partir de ｧ (U+FF67); e ～ (U+FF5E), o til de largura total, ao lado do traço ondulado 〜 da mesma classe, acréscimo meu, já que a normalização dele é o til ASCII, que a lista não contém: 25 ao todo.⁹⁸ PixelMplus10 mapeia 54 das 83 entradas e 24 das 25 formas. Ela não desenha as outras 29 entradas, entre elas 〜 (U+301C), ゠, a meia-risca, ‼ e os katakana pequenos a partir de U+31F0, nem o ｠ de largura total (U+FF60), e o teste de cobertura do item 1 mantém cada um deles fora das strings do mundo, então uma captura só pode mostrar os 75 caracteres que ela desenha (as 54 entradas, três das quais, ), 〕 e ], estão listadas em duas classes, o que dá 51 caracteres, e as 24 formas).⁹⁸ Um script compara a primeira célula de glifo de cada linha, pixel a pixel, com os glifos da fonte para esses 75 no m da captura, desenhados a partir da fonte incluída com CTFontGetGlyphsForCharacters, e não encontra nenhuma correspondência. Os pixels só conseguem distinguir um caractere da lista dos outros do parágrafo onde a fonte os desenha de forma diferente. Desenhados a 10 pixels, dois dos 75 têm um gêmeo idêntico pixel a pixel na fonte: ‐ (U+2010), idêntico ao hífen inseparável U+2011, e os dois-pontos, idênticos à letra modificadora dois-pontos U+A789; nenhuma das 24 formas tem um. Então o parágrafo de teste não usa nenhum dos dois gêmeos; ー (U+30FC) e o kanji 一 (U+4E00) diferem, 200 pixels de dispositivo com tinta contra 250 com m = 5, então 一 pode aparecer em qualquer ponto dele.⁹⁸²¹ O resultado da seção 7 é o Core Text de um Mac; esta captura decide o que o SwiftUI faz no iOS.

8. VoiceOver sobre o palco

Hoje. O VoiceOver ouve “The plaza” e depois o rastro dos testes de caminhada, como “12,4 down” (12,4 para baixo).²⁵ Esse valor é para testes, não para pessoas.

O quê. 1. O rótulo do palco continua “The plaza”, ou o nome da sala, e o valor dele vira uma frase que uma pessoa pode usar: onde o colecionador está, por ponto de referência, quem está perto e o que a pessoa ergue (por exemplo, Perto do lago. Três colecionadores por perto. Erguendo uma carta.), pela regra de accessibilityValue de que um valor diz o que o rótulo não diz.⁷⁹ Tudo o que hoje vai por stepTrace até o valor do palco é transferido, seja quem for que o escreva: quando li PlazaStage.swift, o rastro de passos de rig.onStep, a mensagem de falha de build da closure make da RealityView e o relatório da sonda do ar do .task que lê -airProbe, e minutos depois uma quarta escrita, de uma demo de caminhada acrescentada naquele dia. Isso vai para um elemento oculto que só existe quando o app é iniciado com -worldTrace (nome meu), que os testes de caminhada passam, ao lado da página da caixa (item 3) e das margens que PlazaView leu (item 4), e os testes que leem o valor do palco, entre eles testTheCollectorFacesTheWayItWalks e testTheChimneysSmoke, que espera value CONTAINS 'smoke 18 ', passam a ler esse elemento.²⁵¹⁰³ 2. accessibilityDirectTouch(_:options:) no palco, para que um usuário de VoiceOver possa tocar para caminhar depois de ativá-lo (iOS 17.0).⁸⁰ 3. A entidade de cada colecionador ganha um AccessibilityComponent com o apelido como rótulo e o que ele segura como valor, para que o VoiceOver possa descrevê-lo (iOS 17.0).⁸⁴ 4. Uma linha dita a até seis células do jogador é publicada como AccessibilityNotification.Announcement (por exemplo, Glacier Shuffle 4471: Nice card!) com prioridade baixa, no máximo uma a cada dois segundos, a própria frequência do servidor para uma linha.⁸²⁹¹ 5. Uma página da caixa que abre é anunciada inteira, a menos que repita uma linha que o ponto 4 já anunciou, como fazem as páginas de texto grande do item 4.

Verificações. Um teste de interface de que o valor do palco não contém coordenadas sem -worldTrace; num simulador do iOS 27, um teste com XCUIVoiceOverService que ativa o VoiceOver, leva-o ao palco e afirma que o que currentSpeech() retorna contém o rótulo do palco e nenhum par de números no formato x,y do rastro de passos;⁸⁷ uma verificação manual num dispositivo com o VoiceOver ligado, datada e com o número do build, de que uma entidade de colecionador é alcançável e falada, porque não está verificado se uma RealityView com uma câmera virtual expõe elementos de AccessibilityComponent (seção 11); e um teste unitário do limitador de anúncios, em que duas linhas em menos de 2 segundos geram um único anúncio.

9. Nunca, para tipografia e janelas

1. Nenhum glifo, moldura, seta ou gráfico de janela da ROM ou da descompilação de qualquer jogo no app ou na forja. As folhas do pret e do ff6 são medidas aqui e nunca copiadas. A moldura, a marca e a placa do Kiradex são desenhadas pela forja; a tipografia dele é uma fonte licenciada.
2. Nenhum personagem ou ligadura da franquia. O charmap de Emerald traz glifos especiais para palavras da franquia; nada parecido é desenhado, e nenhuma string usa os nomes que a franquia dá às coisas.³¹
3. Nenhuma fonte sem o arquivo de licença em mãos: uma fonte só é lançada com o texto da licença citado na seção 4 ou 5 e salvo ao lado da evidência.
4. Nenhuma fonte OFL modificada sob o seu Reserved Font Name. Press Start 2P declara um; se alguma fonte OFL for modificada algum dia, ela é renomeada.⁵⁴
5. Nenhum texto embutido na arte do mundo: placas, fachadas de lojas e quadros continuam sem letras, para que nenhum atlas seja jamais por idioma.

Verificação. Um script calcula dois resumos SHA-256 de cada imagem que a forja escreve e que o catálogo de assets contém, um dos bytes do arquivo e outro dos pixels decodificados, e os compara com os mesmos dois resumos de cada PNG medido aqui (graphics/fonts e graphics/text_window do pret, as molduras de Crystal e os gfx/font/font.png de Crystal e Red). A lista desses resumos, não as imagens, vai para o repositório como scripts/forge/canon_digests.txt (um nome escolhido por mim, ao lado do kit.py da forja), para que a verificação rode sem a pasta de evidências, e qualquer correspondência faz o build falhar. O teste dela própria é um controle negativo que não precisa de nenhum arquivo de jogo: acrescenta os resumos de uma saída da forja a uma cópia da lista e afirma que então o script falha. O mesmo script lista para revisão, sem falhar, qualquer célula de 8 por 8 de uma saída da forja cuja máscara de um bit, ou a inversa dela, coincida com uma célula daquelas folhas. Resumos de imagem inteira não conseguem reconstruir essas células, então a lista também guarda o resumo SHA-256 de cada máscara de célula distinta das folhas, sob uma única regra (minha), aplicada do mesmo jeito às saídas da forja: um pixel é ligado onde a cor dele difere do pixel superior esquerdo da imagem; as células vão de 8 em 8 a partir do canto superior esquerdo, descartando uma célula parcial numa borda; uma célula vazia ou sólida fica de fora dos dois lados, já que as folhas têm muitas (só japanese_normal.png tem 430 células vazias de 1.024); e uma máscara são os 64 bits dela fileira a fileira, 8 bytes. Nas 50 folhas, isso dá 7.746 células mantidas e 1.484 resumos distintos.⁹⁹ Uma cópia recolorida, reescalada ou redesenhada passa pelos resumos; a regra 1 se apoia na forja desenhar cada asset a partir de código e nessa revisão, não só na verificação. E a verificação de strings que os briefings anteriores desta série propõem é ampliada com as abreviações da franquia presentes no charmap de Emerald.¹⁰⁵

Fora deste briefing

• Uma fonte pixelada para o app inteiro. A Dex, o scanner e os Ajustes mantêm a fonte do sistema; a tipografia pixelada é para o mundo.
• Chinês e coreano. Os quatro jogos pixelados modernos verificados trazem chinês, e dois deles, Stardew Valley e Sea of Stars, trazem coreano, mas nada aqui mediu uma fonte pixelada para nenhum dos dois.⁶⁴
• Misaki ou qualquer fonte de 8 pontos para leitura de texto. Os kanji dela são os menores medidos; a legibilidade nesse tamanho para um leitor japonês não foi medida.⁶
• Rótulos de nome sobre as cabeças e um campo de nome na caixa.¹
• Japonês com tradução automática que ninguém revisou.
• Negrito ou itálico sintéticos na fonte pixelada.
• Molduras à venda. Toda moldura é gratuita; uma moldura para apoiadores aguarda uma decisão.
• Texto desenhado na cena de RealityKit. O motivo do post do mundo e a aritmética da seção 10 o mantêm no SwiftUI.²³¹¹

Principais conclusões

Se você desenha a arte

• Construa molduras com tiles: um canto, uma borda e um centro. Os menus de Emerald escolhem entre 20 molduras de 24 por 24 pixels, três por três tiles; a caixa de diálogo dele é desenhada a partir de uma tira de 14 tiles com a borda de baixo espelhada; as molduras de Crystal têm 6 tiles de um bit cada.¹
• Dê à marca de avanço um relógio lento. A seta de Emerald se desloca 0, 1, 2 e 1 pixels a partir do repouso, um passo a cada 9 quadros, 0,6 segundo por ciclo.¹
• Mantenha as palavras fora da arte do mundo. Uma placa sem letras serve a todos os idiomas a partir de um único atlas; as palavras vão na caixa.²⁹
• Desenhe o japonês entre 8 e 12 pixels e conte com um kana tendo o dobro de uma letra latina: 8 contra 4, 10 contra 5 e 12 contra 6 em todas as fontes pixeladas com japonês medidas.⁷

Se você constrói o motor

• Escolha uma fonte pixelada pelo arquivo, não pelo nome: confira a grade, o deslocamento em relação à linha de base e os avanços. A grade de PixelMplus12, 0,39 pixel fora da linha de base, borrou em todos os tamanhos no Core Text do macOS; o avanço de kana de 8,01 pixels de k8x12 borrou assim que os glifos foram posicionados com exatidão.⁷
• Desenhe só com pixels de dispositivo inteiros por pixel de fonte: 0,0% de pixels parciais nos múltiplos inteiros de uma grade sobre a linha de base com avanços de pixels inteiros (Misaki, PixelMplus10, Press Start 2P), de 19,4% a 82,2% entre eles, no Core Text de um Mac com a suavização de fontes desligada. Com a suavização padrão do contexto, PixelMplus10 no próprio tamanho saiu com 178 de 272 pixels com tinta parciais, então um múltiplo inteiro é necessário, não suficiente; capture um iPhone antes de confiar em qualquer um dos dois resultados lá.⁷⁹
• Respeite o Dynamic Type arredondando à grade. Um em de 10 pixels é inteiro em 1 dos 12 tamanhos de Body a 3×; arredonde o tamanho escalado a pixels de dispositivo inteiros por pixel de fonte e aplique-o como tamanho fixo.⁷⁶⁸
• Conte a velocidade do texto em tempo, não em quadros, para que 60 e 120 hertz revelem igual; 60 caracteres por segundo é a cadência mais rápida em todos os jogos medidos, e de 15 a 20 o ajuste médio onde um jogo tem um.¹⁴
• Dê ao VoiceOver uma frase, não um rastro. accessibilityValue é para o que o rótulo não diz, AccessibilityComponent descreve uma entidade, e XCUIVoiceOverService consegue testar o que o VoiceOver fala a partir do iOS 27.0.⁷⁹⁸⁴⁸⁷

Se você projeta o loop

• Duas linhas por vez, embaixo. A caixa de Emerald ocupa 30% da tela e a de Crystal 33%, cada uma com duas linhas.¹
• Escreva na medida da largura. Os roteiristas de Emerald mantiveram 95% de 24.100 linhas em 38 caracteres numa janela que comporta 41, e nenhuma passou da janela.¹
• Diga quem fala dentro da linha, não sobre a cabeça; a caixa de Emerald não tem campo de nome.¹
• Planeje o japonês desde o início: quatro de quatro jogos pixelados modernos verificados o trazem. Uma fonte que cobre o JIS X 0208 desenha cerca de sete mil caracteres; um jogo com um script fixo pode sair com menos, como fez a ROM japonesa de Final Fantasy VI com 1.248 letras, e aí cada string nova precisa ser conferida contra a fonte.⁶⁴⁵⁸⁴

Perguntas frequentes

Qual deve ser o tamanho de uma caixa de texto num jogo de pixel art?

Nos Pokémon de portátil, o terço inferior da tela e duas linhas. A moldura de diálogo de Emerald tem 30 por 6 tiles, 240 por 48 pixels, 30% da altura da tela do Game Boy Advance, em volta de uma janela de texto de 27 por 4 tiles que comporta duas linhas de uma fonte de 16 pixels. A caixa de Crystal tem 20 por 6 tiles, 33% da tela do Game Boy, duas linhas de 18 caracteres, e a de Red é a mesma de 20 por 6. Final Fantasy VI abre a janela em cima ou embaixo da tela.¹²³⁴⁵

Qual deve ser a velocidade de um efeito de texto de máquina de escrever?

O cânone conta quadros. Emerald e FireRed imprimem um caractere a cada 8, 4 ou 1 quadros, 7,5, 15 ou 60 por segundo a 60 hertz, e um por quadro enquanto A ou B fica pressionado depois de um aperto durante a impressão; Crystal e Red imprimem a 12, 20 ou 60 por segundo; Final Fantasy VI imprime o diálogo de campo a uma letra por quadro, 60 por segundo, sem ajuste para isso (a velocidade de mensagens em seis níveis define quanto tempo espera uma mensagem de batalha). Num telefone moderno, conte os caracteres em tempo e não em quadros, para que a velocidade não mude a 120 hertz. Todos os jogos medidos chegam no máximo a 60 por segundo, e os ajustes médios de Emerald e Crystal são 15 e 20; o briefing abaixo propõe 30 como padrão, o que é escolha minha entre esses ajustes médios e o rápido de 60, não um ajuste medido.¹¹⁴⁴

Quais fontes pixeladas têm suporte a japonês?

Das medidas, Misaki (8 por 8 pontos), k8x12 (8 por 12) e DotGothic16 desenham todos os 6.879 caracteres do JIS X 0208, e PixelMplus10 e PixelMplus12, todos menos três pontos de código. Misaki, k8x12 e PixelMplus estão sob uma licença gratuita de três frases que permite uso, cópia e distribuição “either commercially or noncommercially” (comercialmente ou não); DotGothic16 está sob a SIL Open Font License 1.1. Medidas com o Core Text no macOS 27.0, Misaki e PixelMplus10 são as duas com uma grade limpa sobre a linha de base e avanços de pixels inteiros, a 8 e 10 pixels; a grade de PixelMplus12 fica 0,39 pixel abaixo da linha de base, o avanço de kana de k8x12 é de 8,01 pixels, e os pontos de DotGothic16 não ficam em grade de pixels nenhuma.^67171853

Por que minha fonte pixelada fica borrada no iPhone?

Normalmente porque um pixel de fonte não é um número inteiro de pixels de dispositivo. No Core Text do macOS 27.0 com a suavização de fontes desligada, as fontes pixeladas TrueType com uma grade limpa sobre a linha de base e avanços de pixels inteiros (Misaki, PixelMplus10 e Press Start 2P) foram desenhadas sem pixels parciais nos múltiplos inteiros da grade e com 19,4% a 82,2% dos pixels com tinta borrados entre eles. Com a suavização padrão do contexto de desenho, até um múltiplo inteiro borrou: PixelMplus10 nos seus próprios 10 pixels saiu com 178 de 272 pixels com tinta parciais.⁹ Duas falhas no arquivo da fonte causam borrão em todos os tamanhos: uma grade fora da linha de base, como a de PixelMplus12, em 0,39 pixel, e um avanço que não é inteiro, como o avanço de kana de 8,01 pixels de k8x12 assim que os glifos são posicionados com exatidão. A medição foi feita num Mac; uma captura no iPhone é a verificação que resolve a questão lá.⁷

Uma fonte pixelada pode ter suporte a Dynamic Type?

Só por arredondamento. Dos doze tamanhos de Body do iOS, de 14 a 53 pontos, um em de 10 pixels cai em pixels de dispositivo inteiros a 3× só em 40 pontos, então uma fonte pixelada que escala continuamente com Font.custom(_:size:relativeTo:) fica fora da grade nos outros onze; no Core Text do Mac, fora da grade significou borrado, e uma captura no iPhone decide o que o SwiftUI desenha lá. Leia o tamanho escalado com UIFontMetrics ou ScaledMetric, arredonde-o a um número inteiro de pixels de dispositivo por pixel de fonte e aplique-o com Font.custom(_:fixedSize:). A Apple pede que uma fonte personalizada implemente os comportamentos que as fontes do sistema têm, entre eles o Dynamic Type, e que um app de preferência deixe as pessoas ampliarem o texto em pelo menos 200 por cento.^710206768

O Core Text segue as regras japonesas de quebra de linha?

Na minha medição no macOS 27.0, sim, de forma estrita, quando o texto não estava marcado com um idioma: um parágrafo de 131 caracteres quebrou em sete larguras sem que nenhuma linha começasse com um caractere da lista de início de linha da sonda (uma lista parcial, na maior parte caracteres do JLREQ, com sete nas formas de largura total), em Hiragino Sans e em oito fontes pixeladas. Marcado com ja, ele afrouxou para a regra mais frouxa que os requisitos de composição japonesa do W3C descrevem, e um kana pequeno começou uma linha em 6 de 7 larguras na maioria das fontes. O que o SwiftUI faz num iPhone com o idioma do dispositivo em japonês não foi medido.⁷²¹

De quantos caracteres uma fonte pixelada japonesa precisa?

O JIS X 0208, a meta de cobertura habitual, tem 6.879: 524 que não são kanji, 2.965 kanji de nível 1 e 3.390 de nível 2. O produtor de Final Fantasy Pixel Remaster contou à Siliconera que a fonte pixelada japonesa dele levou “around 7,500 characters” (cerca de 7.500 caracteres), contra “a few hundred” (algumas centenas) para os idiomas ocidentais. Um jogo com um script fixo pode sair com menos: a ROM japonesa de Final Fantasy VI tem 1.248 letras na fonte de diálogo.⁵⁸⁴

Cada número deste post vem de um script que roda de novo sobre fontes salvas, de uma página salva em 5 de outubro de 2026 ou de uma leitura datada do código do Kiradex, e as notas dizem qual; os números do Core Text são do macOS 27.0, não do iOS. O briefing da seção 12 é a minha proposta e está identificado como tal; nada dele foi construído.

Relacionados neste site: Mundos em pixel art no iPhone é o primeiro post desta série, com a receita de RealityKit e a direção para o texto que este post mede; Pessoas em pixel art: personagens e um criador no iPhone é o colecionador sobre o qual os balões ficam; Estruturas em pixel art: casas, salões e interiores no iPhone tem a forja cuja placa continua sem letras; Movimento em pixel art: caminhadas, câmeras e portas no iPhone tem os relógios de 60 e 120 hertz contra os quais a revelação é cronometrada; Uma cidade pixelada viva quando ninguém está online tem as linhas predefinidas e a frequência delas; Cômodos em pixel art e Rotas em pixel art são os briefings cujas verificações este amplia; Como homenagear os velhos jogos de Pokémon sem tomar nada emprestado explica por que o cânone é medido e nunca copiado; e Xcode 27.1 beta: seu app no simulador do iPhone Duo trata do simulador em que roda a captura do balão.

Fontes