ComfyUI-EquirectProjector

ComfyUI-EquirectProjetor é um conjunto especializado de nós para a popular plataforma ComfyUI que amplia sua funcionalidade para trabalhar com panoramas esféricos de 360 graus. O objetivo principal da ferramenta é integrar imagens e vídeos panorâmicos em um pipeline de IA generativo para criar conteúdo de realidade virtual e processar projeções esféricas. O conjunto consiste em dois componentes-chave: o nó de projeção Rectilinear → Equirectact, que converte imagens de perspectiva padrão em formato equirectangular, e o grupo de nó Equirectact Seam, projetado para costura sem costura panorama com remoção de fronteira visível. A ferramenta foi desenvolvida com compatibilidade com o modelo LTX2.3 VR-Outpaint em mente e foi projetada para processamento em lote de dados de vídeo.

O principal valor deste complemento é que ele resolve problemas típicos encontrados ao trabalhar com panoramas na geração de IA: corretamente projetando imagens planas em uma esfera e eliminando artefatos na junção de bordas panorâmicas (o chamado "seam"). Graças ao seu código de código aberto e ao seu modelo de distribuição gratuito, esta ferramenta é acessível a uma vasta gama de desenvolvedores e entusiastas.

Características do Projeto ComfyUI-Equirect

Para quem é o Projetor ComfyUI-Equirect?

Desenvolvedores de conteúdo e entusiastas de RV

A ferramenta é voltada para profissionais e hobbyistas que criam conteúdo para a realidade virtual. O conjunto de nós permite integrar a geração de panorama de 360 graus em fluxos de trabalho ComfyUI familiares, que é especialmente relevante para desenvolvedores de aplicativos VR e criadores de ambientes imersivos.

Especialistas em vídeo panorâmicas

Uma vez que a ferramenta suporta processamento de vídeo em lote, será útil para aqueles que trabalham com vídeos panorâmicos. A capacidade de processar lotes de imagens permite automatizar a tubulação de processamento de sequências de vídeo em projeção esférica.

Usuários ComfyUI interessados em pintura

O conjunto contém ferramentas para pintar (desenhar) o espaço em torno de uma moldura inserida em uma esfera. Isso será de interesse para artistas e designers que querem estender imagens panorâmicas além do quadro original, mantendo a geometria correta.

Como utilizar o ComfyUI-EquirectProjector?

Instalação via Git

Para começar, você precisa clonar o repositório da ferramenta para o custom_nodes pasta localizada dentro do diretório de instalação ComfyUI. Esta é a maneira padrão de conectar extensões personalizadas à plataforma.

Configurando dependências

Após a clonagem, você precisa instalar as dependências listadas no requirements.txt Arquivo. É importante notar que a ferramenta tem uma dependência opcional da biblioteca scipy — ela é usada para acelerar os cálculos. Se o scipy não estiver instalado, o conjunto de nós irá automaticamente voltar às ferramentas PyTorch padrão.

Executando e usando

Após instalar as dependências, você precisa reiniciar o ComfyUI. Os novos nós aparecerão na interface do usuário sob o 360/projection categoria. A partir daí, eles podem ser adicionados ao grafo de fluxo de trabalho como elementos regulares ComfyUI, combinando-os com outros nós para criar o pipeline de processamento desejado.

Principais características do Projeto ComfyUI-Equirect

Rectilinear → Projecção de equirecto

O nó chave do conjunto converte imagens de perspectiva padrão ou vídeos em projeção equirectangular. Ele suporta a configuração do campo de visão (FOV), bem como parâmetros de orientação da câmera na esfera — guinada e pitch. Uma característica importante é a capacidade de usar o mascaramento, que é necessário para posterior pintura.

Equirect costura sem costura nós

O grupo Echirect Seam Inpaint Prep, Export e Compose foi projetado para resolver o problema dos limites visíveis (seams) em imagens panorâmicas. Esses nós permitem preparar uma imagem para pintura, exportar resultados intermediários e montar a imagem panorâmica sem costura final.

Processamento e filtragem em lote

A ferramenta suporta processamento de imagem em lote, tornando-o adequado para trabalhar com arquivos de vídeo. A transformação utiliza grid_sample método com filtragem bilinear, proporcionando transformação suave e de alta qualidade de pixels durante a projeção.

Vantagens do Projeto ComfyUI-Equirect

