lcms2-dotnet 2.19.1

lcms2-dotnet

lcms2-dotnet are .NET bindings for lcms2.

Usage

using Lcms2;

using var srgb = IccProfile.CreateSrgb();
using var display = IccProfile.Open("/usr/share/color/icc/display.icc");

using var transform = ColorTransform.Create(
    srgb, PixelFormat.Rgb8,
    display, PixelFormat.Rgb8,
    RenderingIntent.Perceptual,
    TransformFlags.BlackPointCompensation);

transform.Transform<byte, byte>(source, destination, pixelCount);

using var profile = IccProfile.FromStream(File.OpenRead("input.icc"));

Console.WriteLine(profile.Description);
Console.WriteLine($"{profile.ColorSpace} → {profile.ProfileConnectionSpace}, v{profile.Version}");

foreach (var tag in profile.GetTagSignatures())
{
    Console.WriteLine(tag);
}

var whitePoint = profile.ReadXyz(Lcms2.Native.cmsTagSignature.cmsSigMediaWhitePointTag);
var redTrc = profile.ReadToneCurve(Lcms2.Native.cmsTagSignature.cmsSigRedTRCTag);

using var gamma = ToneCurve.BuildGamma(2.2);
ColorMath.TryGetWhitePointFromTemperature(6504, out var d65);

using var profile = IccProfile.CreateRgb(d65, primaries, [gamma, gamma, gamma]);
using var description = Mlu.Create("My RGB space", "en", "US");
profile.WriteTag(cmsTagSignature.cmsSigProfileDescriptionTag, description);
profile.ComputeProfileId();
profile.SaveToFile("my-space.icc");

var format = PixelFormat.Create(PixelType.Cmyk, channels: 4, bytesPerChannel: 2, minIsWhite: true);
Console.WriteLine($"{format.BytesPerPixel} bytes/pixel, planar: {format.IsPlanar}");

PixelFormat anyOther = Lcms2.Native.Liblcms2.TYPE_ABGR_16_SE;  // every constant converts implicitly

using var context = Lcms2Context.Create();
context.AdaptationState = 0.0;
context.SetAlarmCodes([0xFFFF, 0, 0xFFFF]);

using var profile = IccProfile.CreateSrgb(context);

try
{
    using var profile = IccProfile.Open("broken.icc");
}
catch (Lcms2Exception ex)
{
    Console.WriteLine($"{ex.ErrorCode}: {ex.NativeMessage}");
}

Lcms2Log.MessageLogged += (_, e) => Console.WriteLine($"[lcms2] {e.ErrorCode}: {e.Message}");

using Lcms2.Native;

unsafe
{
    var profile = Liblcms2.cmsCreate_sRGBProfile();
    var space = Liblcms2.cmsGetColorSpace(profile);
    Liblcms2.cmsCloseProfile(profile);
}

Testing

dotnet test

Samples

dotnet run --project samples/Lcms2.NET.ProfileInfoSample -- [profile.icc]
dotnet run --project samples/Lcms2.NET.TransformSample -- [in.ppm out.ppm src.icc dst.icc]
dotnet run --project samples/Lcms2.NET.NamedColorSample -- [press.icc]

Regenerating the bindings

git submodule update --init
dotnet tool restore
sh eng/generate.sh

Requires a system clang for its builtin-header resource directory.