surface.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 SURFACE_H 
#define SURFACE_H 


#include <jwsc/config.h>

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

#include "jwsc/base/error.h"
#include "jwsc/vector/vector.h"
#include "jwsc/imgblock/imgblock.h"
#include "jwsc/matblock/matblock.h"


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


typedef struct
{
    uint32_t col;

    uint32_t row;

    uint32_t mat;

    float dcol;

    float drow;

    float dmat;

    float intensity;
}
Surface_point_f;




typedef struct
{
    Vector_f* pts[4];

    Vector_f* normal;

    Vector_f* center;

    float albedo;
}
Surface_patch_f;


Error* detect_imgblock_surface_points_f
(
    Surface_point_f** r_pts_out,
    uint32_t*         num_r_pts_out,
    Surface_point_f** g_pts_out,
    uint32_t*         num_g_pts_out,
    Surface_point_f** b_pts_out,
    uint32_t*         num_b_pts_out,
    const Imgblock_f* img,
    float             sigma, 
    float             grad_img_weight,
    float             grad_row_weight,
    float             grad_col_weight,
    float             begin_thresh, 
    float             end_thresh
);

Error* detect_matblock_surface_points_f
(
    Surface_point_f** pts_out,
    uint32_t*         num_pts_out,
    const Matblock_f* m,
    float             sigma, 
    float             grad_mat_weight,
    float             grad_row_weight,
    float             grad_col_weight,
    float             begin_thresh, 
    float             end_thresh
);

void sample_surface_points_f
(
    Surface_point_f**      pts_out, 
    uint32_t*              num_pts_out,
    const Surface_point_f* pts_in, 
    uint32_t               num_pts_in,
    float                  p
);

void color_surface_points_f
(
    Imgblock_f**           img_out,
    const Imgblock_f*      img_in,
    const Surface_point_f* pts, 
    uint32_t               num_pts,
    const Pixel_f*         pxl
);

Error* read_surface_points_f
(
    Surface_point_f** pts_out,
    uint32_t*         num_pts_out,
    const char*       fname
);

Error* write_surface_points_f
(
    const Surface_point_f* pts,
    uint32_t               num_pts,
    const char*            fname
);

void create_surface_patch_f
(
    Surface_patch_f**      patch_out,
    const Surface_point_f* point,
    float                  size,
    float                  x_scale,
    float                  y_scale,
    float                  z_scale
);

void free_surface_patch_f(Surface_patch_f* patch);

#ifdef __cplusplus
}
}
#endif


#endif