Go to file
Davis King dbc9a815e2 Fixed an endianness bug in the PNG I/O functions which occurred when 16bit
grayscale PNGs were used.  libpng doesn't automatically convert from host
endianness to big endian as the PNG standard demands.  You have to explicitly
tell it to do this or it will write out the 16bit pixel data in host order
which result in the wrong thing happening on little endian chips.  Similarly
for reading PNGs.
2013-01-07 19:49:47 -05:00
dlib Fixed an endianness bug in the PNG I/O functions which occurred when 16bit 2013-01-07 19:49:47 -05:00
docs updated docs 2013-01-06 20:13:26 -05:00
examples switched examples over to the new mat() method. 2012-12-23 09:25:22 -05:00
tools Simplified CLI code 2012-12-12 19:50:31 -05:00
.hgignore Added build_clang folders to the ignore list. 2012-04-13 19:37:38 -04:00
.hgtags Added tag v17.49 for changeset 4312a45be8b4 2012-11-15 18:26:37 -05:00
README.txt fixed grammar 2012-05-20 13:14:04 -04:00


If you are reading this file then you must have downloaded dlib via the 
mercurial repository.  If you are new to dlib then go read the introduction
and how to compile pages at http://dlib.net/intro.html and http://dlib.net/compile.html.
If you are planning on contributing code then also read the contribution
instructions at http://dlib.net/howto_contribute.html.


COMPILING DLIB EXAMPLE PROGRAMS
   Go into the examples folder and type:
   mkdir build; cd build; cmake .. ; cmake --build .

   That will build all the examples.  Note that there is nothing to install
   when using dlib.  It's just a folder of source files.  Sometimes people
   tell me dlib should be compiled and installed as some kind of shared
   library, however, they are wrong. Please read this http://dlib.net/howto_contribute.html#9 
   before starting this argument again.  


RUNNING THE UNIT TEST SUITE
   Type the following to compile and run the dlib unit test suite (it takes a while):
   cd dlib/test; mkdir build; cd build; cmake ..; cmake --build . --config Release; ./test --runall

   Note that on windows your compiler might put the test executable in a subfolder called
   Release.  If that's the case then you have to go to that folder before running the test.


DOCUMENTATION
   The mercurial repository doesn't contain finished documentation.  The stuff in
   the docs folder is just a bunch of scripts and xml files used to generate the 
   documentation.  There is a readme in docs/README.txt which discusses how to do
   this.  However, unless you are trying to modify the documentation, you should
   just download a copy from http://dlib.net.  That would probably be easier than
   setting up your environment to generate the documentation yourself.