Copyright (C) 2016, Antoni Buades <toni.buades@uib.es>
                    Jose-Luis Lisani <joseluis.lisani@uib.es>

February 10th, 2016

-----------------
Brief description
-----------------

This codes implements the cartoon+texture decomposition using the
algorithm published in IPOL (www.ipol.im).
The method is also linked to the following publication
A. Buades, J.L. Lisani, “Directional filters for color cartoon + texture 
image and video decomposition”, Journal of Mathematical Imaging and Vision, 2015


===============================================================================
== Licence =================================================

This program is free software: you can use, modify and/or
redistribute it under the terms of the GNU General Public
License as published by the Free Software Foundation, either
version 3 of the License, or (at your option) any later
version. You should have received a copy of this license along
this program. If not, see <http://www.gnu.org/licenses/>.

===============================================================================
====== List of files ==========================================================


The main functions are implemented in
src_cartoon_plus_texture_newdirectional.cpp (Main program)
library/libCartoon.cpp
library/libCartoon.h

Auxiliary functions are implemented in
library/libBasic.cpp
library/libBasic.h
library/libImage.cpp
library/libImage.h
library/libImageFormatPM.cpp
library/libImageFormatPM.h
library/libImageFormats.c
library/libImageFormats.h

Makefile for compilation:
makefile

README.txt (this file)

Test image:
test.png


===============================================================================
== Compilation (Linux) ========================================================

To compile

Type

make

in the directory where the makefile is located.


For parallel execution using OMP directives (much faster, recommended):

make OMP=1



===============================================================================
== Example of use =======================================================

Get cartoon+texture decomposition of test image with scale factor 2
and adding isotropic filter (flag -i) to the bank of filters:

src_cartoon_plus_texture_newdirectional -i test.png cartoon.png texture.png 2


Accepted image formats: PNG, JPEG, TIFF