{"id":13831598,"url":"https://github.com/drwave/usd-sketchup","last_synced_at":"2025-07-09T15:32:23.244Z","repository":{"id":73580236,"uuid":"146032259","full_name":"drwave/usd-sketchup","owner":"drwave","description":"Source \u0026 macOS binary of USD exporter for SketchUp","archived":false,"fork":false,"pushed_at":"2019-08-12T22:20:47.000Z","size":26203,"stargazers_count":62,"open_issues_count":12,"forks_count":5,"subscribers_count":12,"default_branch":"master","last_synced_at":"2024-08-05T10:17:49.908Z","etag":null,"topics":["arkit2","sketchup-plugin","usd","usda","usdz"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/drwave.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-08-24T19:32:14.000Z","updated_at":"2024-05-16T09:22:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"92c90e67-a362-422c-bb54-79b21d609ed7","html_url":"https://github.com/drwave/usd-sketchup","commit_stats":{"total_commits":72,"total_committers":4,"mean_commits":18.0,"dds":"0.33333333333333337","last_synced_commit":"1d2438302f94213c4efe0597a1cafc438eaceb59"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drwave%2Fusd-sketchup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drwave%2Fusd-sketchup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drwave%2Fusd-sketchup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drwave%2Fusd-sketchup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/drwave","download_url":"https://codeload.github.com/drwave/usd-sketchup/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225565872,"owners_count":17489273,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arkit2","sketchup-plugin","usd","usda","usdz"],"created_at":"2024-08-04T10:01:32.594Z","updated_at":"2024-11-20T13:31:00.176Z","avatar_url":"https://github.com/drwave.png","language":"C++","funding_links":[],"categories":["C++","Integrations"],"sub_categories":[],"readme":"Universal Scene Description Exporter for SketchUp\n=================================================\n\nThis plug-in adds the ability to export [Pixar's Universal Scene\nDescription](http://openusd.org/docs/index.html) files from [SketchUp\nPro](https://www.sketchup.com). It has been tested with SketchUp Pro\n2016, 2017, 2018 and 2019.\n\nIt adds three options to the **File**-\u003e**Export**-\u003e**3D Model** menu:\n\n- Pixar USD binary File (*.usd)\n- Pixar USD ASCII File (*.usda)\n- Pixar USDZ  File (*.usdz)\n\nThere are also options on the export panel to conditionally export\n**normals**, **curves**, **edges**, and **lines**, as well as the\nability to organize the USD as a **single file** or as a **set of\nfiles** that reference each other.\n\nThe [**usdz**](https://graphics.pixar.com/usd/docs/Usdz-File-Format-Specification.html) files this exporter writes out takes care to write out in a way that is compatible with Apple's [ARKit 2](https://developer.apple.com/arkit/), which is more constrained than the general [**usdz** specification](https://graphics.pixar.com/usd/docs/Usdz-File-Format-Specification.html), but that support can be toggled on or off in the **Options...** dialog.\n\nThe exporter also leverages the new\n[UsdPreviewSurface](https://graphics.pixar.com/usd/docs/UsdPreviewSurface-Proposal.html)\nto support texture export from SketchUp.\n\nGetting the Prebuilt Plugin for macOS\n------------------------------\n\nWe are providing a pre-built version of the plug-in\n[here](https://github.com/drwave/usd-sketchup/blob/master/USDExporter.plugin.zip). After\ndownloading, you'll want to copy it into the **PlugIns** directory\ninside the SketchUp Pro app bundle.  You can do this from the Terminal\nby the following. Note you will need to type an admin password, as\nthat directory is probably write-protected.\n\n```\nsudo cp -rf USDExporter.plugin /Applications/SketchUp\\ 2018/SketchUp.app/Contents/PlugIns/\n```\n\nOnce you have copied it there, you should see the 3 USD export options\nunder the **File**-\u003e**Export**-\u003e**3D Model** menu.\n\nThis build has been (lightly) tested on SketchUp 2019 (Version\n19.2.221) on macOS 10.14.6, and was built with Xcode 10.3 (10G8)\n\nGetting Help\n------------\n\nNeed help understanding certain concepts in USD? See [Getting Help\nwith USD](http://openusd.org/docs/Getting-Help-with-USD.html) or visit\nthe [forum](https://groups.google.com/forum/#!forum/usd-interest).\n\nIf you are experiencing undocumented problems with the software,\nplease [file a\nbug](https://github.com/drwave/usd-sketchup/issues/new).\n\nSupported Platforms\n-------------------\n\nSketchUp Pro runs on macOS and Windows, but this plug-in is\n**currently only supported on macOS**.\n\nThis plug-in was developed on macOS but care has been taken to make\nsure that, as much as possible, it should be straightforward to port\nto Windows. Both [SketchUp's SDK (*developer account\nrequired*)](https://extensions.sketchup.com/en/developer_center/sketchup_sdk)\non Windows and macOS contain an example plug-in called `skp_to_xml`,\nwhich this plug-in took inspiration from, so if someone wants to port\nthis to Windows they should just need to look in the\n`SDK/samples/skp_to_xml/win/` and in the `USD SketchUp Mac` folder\nhere and do the equivalent for Windows.\n\nDependencies\n------------\n\n| Name | Version |\n| ---- | ------- |\n| [macOS](https://www.apple.com/mac/) | 10.13 or higher | \n| [SketchUp Pro](https://www.sketchup.com/download/all) | 2016 or higher | \n| [Xcode](https://developer.apple.com/xcode) | 9 or higher |\n| [SketchUp SDK](https://extensions.sketchup.com/en/developer_center/sketchup_sdk) | recent|\n| [USD](https://github.com/PixarAnimationStudios/USD) | 18.09 or higher |\n\n\nGetting and Building the Code\n-----------------------------\n\n\n#### 1. Install prerequisites (see [Dependencies](#dependencies) for required versions)\n\nNote: to build this plug-in you will need a [SketchUp Developer/Trimble account](https://developer.sketchup.com/en) and an [Apple Developer account](https://developer.apple.com/account/).\n\nThe rest of these instructions assume you have a\n[Mac](https://www.apple.com/mac/) with\n[Xcode](https://developer.apple.com/xcode) and [SketchUp\nPro](https://www.sketchup.com/download/all) installed.\n\n#### 2. Download the USD source code\n\nYou can download source code archives from [GitHub](https://www.github.com/PixarAnimationStudios/USD) or use ```git``` to clone the repository.\n\n```\ngit clone https://github.com/PixarAnimationStudios/USD\n```\n\n#### 3. Run the USD build script\n\n##### MacOS:\n\nIn a terminal, run ```xcode-select``` to ensure command line developer\ntools are installed. Then run the script. We recommend building\nwithout Python, without imaging, and as a monolithic library that\nincludes tbb in it. The included Xcode project assumes that it has\nbeen built that way and installed into\n```/opt/local/USDForSketchUp```.\n\n```\npython USD/build_scripts/build_usd.py --build-args TBB,extra_inc=big_iron.inc --no-python --no-imaging --no-usdview --build-monolithic /opt/local/USDForSketchUp\n```\n\n#### 4. Download the SketchUp SDK\n\nOnce you login to the [Trimble/SketchUp developer\naccount](https://extensions.sketchup.com/en/developer_center/sketchup_sdk)\n(*look in upper right corner of that linked page*), download the\n[SDK](https://extensions.sketchup.com/en/developer_center/sketchup_sdk). Unzip\nand install this somewhere on your machine, for example,\n```~/SketchUpSDKs/SDK_Mac_2019-0-752_0```\n\n#### 5. Download the USD SketchUp exporter plug-in source code\n\nYou can download source code archives from\n[GitHub](https://www.github.com/drwave/usd-sketchup) or use ```git```\nto clone the repository.\n\n```\ngit clone https://github.com/drwave/usd-sketchup\n```\n\nAt the top level of the repository, make a link to the SketchUp SDK\nyou installed. For example, if the SDK you downloaded was\n```SDK_Mac_18-0-18665``` and you put it in a subdirectory off your\nhome directory called ```SketchUpSDKs```, you would do:\n\n```\ncd usd-sketchup\nln -s ~/SketchUpSDKs/SDK_Mac_2019-0-752_0 SDK_Mac\n```\n#### 6. Build the USD SketchUp exporter plugin\n\nLaunch Xcode on the [project\nfile](https://github.com/drwave/usd-sketchup/tree/master/usd-sketchup.xcodeproj). You\nmay need to fix up various things in the Xcode file that are specific\nto your build if you have changed them (i.e. installed USD in a\ndifferent location, have a different version of SketchUp installed,\netc.).\n\nYou should create symlinks for SketchUp SDK (as `SDK_Mac`) and USD (as `USD`) in this folder.\n\nFor example:\n```\nln -s /Users/\u003cyou\u003e/SketchUpSDKs/SDK_Mac_2019-0-752_0 ./lib/SDK_Mac\nln -s /opt/local/USDForSketchUp ./lib/USD\n```\n\nThe Xcode project assumes that you are building for **SketchUp Pro\n2019**, and building the target will actually copy the resulting\n```USDExporter.plugin``` into SketchUp Pro's app bundle in the PlugIns\ndirectory, i.e. ```/Applications/SketchUp\\\n2019/SketchUp.app/Contents/PlugIns/```.\n\nInitially, that directory will probably not be writable on your machine, so you may need to make it writable:\n\n```\nsudo chmod a+w /Applications/SketchUp\\ 2019/SketchUp.app/Contents/PlugIns/\n```\n\nCopying the plug-in to the directory makes it very easy to debug the\nplug-in, as you can launch SketchUp Pro from inside of Xcode, set\nbreakpoints in your plug-in, etc. Very handy when doing development.\n\n#### 6. Build the USD SketchUp exporter command line app\n\nLaunch Xcode on the [project\nfile](https://github.com/drwave/usd-sketchup/tree/master/usd-sketchup.xcodeproj). You\nmay need to fix up various things in the Xcode file that are specific\nto your build if you have changed them (i.e. installed USD in a\ndifferent location, have a different version of SketchUp installed,\netc.).\n\n\nContributing\n------------\n\nIf you'd like to contribute to this USD plug-in (and we appreciate the\nhelp!), please see the\n[Contributing](http://openusd.org/docs/Contributing-to-USD.html) page\nin the documentation for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrwave%2Fusd-sketchup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdrwave%2Fusd-sketchup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrwave%2Fusd-sketchup/lists"}