updated docs

docs/docs/imaging.xml

@@ -125,6 +125,7 @@
       <section>
          <name>Morphology</name>
          <item>label_connected_blobs</item>
+         <item>segment_image</item>
          <item>binary_dilation</item>
          <item>binary_erosion</item>
          <item>binary_open</item>
@@ -148,6 +149,7 @@
          <name>Miscellaneous</name>
 
          <item>cv_image</item>
+         <item>randomly_color_image</item>
 
          <item>draw_line</item> 
          <item>fill_rect</item> 
@@ -486,6 +488,26 @@
                                  
       </component>
             
+   <!-- ************************************************************************* -->
+      
+      
+      <component>
+         <name>randomly_color_image</name>
+         <file>dlib/image_transforms.h</file>
+         <spec_file link="true">dlib/image_transforms/randomly_color_image_abstract.h</spec_file>
+         <description>
+              Randomly generates a mapping from gray level pixel values
+              to the RGB pixel space and then uses this mapping to create
+              a colored version an image. 
+              <p>
+                 This function is useful for displaying the results of some image 
+                 segmentation.  For example, the output of <a href="#label_connected_blobs">label_connected_blobs</a>
+                 or <a href="#segment_image">segment_image</a>.
+              </p>
+         </description>
+                                 
+      </component>
+            
    <!-- ************************************************************************* -->
       
       <component>
@@ -1052,6 +1074,22 @@
                                  
       </component>
             
+   <!-- ************************************************************************* -->
+      
+      <component>
+         <name>segment_image</name>
+         <file>dlib/image_transforms.h</file>
+         <spec_file link="true">dlib/image_transforms/segment_image_abstract.h</spec_file>
+         <description>        
+              Attempts to segment an image into regions which have some visual consistency to them.
+              In particular, this function implements the algorithm described in the paper:
+              <blockquote>
+               Efficient Graph-Based Image Segmentation by Felzenszwalb and Huttenlocher.
+              </blockquote>
+         </description>
+                                 
+      </component>
+            
    <!-- ************************************************************************* -->
       
       <component>

docs/docs/term_index.xml

@@ -932,6 +932,7 @@
          <term link="dlib/image_transforms/thresholding_abstract.h.html" name="off_pixel"/>
     
 
+         <term file="imaging.html" name="randomly_color_image"/>
          <term file="imaging.html" name="assign_image"/>
          <term file="imaging.html" name="assign_image_scaled"/>
          <term file="imaging.html" name="assign_all_pixels"/>
@@ -950,6 +951,7 @@
          <term file="imaging.html" name="binary_difference"/>
 
          <term file="imaging.html" name="label_connected_blobs"/>
+         <term file="imaging.html" name="segment_image"/>
          <term file="imaging.html" name="neighbors_8"/>
          <term file="imaging.html" name="neighbors_4"/>
          <term file="imaging.html" name="connected_if_both_not_zero"/>