edge.h

Go to the documentation of this file.

/*
 * This work is licensed under a Creative Commons 
 * Attribution-Noncommercial-Share Alike 3.0 United States License.
 * 
 *    http://creativecommons.org/licenses/by-nc-sa/3.0/us/
 * 
 * You are free:
 * 
 *    to Share - to copy, distribute, display, and perform the work
 *    to Remix - to make derivative works
 * 
 * Under the following conditions:
 * 
 *    Attribution. You must attribute the work in the manner specified by the
 *    author or licensor (but not in any way that suggests that they endorse you
 *    or your use of the work).
 * 
 *    Noncommercial. You may not use this work for commercial purposes.
 * 
 *    Share Alike. If you alter, transform, or build upon this work, you may
 *    distribute the resulting work only under the same or similar license to
 *    this one.
 * 
 * For any reuse or distribution, you must make clear to others the license
 * terms of this work. The best way to do this is by including this header.
 * 
 * Any of the above conditions can be waived if you get permission from the
 * copyright holder.
 * 
 * Apart from the remix rights granted under this license, nothing in this
 * license impairs or restricts the author's moral rights.
 */


#ifndef EDGE_H 
#define EDGE_H 


#include <jwsc/config.h>

#include <stdlib.h>
#include <inttypes.h>

#include "jwsc/base/error.h"
#include "jwsc/image/image.h"
#include "jwsc/matrix/matrix.h"


#ifdef __cplusplus
namespace jwsc {
extern "C" {
#endif


typedef struct
{
    uint32_t col;

    uint32_t row;

    float dcol;

    float drow;

    float mag;
}
Edge_point_f;



typedef struct
{
    uint32_t num_rows;

    uint32_t num_cols;

    uint32_t num_edges;

    uint32_t total_num_pts;

    uint32_t* num_pts;

    Edge_point_f** pts;
}
Edge_set_f;




Error* detect_image_edge_set_f
(
    Edge_set_f**   edges_out,
    const Image_f* img,
    float          sigma, 
    float          begin_thresh, 
    float          end_thresh,
    uint32_t       padding
);

Error* DEPRECATED_detect_image_edge_set_f
(
    Edge_set_f**   r_edges_out,
    Edge_set_f**   g_edges_out,
    Edge_set_f**   b_edges_out,
    const Image_f* img,
    float          sigma, 
    float          begin_thresh, 
    float          end_thresh,
    uint32_t       padding
);

Error* detect_matrix_edge_set_f
(
    Edge_set_f**    edges_out,
    const Matrix_f* m,
    float           sigma, 
    float           begin_thresh, 
    float           end_thresh,
    uint32_t        padding
);

void free_edge_set_f(Edge_set_f* edges);

void remove_short_edges_f(Edge_set_f* edges, uint32_t min_len);

void break_edges_at_corners_f
(
    Edge_set_f* edges, 
    float       thresh, 
    uint32_t    num_avg
);

void sample_edge_set_f
(
    Edge_set_f**      edges_out, 
    const Edge_set_f* edges_in, 
    float             p
);

Error* color_edge_set_f
(
    Image_f**         img_out,
    const Image_f*    img_in,
    const Edge_set_f* edges, 
    const Pixel_f*    pxl
);

Error* randomly_color_edge_set_f
(
    Image_f**         img_out,
    const Image_f*    img_in,
    const Edge_set_f* edges
);

Error* color_edge_points_f
(
    Image_f**           img_out,
    const Image_f*      img_in,
    const Edge_point_f* pts, 
    uint32_t            num_pts,
    const Pixel_f*      pxl
);

Error* randomly_color_edge_points_f
(
    Image_f**           img_out,
    const Image_f*      img_in,
    const Edge_point_f* pts, 
    uint32_t            num_pts
);

Error* read_edge_set_f
(
    Edge_set_f** edges_out,
    const char*  fname
);

Error* write_edge_set_f
(
    const Edge_set_f* edges,
    const char*       fname
);

#ifdef __cplusplus
}
}
#endif


#endif