dnn-imageflow

Imageflow image processing and optimizing http module for DNN

It use Imazen Imageflow.NET wrapper for Imageflow, the image processing library for servers.

It is upgrade for very successful dnn-imazen-imageresizer commonly used with 2sxc revolutionizing content management module on DNN. Older brother is based on classic Imageresizer while Imageflow is next-generation product.

It is similar to oqt-imageflow for Oqtane and Imageflow.NET Server a super-fast image server for ASP.NET Core.

Installation

1. Please install DNN 9.6.1+.
2. Download latest ToSic.Imageflow.Dnn_NN.NN.NN_Install.zip from dnn-imageflow releases .
3. Install ToSic.Imageflow.Dnn_NN.NN.NN_Install.zip dnn extension as usually.
4. More DNN info...

Note

1. As part of dnn extension installation it will automatically unregister older ImageResizer http module in web.config.

Usage

Simply store files with images in DNN website (as any other, normal, unrestricted image, eg /Portals/0/Images/img.jpg).

In image link use Querystring API for image manipulation, like is:

• automatically crop away whitespace
• sharpen
• fix white balance
• adjust contrast/saturation/brightness
• rotate & flip images
• crop
• resize & constrain
• produce highly optimized jpeg or webp images to reduce download times
• more

Examples

<img src="img.jpg?w=50" />
<img src="img.jpg?width=100&amp;height=100&amp;mode=max&amp;scale=down" />
<img src="img.jpg?w=300&amp;h=300&amp;mode=crop&amp;scale=both" />
<img src="img.jpg?format=webp" />
<img src="img.jpg?s.grayscale=true" />
<img src="img.jpg?s.grayscale=ry" />
<img src="img.jpg?s.grayscale=bt709" />
<img src="img.jpg?s.grayscale=flat" />
<img src="img.jpg?s.sepia=true" />
<img src="img.jpg?s.invert=true" />
<img src="img.jpg?s.alpha=0.25" />
<img src="img.jpg?s.contrast=-0.80" />
<img src="img.jpg?s.brightness=0.5" />
<img src="img.jpg?s.saturation=-0.5" />

Caching

• High performance Imazen.HybridCache (in-memory persisted database for tracking filenames with files used for bytes) is enabled by default with persistance in App_Data\imageflow_hybrid_cache\.

Roadmap

• watermarks
• presets
• extensionless paths
• mapped paths
• command defaults
• ...

Setup DEV ENV

1. Git clone this repo.
2. In VS open ToSic.Imageflow.Dnn solution.
3. Set Release configuration in configuration manager.
4. Build Solution
5. If all is OK, in \InstallPackages you should find DNN Library extension packages (to install Imageflow on other DNN installations):
   1. ToSic.Imageflow.Dnn_NN.NN.NN_Install.zip
   2. ToSic.Imageflow.Dnn_NN.NN.NN_Symbols.zip

References

• DotNetNuke.Web (>= 9.6.1)

Included dependencies (.NETStandard 2.0/.NET Framework v4.7.2)

• Imageflow.NativeRuntime.win-x86 (2.0.0-preview8)
• Imageflow.NativeRuntime.win-x86_64 (2.0.0-preview8)
• Imageflow.Net 0.10.2
• Imazen.HybridCache 0.8.3
• Imazen.Common (>= 0.8.3)
• Microsoft.CSharp (>= 4.7.0)
• Microsoft.Extensions.Configuration.Abstractions (2.2.0)
• Microsoft.Extensions.DependencyInjection.Abstractions (2.2.0)
• Microsoft.Extensions.DependencyInjection (2.2.0)
• Microsoft.Extensions.FileProviders.Abstractions (2.2.0)
• Microsoft.Extensions.Hosting.Abstractions (>= 2.2.0)
• Microsoft.Extensions.Logging.Abstractions (2.2.0)
• Microsoft.Extensions.Primitives (2.2.0)
• Microsoft.IO.RecyclableMemoryStream (>= 1.2.2 && < 3.0.0)
• Newtonsoft.Json (>= 13.0.3 && < 14.0.0) -> DNN 9.6.1
• System.Buffers (>= 4.5.1)
• System.Memory (>= 4.5.5)
• System.Numerics.Vectors (>= 4.5.0)
• System.Runtime.CompilerServices.Unsafe (>= 4.5.3)

Places with version number

• Properties/AssemblyInfo.cs, bump version on 2 places
• ToSic.Imageflow.Dnn.dnn, bump version in package
• ToSic.Imageflow.Dnn_Symbols.dnn, bump version on 2 places: package, dependency
• releasenotes.txt, bump version in one place