Команди трансляції
Трансляція CAD📐CADSoftware for creating technical drawings and 3D models.View in glossary-файлів у різні формати за допомогою Model Derivative API🔄Model DerivativeAPS service for translating and extracting CAD data.View in glossary.

Огляд команд
| Команда | Опис |
|---|---|
raps translate start | Запустити завдання трансляції |
raps translate status | Перевірити статус трансляції |
raps translate manifest | Переглянути маніфест трансляції |
raps translate derivatives | Показати доступні деривативи для завантаження |
raps translate download | Завантажити деривативи |
raps translate preset | Управління пресетами трансляції |
Підтримувані формати
Вхідні формати
RAPS🌼RAPSRust CLI for Autodesk Platform Services.View in glossary підтримує всі сумісні з APS☁️APSAutodesk Platform Services - cloud APIs for CAD/BIM automation.View in glossary вхідні формати:
- Autodesk: RVT📊RVTRevit's native file format.View in glossary, DWG📄DWGAutoCAD's native file format.View in glossary, DWF, NWD👁️NWDNavisworks review file format.View in glossary, NWC, DGN
- Індустріальні: IFC🌐IFCOpen standard for BIM data exchange.View in glossary, STEP🔧STEPISO standard for 3D CAD data exchange.View in glossary, IGES📜IGESLegacy neutral CAD exchange format.View in glossary, SAT
- 3D: OBJ🎲OBJSimple 3D geometry format.View in glossary, STL🖨️STL3D printing mesh format.View in glossary, 3DS, FBX🎬FBXAutodesk's 3D animation exchange format.View in glossary, GLTF
- Та інші…
Вихідні формати
| Формат | Опис |
|---|---|
svf2 | Потоковий формат для Viewer (рекомендовано) |
svf | Застарілий потоковий формат |
thumbnail | Мініатюри у форматі PNG |
obj | Wavefront OBJ сітка |
stl | Формат сітки STL |
step | Формат CAD STEP |
iges | Формат CAD IGES |
ifc | Формат BIM🏛️BIMIntelligent 3D model-based design for buildings.View in glossary IFC |
raps translate start
Запуск завдання трансляції для завантаженого файлу.
raps translate start <urn> --format <format> [options]
Опції:
--format, -f: Вихідний формат (обов’язково)--wait, -w: Очікувати завершення--root-filename: Кореневий файл для ZIP-архівів--force: Примусова повторна трансляція
Базова трансляція:
$ raps translate start dXJuOmFkc2sub2JqZWN0cy... --format svf2
✓ Translation started
URN: dXJuOmFkc2sub2JqZWN0cy...
Status: pending
Очікування завершення:
$ raps translate start $URN --format svf2 --wait
Translation in progress...
████████████████████████████████████████ 100%
✓ Translation complete (47s)
Декілька форматів:
raps translate start $URN --format svf2
raps translate start $URN --format obj
raps translate start $URN --format thumbnail
raps translate status
Перевірка статусу завдання трансляції.
$ raps translate status $URN
Translation Status:
URN: dXJuOmFkc2sub2JqZWN0cy...
Status: success
Progress: 100%
Derivatives:
• svf2 (3D views, 2D sheets)
• thumbnail (256x256)
Очікування завершення:
$ raps translate status $URN --wait
Waiting for translation...
████████████████████████████████████████ 100%
✓ Translation complete!
JSON📋JSONStandard data interchange format.View in glossary-вивід для скриптів:
raps translate status $URN --output json | jq '.status'
raps translate manifest
Перегляд повного маніфесту трансляції з усіма деривативами.
$ raps translate manifest $URN
Manifest for: dXJuOmFkc2sub2JqZWN0cy...
Status: success
Derivatives:
┌─────────────┬────────────────────────┬────────────┐
│ Type │ Role │ Status │
├─────────────┼────────────────────────┼────────────┤
│ svf2 │ 3d │ success │
│ svf2 │ 2d │ success │
│ thumbnail │ thumbnail │ success │
└─────────────┴────────────────────────┴────────────┘
raps translate download
Завантаження файлів деривативів (OBJ, STL, STEP тощо).
raps translate download <urn> --output <directory>
$ raps translate download $URN --output ./derivatives/
Downloading derivatives...
[1/3] model.obj ████████████████████ 100%
[2/3] model.mtl ████████████████████ 100%
[3/3] textures.zip ████████████████████ 100%
✓ Downloaded to: ./derivatives/
Повний робочий процес
Завантаження та трансляція
# 1. Створити бакет
raps bucket create --key my-project --policy persistent --region US
# 2. Завантажити файл
raps object upload my-project building.rvt
# 3. Отримати URN
URN=$(raps object urn my-project building.rvt --output plain)
# 4. Запустити трансляцію
raps translate start "$URN" --format svf2 --wait
# 5. Перевірити маніфест
raps translate manifest "$URN"
Пакетний пайплайн трансляції
for file in ./models/*.dwg; do
name=$(basename "$file")
raps object upload my-bucket "$file"
URN=$(raps object urn my-bucket "$name" --output plain)
raps translate start "$URN" --format svf2
echo "Started translation for $name"
done
Пресети трансляції
Використовуйте пресети для типових робочих процесів:
# Висока якість для презентацій
raps translate start $URN --format svf2 --preset high-quality
# Швидкий попередній перегляд
raps translate start $URN --format svf2 --preset fast
Усунення неполадок
Помилка “Translation failed”
- Перевірте маніфест для отримання детальних повідомлень про помилки:
raps translate manifest $URN --output json - Переконайтеся, що вихідний файл валідний
- Перевірте, що формат файлу підтримується
Помилка “Derivative not found”
- Переконайтеся, що трансляція завершилася успішно
- Перевірте маніфест на наявність доступних деривативів
- Дочекайтеся завершення трансляції, використовуючи
--wait
Наступні кроки
- Керування даними — Робота з проєктами BIM 360🔵BIM 360Legacy Autodesk construction platform (predecessor to ACC).View in glossary/ACC🏗️ACCAutodesk's construction management platform.View in glossary
- Design Automation — Автоматизація обробки CAD