Free, open-source file converter. Convert 263 formats offline by drag & drop — images, PDF, Word, Excel, PowerPoint, HWP/HWPX, video, audio, e-books and archives. No upload, no Office needed.
C# audio-converteravaloniabatch-conversionconvertercsharpdocument-converterdocx-to-pdfdotnetdrag-and-dropfile-conversionfile-converterheic-converterhwphwpximage-converterlinuxmacospdf-convertervideo-converterwindows
// Raster image ↔ raster image conversion with ImageMagick (Magick.NET, Apache-2.0).
using Filee.Core.Conversion;
using Filee.Engines.Infrastructure;
using ImageMagick;
namespace Filee.Engines.Magick;
/// <summary>
/// Converts between PNG, JPG, WEBP, TIFF, BMP, GIF, ICO, AVIF, JPEG XL, JPEG 2000, PSD/PSB, TGA, PPM, APNG, MNG, QOI,
/// DDS, PCX, CUR, XPM, XBM, WBMP, PAM, PFM, SGI, Sun Raster and MIFF, and reads HEIC, XCF, camera RAW, DICOM,
/// Photo CD, OpenEXR, Radiance HDR, FITS and (on Windows) EMF/WMF.
/// </summary>
public sealed class MagickImageConverter : IConverter, ITiffMerger, IImageTransformer, IImageJoiner
{
public string Id => "magick";
public string DisplayName => "ImageMagick";
public int MaxParallelism => 0;
public bool Transforms(string from, string to) => true;
public IReadOnlyList<ConversionEdge> Edges { get; } =
(from source in ImageEncoder.Sources
from target in ImageEncoder.Writable
select ImageEncoder.Edge(source, target)).ToList();
public EngineStatus GetStatus() =>
EngineStatus.Available(MagickNET.ImageMagickVersion,
$"{EngineVersions.Library("Magick.NET", typeof(MagickImage))} · ImageMagick {ImageMagickNumber()}");
/// <summary>"7.1.2-5" out of "ImageMagick 7.1.2-5 Q8 x64 …".</summary>
private static string ImageMagickNumber() =>
MagickNET.ImageMagickVersion.Split(' ').FirstOrDefault(part => part.Length > 0 && char.IsAsciiDigit(part[0])) ?? "?";
/// <summary>
/// Writes the pages into one multi-page TIFF. Each page is flattened onto the preset's background (no alpha) at 8 bits
/// and marked as a page of a multi-page document (SubfileType 2), so older viewers (Microsoft Office Document
/// Imaging, fax software) show it page by page; compression is the preset's.
/// </summary>
public Task MergeAsync(IReadOnlyList<string> inputPaths, string outputPath, Filee.Core.Presets.ImageOptions options,
CancellationToken cancellationToken) =>
Task.Run(() =>
{
var compression = options.TiffCompression switch
{
Filee.Core.Presets.TiffCompression.Lzw => CompressionMethod.LZW,
Filee.Core.Presets.TiffCompression.Zip => CompressionMethod.Zip,
_ => CompressionMethod.NoCompression,
};
using var pages = new MagickImageCollection();
foreach (var path in inputPaths)
{
cancellationToken.ThrowIfCancellationRequested();
using var source = new MagickImageCollection(path);
foreach (var frame in source)
{
var page = frame.Clone();
page.BackgroundColor = new MagickColor(string.IsNullOrWhiteSpace(options.Background) ? "#FFFFFF" : options.Background);
page.Alpha(AlphaOption.Remove);
page.Depth = 8;
page.Settings.Compression = compression;
page.SetAttribute("tiff:subfiletype", "2");
pages.Add(page);
}
}
pages.Write(outputPath, MagickFormat.Tiff);
}, cancellationToken);
public bool CanRead(string format) => ImageEncoder.Sources.Contains(format);
public bool CanWrite(string format) => ImageEncoder.Writable.Contains(format);
/// <summary>"Merge images": the pictures one under another or side by side in one image (<see cref="ImageJoiner"/>).</summary>
public Task JoinAsync(IReadOnlyList<(string Path, string Format)> inputs, string outputPath, string format,
Filee.Core.Presets.ImageOptions options, IProgress<double>? progress, CancellationToken cancellationToken) =>
Task.Run(() => ImageJoiner.Join(inputs, outputPath, format, options, progress, cancellationToken), cancellationToken);
public Task<IReadOnlyList<string>> ConvertAsync(ConversionStep step, IProgress<double>? progress, CancellationToken cancellationToken) =>
Task.Run<IReadOnlyList<string>>(() =>
{
// FITS → TIFF keeps the file's depth (16 or 32 bits), which the Q8 build can't: Filee writes it.
if (step.From == "fits" && step.To == "tiff")
return FitsRendering.WriteTiff(step, progress, cancellationToken);
// Animated PNGs are often saved as .png: read them as APNG, so they stay animated as GIF or WebP.
var from = step.From == "png" && Apng.IsAnimated(step.InputPath) ? "apng" : step.From;
using var images = ImageReader.Read(step.InputPath, from, step.Preset);
return Write(images, from, step, progress, cancellationToken);
}, cancellationToken);
/// <summary>
/// The rest of a conversion once the picture is read (also for pictures another engine decoded, see
/// Wic/WicImageConverter): the frames kept for the target, the preset's options, the files.
/// </summary>
/// <param name="from">Format the frames were read from (animations and icons keep different frames).</param>
internal static IReadOnlyList<string> Write(MagickImageCollection images, string from, ConversionStep step,
IProgress<double>? progress, CancellationToken cancellationToken)
{
cancellationToken.ThrowIfCancellationRequested();
progress?.Report(0.3);
// A JPG has no transparent border to trim: re-encoding it would only cost a JPEG generation.
if (step.Preset.Image.TrimTransparent && !ImageEncoder.HoldsAlpha(step.To))
throw new ConversionRefusedException("error.no_transparency", step.To.ToUpperInvariant());
var animation = ImageEncoder.KeepsAnimation(from, step.To);
var frames = ImageEncoder.SelectFrames(images, from, step.To);
// Before the options: frames dropped for speed aren't resized for nothing.
if (animation && step.Preset.Image.ChangesSpeed)
frames = AnimationTiming.ChangeSpeed(frames, step.Preset.Image.PlaybackSpeed, step.To);
foreach (var frame in frames)
{
cancellationToken.ThrowIfCancellationRequested();
ImageEncoder.ApplyOptions(frame, step.Preset.Image, step.To);
// Animations aren't trimmed: each frame trimmed alone would shift. Trimming all frames to one box could be added.
if (step.Preset.Image.TrimTransparent && !(animation && frames.Count > 1))
ImageEncoder.TrimTransparentBorders(frame);
}
progress?.Report(0.7);
var written = ImageEncoder.Write(frames, step.To, step.Output, step.Preset.Image, step.InputPath, animation);
progress?.Report(1);
return written;
}
}