Converted readme to markdown
This commit is contained in:
Chuck Walbourn
Родитель
cfdd3a09ad
Коммит
cdc865b667
|
|
@ -0,0 +1,117 @@
|
|||
# UVAtlas - isochart texture atlasing
|
||||
|
||||
http://go.microsoft.com/fwlink/?LinkID=512686
|
||||
|
||||
Release available for download on [GitHub](https://github.com/microsoft/UVAtlas/releases)
|
||||
|
||||
## Release History
|
||||
|
||||
### December 17, 2019
|
||||
* Added VS 2019 UWP project
|
||||
* Added ARM64 platform to VS 2019 Win32 desktop Win10 project
|
||||
* Renamed ``UVAtlas_Windows10.vcxproj`` to ``_Windows10_2017.vcxproj``
|
||||
* Added CMake project files
|
||||
* Code cleanup
|
||||
|
||||
### April 26, 2019
|
||||
* uvatlas command-line tool: Updated for latest DirectXMesh
|
||||
* Added VS 2019 desktop projects
|
||||
* Officially dropped Windows Vista support
|
||||
|
||||
### February 8, 2019
|
||||
* uvatlastool: added ``-sdkmesh2`` switch for PBR materials
|
||||
|
||||
### November 16, 2018
|
||||
* VS 2017 updated for Windows 10 October 2018 Update SDK (17763)
|
||||
* ARM64 platform configurations added to UWP projects
|
||||
* Minor code review
|
||||
|
||||
### August 17, 2018
|
||||
* Updated for VS 2017 15.8
|
||||
* Code cleanup
|
||||
|
||||
### July 3, 2018
|
||||
* Code cleanup
|
||||
* uvatlastool: added ``-flipu`` and ``-ib32`` switches
|
||||
|
||||
### May 31, 2018
|
||||
* VS 2017 updated for Windows 10 April 2018 Update SDK (17134)
|
||||
|
||||
### May 14, 2018
|
||||
* Updated for VS 2017 15.7 update warnings
|
||||
* Code and project cleanup
|
||||
* Retired VS 2013 projects
|
||||
|
||||
### April 23, 2018
|
||||
* Code and project cleanup
|
||||
|
||||
### February 7, 2018
|
||||
* Minor code update
|
||||
|
||||
### December 13, 2017
|
||||
* Updated for VS 2017 15.5 update warnings
|
||||
|
||||
### November 1, 2017
|
||||
* VS 2017 updated for Windows 10 Fall Creators Update SDK (16299)
|
||||
* Removed ``UVAtlas_2017.vcxproj`` as redundant in favor of ``UVAtlas_2017_Win10.vcxproj``
|
||||
|
||||
### September 22, 2017
|
||||
* Updated for VS 2017 15.3 update ``/permissive-`` changes
|
||||
* uvatlastool: added ``-flist`` option
|
||||
|
||||
### July 28, 2017
|
||||
* Code cleanup
|
||||
|
||||
### April 24, 2017
|
||||
* VS 2017 project updates
|
||||
|
||||
### April 8, 2017
|
||||
* VS 2017 updated for Windows Creators Update SDK (15063)
|
||||
* Minor code cleanup
|
||||
|
||||
### January 31, 2017
|
||||
* uvatlas command-line tool: Updated for latest DirectXMesh
|
||||
* uvatlas command-line tool: optional OpenEXR support
|
||||
* VS 2017 RC projects added
|
||||
* Minor code cleanup
|
||||
|
||||
### September 14, 2016
|
||||
* uvatlas command-line tool: added wildcard support for input filename and optional ``-r`` switch for recursive search
|
||||
* uvatlas command-line tool ``-it`` switch now supports HDR (RGBE Radiance) texture files (requires DirectXTex September 2016 release to build)
|
||||
* Code cleanup
|
||||
|
||||
### August 2, 2016
|
||||
* Updated for VS 2015 Update 3 and Windows 10 SDK (14393)
|
||||
|
||||
### June 27, 2016
|
||||
* Code cleanup
|
||||
|
||||
### April 26, 2016
|
||||
* Retired VS 2012 projects and obsolete adapter code
|
||||
* Minor code cleanup
|
||||
|
||||
### November 30, 2015
|
||||
* uvatlas command-line tool updated with ``-flipv`` and ``-flipz`` switches; removed ``-fliptc``
|
||||
* Updated for VS 2015 Update 1 and Windows 10 SDK (10586)
|
||||
|
||||
### October 30, 2015
|
||||
* Minor code cleanup
|
||||
|
||||
### July 29, 2015
|
||||
* Updated for VS 2015 and Windows 10 SDK RTM
|
||||
* Retired VS 2010 and Windows 8.0 Store projects
|
||||
|
||||
### June 18, 2015
|
||||
* Fixed bugs with handling of ``E_ABORT`` from user callback
|
||||
* Added ESC to abort to uvatlas sample
|
||||
|
||||
### April 9, 2015
|
||||
* Added projects for Windows apps Technical Preview
|
||||
* Fixes for potential divide-by-zero cases
|
||||
* Fix for memory allocation problem
|
||||
* Added error detection for invalid partitioning
|
||||
* uvatlastool: fix when importing from .vbo
|
||||
* Minor code cleanup
|
||||
|
||||
### November 12, 2014
|
||||
* Original release
|
||||
|
|
@ -0,0 +1,77 @@
|
|||
|
||||
|
||||
# UVAtlas - isochart texture atlasing
|
||||
|
||||
http://go.microsoft.com/fwlink/?LinkID=512686
|
||||
|
||||
Copyright (c) Microsoft Corporation. All rights reserved.
|
||||
|
||||
**December 17, 2019**
|
||||
|
||||
This package contains UVAtlas, a shared source library for creating and packing an isochart texture atlas.
|
||||
|
||||
This code is designed to build with Visual Studio 2017 ([15.9](https://walbourn.github.io/vs-2017-15-9-update/)), Visual Studio 2019, or clang for Windows v9. It is recommended that you make use of the Windows 10 May 2019 Update SDK ([18362](https://walbourn.github.io/windows-10-may-2019-update/)).
|
||||
|
||||
These components are designed to work without requiring any content from the legacy DirectX SDK. For details, see [Where is the DirectX SDK?](https://aka.ms/dxsdk).
|
||||
|
||||
## Directory Layout
|
||||
|
||||
* ``Inc\``
|
||||
|
||||
+ Public Header File (in the DirectX C++ namespace):
|
||||
|
||||
* UVtlas.h
|
||||
- UVAtlasCreate
|
||||
- UVAtlasPartition
|
||||
- UVAtlasPack
|
||||
- UVAtlasComputeIMTFromPerVertexSignal
|
||||
- UVAtlasComputeIMTFromSignal
|
||||
- UVAtlasComputeIMTFromTexture
|
||||
- UVAtlasComputeIMTFromPerTexelSignal
|
||||
- UVAtlasApplyRemap
|
||||
|
||||
* ``geodesics\``, ``isochart\``
|
||||
|
||||
+ Library source files
|
||||
|
||||
* ``UVAtasTool\``
|
||||
|
||||
+ Command line tool and sample for UVAtlas library
|
||||
|
||||
> To build this tool, you need the DirectXTex (http://go.microsoft.com/fwlink/?LinkId=248926) and DirectXMesh (http://go.microsoft.com/fwlink/?LinkID=324981) libraries in the following directory structure:
|
||||
|
||||
.\DirectXTex\DirectXTex
|
||||
.\DirectXMesh\DirectXMesh
|
||||
.\DirectXMesh\Utilities
|
||||
.\UVAtlas\UVAtlas
|
||||
.\UVAtlas\UVAtlasTool
|
||||
|
||||
## Documentation
|
||||
|
||||
Documentation is available on the [GitHub wiki](https://github.com/Microsoft/UVAtlas/wiki).
|
||||
|
||||
## Notices
|
||||
|
||||
All content and source code for this package are subject to the terms of the [MIT License](http://opensource.org/licenses/MIT).
|
||||
|
||||
For the latest version of UVAtlas, bug reports, etc. please visit the project site on [GitHub](https://github.com/microsoft/UVAtlas).
|
||||
|
||||
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
|
||||
|
||||
## Further reading
|
||||
|
||||
Zhou et al, "Iso-charts: Stretch-driven Mesh Parameterization using Spectral Analysis",
|
||||
Eurographics Symposium on Geometry Processing (2004) [pdf](
|
||||
http://research.microsoft.com/en-us/um/people/johnsny/papers/isochart.pdf)
|
||||
|
||||
Sander et al. "Signal-Specialized Parametrization" Europgraphics 2002 [pdf](http://research.microsoft.com/en-us/um/people/johnsny/papers/ssp.pdf)
|
||||
|
||||
## Release Notes
|
||||
|
||||
* The VS 2017/2019 projects make use of ``/permissive-`` for improved C++ standard conformance. Use of a Windows 10 SDK prior to the Fall Creators Update (16299) or an Xbox One XDK prior to June 2017 QFE 4 may result in failures due to problems with the system headers. You can work around these by disabling this switch in the project files which is found in the ``<ConformanceMode>`` elements, or in some cases adding ``/Zc:twoPhase-`` to the ``<AdditionalOptions>`` elements.
|
||||
|
||||
* The VS 2017 projects require the 15.5 update or later. For UWP and Win32 classic desktop projects with the 15.5 - 15.7 updates, you need to install the standalone Windows 10 SDK (17763) which is otherwise included in the 15.8.6 or later update. Older VS 2017 updates will fail to load the projects due to use of the <ConformanceMode> element. If using the 15.5 or 15.6 updates, you will see ``warning D9002: ignoring unknown option '/Zc:__cplusplus'`` because this switch isn't supported until 15.7. It is safe to ignore this warning, or you can edit the project files ``<AdditionalOptions>`` elements.
|
||||
|
||||
* The VS 2019 projects use a ``<WindowsTargetPlatformVersion>`` of ``10.0`` which indicates to use the latest installed version. This should be Windows 10 SDK (17763) or later.
|
||||
|
||||
* The UWP projects and the VS 2019 Win10 classic desktop project include configurations for the ARM64 platform. These require VS 2017 (15.9 update) or VS 2019 to build, with the ARM64 toolset installed.
|
||||
209
Readme.txt
209
Readme.txt
|
|
@ -1,209 +0,0 @@
|
|||
-----------------------------------
|
||||
UVAtlas - isochart texture atlasing
|
||||
-----------------------------------
|
||||
|
||||
Copyright (c) Microsoft Corporation. All rights reserved.
|
||||
|
||||
December 17, 2019
|
||||
|
||||
This package contains UVAtlas, a shared source library for creating and packing an
|
||||
isochart texture atlas.
|
||||
|
||||
This code is designed to build with Visual Studio 2015 Update 3, Visual Studio 2017,
|
||||
or Visual Studio 2019. It is recommended that you make use of VS 2015 Update 3,
|
||||
Windows Tools 1.4.1, and the Windows 10 Anniversary Update SDK (14393) -or-
|
||||
VS 2017 (15.9 update) / VS 2019 with the Windows 10 May 2019 Update SDK (18362).
|
||||
|
||||
These components are designed to work without requiring any content from the
|
||||
legacy DirectX SDK. For details, see "Where is the DirectX SDK?"
|
||||
<https://aka.ms/dxsdk>.
|
||||
|
||||
Inc\
|
||||
Public Header File (in the DirectX C++ namespace):
|
||||
|
||||
UVtlas.h
|
||||
- UVAtlasCreate
|
||||
- UVAtlasPartition
|
||||
- UVAtlasPack
|
||||
- UVAtlasComputeIMTFromPerVertexSignal
|
||||
- UVAtlasComputeIMTFromSignal
|
||||
- UVAtlasComputeIMTFromTexture
|
||||
- UVAtlasComputeIMTFromPerTexelSignal
|
||||
- UVAtlasApplyRemap
|
||||
|
||||
geodesics\
|
||||
isochart\
|
||||
Library source files
|
||||
|
||||
UVAtasTool\
|
||||
Command line tool and sample for UVAtlas library
|
||||
|
||||
To build this tool, you need the DirectXTex (http://go.microsoft.com/fwlink/?LinkId=248926)
|
||||
and DirectXMesh (http://go.microsoft.com/fwlink/?LinkID=324981) libraries in the following
|
||||
directory structure:
|
||||
.\DirectXTex\DirectXTex
|
||||
.\DirectXMesh\DirectXMesh
|
||||
.\DirectXMesh\Utilities
|
||||
.\UVAtlas\UVAtlas
|
||||
.\UVAtlas\UVAtlasTool
|
||||
|
||||
All content and source code for this package are subject to the terms of the MIT License.
|
||||
<http://opensource.org/licenses/MIT>.
|
||||
|
||||
Documentation is available at <https://github.com/Microsoft/UVAtlas/wiki>.
|
||||
|
||||
For the latest version of UVAtlas, bug reports, etc. please visit the project site.
|
||||
|
||||
http://go.microsoft.com/fwlink/?LinkID=512686
|
||||
|
||||
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the
|
||||
Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
|
||||
|
||||
https://opensource.microsoft.com/codeofconduct/
|
||||
|
||||
Further reading:
|
||||
|
||||
Zhou et al, "Iso-charts: Stretch-driven Mesh Parameterization using Spectral Analysis",
|
||||
Eurographics Symposium on Geometry Processing (2004)
|
||||
http://research.microsoft.com/en-us/um/people/johnsny/papers/isochart.pdf
|
||||
|
||||
Sander et al. "Signal-Specialized Parametrization" Europgraphics 2002
|
||||
http://research.microsoft.com/en-us/um/people/johnsny/papers/ssp.pdf
|
||||
|
||||
|
||||
-------------
|
||||
RELEASE NOTES
|
||||
-------------
|
||||
|
||||
* The VS 2017/2019 projects make use of /permissive- for improved C++ standard
|
||||
conformance. Use of a Windows 10 SDK prior to the Fall Creators Update (16299)
|
||||
or an Xbox One XDK prior to June 2017 QFE 4 may result in failures due to
|
||||
problems with the system headers. You can work around these by disabling this
|
||||
switch in the project files which is found in the <ConformanceMode> elements.
|
||||
|
||||
* The VS 2017 projects require the 15.5 update or later. For UWP and Win32
|
||||
classic desktop projects with the 15.5 - 15.7 updates, you need to install the
|
||||
standalone Windows 10 SDK (17763) which is otherwise included in the 15.8.6 or
|
||||
later update. Older VS 2017 updates will fail to load the projects due to use
|
||||
of the <ConformanceMode> element. If using the 15.5 or 15.6 updates, you will
|
||||
see "warning D9002: ignoring unknown option '/Zc:__cplusplus'" because this
|
||||
switch isn't supported until 15.7. It is safe to ignore this warning, or you
|
||||
can edit the project files <AdditionalOptions> elements.
|
||||
|
||||
* The UWP projects include configurations for the ARM64 platform. These require
|
||||
VS 2017 (15.9 update) or VS 2019 to build.
|
||||
|
||||
|
||||
---------------
|
||||
RELEASE HISTORY
|
||||
---------------
|
||||
|
||||
December 17, 2019
|
||||
Added VS 2019 UWP project
|
||||
Added ARM64 platform to VS 2019 Win32 desktop Win10 project
|
||||
Renamed UVAtlas_Windows10.vcxproj to _Windows10_2017.vcxproj
|
||||
Added CMake project files
|
||||
Code cleanup
|
||||
|
||||
April 26, 2019
|
||||
uvatlas command-line tool: Updated for latest DirectXMesh
|
||||
Added VS 2019 desktop projects
|
||||
Officially dropped Windows Vista support
|
||||
|
||||
February 8, 2019
|
||||
uvatlastool: added -sdkmesh2 switch for PBR materials
|
||||
|
||||
November 16, 2018
|
||||
VS 2017 updated for Windows 10 October 2018 Update SDK (17763)
|
||||
ARM64 platform configurations added to UWP projects
|
||||
Minor code review
|
||||
|
||||
August 17, 2018
|
||||
Updated for VS 2017 15.8
|
||||
Code cleanup
|
||||
|
||||
July 3, 2018
|
||||
Code cleanup
|
||||
uvatlastool: added -flipu and -ib32 switches
|
||||
|
||||
May 31, 2018
|
||||
VS 2017 updated for Windows 10 April 2018 Update SDK (17134)
|
||||
|
||||
May 14, 2018
|
||||
Updated for VS 2017 15.7 update warnings
|
||||
Code and project cleanup
|
||||
Retired VS 2013 projects
|
||||
|
||||
April 23, 2018
|
||||
Code and project cleanup
|
||||
|
||||
February 7, 2018
|
||||
Minor code update
|
||||
|
||||
December 13, 2017
|
||||
Updated for VS 2017 15.5 update warnings
|
||||
|
||||
November 1, 2017
|
||||
VS 2017 updated for Windows 10 Fall Creators Update SDK (16299)
|
||||
Removed UVAtlas_2017.vcxproj as redundant in favor of UVAtlas_2017_Win10.vcxproj
|
||||
|
||||
September 22, 2017
|
||||
Updated for VS 2017 15.3 update /permissive- changes
|
||||
uvatlastool: added -flist option
|
||||
|
||||
July 28, 2017
|
||||
Code cleanup
|
||||
|
||||
April 24, 2017
|
||||
VS 2017 project updates
|
||||
|
||||
April 8, 2017
|
||||
VS 2017 updated for Windows Creators Update SDK (15063)
|
||||
Minor code cleanup
|
||||
|
||||
January 31, 2017
|
||||
uvatlas command-line tool: Updated for latest DirectXMesh
|
||||
uvatlas command-line tool: optional OpenEXR support
|
||||
VS 2017 RC projects added
|
||||
Minor code cleanup
|
||||
|
||||
September 14, 2016
|
||||
uvatlas command-line tool: added wildcard support for input filename and optional -r switch for recursive search
|
||||
uvatlas command-line tool -it switch now supports HDR (RGBE Radiance) texture files (requires DirectXTex September 2016 release to build)
|
||||
Code cleanup
|
||||
|
||||
August 2, 2016
|
||||
Updated for VS 2015 Update 3 and Windows 10 SDK (14393)
|
||||
|
||||
June 27, 2016
|
||||
Code cleanup
|
||||
|
||||
April 26, 2016
|
||||
Retired VS 2012 projects and obsolete adapter code
|
||||
Minor code cleanup
|
||||
|
||||
November 30, 2015
|
||||
uvatlas command-line tool updated with -flipv and -flipz switches; removed -fliptc
|
||||
Updated for VS 2015 Update 1 and Windows 10 SDK (10586)
|
||||
|
||||
October 30, 2015
|
||||
Minor code cleanup
|
||||
|
||||
July 29, 2015
|
||||
Updated for VS 2015 and Windows 10 SDK RTM
|
||||
Retired VS 2010 and Windows 8.0 Store projects
|
||||
|
||||
June 18, 2015
|
||||
Fixed bugs with handling of E_ABORT from user callback
|
||||
Added ESC to abort to uvatlas sample
|
||||
|
||||
April 9, 2015
|
||||
Added projects for Windows apps Technical Preview
|
||||
Fixes for potential divide-by-zero cases
|
||||
Fix for memory allocation problem
|
||||
Added error detection for invalid partitioning
|
||||
uvatlastool: fix when importing from .vbo
|
||||
Minor code cleanup
|
||||
|
||||
November 12, 2014
|
||||
Original release
|
||||
Загрузка…
Ссылка в новой задаче