Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
himynamesdave committed Jun 2, 2020
1 parent df8e2aa commit eb34302
Showing 1 changed file with 3 additions and 3 deletions.
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,17 +45,17 @@ Using the script is simple. Arguments can be provided in the following format:

`python nadir-patcher.py "[PANORAMIC PHOTO FILE OR FOLDER PATH]" "[NADIR FILE PATH]" [PERCENTAGE SIZE] "[OUTPUT_FOLDER_PATH]"`

In the images below I'll use [this panoramic photo](input/MULTISHOT_9698_000001.jpg) and [this nadir](my_custom_nadir.png).
In the images below I'll use [this panoramic photo](samples/input/MULTISHOT_9698_000001.jpg) and [this nadir](samples/input/my_custom_nadir.png).

`[PERCENTAGE SIZE]` refers to the height of the nadir as a percentage of total image height. This must be specified as whole number between 1 (smallest) and 100 (covers entire image). Somewhere between 5% to 15% is what most other software tools use to generate a nadir.

![Nadir as percentage of panoramic image height](/example-nadir-percentage-of-pano.jpg)

The naming convention for outputted images is as follows: [ORIGINAL FILE NAME] _ [NADIR FILE NAME] _ [PERCENTAGE SIZE OF NADIR] pc. [ORIGINAL FILE EXTENSION]. For example; MULTISHOT_9698_000001.jpg > MULTISHOT_9698_000001_nadir_12pc.jpg

And here's what is looks like when rendered in a panoramic viewer:
And here's what the outputted file looks like when rendered in a panoramic viewer:

![Example Nadir Patcher output](/example-nadir-pano-result.jpg)
<iframe width="600" height="400" allowfullscreen style="border-style:none;" src="https://cdn.pannellum.org/2.5/pannellum.htm#panorama=samples/output/MULTISHOT_9698_000001_nadir_12pc.jpg"></iframe>

To help you get started here's some examples. You'll find the files used in the [`samples/`](/samples) directory of this repository.

Expand Down

0 comments on commit eb34302

Please sign in to comment.