From 73865db0d8ef31b55533c35afad108b8cd6cfa0a Mon Sep 17 00:00:00 2001 From: Mark Hale Date: Thu, 23 Feb 2017 22:08:40 +0000 Subject: [PATCH] Added readmes. Signed-off-by: Mark Hale Former-commit-id: 74c181edb4819542cc95da03c63857023e712e94 --- contrib/blender/README.md | 23 +++++++++++++++++++++++ contrib/grass/README.md | 16 ++++++++++++++++ 2 files changed, 39 insertions(+) create mode 100644 contrib/blender/README.md create mode 100644 contrib/grass/README.md diff --git a/contrib/blender/README.md b/contrib/blender/README.md new file mode 100644 index 00000000..791cc5d5 --- /dev/null +++ b/contrib/blender/README.md @@ -0,0 +1,23 @@ +# Blender scripts +# odm_photo +Renders photos from ODM generated texture models. +Currently can produce 360 panoramic photos and 360 3D panoramic (VR) photos. + +## Requirements +* Blender +* ExifTool (must be on your PATH) + +## Usage +To generate a 360 panoramic photo: + + blender -b photo_360.blend --python odm_photo.py -- + +Output is `/odm_photo/odm_photo_360.jpg`. + +To generate a 360 3D panoramic photo: + + blender -b photo_vr.blend --python odm_photo.py -- + +Output is `/odm_photo/odm_photo_vr_L.jpg` and `/odm_photo/odm_photo_vr_R.jpg`. + +**NB: argument order matters!** diff --git a/contrib/grass/README.md b/contrib/grass/README.md new file mode 100644 index 00000000..b51087b7 --- /dev/null +++ b/contrib/grass/README.md @@ -0,0 +1,16 @@ +# GRASS scripts +# odm_grass +Generates DEM, contour and textured relief maps. + +## Requirements +* GRASS +* Environment variables: + * PYTHONHOME set to the location of Python + * PYTHONPATH set to the location of GRASS Python libs + * PATH includes GRASS bin and lib directories + * GISBASE set to the location of GRASS + +## Usage + python odm_grass.py + +Output is `/odm_georeferencing/odm_dem.tif`, `/odm_georeferencing/odm_contour.shp` and `/odm_orthophoto/odm_relief.tif`. \ No newline at end of file