Difference between revisions of "User:Level zero/GSOC13/api"

From BRL-CAD
(API CALLS)
(API CALLS)
 
Line 8: Line 8:
 
*''img_out'' is the output image.
 
*''img_out'' is the output image.
  
     void
+
     int
 
     icv_rect(const icv_image_t *img,
 
     icv_rect(const icv_image_t *img,
 
             const icv_point_t *area,
 
             const icv_point_t *area,
Line 22: Line 22:
 
*''img_out'' is the output image.
 
*''img_out'' is the output image.
  
     void
+
     int
 
     icv_crop(const icv_image_t *img,
 
     icv_crop(const icv_image_t *img,
 
             const icv_point_t *p1,
 
             const icv_point_t *p1,
Line 42: Line 42:
  
  
     void
+
     int
 
     icv_airth2(const icv_image_t* img1,
 
     icv_airth2(const icv_image_t* img1,
 
               const icv_image_t* img2,
 
               const icv_image_t* img2,
Line 56: Line 56:
 
*''img_out'' is the output image.
 
*''img_out'' is the output image.
  
     void
+
     int
 
     icv_airth1(icv_image_t* img,
 
     icv_airth1(icv_image_t* img,
 
               const icv_operation_t *oper[],   
 
               const icv_operation_t *oper[],   
Line 67: Line 67:
 
*''img_out'' is the output image.
 
*''img_out'' is the output image.
  
     void
+
     int
 
     icv_saturate(const icv_image_t *img,
 
     icv_saturate(const icv_image_t *img,
 
                 const double saturation,
 
                 const double saturation,
Line 80: Line 80:
 
*''img_out'' is the output image.
 
*''img_out'' is the output image.
  
     void
+
     int
 
     icv_filter(const icv_image_t *img,
 
     icv_filter(const icv_image_t *img,
 
               const icv_kernel_type_t kernel;
 
               const icv_kernel_type_t kernel;
Line 94: Line 94:
 
*For three channel image this is called with all the three output pointers, for bw image this is called with pointers only for first and others are left as NULL
 
*For three channel image this is called with all the three output pointers, for bw image this is called with pointers only for first and others are left as NULL
  
     void
+
     int
 
     icv_hist(const icv_image_t *img,
 
     icv_hist(const icv_image_t *img,
 
             const int bin,
 
             const int bin,
Line 106: Line 106:
 
*Calculates histogram equalization of the image
 
*Calculates histogram equalization of the image
  
     void icv_histeq(const icv_image_t *img,
+
     int
 +
    icv_histeq(const icv_image_t *img,
 
                     icv_imgage_file_t *img_out);
 
                     icv_imgage_file_t *img_out);
  
Line 116: Line 117:
 
* ''method'' is the prescribed method     
 
* ''method'' is the prescribed method     
  
     void icv_scale(const icv_image_t *img,
+
     int   
 +
    icv_scale(const icv_image_t *img,
 
                   const icv_size_t *outsize,
 
                   const icv_size_t *outsize,
 
                   const icv_scale_method_t method,
 
                   const icv_scale_method_t method,
Line 127: Line 129:
 
* ''method'' is the prescribed method.
 
* ''method'' is the prescribed method.
  
     void icv_shrink(const icv_image_t *img,
+
     int
 +
    icv_shrink(const icv_image_t *img,
 
                     icv_image_t *img_out,
 
                     icv_image_t *img_out,
 
                     const int factor,
 
                     const int factor,
Line 141: Line 144:
 
* finds the image statistics  
 
* finds the image statistics  
  
     void icv_stat(const icv_image_t *img,
+
     int
 +
    icv_stat(const icv_image_t *img,
 
                   icv_stat_t *stat1,  
 
                   icv_stat_t *stat1,  
 
                   icv_stat_t *stat2,   
 
                   icv_stat_t *stat2,   
Line 148: Line 152:
 
'''for pixcolors'''
 
'''for pixcolors'''
  
     void icv_colors(icv_image_t *img)  
+
     int
 +
    icv_colors(icv_image_t *img)  
 
     /* Prints all the colors */     
 
     /* Prints all the colors */     
 
      
 
      
Line 160: Line 165:
 
* ''img_out'' is the output image
 
* ''img_out'' is the output image
  
     void icv_threshold(const icv_image_t *img,
+
     int
 +
    icv_threshold(const icv_image_t *img,
 
                       icv_image_t *img_out,
 
                       icv_image_t *img_out,
 
                       const unsigned char *val,
 
                       const unsigned char *val,
Line 167: Line 173:
 
'''for pixclump'''
 
'''for pixclump'''
  
     void icv_clump()
+
     int
 +
    icv_clump()
 
/* Need Suggestions */
 
/* Need Suggestions */
 
      
 
      
Line 176: Line 183:
 
*Interpolates the image two twice its resolution
 
*Interpolates the image two twice its resolution
  
     void icv_interep2x(const icv_image_t *img,
+
     int
 +
    icv_interep2x(const icv_image_t *img,
 
                       icv_image_t *img_out);     
 
                       icv_image_t *img_out);     
  
Line 184: Line 192:
 
*Decimates the image
 
*Decimates the image
  
     void icv_halve(const icv_image_t *img,
+
     int
 +
    icv_halve(const icv_image_t *img,
 
                   icv_image_t *img_out);
 
                   icv_image_t *img_out);
  

Latest revision as of 11:06, 12 June 2013

API CALLS[edit]

Cropping(Group1)[edit]

for bwrect, pixrect Comments

  • Removes a rectangular portion of a potentially huge image.
  • orig, is the point that corresponds to Bottom left corner to extract the image from
  • area corresponds to the total number of pixels in the new map.
  • img_out is the output image.
   int
   icv_rect(const icv_image_t *img,
            const icv_point_t *area,
            const icv_point_t *orig
            icv_image_t *img_out);   


for bwcrop

Comments

  • Crops file with arbitrary points
  • p1, p2, p3, p4 are left lower, right lower, left upper and right upper points respectively.
  • img_out is the output image.
   int
   icv_crop(const icv_image_t *img,
            const icv_point_t *p1,
            const icv_point_t *p2,
            const icv_point_t *p3,
            const icv_point_t *p4,
            const icv_size_t *outsize,
            icv_image_t *img_out);

Operations (Group2)[edit]

for bwdiff, pixdiff

Comments

  • Performs arithmetic operations between the pixels of two images.
  • img_1 and img_2 are two input images.
  • opr corresponds to the operation information.
  • img_out is the output image.


   int
   icv_airth2(const icv_image_t* img1,
              const icv_image_t* img2,
              const icv_operation_t *opr,
              icv_image_t *img_out) 

for bwmod

Comments

  • Performs arithmetic operations with a value of the pixels of the input image, the resultant value is replaced in the same input image.
  • oper is the array corresponding to the operations.
  • numop is the number of operations.
  • img_out is the output image.
   int
   icv_airth1(icv_image_t* img,
             const icv_operation_t *oper[],  
             const int numop); 

for Pixsaturate

Comments

  • saturation is the saturation value
  • img_out is the output image.
   int
   icv_saturate(const icv_image_t *img,
                const double saturation,
                icv_image_t *img_out);

Filters (Group3)[edit]

for bwfilter, pixfilter, pix3filter, pixfade

Comments

  • Performs filtering of image using convolution with the kernel.
  • kernel corresponds to kernel used for image filter
  • img_out is the output image.
   int
   icv_filter(const icv_image_t *img,
              const icv_kernel_type_t kernel;
              icv_image_ *img_out);

Histogram (Group4)[edit]

for bwhist, pixhist

Comments

  • Finds histogram of the image
  • bin is the number of bins for calculating histogram
  • bin_out1, bin_out2 and bin_out3 are the pointers for output histograms
  • For three channel image this is called with all the three output pointers, for bw image this is called with pointers only for first and others are left as NULL
   int
   icv_hist(const icv_image_t *img,
            const int bin,
            long *bin_out1,
            long *bin_out2,
            long *bin_out3);

for bwhisteq

Comments

  • Calculates histogram equalization of the image
   int 
   icv_histeq(const icv_image_t *img,
                   icv_imgage_file_t *img_out);

Scale (Group5)[edit]

for bwscale, pixscale

Comments

  • outsize is the required output size
  • method is the prescribed method
   int    
   icv_scale(const icv_image_t *img,
                  const icv_size_t *outsize,
                  const icv_scale_method_t method,
                  icv_image_t *img_out);

for bwshrink, pixshrink

Comments

  • factor is shrinking factor.
  • method is the prescribed method.
   int
   icv_shrink(const icv_image_t *img,
                   icv_image_t *img_out,
                   const int factor,
                   const icv_shrink_mehtod_t method);

Stats (Group6)[edit]

for imgdims, pixcount Not useful

for pixstat, bwstat

Comments

  • finds the image statistics
   int
   icv_stat(const icv_image_t *img,
                 icv_stat_t *stat1, 
                 icv_stat_t *stat2,   
                 icv_stat_t *stat3);

for pixcolors

   int
   icv_colors(icv_image_t *img) 
   /* Prints all the colors */    
   

Threshold (Group7)[edit]

for bwthresh

Comments

  • val is a pointer to an array of threshold values
  • num_thresh is the number of the threshold values
  • img_out is the output image
   int
   icv_threshold(const icv_image_t *img,
                      icv_image_t *img_out,
                      const unsigned char *val,
                      const int num_thresh);

for pixclump

   int
   icv_clump()	

/* Need Suggestions */

Interpolate (Group8)[edit]

for pixinterep2x

Comments

  • Interpolates the image two twice its resolution
   int
   icv_interep2x(const icv_image_t *img,
                      icv_image_t *img_out);    

for pixhalve

Comments

  • Decimates the image
   int
   icv_halve(const icv_image_t *img,
                  icv_image_t *img_out);

Structure[edit]

  • ICV_IMAGE_FILE
 struct icv_image_file {
   uint_32 magic;
   char* filename;
   int fd;
   int format;
   int width, height, depth;
   unsigned char *data;
   unisgned long flags;		
 };
  • ICV_SIZE
 struct icv_size {
   int height, width;
 };
  • ICV_POINT
 struct icv_point {
   int x,y;
 };
  • ICV_OPERATION
 struct icv_operation {	
   char oper;
   double val;	
 };
  • ICV_KERNEL
 struct icv_kernel {
   char *name;
   char *uname;		/* What is needed to recognize it */
   int *kern;
   int kerndiv;	/* Divisor for kernel */
   int kernoffset;	/* To be added to result */
 };
  • ICV_STAT
   struct icv_stat {
     int max, min, mode, median;
     double mean, var, skew;
     long sum, partial_sum;
   };