×
Namespaces

Variants
Actions
(Difference between revisions)

Instagram Earlybird Filter Recipe - Mk1 (Nokia Imaging SDK)

From Nokia Developer Wiki
Jump to: navigation, search
hamishwillee (Talk | contribs)
m (Hamishwillee - - License)
hamishwillee (Talk | contribs)
m (Hamishwillee -)
Line 1: Line 1:
[[Category:Nokia Imaging SDK Filter Recipes]]
+
[[Category:Nokia Imaging SDK Filter Recipes]][[Category:Nokia Imaging SDK Filter Recipes]]
[[Category:Nokia Imaging SDK Filter Recipes]]
+
 
{{Abstract|This recipe replicates [http://instagram.com/ Instagram]'s ''Earlybird'' Filter using Nokia Imaging SDK inbuilt filters. }}
 
{{Abstract|This recipe replicates [http://instagram.com/ Instagram]'s ''Earlybird'' Filter using Nokia Imaging SDK inbuilt filters. }}
 
{{SeeAlso|
 
{{SeeAlso|
Line 161: Line 160:
  
 
File:Shoe_ImageOriginal.jpg|Original
 
File:Shoe_ImageOriginal.jpg|Original
File:Shoe_Earlybird_Instagram.jpg|Instagram
+
File:Shoe_EarlyBird_Instagram.jpg|Instagram
File:Shoe_Earlybird_RecipeMk1.jpg|Recipe
+
File:Shoe_EarlyBird_FilterGroup.jpg|Recipe
  
 
File:Football_ImageOriginal.jpg|Original
 
File:Football_ImageOriginal.jpg|Original

Revision as of 11:19, 28 February 2014

This recipe replicates Instagram's Earlybird Filter using Nokia Imaging SDK inbuilt filters.

See Also
Article Metadata
Tested with
SDK: Windows Phone 8.0 SDK
Devices(s): Nokia Lumia 1020
Dependencies: Nokia Imaging SDK 1.0
Article
Created: hamishwillee (28 Feb 2014)
Last edited: hamishwillee (28 Feb 2014)

Contents

Introduction

The Instagram Earlybird filter gives images a retro feel with soft faded colours and a hint of yellow. This filter is used in about 8.3% of all photos shared on Instagram (source /filterfakers.com).

The recipe in this article shows how to recreate Earlybird by combining some of the 50+ inbuilt filters from the Nokia Imaging SDK.

The article includes the recipe source code, instructions on how it can be used and tested, performance measurements and a gallery.


Source code

The code for creating the effect, the source, renderer and target is described in #How to use the filter and Core concepts (Nokia Developer Library). The fragment below shows only the "recipe-specific" code for adding the filters to the List<IFilter>.

Warning.pngWarning: The code below uses a Rect based on the image size (_frameSize) to define the vignetting region. Depending on the architecture of your app this may be available directly where you're defining the filter, or indirectly from the source. This is discussed further in #How to use the filter.

var filters = new List<IFilter>();
// Instagram Earlybird 
filters.Add(new ColorAdjustFilter(-0.012, +0.04, -0.161)); //Add more green
filters.Add(new HueSaturationFilter(0, -0.3)); //Decrease saturation
 
//Adjust red curve
Curve curve_red = new Curve(CurveInterpolation.Linear);
curve_red.SetPoint(0, 25);
filters.Add(new CurvesFilter(curve_red, new Curve(CurveInterpolation.Linear), new Curve(CurveInterpolation.Linear)));
 
filters.Add(new ContrastFilter(0.35)); //Increase contrast
 
//Vignetting
Color black;
black.R = 0;
black.G = 0;
black.B = 0;
 
// NOTE: How _frameSize obtained depends on the architecture
Rect region = new Rect();
region.X = 0.0375 * App._frameSize.Width;
region.Y = 0.0375 * App._frameSize.Height;
region.Width = App._frameSize.Width - (2 * region.X);
region.Height = App._frameSize.Height - 2 * region.Y;
 
filters.Add(new VignettingFilter(0.55, black, region));

How to use the filter

This recipe uses only filters based on IFilter. These are combined by simply adding them to an IFilter list, which is then passed to a FilterEffect along with the source. The code fragment below shows the general strategy (this is explained in more detail in Nokia Developer SDK - Core concepts).

var filters = new List<IFilter>();
//The recipe filters are added here
...
...
 
using (var source = new StreamImageSource(stream))
using (var filterEffect = new FilterEffect(source) { Filters = filters })
using (var renderer = new WriteableBitmapRenderer(filterEffect, writeableBitmap))
{
await renderer.RenderAsync();
}

The recipe uses a Rect based on the image size (_frameSize) to define the vignetting region. In the code fragment above we have access to the source as a StreamImage, and so can get the ImageSize using the following asynchronous function call:

//Get image size from stream to use in vignetting. Note is asynchronous call.
ImageProviderInfo imageInformation = await StreamImage.GetInfoAsync();
Size _frameSize = imageInformation.ImageSize;

Depending on the application architecture it may be possible to get hold of frames directly. It is also possible to define vignetting without a region, and this might be an area for further exploration.


Testing the filter

The easiest way to test the recipes is to add them to the Test Apps for Viewing Custom Filters (Nokia Imaging SDK) (a fork of the Real Time Filter Demo).

The first step is simply to add the filter source above to both RealtimeFilterDemo and StaticFilterViewer test apps in their respective switch statements.


For the RealtimeFilterDemo

After adding the recipe, open NokiaImagingSDKEffects.cs and add the following private member to class NokiaImagingSDKEffects to hold the frame size.

private Size _frameSize;

Then in method GetNewFrameAndApplyEffect, assign this value to the frameSize passed in:

public async Task GetNewFrameAndApplyEffect(IBuffer frameBuffer, Size frameSize)
{
_frameSize = frameSize;

_frameSize is then available to the recipe.


For the StaticFilterViewer:

Add the following lines at the top of the recipe to get the frame size from the image source (in StaticCustomEffects.cs, Initialize() method):

ImageProviderInfo imageinfor = await StreamImage.GetInfoAsync();
Size _frameSize = imageinfor.ImageSize;

Note that the method is uses wait, so you will also need to update Initialize() and the methods that call it to be async (PreviousEffect()and NextEffect() )


License

The code has been released with the standard MIT License.

Performance

This section lists the approximate frame rate range (in frames-per-second) obtained by using the recipe in the Test framework.

Device FPS (Frames Per Second)
Lumia 1020  ?-? FPS
- -

Gallery

136 page views in the last 30 days.
×