Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/PixarAnimationStudios/OpenSubdiv

An Open-Source subdivision surface library.
https://github.com/PixarAnimationStudios/OpenSubdiv

Last synced: about 2 months ago
JSON representation

An Open-Source subdivision surface library.

Host: GitHub
URL: https://github.com/PixarAnimationStudios/OpenSubdiv
Owner: PixarAnimationStudios
License: other
Created: 2012-04-24T00:12:00.000Z (about 12 years ago)
Default Branch: release
Last Pushed: 2023-11-06T09:54:07.000Z (8 months ago)
Last Synced: 2024-01-31T09:09:13.298Z (5 months ago)
Language: C++
Homepage: graphics.pixar.com/opensubdiv
Size: 65.5 MB
Stars: 2,803
Watchers: 304
Forks: 556
Open Issues: 49
Metadata Files:
- Readme: README.md
- License: LICENSE.txt

Lists

awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
macOS-iOS-iPadOS-Guide - OpenSubdiv
Developer-Handbook - OpenSubdiv
awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
fucking-awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-cpp-completed - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-stars - PixarAnimationStudios/OpenSubdiv - An Open-Source subdivision surface library. (C++)
awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-cpp-completed - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)
awesome-cpp - OpenSubdiv - Pixar's library for evaluating and rendering subdivision surfaces on CPU and GPU. [Modified Apache2] (Graphics)

README

        # OpenSubdiv

OpenSubdiv is a set of open source libraries that implement high performance subdivision surface (subdiv) evaluation on massively parallel CPU and GPU architectures. This codepath is optimized for drawing deforming subdivs with static topology at interactive framerates. The resulting limit surface matches Pixar's Renderman to numerical precision.

OpenSubdiv is covered by the Apache license, and is free to use for commercial or non-commercial use. This is the same code that Pixar uses internally for animated film production. Our intent is to encourage high performance accurate subdiv drawing by giving away the "good stuff".

Feel free to use it and let us know what you think.

