Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mirzaevolution/ThumbnailSharp
A simple but awesome library to create a flexibel thumbnail from an image for .NET Framework 4.5+
https://github.com/mirzaevolution/ThumbnailSharp
thumbnail
Last synced: 2 months ago
JSON representation
A simple but awesome library to create a flexibel thumbnail from an image for .NET Framework 4.5+
- Host: GitHub
- URL: https://github.com/mirzaevolution/ThumbnailSharp
- Owner: mirzaevolution
- License: mit
- Created: 2017-11-06T05:56:13.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-01-07T19:35:53.000Z (about 1 year ago)
- Last Synced: 2024-10-11T01:07:43.349Z (3 months ago)
- Topics: thumbnail
- Language: C#
- Homepage:
- Size: 38.1 KB
- Stars: 28
- Watchers: 4
- Forks: 16
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ThumbnailSharp
A specialized library to create an image thumbnail from various sources with better result and supports different image formats. A Thumbnail is something that's not very important sometimes, but for softwares/web apps that require a thumbnail to be uploaded to their databases to be used later becomes so vital. And if we just need to create a simple thumbnail, why do we need a big image composition library that holds unnecessary methods for us? Here, we introduce a simple but powerful library for creating a nice thumbnail either from local or internet (supports async/await) that produces better result than **Image.GetThumbnailImage Method** from **System.Drawing.dll**. You can consume the result of operation either as an array of bytes or a stream.
Here are some samples:
**Original Image (Landscape)**
**Thumbnail (Jpeg)**
*size is set to 250*
*size is set to 450*
**Original Image (Portrait)**
**Thumbnail (Jpeg)**
*size is set to 250*
*size is set to 450*
**Original Image (Square/Proportional)**
**Thumbnail (Jpeg)**
*size is set to 250*
How does it work?
Simple, you just need to pass thumbnail size (aspect ratio will be reserved), image source, and image format.
**Get thumbnail from internet source**
```csharp
byte[] resultBytes = await new ThumbnailCreator().CreateThumbnailBytesAsync(
thumbnailSize: 250,
urlAddress: new Uri("http://www.sample-image.com/image.jpg",UriKind.Absolute),
imageFormat: Format.Jpeg
);
// or
Stream resultStream = await new ThumbnailCreator().CreateThumbnailStreamAsync(
thumbnailSize: 250,
urlAddress: new Uri("http://www.sample-image.com/image.png",UriKind.Absolute),
imageFormat: Format.Png
);
```
**Get thumbnail from local source**
```csharp
byte[] resultBytes = new ThumbnailCreator().CreateThumbnailBytes(
thumbnailSize: 300,
imageFileLocation: @"C:\images\image.bmp",
imageFormat: Format.Bmp
);
//or
Stream resultStream = new ThumbnailCreator().CreateThumbnailStream(
thumbnailSize: 300,
imageFileLocation: @"C:\images\image.bmp",
imageFormat: Format.Bmp
);
```
**Get thumbnail from image stream**
```csharp
byte[] resultBytes = new ThumbnailCreator().CreateThumbnailBytes(
thumbnailSize: 300,
imageStream: new FileStream(@"C:\images\image.jpg",FileMode.Open,FileAccess.ReadWrite),
imageFormat: Format.Jpeg
);
//or
Stream resultStream = new ThumbnailCreator().CreateThumbnailStream(
thumbnailSize: 300,
imageStream: new FileStream(@"C:\images\image.jpg",FileMode.Open,FileAccess.ReadWrite),
imageFormat: Format.Jpeg
);
```
**Get thumbnail from image bytes**
```csharp
byte[] buffer = GetImageBytes(); //this is just fictitious method to get image data in bytes
byte[] resultBytes = new ThumbnailCreator().CreateThumbnailBytes(
thumbnailSize: 300,
imageBytes: buffer,
imageFormat: Format.Gif
);
//or
Stream resultStream = new ThumbnailCreator().CreateThumbnailStream(
thumbnailSize: 300,
imageBytes: buffer,
imageFormat: Format.Tiff
);
```
**Take a look our softwares that were built using this library:**
### [ThumbnailSharp.Clients](https://github.com/mirzaevolution/ThumbnailSharp.Client)
---
Ready to taste it?
#### Install from [Nuget.Org](https://www.nuget.org/packages/ThumbnailSharp/1.0.0)
```
Install-Package ThumbnailSharp -Version 1.0.0
```
---
Created by: **[Mirza Ghulam Rasyid](https://twitter.com/mirzaevolution)**