You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[BUG] ensure app temp dir exists before loading sources
[BUG] only set selection clipboard on OS that supports it
[ENH] display absolute path to program in about dialog
[ENH] theme/icon support, add missing icons, move off django icons
[EHN] Rewrite file parsers to move read/write logic out of init
[MNT] rm deprecated -dark flag
[MNT] better defaults for diff and text editor on Windows
[DOC] clarify install instructions
Signed-off-by: mds-dwa <mark.sandell@dreamworks.com>
The preferred icon set that usdmanager was originally developed with is Crystal Project Icons. These icons are licensed
123
-
under LGPL and available via pypi and GitHub here: https://github.com/ambv/django-crystal-small. While not required for
124
-
the application to work, if you would like these icons to get the most out of the application, please install them to a
125
-
directory named crystal_project under one of the directories listed by `Qt.QtGui.QIcon.themeSearchPaths()` (e.g.
126
-
/usr/share/icons/crystal_project).
128
+
under LGPL and available via PyPI and GitHub here: https://github.com/mds-dwa/crystal-small. While not required for
129
+
the application to work, if you would like these icons to get the most out of the application, please ensure crystal-small
130
+
is installed via pip (already part of the default setup) or install them to a directory named crystal_project under one
131
+
of the directories listed by `Qt.QtGui.QIcon.themeSearchPaths()` (e.g. /usr/share/icons/crystal_project).
127
132
128
133
Additional icons for custom plug-ins can be placed in the plugins directory and then added to the
129
134
[usdmanager/plugins/images.qrc](https://github.com/dreamworksanimation/usdmanager/blob/master/usdmanager/plugins/images.qrc) file. After adding a file to images.rc, run the
- Install Python 2 ([https://www.python.org/downloads/](https://www.python.org/downloads/)), or 3 if on the python3 branch.
20
20
***Windows:** Ensure the install location is part of your PATH variable (newer installs should have an option for this)
21
21
- Install one of the recommended Python Qt bindings
22
22
***Python 2:** PyQt4 or PySide
23
+
***Python 3:** PyQt5 or PySide2, example:
24
+
```
25
+
pip install PySide2
26
+
```
23
27
24
28
## Install with setup.py
25
29
@@ -65,23 +69,20 @@ and this will depend on your setup.py install settings.
65
69
3. Customize usdmanager/config.json if needed.
66
70
4. Run ```python setup.py install``` (may need the ```--user``` flag)
67
71
68
-
If setup.py complains about missing setuptools, you can install it via pip. If you installed a new enough python-2 version, pip should already be handled for you, but you may still need to add it to your PATH. pip should already live somewhere like this (C:\Python27\Scripts\pip.exe), and you can permanently add it to your environment with: ```setx PATH "%PATH%;C:\Python27\Scripts"```
72
+
If setup.py complains about missing setuptools, you can install it via pip. If you installed a new enough python version, pip should already be handled for you, but you may still need to add it to your PATH. pip should already live somewhere like this (C:\Python27\Scripts\pip.exe or C:\Users\username\AppData\Local\Microsoft\WindowsApps\pip.exe), but if needed, you can permanently add it to your environment with this (adjusting the path as needed): ```setx PATH "%PATH%;C:\Python27\Scripts"```
69
73
70
74
1. Upgrade pip if needed
71
75
1. Launch Command Prompt in Administrator mode
72
76
2. Run ```pip install pip --upgrade``` (may need the ```--user``` flag)
73
77
2. Install setuptools if needed
74
78
1. Run ```pip install setuptools```
75
79
3. Re-run the setup.py step above for usdmanager
76
-
4. If you don't modify your path, you should now be able to run something like this to launch the program: ```python C:\Python27\Scripts\usdmanager```
80
+
4. If you don't modify your path, you should now be able to run something like this to launch the program: ```python C:\Python27\Scripts\usdmanager``` or from the install directory itself, e.g. ``` python .\build\scripts-3.8\usdmanager```
77
81
78
82
#### Known Issues
79
-
-Drive letter may show doubled-up in address bar (e.g. C:C:/my_file.txt)
83
+
- Since this is not installed as an entirely self-contained package, the application name (and icon) will by Python, not USD Manager.
80
84
81
85
## Common Problems
82
-
- Missing icons (may still be missing some even after this!)
83
-
*```pip install django-crystal-small``` (this also installs django by default, which you may not want)
84
-
* Add installed path to your downloaded usdmanager/config.json file, then re-run the setup.py install. You'll need a line similar to this in your config.json: ```"themeSearchPaths": ["C:\\Python27\\Lib\\site-packages\\django_crystal_small\\static\\crystal"]```
85
86
- Can't open files in external text editor
86
-
* In Preferences, try setting your default text editor
87
-
***Windows:** Try ```notepad.exe```or```"C:\Windows\notepad.exe"``` (including the quotation marks)
87
+
* In Preferences, update your default text editor
88
+
* **Windows:** Try ```notepad```, ```notepad.exe```, or ```"C:\Windows\notepad.exe"``` (including the quotation marks on that last one)
0 commit comments