lettucebo / ci.image

創鈺共用類別庫系列

Creatidea.Library.Images

創鈺共用類別庫系列

Requirements

this library requires .NET 4.5 and above.

Installation

You can either download the source and build your own dll or, if you have the NuGet package manager installed, you can grab them automatically.

PM> Install-Package Creatidea.Library.Images

Once you have the libraries properly referenced in your project, you can include calls to them in your code. For a sample implementation, check the Example folder.

Add the following namespaces to use the library:

using System.Drawing;

Functions

• Thumb Image
• Text To Image

How to: Thumb Image

Getting Started

CiImage is a static calss, so no need to new an instance, just call it. The return type is CiResult<Image>, call CiResult<Image>.Data for Image object.

Thumb is common use in most of scenario, here provide a simple way to accomplish this goal. Combine CiConfig and CiResult for better user experience.

CiImage provide various method to thumb the image, include using CiConfig to get size setting or just given size to method through parameter

Setting CiConfig

If you install this package by nuget, then CiConfig is all set. Just need to modify the Size or FitSize property to what you want. CiImage.json

{
    "CiImage": {
        "Version": "1.0.2",
        "Size": 300,
        "FitSize" : "500,500"
    }
}

Thumb Image using CiConfig Value

The following example demonstrates how to thumb an image using the easiest way:

var result1 = CiImage.Thumb(path);
if (!result1.Success)
{
    Console.WriteLine("發生錯誤：{0}", result1.Message);
}
else
{
    var link = SaveImage(result1.Data, ImageFormat.Jpeg);
    Console.WriteLine("Show result1: {0}", link);
}

• This method use CiConfig to read size config, first look for "Size", if not exist then find for "FitSize".
• If Size is found, then it will stop to find FitSize and use Size for size setting.
• Use Size will maintain image ratio，FitSize will not maintain image ratio.

Thumb Image by Given Specific Parameter #1

The following example demonstrates how to thumb an image:

var result2 = CiImage.Thumb(path, 300);
if (!result2.Success)
{
    Console.WriteLine("發生錯誤：{0}", result2.Message);
}
else
{
    var link = SaveImage(result2.Data, ImageFormat.Jpeg);
    Console.WriteLine("Show result2: {0}", link);
}

• This method use given size(integer) to thumb image and thumbnail will maintain image ratio

Thumb Image By Given Specific Parameter #2

The following example demonstrates how to thumb an image:

Size size = new Size(500, 500);
// will maintain image ratio
var result3 = CiImage.Thumb(path, size);

// will not maintain image ratio
var result31 = CiImage.Thumb(path, size, false);

if (!result3.Success)
{
    Console.WriteLine("發生錯誤：{0}", result3.Message);
}
else
{
    var link = SaveImage(result3.Data, ImageFormat.Jpeg);
    Console.WriteLine("Show result3: {0}", link);
}

• This method use given size to thumb image
• If set to maintain image ratio, it will auto find the largest edge and thumb image to the given size and the shorter edge will auto short according image raito

Thumb Image And Set Thumb Quality

All thumb method can assign wanted thumb image quality. The following example demonstrates how to set thumb image quality:

var result4 = CiImage.Thumb(path, ThumbQuality.Best);
if (!result4.Success)
{
    Console.WriteLine("發生錯誤：{0}", result4.Message);
}
else
{
    var link = SaveImage(result4.Data, ImageFormat.Jpeg);
    Console.WriteLine("Show result4: {0}", link);
}

How to: Text to Image