Table of Contents
docfx-pages

NURBS Sharp

NuGet Version Build Status

NURBS Sharpは.NET向けの依存関係なしのNURBS（非一様有理 B-スプライン）ライブラリです。
データ構造、評価器、トポロジー演算、入出力、テッセレーション機能を.NET標準ライブラリのみで実装しています。

English README

test

目次

特長

  • NURBS曲線・サーフェスの生成および評価
  • トポロジー演算：次数変更、ノット挿入/削除/細分化、結合/分割
  • 生成機能：補間、最小二乗近似、プリミティブ形状
  • 交差計算：Ray-Box、Ray-Mesh、Curve-Curve、Curve-Surface, Surface-Surface, Surface-Plane
  • 入出力ヘルパー：
    • メッシュのみ：OBJ/STL出力、BMP出力（簡易）
    • NURBSのみ：IGES入出力（Point、Curve、Surfaceエンティティ対応）
  • 曲線・サーフェス用のテッセレーションユーティリティ
  • 対応ターゲット：.NET 8、 .NET Standard 2.1

制限事項

  • Viewer: このライブラリは3Dモデルビューアーを含みません。モデルの詳細の確認は3D描画ライブラリあるいはファイル出力が必要です。
  • NURBSサーフェス: TrimSurfaceは未実装です。
  • ノットベクトル (Knot Vector): 現在、"Clamped" ノットベクトルのみサポートしています（多重度 = 次数 + 1）。
  • IGESサポート:
    • インポート: Entity Type 126 (Rational B-spline curve)、128 (Rational B-spline surface) のみサポートしています。
    • エクスポート: Point、NURBSエンティティのみサポートしています。メッシュのエクスポートはサポートされていません。
  • メッシュエクスポート (OBJ/STL): メッシュオブジェクトのみサポートしています。NURBSからの直接エクスポートはサポートされていません（テッセレーションが必要です）。
  • 交差計算:
    • 現状初期条件に依存するため不安定な場合があります。

インストール

NuGetからインストール

dotnet add package NurbsSharp

またはプロジェクトファイルにパッケージ参照を追加してください。

クイックスタート

基本的な使用例（C#）

using NurbsSharp.Core;
using NurbsSharp.Geometry;
using NurbsSharp.Tesselation;
using NurbsSharp.IO;

// NURBS曲面を作成して評価
int degreeU = 3, degreeV = 3;
var knotsU = new double[] {0,0,0,0,1,1,1,1};
var knotsV = new double[] {0,0,0,0,1,1,1,1};
var kvU = new KnotVector(knotsU);
var kvV = new KnotVector(knotsV);

// コントロールポイント（u x v グリッド）
ControlPoint[][] controlPoints = new ControlPoint[4][];
controlPoints[0] = new ControlPoint[] {
    new ControlPoint(0.0, 0.0, 0.0, 1),
    new ControlPoint(1.0, 0.0, 1.0, 1),
    new ControlPoint(2.0, 0.0, 3.0, 1),
    new ControlPoint(3.0, 0.0, 3.0, 1)
};
// ... コントロールポイントの定義 ...

var surface = new NurbsSurface(degreeU, degreeV, kvU, kvV, controlPoints);
var point = surface.GetPos(0.5, 0.5);
Console.WriteLine(point);

例

NURBSサーフェスを分割メッシュ化してSTLとしてエクスポートする例

int divideN = 20;
var mesh = SurfaceTessellator.Tessellate(surface, divideN, divideN);
using (var fs = new FileStream("test_output.stl", FileMode.Create, FileAccess.Write))
{
    await STLExporter.ExportAsync(mesh, fs);
}

サンプルプロジェクト: https://github.com/nyarurato/NurbsSharpSample
Github Wiki: https://github.com/nyarurato/NurbsSharp/wiki/Samples

ドキュメント

APIドキュメント: https://nyarurato.github.io/NurbsSharp/

開発

リポジトリをクローンしてローカルでビルド

dotnet restore
dotnet build -c Debug

ユニットテストを実行するには：

dotnet test -c Debug

プロジェクト構成のハイライト：

  • src/Core — 数値ヘルパーとコア型（BoundingBox、Ray、KnotVector、LinAlgなど）
  • src/Geometry — NurbsCurve、NurbsSurface、NurbsVolume、Meshなど
  • src/Evaluation — 評価器（曲線/サーフェス/ボリューム）
  • src/Operation — トポロジー演算（次数、ノット、結合、分割、サーフェス演算）
  • src/Generation — 補間、最小二乗近似、プリミティブ形状生成
  • src/Intersection — 交差計算（Ray-Box、Ray-Mesh、Curve-Curve、Curve-Surface、BVH構造）
  • src/IO — OBJExporter、STLExporter、BMPExporter、IGES入出力
  • src/Tesselation — テッセレーション（曲線/サーフェス）

コントリビュート

issue/PRを歓迎します。
PRの典型的なワークフロー：

  1. リポジトリをフォーク
  2. わかりやすいブランチ名でブランチを作成
  3. 必要に応じて新しいテストを追加
  4. プルリクエストを masterへ送る

ライセンス

MIT License

Edit this page