Boost C++ Libraries of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards


// Copyright 2005-2007 Adobe Systems Incorporated
// Distributed under the Boost Software License, Version 1.0
// See accompanying file LICENSE_1_0.txt or copy at

#include <boost/gil/extension/io/jpeg.hpp>

// Demonstrates how to compute gradients along the x-axis
// This example converts the input image to a greyscale view via color_converted_view,
// and then relies on the function static_transform to apply the operation halfdiff_cast_channels.
// The result is captured in a view, initially blacked out via a call to fill_pixels (defined in
// include/boost/gil/algorithm.hpp)
// static_transform is defined in include/boost/gil/color_based_algorithm.hpp and applies an operation
// to either a single source or two sources and a destination (as is the case here).
// In this example, the gradient is calculated as half the difference between the two pixels surrounding x
// in the loop in x_gradient.

using namespace boost::gil;

template <typename Out>
struct halfdiff_cast_channels {
    template <typename T> Out operator()(const T& in1, const T& in2) const {
        return Out((in2-in1)/2);

template <typename SrcView, typename DstView>
void x_gradient(SrcView const& src, DstView const& dst)
    using dst_channel_t = typename channel_type<DstView>::type;

    for (int y = 0; y < src.height(); ++y)
        typename SrcView::x_iterator src_it = src.row_begin(y);
        typename DstView::x_iterator dst_it = dst.row_begin(y);

        for (int x = 1; x < src.width() - 1; ++x)
            static_transform(src_it[x - 1], src_it[x + 1], dst_it[x],

template <typename SrcView, typename DstView>
void x_luminosity_gradient(SrcView const& src, DstView const& dst)
    using gray_pixel_t = pixel<typename channel_type<SrcView>::type, gray_layout_t>;
    x_gradient(color_converted_view<gray_pixel_t>(src), dst);

int main()
    rgb8_image_t img;
    read_image("test.jpg",img, jpeg_tag{});

    gray8s_image_t img_out(img.dimensions());

    x_luminosity_gradient(const_view(img), view(img_out));
    write_view("out-x_gradient.jpg",color_converted_view<gray8_pixel_t>(const_view(img_out)), jpeg_tag{});

    return 0;