usd-convert-cad 0.2.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# NVIDIA Omniverse Licensing Terms
|
|
2
|
+
|
|
3
|
+
The **Omniverse CAD Converter**, distributed on GitHub and PyPI using the
|
|
4
|
+
`usd-convert-cad` repository, package, and command-line identifier, is governed
|
|
5
|
+
by the following NVIDIA agreements:
|
|
6
|
+
|
|
7
|
+
- [NVIDIA Software License Agreement](https://www.nvidia.com/en-us/agreements/enterprise-software/nvidia-software-license-agreement/)
|
|
8
|
+
- [Product Specific Terms for NVIDIA AI Products](https://www.nvidia.com/en-us/agreements/enterprise-software/product-specific-terms-for-ai-products/)
|
|
9
|
+
|
|
10
|
+
These terms govern the use of NVIDIA Omniverse by individuals and commercial
|
|
11
|
+
customers. Customers may redistribute the Omniverse CAD Converter as permitted
|
|
12
|
+
by those terms.
|
|
13
|
+
|
|
14
|
+
By downloading or using NVIDIA Omniverse, you agree to the terms. See the
|
|
15
|
+
[Omniverse License Agreement](https://docs.omniverse.nvidia.com/dev-guide/latest/common/NVIDIA_Omniverse_License_Agreement.html).
|
|
16
|
+
|
|
17
|
+
The Omniverse CAD Converter uses the Tech Soft 3D HOOPS Exchange SDK, licensed
|
|
18
|
+
by NVIDIA, to read supported CAD data for conversion to OpenUSD. See
|
|
19
|
+
[`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md) for third-party
|
|
20
|
+
acknowledgements and license notices that must accompany the software.
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: usd-convert-cad
|
|
3
|
+
Version: 0.2.0
|
|
4
|
+
Summary: Convert supported CAD assets to OpenUSD (.usd, .usda, .usdc).
|
|
5
|
+
Project-URL: Homepage, https://github.com/NVIDIA-Omniverse/usd-convert-cad
|
|
6
|
+
Project-URL: Documentation, https://github.com/NVIDIA-Omniverse/usd-convert-cad#readme
|
|
7
|
+
Project-URL: Repository, https://github.com/NVIDIA-Omniverse/usd-convert-cad
|
|
8
|
+
Project-URL: Issues, https://github.com/NVIDIA-Omniverse/usd-convert-cad/issues
|
|
9
|
+
Author: NVIDIA
|
|
10
|
+
License: # NVIDIA Omniverse Licensing Terms
|
|
11
|
+
The **Omniverse CAD Converter**, distributed on GitHub and PyPI using the
|
|
12
|
+
`usd-convert-cad` repository, package, and command-line identifier, is governed
|
|
13
|
+
by the following NVIDIA agreements:
|
|
14
|
+
- [NVIDIA Software License Agreement](https://www.nvidia.com/en-us/agreements/enterprise-software/nvidia-software-license-agreement/)
|
|
15
|
+
- [Product Specific Terms for NVIDIA AI Products](https://www.nvidia.com/en-us/agreements/enterprise-software/product-specific-terms-for-ai-products/)
|
|
16
|
+
These terms govern the use of NVIDIA Omniverse by individuals and commercial
|
|
17
|
+
customers. Customers may redistribute the Omniverse CAD Converter as permitted
|
|
18
|
+
by those terms.
|
|
19
|
+
By downloading or using NVIDIA Omniverse, you agree to the terms. See the
|
|
20
|
+
[Omniverse License Agreement](https://docs.omniverse.nvidia.com/dev-guide/latest/common/NVIDIA_Omniverse_License_Agreement.html).
|
|
21
|
+
The Omniverse CAD Converter uses the Tech Soft 3D HOOPS Exchange SDK, licensed
|
|
22
|
+
by NVIDIA, to read supported CAD data for conversion to OpenUSD. See
|
|
23
|
+
[`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md) for third-party
|
|
24
|
+
acknowledgements and license notices that must accompany the software.
|
|
25
|
+
License-File: LICENSE.md
|
|
26
|
+
Requires-Python: <3.13,>=3.12
|
|
27
|
+
Description-Content-Type: text/markdown
|
|
28
|
+
|
|
29
|
+
# Omniverse CAD Converter (`usd-convert-cad`)
|
|
30
|
+
|
|
31
|
+
Pip-installable Omniverse CAD Converter package for converting supported CAD
|
|
32
|
+
assets to OpenUSD.
|
|
33
|
+
|
|
34
|
+
`usd-convert-cad` converts supported CAD, AEC, and interchange files to OpenUSD. The wheel includes the converter command line, Python package, required native runtime components, and the canonical agent skill.
|
|
35
|
+
|
|
36
|
+
## Installing
|
|
37
|
+
|
|
38
|
+
Create an isolated Python environment and install the package:
|
|
39
|
+
|
|
40
|
+
```shell
|
|
41
|
+
python -m venv .venv
|
|
42
|
+
python -m pip install usd-convert-cad
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Converting Files
|
|
46
|
+
|
|
47
|
+
Run the console command with an input CAD asset and output USD path:
|
|
48
|
+
|
|
49
|
+
```shell
|
|
50
|
+
usd-convert-cad --input model.stp --output model.usdc
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
Short flags are also supported:
|
|
54
|
+
|
|
55
|
+
```shell
|
|
56
|
+
usd-convert-cad -i model.stp -o model.usda
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
The package supports module execution as well:
|
|
60
|
+
|
|
61
|
+
```shell
|
|
62
|
+
python -m usd_convert_cad --input model.stp --output model.usdc
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## Output Formats
|
|
66
|
+
|
|
67
|
+
The output path determines the USD file format. Supported output extensions are
|
|
68
|
+
`.usd`, `.usda`, and `.usdc`. USDZ (`.usdz`) export is not supported.
|
|
69
|
+
|
|
70
|
+
Examples:
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
usd-convert-cad -i assembly.stp -o assembly.usdc
|
|
74
|
+
usd-convert-cad -i part.igs -o part.usda
|
|
75
|
+
usd-convert-cad -i model.prt -o model.usd
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Conversion Options
|
|
79
|
+
|
|
80
|
+
Run `usd-convert-cad --help` to view all options.
|
|
81
|
+
|
|
82
|
+
Options include:
|
|
83
|
+
|
|
84
|
+
- `--global-xforms`: Author global transforms instead of local transforms.
|
|
85
|
+
- `--convert-curves`: Convert wire and curve geometry.
|
|
86
|
+
- `--convert-metadata`: Convert CAD metadata to USD custom attributes.
|
|
87
|
+
- `--no-dedup`: Disable mesh and material deduplication.
|
|
88
|
+
- `--tess-lod <0-4>`: Set tessellation level of detail.
|
|
89
|
+
- `--revit-lod <0-3>`: Set Revit detail level. Values are `0` for file
|
|
90
|
+
default, `1` coarse, `2` medium, and `3` fine.
|
|
91
|
+
- `--accurate-tessellation`: Enable accurate tessellation.
|
|
92
|
+
- `--fast-surface-curvatures`: Disable accurate surface curvature computation.
|
|
93
|
+
- `--no-normals`: Do not author normals.
|
|
94
|
+
- `--no-materials`: Do not author materials.
|
|
95
|
+
- `--material-type <type>`: Choose material output type. Valid values:
|
|
96
|
+
`none`, `preview-surface`, `preview-surface-omnipbr`.
|
|
97
|
+
- `--up-axis <axis>`: Override output stage up-axis. Valid values:
|
|
98
|
+
`file`, `y`, `z`.
|
|
99
|
+
- `--instancing-style <style>`: Choose how repeated components are authored.
|
|
100
|
+
Valid values: `none`, `reference`, `instanceable-reference`.
|
|
101
|
+
- `--composition-style <style>`: Choose how external sub-assemblies and parts
|
|
102
|
+
are authored. Valid values: `none`, `reference`, `payload`.
|
|
103
|
+
- `--filter-style <style>`: Choose how hidden CAD elements are converted.
|
|
104
|
+
Valid values: `none`, `omit`, `hide`, `deactivate`.
|
|
105
|
+
- `--load-hidden`: Load hidden CAD elements before filtering.
|
|
106
|
+
- `--progress`: Print converter progress.
|
|
107
|
+
- `--progress-frequency <hz>`: Set progress report frequency in Hz.
|
|
108
|
+
- `--creator <value>`: Set creator metadata on output USD layers.
|
|
109
|
+
- `--convert-physics-data`: Author physical properties on USD prims.
|
|
110
|
+
- `--physics-accuracy-level <0.0-1.0>`: Set physical property accuracy.
|
|
111
|
+
- `--physics-use-geometry-on-ribrep`: Use geometry instead of topology for
|
|
112
|
+
RiBRep physical properties.
|
|
113
|
+
- `--view-layer-name <name>`: Convert a CAD view layer or simplified
|
|
114
|
+
representation by name.
|
|
115
|
+
|
|
116
|
+
Pass the selected value after the option name:
|
|
117
|
+
|
|
118
|
+
```bash
|
|
119
|
+
usd-convert-cad \
|
|
120
|
+
--input model.stp \
|
|
121
|
+
--output model.usdc \
|
|
122
|
+
--convert-metadata \
|
|
123
|
+
--tess-lod 3 \
|
|
124
|
+
--material-type preview-surface \
|
|
125
|
+
--up-axis z \
|
|
126
|
+
--instancing-style instanceable-reference \
|
|
127
|
+
--composition-style payload \
|
|
128
|
+
--filter-style hide \
|
|
129
|
+
--progress-frequency 4 \
|
|
130
|
+
--progress
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
## Python Package
|
|
134
|
+
|
|
135
|
+
The installed Python package exposes version helpers:
|
|
136
|
+
|
|
137
|
+
```python
|
|
138
|
+
import usd_convert_cad
|
|
139
|
+
|
|
140
|
+
print(usd_convert_cad.__version__)
|
|
141
|
+
print(usd_convert_cad.get_version())
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
The wheel also installs the canonical agent skill at
|
|
145
|
+
`usd_convert_cad/skills/omniverse-cad-to-usd/SKILL.md`.
|
|
146
|
+
|
|
147
|
+
## Uninstalling
|
|
148
|
+
|
|
149
|
+
```bash
|
|
150
|
+
python -m pip uninstall usd-convert-cad
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
## License and Third-Party Notices
|
|
154
|
+
|
|
155
|
+
The Omniverse CAD Converter is governed by the applicable
|
|
156
|
+
[NVIDIA Omniverse licensing terms](https://docs.omniverse.nvidia.com/dev-guide/latest/common/NVIDIA_Omniverse_License_Agreement.html).
|
|
157
|
+
NVIDIA licenses the Tech Soft 3D HOOPS Exchange SDK to read supported CAD data
|
|
158
|
+
for conversion to OpenUSD. See the repository [license](https://github.com/NVIDIA-Omniverse/usd-convert-cad/blob/main/LICENSE.md)
|
|
159
|
+
and [third-party notices](https://github.com/NVIDIA-Omniverse/usd-convert-cad/blob/main/THIRD_PARTY_NOTICES.md).
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: Apache-2
|
|
3
|
+
|
|
4
|
+
[build-system]
|
|
5
|
+
requires = ["wheel-stub"]
|
|
6
|
+
build-backend = "wheel_stub.buildapi"
|
|
7
|
+
|
|
8
|
+
[tool.wheel_stub]
|
|
9
|
+
index_url = "https://pypi.nvidia.com/"
|
|
10
|
+
include_cuda_debuginfo = true
|