@jjlmoya/utils-games-development 1.54.0 → 1.56.0

package/src/tool/pixelArtPaletteSwapper/i18n/pt.ts

@@ -0,0 +1,233 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { PixelArtPaletteSwapperUI } from '../ui';
+
+export const content: ToolLocaleContent<PixelArtPaletteSwapperUI> = {
+  slug: 'troca-paleta-pixel-art',
+  title: 'Troca de Paleta para Pixel Art',
+  description: 'Reduza sprites e folhas de sprites para paletas clássicas de consoles ou uma lista personalizada de cores hexadecimais no navegador.',
+  ui: {
+    uploadTitle: 'Arraste um sprite ou folha de sprites',
+    uploadHint: 'PNG, JPEG ou WebP processados no seu dispositivo',
+    chooseImage: 'Escolher imagem',
+    replaceImage: 'Substituir imagem',
+    paletteTitle: 'Escolher paleta',
+    gameBoyPalette: 'Game Boy',
+    nesPalette: 'Inspirada no NES',
+    pico8Palette: 'PICO-8',
+    commodore64Palette: 'Commodore 64',
+    dawnBringerPalette: 'DawnBringer 16',
+    customPalette: 'Cores personalizadas',
+    customPaletteHint: 'Separa valores hexadecimais por vírgulas, espaços ou quebras de linha.',
+    applyCustomPalette: 'Aplicar paleta',
+    resetCustomPalette: 'Redefinir',
+    sourcePreview: 'Original',
+    resultPreview: 'Resultado reduzido',
+    waitingForImage: 'Aguardando uma imagem',
+    uploadToPreview: 'Envie uma imagem para visualizar',
+    resultEmpty: 'As versões original e reduzida aparecerão lado a lado.',
+    downloadPng: 'Baixar PNG',
+    downloadDisabled: 'Envie uma imagem para habilitar a exportação.',
+    colorCount: 'Cores originais',
+    mappedCount: 'Cores usadas',
+    imageSize: 'Tamanho da imagem',
+    paletteCount: 'cores da paleta',
+    preserveAlpha: 'Preservar transparência',
+    zoomLabel: 'Zoom',
+    processing: 'Mapeando pixels',
+    invalidPalette: 'Adicione pelo menos uma cor hexadecimal válida',
+    invalidImage: 'Escolha uma imagem PNG, JPEG ou WebP',
+    readyStatus: 'Pronto',
+    dropActive: 'Solte para carregar',
+    mappedSummary: 'Mapeadas {source} cores originais para {mapped} cores da paleta',
+  },
+  seo: [
+    {
+      type: 'title',
+      level: 2,
+      text: 'Converta um Sprite Colorido em uma Paleta Retro Definida',
+    },
+    {
+      type: 'paragraph',
+      html: 'Uma paleta limitada é muito mais do que uma restrição técnica. Ela dá ao sprite um vocabulário de cores coerente, faz com que os elementos de uma cena pareçam pertencer ao mesmo universo e sugere o caráter visual de um console ou hardware clássico específico. Este alterador de paleta no navegador permite comparar a imagem original com uma versão reduzida enquanto você experimenta com Game Boy, inspiradas no NES, PICO-8, Commodore 64, DawnBringer 16 e listas personalizadas.',
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Como Funciona o Mapeamento pela Cor Mais Próxima',
+    },
+    {
+      type: 'paragraph',
+      html: 'A ferramenta lê os canais vermelho, verde e azul de cada pixel visível e compara essa cor com cada valor presente na paleta selecionada. Ela escolhe a entrada da paleta com a menor distância RGB ao quadrado e escreve a cor de substituição em um novo buffer de tela. O canal alfa é mantido separado, de modo que os pixels transparentes permanecem transparentes e as bordas parcialmente transparentes conservam sua opacidade original quando a opção Preservar transparência está ativa.',
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Redução de paleta',
+          description: 'Cada cor original é substituída pela amostra disponível mais próxima.',
+          points: [
+            'Rápido e previsível para sprites, ícones, elementos de mapas e interfaces',
+            'Conserva exatamente as dimensões e as posições dos pixels originais',
+            'Facilita a verificação e o controle de um orçamento de cores estabelecido',
+          ],
+        },
+        {
+          title: 'Troca de paleta (Palette Swapping)',
+          description: 'A mesma ilustração pode ser remapeada para outro conjunto de cores cuidadosamente escolhido.',
+          points: [
+            'Útil para trajes alternativos, variações de biomas e estados de dano',
+            'Listas hexadecimais personalizadas permitem adequar-se à sua própria direção artística',
+            'O arquivo PNG baixado está pronto para ser reimportado no seu editor',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Escolhendo uma Paleta para Pixel Art',
+    },
+    {
+      type: 'table',
+      headers: ['Paleta', 'Cores', 'Uso recomendado', 'Aspectos a considerar'],
+      rows: [
+        ['Game Boy', '4', 'Estilo monocromático portátil e estudos de valores bem definidos', 'A gama reduzida de valores pode fundir materiais com tonalidades próximas'],
+        ['Inspirada no NES', '16', 'Sprites marcantes estilo arcade, personagens e cenários', 'Cores muito brilhantes podem se sobrepor a detalhes pequenos'],
+        ['PICO-8', '16', 'Pixel art moderno com acentos de cores saturadas', 'Tonalidades muito saturadas exigem um contraste intencional'],
+        ['Commodore 64', '16', 'Cenas retro suaves e estética de computadores clássicos', 'Baixo contraste se beneficia de silhuetas bem definidas'],
+        ['DawnBringer 16', '16', 'Paleta artesanal versátil para uso geral em pixel art', 'Rampas de cores ainda exigem uma direção de luz clara'],
+      ],
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Fluxo de Trabalho Prático para Folhas de Sprites',
+    },
+    {
+      type: 'paragraph',
+      html: 'Comece com a maior imagem original que você consiga editar confortavelmente, e em seguida envie o sprite ou folha de sprites exportada para cá. Selecione uma predefinição para definir o estilo visual ou cole uma lista personalizada de uma biblioteca de cores. Inspecione ambas as telas em um nível de ampliação maior para verificar se houve perda de detalhes faciais, contornos fundidos ou pontos de luz que não se destacam mais. Se o resultado parecer apagado, tente uma paleta com saltos de valor mais acentuados ou adicione uma cor de destaque intencional.',
+    },
+    {
+      type: 'tip',
+      title: 'Mantenha uma Paleta Intencional',
+      html: 'Uma lista de cores maior não é automaticamente melhor. Comece com 4 a 16 cores, atribua uma função clara a cada cor e reserve os valores mais brilhantes para pontos focais ou destaques bem legíveis. O algoritmo da cor mais próxima preserva as posições dos pixels, mas não pode decidir quais cores devem estruturar a hierarquia visual do seu sprite.',
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Lista de Verificação para Exportação de Pixel Art',
+    },
+    {
+      type: 'diagnostic',
+      variant: 'info',
+      title: 'Antes de Importar o Arquivo PNG Reduzido',
+      html: 'Verifique o resultado em escala de 100 por cento e no tamanho final dentro do jogo, confirme se as bordas transparentes continuam limpas, verifique se as silhuetas importantes permanecem bem legíveis e conserve o arquivo original ao lado do exportado para poder ajustar a paleta sem ter que recomeçar do zero.',
+    },
+    {
+      type: 'glossary',
+      items: [
+        {
+          term: 'Quantização de cor',
+          definition: 'O processo de redução de um amplo conjunto de cores originais para um conjunto menor e definido.',
+        },
+        {
+          term: 'Rampa de paleta',
+          definition: 'Uma sequência ordenada de tons escuros, médios e claros usada para sombrear uma superfície ou material.',
+        },
+        {
+          term: 'Paleta indexada',
+          definition: 'Uma tabela de cores compacta em que os pixels fazem referência a índices em uma lista compartilhada em vez de armazenar cores completas.',
+        },
+      ],
+    },
+  ],
+  faq: [
+    {
+      question: 'A ferramenta envia minhas imagens para um servidor?',
+      answer: 'Não. A imagem é decodificada em uma tela no seu navegador, mapeada localmente em JavaScript e exportada diretamente como PNG. A ferramenta não possui etapa de envio externo.',
+    },
+    {
+      question: 'Posso usar minha própria paleta personalizada?',
+      answer: 'Sim. Cole códigos hexadecimais de 6 ou 3 dígitos no campo Cores personalizadas, separados por vírgulas, espaços ou quebras de linha, e selecione Aplicar paleta.',
+    },
+    {
+      question: 'O tamanho do meu sprite é alterado?',
+      answer: 'Não. O arquivo exportado mantém a largura, a altura, as posições dos pixels e os valores alfa originais quando a opção Preservar transparência está ativa.',
+    },
+    {
+      question: 'Qual algoritmo é utilizado?',
+      answer: 'Cada pixel visível é atribuído à cor mais próxima na paleta selecionada usando a distância euclidiana ao quadrado no espaço RGB. É um método rápido, determinístico e fácil de previsualizar, que não aplica pontilhado (dithering) ou correção cromática perceptual Lab.',
+    },
+  ],
+  howTo: [
+    {
+      name: 'Carregar um sprite',
+      text: 'Arraste um sprite ou folha de sprites PNG, JPEG ou WebP para a área de trabalho ou use o botão Escolher imagem.',
+    },
+    {
+      name: 'Escolher uma paleta',
+      text: 'Selecione uma predefinição clássica ou insira suas próprias cores hexadecimais. O resultado é atualizado instantaneamente.',
+    },
+    {
+      name: 'Comparar e exportar',
+      text: 'Inspecione a tela original e a reduzida, ajuste a ampliação e baixe o resultado em formato PNG.',
+    },
+  ],
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: 'Troca de Paleta para Pixel Art',
+      applicationCategory: 'DesignApplication',
+      operatingSystem: 'Any',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: [
+        {
+          '@type': 'Question',
+          name: 'A ferramenta envia minhas imagens para um servidor?',
+          acceptedAnswer: {
+            '@type': 'Answer',
+            text: 'Não. A imagem é processada localmente no navegador e exportada diretamente como PNG.',
+          },
+        },
+        {
+          '@type': 'Question',
+          name: 'Posso usar minha própria paleta personalizada?',
+          acceptedAnswer: {
+            '@type': 'Answer',
+            text: 'Sim. Insira códigos hexadecimais no campo Cores personalizadas e aplique a paleta.',
+          },
+        },
+      ],
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: 'Como reduzir um sprite para uma paleta retro',
+      step: [
+        { '@type': 'HowToStep', name: 'Carregar um sprite', text: 'Arraste um arquivo para a área de trabalho.' },
+        { '@type': 'HowToStep', name: 'Escolher uma paleta', text: 'Selecione uma predefinição ou insira suas cores.' },
+        { '@type': 'HowToStep', name: 'Comparar e exportar', text: 'Inspecione o resultado e baixe o arquivo PNG.' },
+      ],
+    },
+  ],
+  bibliography: [
+    {
+      name: 'MDN Canvas API',
+      url: 'https://developer.mozilla.org/en-US/docs/Web/API/Canvas_API',
+    },
+    {
+      name: 'Lospec Palette List',
+      url: 'https://lospec.com/palette-list',
+    },
+    {
+      name: 'W3C Portable Network Graphics Specification',
+      url: 'https://www.w3.org/TR/png-3/',
+    },
+  ],
+};