For more details about OpenSubdiv, see [Pixar Graphics Technologies](http://graphics.pixar.com).

|         |   Linux   |  Windows  |   macOS   |

|:-------:|:---------:|:---------:|:---------:|

|   dev   | [![Build Status](https://dev.azure.com/PixarAnimationStudios/OpenSubdiv/_apis/build/status/PixarAnimationStudios.OpenSubdiv?branchName=dev&jobName=Linux)](https://dev.azure.com/PixarAnimationStudios/OpenSubdiv/_build/latest?definitionId=2&branchName=dev) | [![Build Status](https://dev.azure.com/PixarAnimationStudios/OpenSubdiv/_apis/build/status/PixarAnimationStudios.OpenSubdiv?branchName=dev&jobName=Windows)](https://dev.azure.com/PixarAnimationStudios/OpenSubdiv/_build/latest?definitionId=2&branchName=dev) | [![Build Status](https://dev.azure.com/PixarAnimationStudios/OpenSubdiv/_apis/build/status/PixarAnimationStudios.OpenSubdiv?branchName=dev&jobName=macOS)](https://dev.azure.com/PixarAnimationStudios/OpenSubdiv/_build/latest?definitionId=2&branchName=dev) |

|  release | [![Build Status](https://dev.azure.com/PixarAnimationStudios/OpenSubdiv/_apis/build/status/PixarAnimationStudios.OpenSubdiv?branchName=release&jobName=Linux)](https://dev.azure.com/PixarAnimationStudios/OpenSubdiv/_build/latest?definitionId=2&branchName=release) | [![Build Status](https://dev.azure.com/PixarAnimationStudios/OpenSubdiv/_apis/build/status/PixarAnimationStudios.OpenSubdiv?branchName=release&jobName=Windows)](https://dev.azure.com/PixarAnimationStudios/OpenSubdiv/_build/latest?definitionId=2&branchName=release) | [![Build Status](https://dev.azure.com/PixarAnimationStudios/OpenSubdiv/_apis/build/status/PixarAnimationStudios.OpenSubdiv?branchName=release&jobName=macOS)](https://dev.azure.com/PixarAnimationStudios/OpenSubdiv/_build/latest?definitionId=2&branchName=release) |

## Documents

 * [User Documents](http://graphics.pixar.com/opensubdiv/docs/intro.html)

 * [Doxygen API Documents](http://graphics.pixar.com/opensubdiv/docs/doxy_html/index.html)

 * [Release Notes](http://graphics.pixar.com/opensubdiv/docs/release_notes.html)

## Forum

 * [OpenSubdiv Google Groups](https://groups.google.com/forum/embed/?place=forum/opensubdiv)

## Prerequisite

  For complete information, please refer OpenSubdiv documents:

  [Building with CMake](http://graphics.pixar.com/opensubdiv/docs/cmake_build.html)

 * General requirements:

| Lib                           | Min Version | Note       |

| ----------------------------- | ----------- | ---------- |

| [CMake](http://www.cmake.org) | 3.12        | *Required* |

 * Osd optional requirements:

| Lib                                                                | Min Version | Note                        |

| ------------------------------------------------------------------ | ----------- | ----------------------------|

| [CUDA](http://developer.nvidia.com/cuda-toolkit)                   | 4.0         | cuda backend                |

| [TBB](https://www.threadingbuildingblocks.org)                     | 2018        | TBB backend                 |

| [OpenCL](http://www.khronos.org/opencl)                            | 1.1         | CL backend                  |

| [DX11 SDK](http://www.microsoft.com/download/details.aspx?id=6812) |             | DX backend                  |

| [Metal](https://developer.apple.com/metal/)                        | 1.2         | Metal backend               |

 * Requirements for building optional examples:

| Lib                                  | Min Version | Note                              |

| -------------------------------------| ----------- | --------------------------------- |

| [GLFW](http://www.glfw.org)          | 3.0.0       | GL examples                       |

| [Ptex](https://github.com/wdas/ptex) | 2.0         | ptex viewers                      |

| [Zlib](http://www.zlib.net)          |             | (required for Ptex under windows) |

 * Requirements for building documentation:

| Lib                                         |

| ------------------------------------------- |

| [Docutils](http://docutils.sourceforge.net) |

| [Doxygen](http://www.doxygen.org)           |

| [Graphviz](https://graphviz.gitlab.io/)     |

## Build example to run glViewer and other example programs with minimal dependency

### All platforms:

  * Install cmake and GLFW

   make sure GLFW install directories are configured as follows:

```

   ${GLFW_LOCATION}/include/GLFW/glfw3.h

   ${GLFW_LOCATION}/lib/libglfw3.a (linux)

   ${GLFW_LOCATION}/lib/glfw3.lib (windows)

```

  * Clone OpenSubdiv repository, and create a build directory.

```

   git clone https://github.com/PixarAnimationStudios/OpenSubdiv

   mkdir build

   cd build

```

### Windows (Visual Studio)

```

cmake ^

    -G "Visual Studio 15 2017 Win64" ^

    -D NO_PTEX=1 -D NO_DOC=1 ^

    -D NO_OMP=1 -D NO_TBB=1 -D NO_CUDA=1 -D NO_OPENCL=1 -D NO_CLEW=1 ^

    -D "GLFW_LOCATION=*YOUR GLFW INSTALL LOCATION*" ^

    ..

cmake --build . --config Release --target install

```

### Linux

```

cmake -D NO_PTEX=1 -D NO_DOC=1 \

      -D NO_OMP=1 -D NO_TBB=1 -D NO_CUDA=1 -D NO_OPENCL=1 -D NO_CLEW=1 \

      -D GLFW_LOCATION="*YOUR GLFW INSTALL LOCATION*" \

      ..

cmake --build . --config Release --target install

```

### macOS

```

cmake -G Xcode -D NO_PTEX=1 -D NO_DOC=1 \

      -D NO_OMP=1 -D NO_TBB=1 -D NO_CUDA=1 -D NO_OPENCL=1 -D NO_CLEW=1 \

      -D GLFW_LOCATION="*YOUR GLFW INSTALL LOCATION*" \

      ..

cmake --build . --config Release --target install

```

### iOS

```

SDKROOT=$(xcrun --sdk iphoneos --show-sdk-path) cmake -D NO_PTEX=1 -D NO_DOC=1 \

      -D NO_OMP=1 -D NO_TBB=1 -D NO_CUDA=1 -D NO_OPENCL=1 -D NO_CLEW=1 \

      -D CMAKE_TOOLCHAIN_FILE=../cmake/iOSToolchain.cmake -G Xcode \

      ..

```

  * This will produce an "OpenSubdiv.xcodeproj" that can be open and the targets 'mtlViewer' and 'mtlPtexViewer' (if NO_PTEX is ommitted and libPtex.a is installed in the iOS SDK) that can be run

### Useful cmake options and environment variables

````

-DCMAKE_BUILD_TYPE=[Debug|Release]

-DCMAKE_INSTALL_PREFIX=[base path to install OpenSubdiv]

-DCMAKE_LIBDIR_BASE=[library directory basename (default: lib)]

-DCMAKE_TOOLCHAIN_FILE=[toolchain file for crossplatform builds]

-DCUDA_TOOLKIT_ROOT_DIR=[path to CUDA Toolkit]

-DOSD_CUDA_NVCC_FLAGS=[CUDA options, e.g. --gpu-architecture]

-DPTEX_LOCATION=[path to Ptex]

-DGLFW_LOCATION=[path to GLFW]

-DSTRINGIFY_LOCATION=[path to stringify utility]

-DNO_LIB=1        // disable the opensubdiv libs build (caveat emptor)

-DNO_EXAMPLES=1   // disable examples build

-DNO_TUTORIALS=1  // disable tutorials build

-DNO_REGRESSION=1 // disable regression tests build

-DNO_PTEX=1       // disable PTex support

-DNO_DOC=1        // disable documentation build

-DNO_OMP=1        // disable OpenMP

-DNO_TBB=1        // disable TBB

-DNO_CUDA=1       // disable CUDA

-DNO_OPENCL=1     // disable OpenCL

-DNO_OPENGL=1     // disable OpenGL

-DNO_CLEW=1       // disable CLEW wrapper library

-DNO_METAL=1      // disable Metal

````