Skip to content

Commit

Permalink
Added converter with 1.8 conversion capability. Updated information f…
Browse files Browse the repository at this point in the history
…or readme (#121)
  • Loading branch information
rvargasESRI authored May 26, 2021
1 parent 9f6c4e8 commit 45e28ca
Show file tree
Hide file tree
Showing 3 changed files with 7 additions and 7 deletions.
Binary file modified i3s_converter/i3s_converter.exe
Binary file not shown.
10 changes: 5 additions & 5 deletions i3s_converter/i3s_converter_ReadMe.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@
## Introduction <a name="Introduction"></a>
i3s_converter a command line tool for
- Validating a 1.6 Scene Layer Package (slpk)
- Convert a 1.4-1.6 slpk to 1.7
- Extract a 1.7 slpk or a 2.0 slpk with layer type of Point Cloud.
- Convert a 1.4-1.6 slpk to 1.8
- Extract a 1.8 slpk or a 2.0 slpk with layer type of Point Cloud.


| &nbsp; | Validate | Convert | Extract |
Expand All @@ -26,7 +26,7 @@ i3s_converter a command line tool for
| Pointcloud | <img alt="supported" src="readme_images/checkmark.png"> | &nbsp; | <img alt="supported" src="readme_images/checkmark.png"> |
| Building | <img alt="supported" src="readme_images/checkmark.png"> | <img alt="supported" src="readme_images/checkmark.png"> | <img alt="supported" src="readme_images/checkmark.png"> |

*Note:* 1.7 maintains backwards compatibility with 1.6. The resultant 1.7 slpk will be larger in size than the input slpk. This is due to the creation of Draco-compressed geometries and DXT-compressed textures. All of these features are important for increased performance. If output slpk size is a limiting factor, the `-x` option can be used to skip writing DXT textures, but this may result in slower drawing performance.
*Note:* 1.8 maintains backwards compatibility with 1.6. The resultant 1.8 slpk will be larger in size than the input slpk. This is due to the creation of Draco-compressed geometries and DXT-compressed textures. All of these features are important for increased performance. If output slpk size is a limiting factor, the `-x` option can be used to skip writing DXT textures, but this may result in slower drawing performance.

When extracing or converting, the following formats are available:
- Archived: *.slpk
Expand Down Expand Up @@ -93,8 +93,8 @@ is the equivalent to<br>
| -d \[dir] | --dest \[output-directory] | Change [output directory](#outputDirectory). Will create it if it doesn't exist|
| -k | --create-ktx2-textures | Create Basis Universal texture from input |
| -j \[log_name] | --json \[log_name] | Set log name |
| -n | --drop-normals | Drop all normals. Client will recreate |
| -o \[outfile] | --output-name \[outfile] | 1.7 slpk name |
| -n | --drop-normals | Drop all normals. Client will recreate (Draco geometry buffer only) |
| -o \[outfile] | --output-name \[outfile] | 1.8 slpk name |
| -r | --region | Region where bucket is located (S3/OSS).|
| -s \[key] | --secret-key \[key] | AWS S3/Alibaba OSS secret key or Azure account key |
| -t \[num threads] | --thread-count \[num threads] | [Number of threads](#threadsDesc) to use when converting, default is 1 |
Expand Down
4 changes: 2 additions & 2 deletions i3s_converter/i3s_converter_examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ In all the of following examples, we will assume a working directory of ```C:\Us

-------------------------------------

### Convert from old version (1.4-1.6) to new version (1.7)<a name = "ConvertSLPK"></a>
### Convert from old version (1.4-1.6) to new version (1.8)<a name = "ConvertSLPK"></a>
```i3s_converter.exe -u myFile.slpk```<br>
This command will convert/upgrade from an older SLPK version to the latest SLPK version. The output file will be in the working directory.

Expand Down Expand Up @@ -62,7 +62,7 @@ present.

### Drop normals.<a name = "dropNormals"></a>
```i3s_converter.exe -u myFile.slpk -n```<br>
This command performs a conversion and drops all normals. Client will recreate these normals.
This command performs a conversion and drops all normals. Client will recreate these normals. This command only drops normals from Draco compressed geometry.

### Convert to filesystem (eslpk)<a name = "convertFilesystem"></a>
```i3s_converter.exe -u myFile.slpk -d C:\Users\johndoe\Desktop\MyFolder -t 2```<br>
Expand Down

0 comments on commit 45e28ca

Please sign in to comment.