add documentation for image binary encoding
rename types