displaycontours.h File Reference

Display contours detected by mosaiced contour stencils as EPS. More...

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
int	DisplayContours (const float *Image, int Width, int Height, int RedX, int RedY, const char *OutputFile)
	Display orientations estimated by mosaiced contour stencils. More...

Detailed Description

Display contours detected by mosaiced contour stencils as EPS.

Author

Pascal Getreuer getre.nosp@m.uer@.nosp@m.gmail.nosp@m..com

Copyright (c) 2010-2011, Pascal Getreuer All rights reserved.

This program is free software: you can use, modify and/or redistribute it under the terms of the simplified BSD License. You should have received a copy of this license along this program. If not, see http://www.opensource.org/licenses/bsd-license.html.

Definition in file displaycontours.h.

Function Documentation

int DisplayContours	(	const float *	Image,
		int	Width,
		int	Height,
		int	RedX,
		int	RedY,
		const char *	OutputFile
	)

Display orientations estimated by mosaiced contour stencils.

Parameters

Image	the input RGB image in planar row-major order
Width,Height	the image dimensions
RedX,RedY	the coordinates of the upper-leftmost red pixel
OutputFile	EPS file to write

Returns

1 on success, 0 on failure

Warning

For larger images (e.g., over 300x300), the output EPS file is very large. Some measures are taken for efficient encoding, but compression is not performed.

This routine writes an EPS file of Image superimposed with the orientations detected by mosaiced contour stencils at each pixel. This function is called when running the command line program with the -s option.

For visualization purposes, it is recommended to pass an image that has full color information rather than a mosaiced image (i.e., use the original image or a demosaiced image). The estimated contour orientations are the same regardless of whether the input is mosaiced.

Using the Ghostscript program, the EPS output (say, "contours.eps") can be converted to PDF as

gs -dSAFER -q -P- -dCompatibilityLevel=1.4 -dNOPAUSE -dBATCH \
    -sDEVICE=pdfwrite -sOutputFile=contours.pdf -c .setpdfwrite \
    -f contours.eps

Distiller commands are included within the EPS to preserve the bounding box. PDF conversion applies (lossless) deflate compression to the image data, which significantly decreases the file size.

Definition at line 59 of file displaycontours.c.