ImageMerger class

Pure-Dart image merging (vertical/horizontal stitching) — reachable as PixelCompressor.merge. Unlike every other concern on the facade, this does no native platform-channel work: it's dart:ui Canvas drawing entirely on the Dart side, and only ever produces PNG bytes (dart:ui has no built-in JPEG/WebP/HEIC encoder). To get another format or hit a target file size, pipe the PNG through PixelCompressor.image.compress:

final merged = await PixelCompressor.merge.combine(sources);
final jpeg = await PixelCompressor.image.compress(
  MediaSource.file(merged.outputFile),
  options: const ImageCompressOptions(
    format: ImageFormat.jpeg,
    targetSizeBytes: 500 * 1024,
  ),
);

Constructors

ImageMerger.internal()

Properties

hashCode → int

The hash code for this object.

no setter, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

combine(List<MediaSource> inputs, {MergeOptions options = const MergeOptions()}) → Future<MergeResult>

Decodes every source in inputs, stitches them per options, and writes the result to options.outputPath (or a temp file). Requires at least 2 sources.

decode(MediaSource source) → Future<Image>

Decodes one source into a dart:ui ui.Image — the same decode path combine uses internally, exposed so a live MergeView preview shares identical PixelCompressorException handling with the headless path. The caller owns the returned image and must call .dispose() on it when done.

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited