More work on the PiCamera class

Started documenting methods, tested and fixed the setter for the
preview_resolution property - works with full-frame resolution nicely
now.