About the Tutorial
In Part 1. this tutorial takes you, step-by-step through the process of calculating your multi-resolution tile and level sizes to create the perfect set of tiles for your project. In Part 2. I look at extracting the high resolution tiles, renaming them and in Part 3. re-assembling them to restore your equirectangular image.
The tutorial is based on the Macintosh OS and shows a Mac only program for renaming the tiles. At this time we are still looking for a suitable Windows application and would appreciate any feedback or recommendations.
Update 5/02/18: Yet another free Windows application has been brought to my attention, it's called Bulk Rename Utility
Update 27/03/18: Another free Windows application has been brought to my attention, it's called Advanced Renamer.
Note: this tutorial assumes a working knowledge of Pano2VR V5.2.3
This tutorial is broken down into 3 parts, this is Part 2: Extracting and Renaming the Tiles. The parts of the tutorial are;
Part 2: Extracting and Renaming the Tiles
In this part of the tutorial we are going to look at the best way to set up our tiles so we can easily extract them from the project and rename them.
As you have seen in Part 1. there is a distinct naming convention for the tiles. To recap here is the final Tile output from Step 1 (figure #1)
As you can see from the image above the structure is node1/cf_0/l_3/c_0 this can be broken down to:
node1 = node number of the panorama
cf_0 = cube face 0
l_3 = level 3 (levels start at 0)
c_0 = column 0
Note: This structure makes it difficult to rename the files as each column contains the same number of files with exactly the same names. If we try to copy all the tiles to one folder we will only have the option to replace or skip (figure #2)
Fortunately Pano2VR allows us to choose different tile structures or make our own. Under the 'Output/Advanced' dropdown there is a section 'Multiresolution/Filename' and a dropdown with several different structures.
In this example we will create our own structure as follows;
This breaks down to
$n = panorama name
cf_%C = cube face 1
l%L = level 4 (levels start at 1)
cf_%C_%00Y_%00X.jpg = 004_001.jpg
1. Copy the new structure and paste it into the Multiresolution filename in the 'Output/Advanced/Multiresolution/Filename' dropdown (figure #3)
Note: you don't have to save it, when you save the project it's automatically saved
2. 'Save' the project
3. Click on the small 'trash can' (Erase Output Folder) in the 'Output/Output Folder' section and 'select yes' to the warning modal window.
Note: this will clear out any Pano2VR created files from the project folder and will generate a clean set of tiles (figure #4)
4. 'Output' the project
5. In the output folder navigate to 'Tiles/*Name of your Panorama*/cf_1/l4' (figure #5)
Note: As you can see from the image rather than have each column of tiles in a separate folder they are all in one folder and each 'column' is identified by the number 001. In turn each 'image' in the column is identified by the number 001-007.jpg. This makes it much easier to rename the entire cube face of tiles using a single sequence command.
Renaming the tiles
On the Macintosh I recommend the renaming application 'NameChanger'. I use it all the time and it is perfect for the task we need it to perform and it's free! You can find out more information on the application and download it to your desktop from https://mrrsoftware.com/namechanger/
1. Copy the entire 'l4 folder' to a location outside of the project folder and rename it 'Cube1_l4'
2. Launch 'NameChanger' (figure #6)
3. With the application active select 'Menu/NameChanger/Preferences' and check 'Renaming Options: Hide extensions by default' and 'Warn before removing file extensions' (figure #7)
4. 'Drag and drop' all of the files from 'Cube1_l4' onto the 'NameChanger' window (figure #8 & #9)
5. Select 'Sequence' from the dropdown menu in the centre of the window (figure #10)
6. 'Configure' the Sequence as per the image below.
Note: As you make changes the results are shown in the 'Rename Filename' column (figure #11)
7. To make sure that you have all the correct tiles click on the 'Image Browser' button at the top right to open a window displaying all of the tiles in order (figure #12)
8. Save the sequence configuration by selecting 'Menu/Renames/Save Current Rename/' and naming it 'Cube1' (figure #13)
9. Click on the 'Rename' button to confirm the changes. (figure #14)
10. The files in the Rename Filename column are changed and the 'Rename Complete' message is displayed (figure #15)
Note: You can ignore the 'warning' message
11. 'Navigate to the Cube1_l4' folder and you will see that the tiles in the folder have been renamed (figure #16)
12. In NameChanger select 'Clear' to remove the current tiles (figure #14)
13. Repeat 'step 1' and copy the remaining 5 Cube faces until you have 6 folders 'Cube1_l4 - Cube6_l4'
14. Repeat 'step #4' with 'Cube2_l4'
Note: if you don't close NameChanger between renames the Sequence option will still be selected
14. Change the rename from 'Cube1-' to 'Cube2-'
15. Repeat 'step #8' and 'Save Current Rename' the sequence configuration as 'Cube2'
16. Repeat steps #9 & #11
17. Do the same for the remaining Cube folders
That finishes Part2. Extraction and Renaming of this tutorial you are now ready to move onto the final Part3. Reassemble the Cube Faces.