Tharga.Team.Images
3.8.3
See the version list below for details.
dotnet add package Tharga.Team.Images --version 3.8.3
NuGet\Install-Package Tharga.Team.Images -Version 3.8.3
<PackageReference Include="Tharga.Team.Images" Version="3.8.3" />
<PackageVersion Include="Tharga.Team.Images" Version="3.8.3" />
<PackageReference Include="Tharga.Team.Images" />
paket add Tharga.Team.Images --version 3.8.3
#r "nuget: Tharga.Team.Images, 3.8.3"
#:package Tharga.Team.Images@3.8.3
#addin nuget:?package=Tharga.Team.Images&version=3.8.3
#tool nuget:?package=Tharga.Team.Images&version=3.8.3
Tharga.Team.Images
Image processing for Tharga Team icons. Registers an IIconProcessor (backed by
ImageSharp) that squares and downscales uploaded icons,
instead of rejecting ones larger than the configured maximum.
Registration
builder.Services.AddThargaImageProcessing();
The built-in icon store runs the processor before validating/storing. Any uploaded image (team or user)
is fitted within IconOptions.MaxDimension (default 256px), squared by padding the short side
with transparency, and re-encoded as PNG. Formats ImageSharp can't decode (e.g. SVG) pass through
unchanged, as do images that are already square and within the box.
Content is never cropped and never upscaled. The output side is min(max(width, height), MaxDimension):
| Source | Output | Why |
|---|---|---|
| 1000×500 | 256×256 | scaled to 256×128, then padded |
| 100×50 | 100×100 | already fits, so padded only — no pixel is invented |
| 300×300 | 256×256 | square, but larger than the box |
| 100×100 | unchanged | square and within bounds |
Squaring exists so avatar surfaces that reserve a square box stop letterboxing wide and tall sources inconsistently. Cropping would square them too, and is exactly what to avoid — it takes a face out of a portrait photo.
Behaviour change. Before this, output preserved the source aspect ratio, so a 1000×500 upload was stored as 256×128. New uploads are now squared. Already-stored icons are not reprocessed — only images uploaded from here on change shape.
Configure the maximum via the platform options:
builder.AddThargaTeam(o => o.Icon.MaxDimension = 256);
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Microsoft.Extensions.Options (>= 10.0.10)
- SixLabors.ImageSharp (>= 3.1.12)
- Tharga.Team (>= 3.8.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 3.10.7 | 0 | 8/7/2026 |
| 3.10.6 | 0 | 8/7/2026 |
| 3.10.5 | 86 | 8/4/2026 |
| 3.10.4 | 92 | 8/3/2026 |
| 3.10.3 | 89 | 8/2/2026 |
| 3.10.2 | 85 | 8/2/2026 |
| 3.10.1 | 83 | 8/2/2026 |
| 3.10.0 | 88 | 8/1/2026 |
| 3.9.0 | 85 | 8/1/2026 |
| 3.8.3 | 86 | 8/1/2026 |
| 3.8.2 | 88 | 8/1/2026 |
| 3.8.1 | 91 | 7/31/2026 |
| 3.8.0 | 87 | 7/31/2026 |
| 3.7.0 | 90 | 7/30/2026 |
| 3.6.1 | 88 | 7/27/2026 |
| 3.6.0 | 103 | 7/27/2026 |
| 3.5.4 | 88 | 7/27/2026 |
| 3.5.3 | 93 | 7/27/2026 |
| 3.5.2 | 92 | 7/26/2026 |
| 3.5.1 | 96 | 7/24/2026 |