• Integração do Panorama no gasoduto IA: a ferramenta permite incluir imagens de 360 graus no processo de geração, que não está disponível com ferramentas padrão ComfyUI.
• Resolver o problema da costura: os nós especializados em pintura automatizam o processo de remoção de fronteiras visíveis em panoramas, simplificando muito a criação de imagens esféricas de alta qualidade.
• Suporte a vídeo: a capacidade de trabalhar com frame lotes torna a ferramenta adequada para o processamento de material de vídeo panorâmico.
• Código aberto: a licença MIT permite o uso livre, modificação e distribuição do código, bem como adaptá-lo às suas próprias necessidades.
• A título gratuito: a ausência de quaisquer taxas torna a ferramenta acessível a todas as categorias de usuários.

Desvantagens do projeto ComfyUI-Equirect

Informações sobre desvantagens óbvias da ferramenta não são fornecidas em fontes disponíveis. Como qualquer ferramenta especializada, exige que o usuário tenha conhecimento básico da plataforma ComfyUI e uma compreensão de como as projeções panorâmicas funcionam. Além disso, a funcionalidade completa pode exigir a instalação da dependência adicional de cypy, embora a funcionalidade seja preservada sem ela. As limitações de desempenho ao processar grandes arrays de vídeo também não são descritas nos dados de origem.

Que tarefas o ComfyUI-EquirectProjetor resolve?

Geração de panorama de RV

A ferramenta permite criar panoramas de 360 graus para uso em aplicações de realidade virtual. Permite incorporar a geração de imagens esféricas em gasodutos ComfyUI automatizados.

Convertendo imagens de perspectiva para esféricas

Usando o nó Rectilinear → Equirect, imagens planas regulares podem ser convertidas em formato equirectangular com controle sobre o campo de visão e orientação da câmera. Isso é necessário para posterior uso de imagens em um contexto panorâmico.

Costura sem costura panorama

O conjunto de nó Echirect Seam resolve o problema de remover limites visíveis em panoramas. Isto é especialmente importante ao gerar imagens com redes neurais, que muitas vezes criam artefatos nas bordas de projeções esféricas.

Espaço de pintura em uma esfera

Graças ao mascaramento, a ferramenta permite desenhar em (pintura) áreas além do quadro original, logicamente continuando a imagem esférica. Isso é útil para expandir panoramas ou preencher lacunas.

Preços dos Projectos ComfyUI-Equirect

A ferramenta é distribuída gratuitamente. O modelo de negócio do projeto é construído com base no princípio do código aberto — não há taxas de uso, assinaturas ou custos ocultos. Os usuários podem baixar, instalar e usar livremente o conjunto de nós sem restrições.

Termos de Uso do Projeto ComfyUI-Equirect

Requisitos ambientais

A ferramenta requer que a plataforma ComfyUI seja instalada. A instalação é feita clonando o repositório para o custom_nodes diretório, após o qual dependências de requirements.txt tem de ser instalado. Opcionalmente, scipy é recomendado para processamento mais rápido.

Termos da licença

O projeto é distribuído sob a licença do MIT, que permite uso comercial e não comercial, modificação e distribuição do código, desde que o aviso de direitos autorais seja mantido.

Disponibilidade do Projeto ComfyUI-Equirect

A plataforma é uma instalação local ComfyUI. Python e dependências instaladas são necessárias para uso. A ferramenta está disponível para download através de um repositório GitHub; nenhuma região específica ou requisitos VPN são indicados. A linguagem de interface é o inglês, que corresponde à interface padrão ComfyUI.

Como o projetor ComfyUI-Equirect difere das alternativas

A diferença chave entre este conjunto de nós e outras ferramentas de panorama é sua integração apertada com o ecossistema ComfyUI. Ao contrário de programas de processamento de panorama standalone, esta ferramenta torna-se parte do gráfico nó de um pipeline generativo, permitindo que ele seja combinado com quaisquer outros nós ComfyUI, incluindo outpinting e modelos de geração. O grupo especializado Echirect Seam resolve propositadamente o problema da costura, que muitas vezes permanece não resolvido em ferramentas universais. Outra diferença é a otimização para o modelo específico LTX2.3 VR-Outpaint e suporte embutido para processamento de vídeo em lote, tornando-se conveniente para trabalhar não só com imagens únicas, mas também com sequências de vídeo.

Conclusão

ComfyUI-EquirectProjetor é um conjunto de nós livre e de código aberto projetado para integrar panoramas de 360 graus em fluxos de trabalho ComfyUI. Ele fornece ferramentas para projetar imagens regulares em formato equirectangular, costura sem costura panorama, e a pintura. A ferramenta destina-se a desenvolvedores e entusiastas criando conteúdo de RV e processando vídeos panorâmicos. Graças à licença do MIT e à ausência de taxas, está disponível para uso gratuito e modificação, tornando-se uma adição valiosa ao ecossistema ComfyUI.