Когато работите с обработка на изображения в .NET, една обща необходимост е да се сливат няколко снимки - често от различни размери - в един изход. Типични случаи на използване включват колажи, спиртни листа, контактни листове, или маркетингови банери. Този урок показва как да ги сливате с помощта на Aspose.Imaging за .Net с точен контрол над оформлението: оси (хоризонтална / вертикална), съгласуване (горната / центъра / долната и лявата / централната / дясната), външния падинг и пространството между снимките. Ние също ще покрием безопасен, cross-platform подход, който се основава на Aspose Graphics
на огъня.
Какво ще изградиш
- Разположение: * хоризонтално или вертикално
- Използване на: *
Горизонтално разпределение → вертикално сближаване:
Top
,Middle
,Bottom
Вертикално разпределение на хоризонталната ориентация:
Left
,Center
,Right
Паджиране: външен падинг и интер-имен пространство
- Назад: * Попълване на твърди цветове
Формати: натоварени смесени формати (JPG, PNG и т.н.), с изключение на ПНГ/JPEG
Пълният пример
using System;
using System.Collections.Generic;
using System.IO;
using Aspose.Imaging;
using Aspose.Imaging.ImageOptions;
namespace ImagingMergeDemo
{
public enum MergeAxis { Horizontal, Vertical }
public enum VAlign { Top, Middle, Bottom }
public enum HAlign { Left, Center, Right }
public static class ImageMerger
{
/// <summary>
/// Merges input images into a single image with alignment and padding.
/// </summary>
/// <param name="inputPaths">List of source image file paths.</param>
/// <param name="axis">Horizontal or Vertical stacking.</param>
/// <param name="outerPadding">Padding around the whole collage (in pixels).</param>
/// <param name="spacing">Spacing between images (in pixels).</param>
/// <param name="bgColor">Background color for the canvas.</param>
/// <param name="verticalAlign">Only used when axis == Horizontal (Top/Middle/Bottom inside the row).</param>
/// <param name="horizontalAlign">Only used when axis == Vertical (Left/Center/Right inside the column).</param>
/// <param name="outputPath">Destination file path. Extension determines encoder (e.g., .png, .jpg).</param>
public static void Merge(
IReadOnlyList<string> inputPaths,
MergeAxis axis,
int outerPadding,
int spacing,
Color bgColor,
VAlign verticalAlign,
HAlign horizontalAlign,
string outputPath)
{
if (inputPaths is null || inputPaths.Count == 0)
throw new ArgumentException("No input images provided.");
// Load all images first so we can compute canvas size.
var loaded = new List<Image>(inputPaths.Count);
try
{
foreach (var p in inputPaths)
{
var img = Image.Load(p);
loaded.Add(img);
}
// Compute canvas size.
// For horizontal axis: width = sum(widths) + spacings + 2*outerPadding
// height = max(heights) + 2*outerPadding
// For vertical axis: height = sum(heights) + spacings + 2*outerPadding
// width = max(widths) + 2*outerPadding
int totalWidth, totalHeight;
if (axis == MergeAxis.Horizontal)
{
int sumWidths = 0, maxH = 0;
for (int i = 0; i < loaded.Count; i++)
{
sumWidths += loaded[i].Width;
maxH = Math.Max(maxH, loaded[i].Height);
}
totalWidth = sumWidths + ((loaded.Count - 1) * spacing) + 2 * outerPadding;
totalHeight = maxH + 2 * outerPadding;
}
else
{
int sumHeights = 0, maxW = 0;
for (int i = 0; i < loaded.Count; i++)
{
sumHeights += loaded[i].Height;
maxW = Math.Max(maxW, loaded[i].Width);
}
totalHeight = sumHeights + ((loaded.Count - 1) * spacing) + 2 * outerPadding;
totalWidth = maxW + 2 * outerPadding;
}
// Create canvas (use PNG by default for lossless output; you can switch to JPEGOptions)
using var canvas = Image.Create(new PngOptions(), totalWidth, totalHeight);
// Draw on canvas
using var g = new Graphics(canvas);
g.Clear(bgColor);
int cursorX = outerPadding;
int cursorY = outerPadding;
for (int i = 0; i < loaded.Count; i++)
{
var img = loaded[i];
int drawX, drawY;
if (axis == MergeAxis.Horizontal)
{
// X flows left -> right
drawX = cursorX;
// Y depends on vertical alignment vs tallest height
drawY = verticalAlign switch
{
VAlign.Top => outerPadding,
VAlign.Middle => outerPadding + (totalHeight - 2 * outerPadding - img.Height) / 2,
VAlign.Bottom => outerPadding + (totalHeight - 2 * outerPadding - img.Height),
_ => outerPadding
};
// Draw and move X cursor
g.DrawImage(img, new Rectangle(drawX, drawY, img.Width, img.Height));
cursorX += img.Width + spacing;
}
else
{
// Y flows top -> bottom
drawY = cursorY;
// X depends on horizontal alignment vs widest width
drawX = horizontalAlign switch
{
HAlign.Left => outerPadding,
HAlign.Center => outerPadding + (totalWidth - 2 * outerPadding - img.Width) / 2,
HAlign.Right => outerPadding + (totalWidth - 2 * outerPadding - img.Width),
_ => outerPadding
};
// Draw and move Y cursor
g.DrawImage(img, new Rectangle(drawX, drawY, img.Width, img.Height));
cursorY += img.Height + spacing;
}
}
// Save with encoder that matches extension
SaveByExtension(canvas, outputPath);
}
finally
{
// Dispose loaded images
foreach (var img in loaded)
img.Dispose();
}
}
private static void SaveByExtension(Image image, string outputPath)
{
var ext = Path.GetExtension(outputPath).ToLowerInvariant();
ImageOptionsBase opts = ext switch
{
".jpg" or ".jpeg" => new JpegOptions { Quality = 90 },
".png" => new PngOptions(),
_ => new PngOptions() // default to PNG
};
image.Save(outputPath, opts);
}
}
// Example usage
public class Program
{
public static void Main()
{
var inputs = new List<string>
{
"image1.jpg",
"image2.png",
"image3.jpg"
};
// Horizontal strip, vertically centered, with padding/spacing
ImageMerger.Merge(
inputPaths: inputs,
axis: MergeAxis.Horizontal,
outerPadding: 20,
spacing: 10,
bgColor: Color.White,
verticalAlign: VAlign.Middle,
horizontalAlign: HAlign.Center, // ignored for horizontal axis
outputPath: "merged_horizontal.png"
);
// Vertical stack, horizontally right-aligned
ImageMerger.Merge(
inputPaths: inputs,
axis: MergeAxis.Vertical,
outerPadding: 20,
spacing: 12,
bgColor: Color.FromArgb(255, 245, 245, 245),
verticalAlign: VAlign.Middle, // ignored for vertical axis
horizontalAlign: HAlign.Right,
outputPath: "merged_vertical.jpg"
);
}
}
}
Стъпка по стъпка ръководство
Стъпка 1: Изтегляне на изображения
Изтеглете всички входящи изображения с Image.Load(path)
Дръжте ги живи, докато след рисуване, а след това изхвърлете.
Стъпка 2: Определете размера на изхода
- Хоризонтално оформление: ширина = сума от ширини + пространства + външна поддръжка; височина = максималната висина + вътрешната поддаване.
- ** Вертикално оформление**: височина = сумата на височините + пространства + външна поддръжка; ширина = максималната широчина + вътрешната поддаване.
Стъпка 3: Създаване на изходния канал
Създаване на използване Image.Create(new PngOptions(), width, height)
(или JpegOptions
ако предпочитате загубен изход). Чист с цвят на фона.
Стъпка 4: Конфигуриране на Alignment & Padding
- Горизонтално сливане → изчисляване Y чрез
Top / Middle / Bottom
. - Вертикално сливане → изчисляване X от
Left / Center / Right
. - Apply
outerPadding
иspacing
и последователно.
Стъпка 5: Направете всяка снимка
Използване Graphics.DrawImage(image, new Rectangle(x, y, image.Width, image.Height))
.
Стъпка 6: Спасете резултата
Изберете кода на базата на разширяването на името на изхода (например, .png
→ PngOptions
, .jpg
→ JpegOptions { Quality = … }
).
Най-добрите практики
- Нормализиране на формати: Ако имате нужда от прозрачни фонтани, спестете като PNG. За по-малки файлове без прозорливост, използвайте JPEG и Tune
Quality
. - Guardrails: Валидиране на списъка с вход, справяне с липсващите файлове и разглеждане на максималните измерения на канала, за да се избегне OOM.
- На разположение е:
Image
,Graphics
Използва се – използва сеusing
илиtry/finally
.
- На разположение е:
- ** Цветна консистенция**: Ако входът има смесени цветови типове, разчитайте на дефектите на Aspose или изрично конвертирайте, когато е необходимо.
- Batching: За големи комплекти, поточните изходи по време на пътуване или създаване на няколко табла/страници.
More in this category
- Оптимизиране на анимирани GIFs в .NET с помощта на Aspose.Imaging
- Оптимизиране на Multi-Page TIFFs за архивиране в .NET с Aspose
- HEIC към JPEG/PNG Конверсия с Aspose.Imaging за .NET
- Анимации, насочени към данни в .NET с Aspose.Imaging
- Без загуба и качествено дефинирана компресия на изображението в .NET с Aspose.Imaging