Ir para o conteúdo principal

Ferramenta de dicionário de bitmap

A ferramenta de dicionário de bitmap organiza textos ou gráficos de uma imagem em dados de bitmap reutilizáveis. Ela é útil quando o texto de uma screenshot não é texto comum e não pode ser capturado como elemento de texto.

Abrir a ferramenta​

Abra primeiro o 样本工作台 e mude para a página 点阵字库工具. Você também pode abrir uma screenshot no seletor de cores e depois mudar para a ferramenta de dicionário de bitmap para continuar usando a mesma imagem.

Criar um bitmap de um caractere​

  1. Abra uma screenshot que contenha o texto ou gráfico desejado.
  2. Clique na cor do texto na imagem original para adicioná-la a 二值化偏色列表.
  3. Ajuste 默认容差 se necessário ou edite diretamente um intervalo de cores como RRGGBB-RRGGBB.
  4. Clique em 二值化 até que a visualização binarizada contenha, na medida do possível, apenas o texto ou gráfico desejado.
  5. Arraste com Shift para delimitar um caractere. Para uma segunda seleção, arraste com Meta/Ctrl.
  6. Informe o caractere em 文字, por exemplo A ou 阿.
  7. Clique em 提交/更新; o bitmap aparecerá em 点阵列表.

Em uma tela sensível ao toque ou em um dispositivo móvel, use os botões Shift选区 e Meta选区 para alternar o modo de seleção.

Dividir uma linha de texto​

Se a screenshot contiver uma linha de caracteres, delimite a linha inteira e clique em 拆分. A ferramenta dividirá a linha em vários bitmaps usando as colunas vazias.

Antes de dividir, confirme se a visualização binarizada está suficientemente limpa: o fundo deve estar o mais vazio possível e os caracteres, completos. Se o resultado não for ideal, ajuste o número mínimo de colunas de intervalo para mais ou para menos ou use 选区适应 para ajustar a seleção ao conteúdo.

Entender o resultado​

  • 二值化: transforma a imagem em uma visualização em preto e branco que mantém apenas a cor desejada.
  • 偏色范围: permite uma pequena variação de cor para evitar pontos ausentes causados pelo antialiasing da screenshot.
  • 点阵列表: itens de dicionário já organizados.
  • 拷贝: copia a linha de codificação do bitmap atual, adequada para colar em um dicionário existente.
  • 导出: copia ou baixa a lista completa de bitmaps, útil para backup ou importação em outro projeto.
  • 代码模板 → 拷贝代码: gera um trecho de script com o intervalo de cores, a seleção e a lista de bitmaps atuais, pronto para colar no script.
  • 左偏移 / 右偏移: deixa espaço à esquerda e à direita do caractere; normalmente, mantenha os valores padrão.

Salvar a imagem do bitmap​

Para salvar a visualização do bitmap como imagem:

  1. Clique em 保存点阵图.
  2. Informe o nome do arquivo.
  3. Verifique 生成的代码.
  4. Escolha o local de salvamento.
  5. Clique em 保存 ou em 拷贝代码并保存图像.

Ao escolher 拷贝代码并保存图像, o código que carrega a imagem é copiado para a área de transferência. Normalmente, cole-o no ponto do script em que o recurso precisa ser carregado.

O modelo de código em 保存点阵图像 é salvo separadamente do modelo de imagem de região do seletor de cores. Ele aceita a variável de nome de arquivo $imgFileBaseName e todas as variáveis do modelo de código de bitmap:

  • seleção Shift: $shiftRect.left, $shiftRect.top, $shiftRect.right, $shiftRect.bottom;
  • seleção Meta: $metaRect.left, $metaRect.top, $metaRect.right, $metaRect.bottom;
  • conteúdo do bitmap: $colorRange, $matrix, $matrixList, $word.

Testar modelos em um dispositivo​

Defina o dispositivo atual de desenvolvimento e teste no editor de texto ou no menu de contexto do dispositivo e clique no botão de teste à esquerda de Copiar. Há suporte aos cinco modelos de cor, find_image, load_data e imagens de região, além dos seis modelos e imagens de matriz. As duas ferramentas usam o dispositivo atual de desenvolvimento e teste e acompanham suas mudanças imediatamente. O dispositivo de captura e as seleções na lista de dispositivos ou nos grupos não alteram o destino do teste. Se nenhum dispositivo estiver definido ou ele estiver indisponível, defina um dispositivo disponível pelos mesmos menus primeiro.

O lápis ao lado do título permite editar nome, código original, código de teste e prévias. Matrizes usam o editor existente. As alterações são salvas automaticamente, inclusive ao fechar com Escape. Nomes vazios dos modelos 1–5 usam o padrão do idioma atual; código de teste vazio desativa o teste. Restaurar redefine nome, código original e código de teste juntos.

$code insere o código gerado sem expandir seu conteúdo novamente. $screenOrient indica a orientação da captura e tem padrão 0; matrizes também aceitam $coreLine. Testes de imagem aceitam $testResourceRoot e $testImagePath e enviam o PNG atual sem salvá-lo localmente antes.

O teste abre os logs do editor e preserva arquivos, logs anteriores e conteúdo da bancada. O código é enviado após a conexão dos logs ficar pronta; resultados e erros aparecem ali. Encerre primeiro qualquer execução ou depuração ativa. Se o envio não for confirmado, consulte os logs antes de tentar novamente.

OCR e FindStr carregam automaticamente a lista atual de matrizes. $matrixListLiteral cria uma string Lua segura com aspas, quebras de linha e caracteres especiais. Apenas padrões antigos não alterados são atualizados; código personalizado é preservado. O teste usa o mesmo conteúdo de Copiar código: código completo ou linha principal quando vazio.

Problemas comuns​

  • Visualização binarizada vazia: clique novamente na cor desejada ou aumente a tolerância adequadamente.
  • Fundo e conteúdo invertidos: alterne o modo de cor de fundo e extraia novamente.
  • Resultado da divisão igual a 0: confirme se a seleção cobre o texto desejado, se o intervalo de cores está marcado e se o número mínimo de colunas de intervalo não está alto demais.
  • Dados de bitmap inválidos: verifique se o conteúdo importado contém uma entrada por linha ou extraia novamente a partir da seleção.