updated docs

docs/docs/imaging.xml

@@ -193,6 +193,7 @@
          <item>upsample_image_dataset</item> 
          <item>flip_image_dataset_left_right</item> 
          <item>rotate_image_dataset</item> 
+         <item>extract_image_chips</item> 
       </section>
 
       <section>
@@ -1440,6 +1441,20 @@
          </description>
       </component>
 
+   <!-- ************************************************************************* -->
+
+      <component>
+         <name>extract_image_chips</name>
+         <file>dlib/image_transforms.h</file>
+         <spec_file link="true">dlib/image_transforms/interpolation_abstract.h</spec_file>
+         <description>        
+              This function extracts "chips" from an image.  That is, it takes a list of
+              rectangular sub-windows (i.e. chips) within an image and extracts those
+              sub-windows, storing each into its own image.  It also allows the user to
+              specify the scale and rotation or the chip.
+         </description>
+      </component>
+
    <!-- ************************************************************************* -->
 
       <component>

docs/docs/term_index.xml

@@ -1229,6 +1229,9 @@
          <term file="imaging.html" name="transform_image"         include="dlib/image_transforms.h"/>
          <term file="imaging.html" name="rotate_image"            include="dlib/image_transforms.h"/>
          <term file="imaging.html" name="resize_image"            include="dlib/image_transforms.h"/>
+         <term file="imaging.html" name="extract_image_chips"     include="dlib/image_transforms.h"/>
+         <term file="dlib/image_transforms/interpolation_abstract.h.html" name="extract_image_chip"      include="dlib/image_transforms.h"/>
+         <term file="dlib/image_transforms/interpolation_abstract.h.html" name="chip_details"      include="dlib/image_transforms.h"/>
          <term file="imaging.html" name="pyramid_up"              include="dlib/image_transforms.h"/>
          <term file="imaging.html" name="add_image_left_right_flips" include="dlib/image_transforms.h"/>
          <term file="imaging.html" name="flip_image_dataset_left_right" include="dlib/image_transforms.h"/>