Kuvien pyörittäminen mielivaltaisella nurkalla, jossa on läpinäkyvä tausta, on yleinen vaatimus gallereille, paneeleille ja suunnittelutyökaluille .NET: ssä. Aspose.Imaging for .Net tarjoaa suoran API: n kuvan lataamiseen, sen pyörittämiseen räätälöityllä nurkana ja tallennukseen avoimuutta tukevalle muodolle.
Täydellinen esimerkki
// File: Program.cs
// Requires NuGet: Aspose.Imaging
using System;
using System.Collections.Generic;
using System.IO;
using Aspose.Imaging;
using Aspose.Imaging.ImageOptions;
namespace RotateTransparentDemo
{
public static class Program
{
public static int Main(string[] args)
{
try
{
if (args.Length == 0)
{
// Single-file demo paths. Replace with your own files or pass CLI args.
var input = "input.png"; // source can be PNG, JPG, etc.
var output = "rotated-output.png"; // must be PNG to preserve transparency
RotateSingle(input, output, angleDegrees: 17f, expandCanvas: true);
Console.WriteLine($"Saved: {output}");
return 0;
}
// CLI:
// 1) Single file:
// RotateTransparentDemo.exe <inputPath> <outputPath> <angleDegrees> [expandCanvas:true|false]
//
// 2) Batch folder:
// RotateTransparentDemo.exe --batch <inputDir> <outputDir> <angleDegrees> [expandCanvas:true|false]
if (args[0].Equals("--batch", StringComparison.OrdinalIgnoreCase))
{
if (args.Length < 4)
{
Console.Error.WriteLine("Usage: --batch <inputDir> <outputDir> <angleDegrees> [expandCanvas:true|false]");
return 2;
}
var inputDir = args[1];
var outputDir = args[2];
var angle = float.Parse(args[3]);
var expandCanvas = args.Length >= 5 ? bool.Parse(args[4]) : true;
BatchRotate(inputDir, outputDir, angle, expandCanvas);
Console.WriteLine($"Batch complete. Output in: {outputDir}");
return 0;
}
else
{
if (args.Length < 3)
{
Console.Error.WriteLine("Usage: <inputPath> <outputPath> <angleDegrees> [expandCanvas:true|false]");
return 2;
}
var inputPath = args[0];
var outputPath = args[1];
var angle = float.Parse(args[2]);
var expandCanvas = args.Length >= 4 ? bool.Parse(args[3]) : true;
RotateSingle(inputPath, outputPath, angle, expandCanvas);
Console.WriteLine($"Saved: {outputPath}");
return 0;
}
}
catch (Exception ex)
{
Console.Error.WriteLine("Error: " + ex.Message);
return 1;
}
}
/// <summary>
/// Rotates a single image by an arbitrary angle and preserves transparency in the output PNG.
/// </summary>
private static void RotateSingle(string inputPath, string outputPath, float angleDegrees, bool expandCanvas)
{
if (!File.Exists(inputPath))
throw new FileNotFoundException("Input image not found.", inputPath);
// If you expect large images or batches, you can enable disk cache to reduce RAM pressure:
// Aspose.Imaging.Cache.CacheType = Aspose.Imaging.Cache.CacheType.CacheOnDisk;
// Aspose.Imaging.Cache.CacheFolder = Path.GetFullPath(".imaging-cache");
// Aspose.Imaging.Cache.CacheSize = 512L * 1024 * 1024; // 512 MB
using (var image = Image.Load(inputPath))
{
// Raster operations are available on RasterImage
if (image is not RasterImage raster)
throw new InvalidOperationException("Loaded image is not a raster image.");
// Rotate by an arbitrary angle. Set expandCanvas to true to avoid clipping.
// Color.Transparent keeps the background transparent for alpha-capable formats.
raster.Rotate(angleDegrees, expandCanvas, Color.Transparent);
// Save as PNG to preserve alpha channel
var pngOptions = new PngOptions
{
// Most cases do not need explicit color type; leaving defaults preserves alpha.
// Uncomment if you want to force RGBA:
// ColorType = Aspose.Imaging.FileFormats.Png.PngColorType.TruecolorWithAlpha
};
// Ensure output directory exists
Directory.CreateDirectory(Path.GetDirectoryName(Path.GetFullPath(outputPath)) ?? ".");
raster.Save(outputPath, pngOptions);
}
}
/// <summary>
/// Rotates all supported images in a folder and writes PNG outputs with transparency preserved.
/// </summary>
private static void BatchRotate(string inputDir, string outputDir, float angleDegrees, bool expandCanvas)
{
if (!Directory.Exists(inputDir))
throw new DirectoryNotFoundException("Input directory not found: " + inputDir);
Directory.CreateDirectory(outputDir);
// Common raster extensions. Adjust as needed.
var extensions = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
{
".png", ".jpg", ".jpeg", ".bmp", ".gif", ".tif", ".tiff", ".webp"
};
var files = Directory.GetFiles(inputDir, "*.*", SearchOption.AllDirectories);
foreach (var file in files)
{
var ext = Path.GetExtension(file);
if (!extensions.Contains(ext))
continue;
var rel = Path.GetRelativePath(inputDir, file);
var relBase = Path.ChangeExtension(rel, ".png"); // output is PNG to keep transparency
var outPath = Path.Combine(outputDir, relBase);
Directory.CreateDirectory(Path.GetDirectoryName(Path.GetFullPath(outPath)) ?? ".");
try
{
RotateSingle(file, outPath, angleDegrees, expandCanvas);
Console.WriteLine($"OK {rel} -> {relBase}");
}
catch (Exception ex)
{
Console.WriteLine($"ERR {rel}: {ex.Message}");
}
}
}
}
}
Miten se toimii *
Image.Load
avaa lähteen. koodi tarkistaa ja laittaaRasterImage
Rasterin toimintaa varten.raster.Rotate(angle, expandCanvas, Color.Transparent)
Kääntyy mihin tahansa arvoon.- säästää yhdessä
PngOptions
säilyttää läpinäkyvyys. - Batch-tilassa kulkee direktiivivuu, kiertää tuettuja muotoja ja kirjoittaa PNG:itä.
Vaiheittainen opas
1) Lataa kuva
Käytä Image.Load
avaa lähteen tiedoston. Cast to RasterImage
jos tarvitset raster-erityisiä jäseniä.
using (var image = (RasterImage)Image.Load(inputPath))
{
// work with the image here
}
2) Kiertää mihin tahansa kulmaan
Soittaminen Rotate(angle, expandCanvas, backgroundColor)
.
angle
Se on astettaexpandCanvas = true
Välttää kiertämistä uudelleen kiinnittämällä kanvoja pyöriin rajoihinColor.Transparent
Pidä tausta läpinäkyvä, jos lähtömuoto tukee alfa
image.Rotate(17, true, Color.Transparent);
3) Tallenna muodossa, joka tukee avoimuutta
PNG tukee avoimuutta. Käytä PngOptions
säästää kierrätettyä tuotantoa alfa-kanavalla säilytettynä.
image.Save(outputPath, new PngOptions());
Käytännön vaihtoehtoja
- Välttää klippiä*: set
expandCanvas = true
kun kierretään ei-oikealla nurmalla
- Välttää klippiä*: set
- Opaque taustat: pass a solid
Color
Sen sijaan ettäColor.Transparent
Jos haluat täynnä taustaa - Hävittämätön tuotto: mieluummin PNG: n käyttöliittymien, logojen ja ylityöpaikkojen osalta, jotka tarvitsevat krisp-piirejä ja läpinäkyvyyttä
- Photography: jos et tarvitse läpinäkyvyyttä, säästää JPEG voi vähentää tiedoston koon
Yhteiset pitfallit ja korjaukset
- Läpinäkyvä tausta kadonnut*Pelastaa yhdessä
PngOptions
tai muu alfa-tuki. JPEG ei tue läpinäkyvyyttä.
- Läpinäkyvä tausta kadonnut*Pelastaa yhdessä
- Kuvan osat puuttuvat kääntymisen jälkeen*Käytä
expandCanvas = true
kasvaa kanavia niin, että kierrätetty sisältö sopii.
- Kuvan osat puuttuvat kääntymisen jälkeen*Käytä
- Jäähdytetyt reunat pyörimisen jälkeen*Jos lähde on alhainen resoluutio, harkitse kierrätystä uudelleen korkeammalle resoluutiolle ennen kierrosta, ja laske sen jälkeen säästää vähentää näkyviä esineitä.
- muisti ja suuret kuvat*Aseta kuvat nopeasti ja vältä ladata useita suuria tiedostoja kerralla.
Mini tarkastuslistat
- Lataa kanssa
Image.Load
- Pyöräämme kanssa
image.Rotate(angle, true, Color.Transparent)
- Pelastaa yhdessä
new PngOptions()
Läpinäkyvyydestä - Käytä kiinteää taustaa, jos läpinäkyvyyttä ei tarvita
- Validoi tuottoa visuaalisesti avainvaroille
FAQ
Mikä muodot säilyttävät läpinäkyvyyden kääntymisen jälkeenPNG ja muut alfa-tapaavat muodot. JPEG ei säilytä läpinäkyvyyttä.
Kuinka pyörittää ilman laajentumistaPass expandCanvas = false
Sisältö alkuperäisten rajojen ulkopuolella tallennetaan.
- Voin kääntää mihin tahansa kulmaan*Kyllä. kulman parametri hyväksyy minkä tahansa numerisen asteen arvon.
More in this category
- Animoitujen GIF:ien optimointi .NET:ssä käyttämällä Aspose.Imaging
- Optimoi monivuotiset TIFF:t arkistointiin .NET: ssä Asposella
- E-kaupankäynnin alustojen tuotekuvia käyttämällä Aspose.Imaging for .NET
- HEIC JPEG/PNG muuntaminen Aspose.Imaging for .NET
- Korkean resoluution kuvien optimointi mobiilille ja webille .NET: ssä