LeadSoft.Common.GlobalDomain 10.1.1

LeadSoft® Global Domain

Developers Common Global Domain © LeadSoft® 2025

This package contains useful entities and classes for LeadSoft® or external applications that needs a huge amount of functions that makes easy developers day-by-day.

For any development and tool use question, contact developers@leadsoft.inf.br .

Nuget.Org: LeadSoft.Common.GlobalDomain

GitHub Repo: leadsoft-global-domain

Features

• Controllers
  • LeadSoftErrorController
  • LeadSoftRootController
• DTOs
• Entities
• Helpers
  • PagedRequestExtensions
  • ImageExtensions
• PagedList.cs
• PagedRequest.cs
• PagingMetadata.cs

📦 Helpers

🖼️ ImageExtensions

Métodos de extensão para manipulação de imagens em Stream, usando SkiaSharp internamente — não depende de nenhuma API externa e roda tanto em Windows quanto em Linux (ex.: instâncias EC2/AWS).

📁 Namespace: LeadSoft.Common.GlobalDomain.Helpers

⚠️ Runtime em Linux: o pacote SkiaSharp sozinho só traz o binário nativo para Windows/macOS. Este projeto já referencia SkiaSharp.NativeAssets.Linux.NoDependencies, que resolve isso sem exigir libfontconfig (nada aqui usa texto/fontes). Isso já é transitivo para quem consome este NuGet — não precisa fazer nada a mais. Testado com sucesso em container Amazon Linux 2023 "limpo".

CreateThumbnail(this Stream, int aWidth = 256, int aHeight = 256)

🔹 Gera uma miniatura (thumbnail) a partir de um stream de imagem, respeitando a proporção original (não distorce) e ajustando a imagem dentro dos limites de largura/altura informados.

• Retorno: novo Stream (PNG) já posicionado no início (Position = 0), pronto para leitura.
• Boas práticas: o stream de entrada é lido, mas não é descartado (Dispose) pelo método — a responsabilidade de liberar o stream original continua sendo de quem o criou. Sempre envolva o resultado em using.

await using var thumbnail = originalStream.CreateThumbnail(128, 128);

Resize(this Stream, int aWidth = 1024, int aHeight = 1024)

🔹 Redimensiona a imagem mantendo a proporção original, ajustando-a (fit) dentro da largura/altura máximas informadas — usado internamente pelo CreateThumbnail, mas com valores padrão maiores.

• Retorno: novo Stream (PNG) já posicionado no início (Position = 0).
• ⚠️ Se a imagem original já for menor ou igual aos limites informados, ela não é ampliada — apenas mantida no tamanho original.

await using var resized = originalStream.Resize(800, 600);

💡 Todos os métodos aceitam aFormat (usando LeadSoft.Common.Library.Enumerators.Enums.FileExtension, padrão Png) e aQuality (padrão 100) para escolher o formato/qualidade de saída. Hoje Png, Jpg/Jpeg e Webp são suportados na codificação — usar outro valor lança NotSupportedException.

TrimTransparency(this Stream, int aBorderPx = 0, byte aAlphaTolerance = 0, ...)

✂️ Corta as margens transparentes ao redor do conteúdo visível da imagem, deixando opcionalmente uma borda transparente de aBorderPx pixels ao redor do resultado.

• aAlphaTolerance: pixels com alpha ≤ esse valor são tratados como "transparentes" na detecção dos limites — útil para lidar com bordas de anti-aliasing que não são 100% transparentes.
• ⚠️ Se a imagem inteira for transparente, o resultado degenera para 1x1 pixel (mais a borda, se houver).

await using var trimmed = originalStream.TrimTransparency(aBorderPx: 10, aAlphaTolerance: 5);

CenterOnCanvas(this Stream, int aCanvasWidth, int aCanvasHeight, ...)

🎯 Centraliza a imagem (sem redimensionar) sobre um canvas transparente do tamanho informado.

• ⚠️ Se a imagem for maior que o canvas em algum eixo, o excedente é cortado igualmente dos dois lados.

await using var centered = originalStream.CenterOnCanvas(500, 500);

🧩 Combinações prontas

Os métodos acima podem ser encadeados livremente (stream.TrimTransparency(10).Resize(500, 500).CenterOnCanvas(500, 500), ou na ordem inversa), e a classe já traz duas combinações prontas para os casos mais comuns:

• ResizeToSquare(this Stream, int aSize = 512, ...) — redimensiona (fit, sem distorcer) e centraliza em um canvas quadrado transparente de aSize x aSize.
• TrimAndFit(this Stream, int aWidth, int aHeight, int aBorderPx = 0, byte aAlphaTolerance = 0, ...) — corta a transparência, redimensiona o conteúdo restante e centraliza no canvas final aWidth x aHeight.

await using var square = originalStream.ResizeToSquare(300);
await using var thumb = originalStream.TrimAndFit(200, 200, aBorderPx: 8);

Tech

Framework requirements to run:

• Microsoft .NET 10.0
• Open Source (MIT License).

Development

Development by LeadSoft® Soluções Web Team.

• Lucas Resende Tavares — lucasrtavares.com.br (posts sobre esses pacotes NuGet e repositórios open source)
• Frederico Ferreira Bitencourt
• Pedro Foresti Leão

Nossa empresa

LeadSoft Soluções Web Ltda CNPJ 38.043.762/0001-48

Como nos encontrar:

• Nosso Site
• GitHub
• LinkedIn
• Behance
• YouTube
• Instagram
• Facebook

INFORMAÇÕES DE CONTATO Se você tiver alguma dúvida sobre estes Termos ou Serviços, entre em contato conosco em

developers@leadsoft.inf.br.