package/src/tool/pixelArtPaletteSwapper/i18n/ru.ts

@@ -0,0 +1,233 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { PixelArtPaletteSwapperUI } from '../ui';
+
+export const content: ToolLocaleContent<PixelArtPaletteSwapperUI> = {
+  slug: 'konverter-palitry-pixel-art',
+  title: 'Конвертер Палитры для Пиксель Арта',
+  description: 'Уменьшайте палитру спрайтов и спрайтшитов до классических консольных цветов или собственных hex-значений прямо в браузере.',
+  ui: {
+    uploadTitle: 'Перетащите спрайт или спрайтшит',
+    uploadHint: 'Файлы PNG, JPEG или WebP обрабатываются локально',
+    chooseImage: 'Выбрать изображение',
+    replaceImage: 'Заменить изображение',
+    paletteTitle: 'Выберите палитру',
+    gameBoyPalette: 'Game Boy',
+    nesPalette: 'В стиле NES',
+    pico8Palette: 'PICO-8',
+    commodore64Palette: 'Commodore 64',
+    dawnBringerPalette: 'DawnBringer 16',
+    customPalette: 'Собственные цвета',
+    customPaletteHint: 'Разделяйте hex-коды запятыми, пробелами или переносами строк.',
+    applyCustomPalette: 'Применить палитру',
+    resetCustomPalette: 'Сбросить',
+    sourcePreview: 'Оригинал',
+    resultPreview: 'Ограниченный результат',
+    waitingForImage: 'Ожидание изображения',
+    uploadToPreview: 'Загрузите изображение для предпросмотра',
+    resultEmpty: 'Оригинальная и обработанная версии появятся рядом.',
+    downloadPng: 'Скачать PNG',
+    downloadDisabled: 'Загрузите изображение для экспорта.',
+    colorCount: 'Исходные цвета',
+    mappedCount: 'Использовано цветов',
+    imageSize: 'Размер изображения',
+    paletteCount: 'цветов в палитре',
+    preserveAlpha: 'Сохранять прозрачность',
+    zoomLabel: 'Масштаб',
+    processing: 'Пиксели обрабатываются',
+    invalidPalette: 'Добавьте хотя бы один корректный hex-код',
+    invalidImage: 'Выберите файл PNG, JPEG или WebP',
+    readyStatus: 'Готово',
+    dropActive: 'Отпустите для загрузки',
+    mappedSummary: 'Сконвертировано {source} исходных цветов в {mapped} цветов палитры',
+  },
+  seo: [
+    {
+      type: 'title',
+      level: 2,
+      text: 'Превратите Полноцветный Спрайт в Продуманную Ретро Палитру',
+    },
+    {
+      type: 'paragraph',
+      html: 'Ограниченная палитра - это больше, чем просто техническое ограничение. Она дает спрайту узнаваемый цветовой язык, помогает элементам сцены выглядеть единым целым и передает визуальный характер конкретной ретро-консоли или классической платформы. Этот браузерный инструмент позволяет сравнивать исходное изображение с обработанным при экспериментировании с палитрами Game Boy, NES, PICO-8, Commodore 64, DawnBringer 16 и пользовательскими наборами.',
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Как Работает Преобразование по Ближайшему Цвету',
+    },
+    {
+      type: 'paragraph',
+      html: 'Инструмент считывает красный, зеленый и синий каналы каждого видимого пикселя и сравнивает этот цвет с каждым значением в выбранной палитре. Он выбирает элемент палитры с наименьшим квадратичным расстоянием RGB и записывает заменяющий цвет в новый буфер холста. Альфа-канал обрабатывается отдельно, благодаря чему прозрачные пиксели остаются прозрачными, а полупрозрачные края сохраняют свою исходную непрозрачность при включенном параметре Сохранять прозрачность.',
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Ограничение палитры',
+          description: 'Каждый исходный цвет заменяется ближайшим доступным образцом.',
+          points: [
+            'Быстро и предсказуемо для спрайтов, иконок, тайлов и элементов интерфейса',
+            'Точно сохраняет исходные размеры и координаты пикселей',
+            'Облегчает контроль и проверку заданного цветового бюджета',
+          ],
+        },
+        {
+          title: 'Смена палитры (Palette Swapping)',
+          description: 'Одно и то же изображение можно перераспределить на другой тщательно подобранный набор цветов.',
+          points: [
+            'Удобно для альтернативных костюмов, смены биомов и состояний урона',
+            'Пользовательские списки hex-кодов позволяют точно следовать вашей арт-дирекции',
+            'Скачанный файл PNG сразу готов к повторному импорту в ваш графический редактор',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Выбор Палитры для Пиксель Арта',
+    },
+    {
+      type: 'table',
+      headers: ['Палитра', 'Цвета', 'Назначение', 'Особенности'],
+      rows: [
+        ['Game Boy', '4', 'Монохромная стилистика портативной консоли и выразительная светотень', 'Узкий диапазон тонов может сливать близкие по цвету материалы'],
+        ['В стиле NES', '16', 'Выразительные аркадные спрайты, персонажи и тайлы', 'Очень яркие тона могут перекрывать мелкие детали'],
+        ['PICO-8', '16', 'Современный пиксель-арт с saturated акцентами', 'Насыщенные оттенки требуют продуманного контраста'],
+        ['Commodore 64', '16', 'Мягкие ретро-сцены и эстетика классических компьютерных игр', 'Низкий контраст выигрывает от четких силуэтов'],
+        ['DawnBringer 16', '16', 'Универсальная художественная палитра для пиксель-арта', 'Градационные рампы все еще требуют четкого направления света'],
+      ],
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Практический Процесс Работы со Спрайтшитами',
+    },
+    {
+      type: 'paragraph',
+      html: 'Начните с самого крупного исходного изображения, которое вам удобно редактировать, и загрузите экспортированный спрайт или спрайтшит сюда. Выберите пресет для задания стиля или вставьте пользовательский список из библиотеки палитр. Проверьте оба холста при большем увеличении на предмет утерянных черт лица, слившихся контуров или бликов. Если результат выглядит размытым, попробуйте палитру с более резкими шагами тонов или добавьте один акцентный цвет.',
+    },
+    {
+      type: 'tip',
+      title: 'Подходите к Палитре Осознанно',
+      html: 'Больший список цветов не означает автоматическое улучшение. Начните с 4-16 цветов, назначьте каждому цвету четкую роль и приберегите самые яркие значения для ключевых точек или читаемых бликов. Алгоритм ближайшего цвета сохраняет позиции пикселей, но не может решить, какие цвета должны выстраивать визуальную иерархию вашего спрайта.',
+    },
+    {
+      type: 'title',
+      level: 2,
+      text: 'Чек-лист Экспорта Пиксель Арта',
+    },
+    {
+      type: 'diagnostic',
+      variant: 'info',
+      title: 'Перед Импортом Обработанного Файла PNG',
+      html: 'Проверьте результат в масштабе 100 процентов и в итоговом игровом размере, убедитесь, что прозрачные края остаются чистыми, проверьте читаемость важных силуэтов и сохраните исходный файл рядом с экспортированным, чтобы иметь возможность скорректировать палитру без необходимости начинать заново.',
+    },
+    {
+      type: 'glossary',
+      items: [
+        {
+          term: 'Квантование цвета',
+          definition: 'Процесс сокращения большого набора исходных цветов до более мелкого, четко определенного набора.',
+        },
+        {
+          term: 'Цветовая рампа',
+          definition: 'Упорядоченная последовательность темных, средних и светлых оттенков, используемая для построения объема.',
+        },
+        {
+          term: 'Индексированная палитра',
+          definition: 'Компактная таблица цветов, в которой пиксели ссылаются на индексы в общем списке вместо повторного сохранения полных значений.',
+        },
+      ],
+    },
+  ],
+  faq: [
+    {
+      question: 'Загружает ли инструмент мои изображения на сервер?',
+      answer: 'Нет. Изображение декодируется на холсте в вашем браузере, обрабатывается локально с помощью JavaScript и экспортируется напрямую в формат PNG. Утилита не содержит этапа загрузки на сервер.',
+    },
+    {
+      question: 'Могу ли я использовать собственную палитру?',
+      answer: 'Да. Вставьте 6-значные или 3-значные hex-коды в поле Собственные цвета, разделяя их запятыми, пробелами или переносами строк, а затем нажмите Применить палитру.',
+    },
+    {
+      question: 'Изменяет ли инструмент размер спрайта или спрайтшита?',
+      answer: 'Нет. Итоговый файл сохраняет исходную ширину, высоту, координаты пикселей и значения альфа-канала при включенном параметре Сохранять прозрачность.',
+    },
+    {
+      question: 'Какой алгоритм используется?',
+      answer: 'Каждый видимый пиксель сопоставляется с ближайшим цветом в выбранной палитре с использованием квадратичного евклидова расстояния в пространстве RGB. Это быстрый, детерминированный и наглядный метод, который не применяет дизеринг или перцептивную цветокоррекцию Lab.',
+    },
+  ],
+  howTo: [
+    {
+      name: 'Загрузить спрайт',
+      text: 'Перетащите спрайт или спрайтшит PNG, JPEG или WebP в рабочую область или используйте кнопку Выбрать изображение.',
+    },
+    {
+      name: 'Выбрать палитру',
+      text: 'Выберите классический пресет или введите собственные hex-коды. Результат обновится мгновенно при применении палитры.',
+    },
+    {
+      name: 'Сравнить и экспортировать',
+      text: 'Оцените оригинальный и обработанный холст, отрегулируйте масштаб предпросмотра и скачайте результат в формате PNG.',
+    },
+  ],
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: 'Конвертер Палитры для Пиксель Арта',
+      applicationCategory: 'DesignApplication',
+      operatingSystem: 'Any',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: [
+        {
+          '@type': 'Question',
+          name: 'Загружает ли инструмент мои изображения на сервер?',
+          acceptedAnswer: {
+            '@type': 'Answer',
+            text: 'Нет. Изображение обрабатывается локально в браузере и экспортируется напрямую в PNG.',
+          },
+        },
+        {
+          '@type': 'Question',
+          name: 'Могу ли я использовать собственную палитру?',
+          acceptedAnswer: {
+            '@type': 'Answer',
+            text: 'Да. Введите hex-коды в поле Собственные цвета и нажмите Применить палитру.',
+          },
+        },
+      ],
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: 'Как конвертировать спрайт в ретро палитру',
+      step: [
+        { '@type': 'HowToStep', name: 'Загрузить спрайт', text: 'Перетащите файл в рабочую область.' },
+        { '@type': 'HowToStep', name: 'Выбрать палитру', text: 'Выберите пресет или укажите свои цвета.' },
+        { '@type': 'HowToStep', name: 'Сравнить и экспортировать', text: 'Оцените результат и скачайте PNG.' },
+      ],
+    },
+  ],
+  bibliography: [
+    {
+      name: 'MDN Canvas API',
+      url: 'https://developer.mozilla.org/en-US/docs/Web/API/Canvas_API',
+    },
+    {
+      name: 'Lospec Palette List',
+      url: 'https://lospec.com/palette-list',
+    },
+    {
+      name: 'W3C Portable Network Graphics Specification',
+      url: 'https://www.w3.org/TR/png-3/',
+    },
+  ],
+};