Import/Export フォーマット

NOFF (.noff, .cnoff)

NOFF3次元形状形式．
3次元模型を保持したり，交換したりするのに使われる．
NOFFはObject File Formatからの頭字語である．
OFFとCOFFに関連している．
色情報が存在する場合には，CNOFFと呼ばれることもある．
ASCIIあるいはバイナリ形式．
単一の2次元あるいは3次元のオブジェクトを表す．
平面多角形のコレクションを共有される可能性がある頂点と頂点法線のデータと一緒に保持する．

ImportとExportはASCIIとバイナリのバージョンのNOFFファイル形式をサポートする．

Mathematica は頂点と面の色を読み取ったり，書き込んだりする．

頂点と面の色がファイル内に両方存在する場合には，Import は頂点の色情報を返す．

IMPORTとEXPORT

Import["file.off"]はNOFFファイルをグラフィックスとしてインポートする．

Export["file.off", expr]はグラフィックスをバイナリのNOFFファイルにエキスポートする．

3次元オブジェクトを表すNOFFファイルについては，Import["file.off"] はGraphics3D[ GraphicsComplex[vertices, primitives, opts]]の形の式を返す．

平面オブジェクトはGraphics[ GraphicsComplex[vertices, primitives, opts]としてインポートされる．

Import["file.off", elem]は指定された要素をNOFFファイルからインポートする．

Import["file.off", {elem, sub_a, sub_b, ...}]は子要素をインポートする．

Import["file.off", {{elem₁, elem₂, ...}}]は複数の要素をインポートする．

インポートの形式は Import["file", "NOFF"]あるいはImport["file", {"NOFF", elem, ...}]で指定することができる．

Export["file.off", expr, elem]はexpr が要素elem を指定するものとして扱って，バイナリのNOFFファイルを作成する．

Export["file.off", {expr₁, expr₂, ...}, {{elem₁, elem₂, ...}}] はそれぞれのexpr_i が対応するelem_i を指定するものとして扱う．

Export["file.off", expr, opt₁->val₁, ...] は指定されたオプションの要素が指定された値を取るものとしてexpr をエキスポートする．

Export["file.off", {elem₁->expr₁, elem₂->expr₂, ...}, "Rules"]は規則を使ってエキスポートされるべき要素を指定する．

ImportとExportについての一般的な情報は，関数ページを参照のこと．

ImportStringとExportString はNOFF形式をサポートする．

要素

一般的なImport要素：

	"Elements"	ファイル中の有効な要素とオプションのリスト
	"Rules"	それぞれの要素とオプションの規則の完全リスト
	"Options"	オプション，属性，設定についての規則のリスト

データを表現する要素：

	"Graphics"	Graphicsオブジェクトとして表示される2次元NOFFファイル
	"Graphics3D"	Graphics3D オブジェクトとして表示される3次元形状
	"GraphicsComplex"	GraphicsComplexオブジェクトとしてのNOFFファイル
	"PolygonColors"	それぞれの多角形に関連するカラープリミティブのリストとして与えられる面の色情報
	"PolygonData"	インデックス付きの形での多角形要素
	"PolygonObjects"	絶対座標で与えられるPolygonプリミティブのリスト
	"VertexColors"	それぞれの頂点に関連する色（カラープリミティブのリストとして与えられる）
	"VertexData"	頂点座標のリスト
	"VertexNormals"	"VertexData"で与えられる頂点に対応している正規ベクトル

ImportとExportはデフォルトで"Graphics3D" 要素を使って3次元形状を，"Graphics"要素を使って2次元オブジェクトを表す．

"VertexData"要素はGraphicsComplexの第1引数に対応する．

オプション

一般的なImportオプション：

Background	Automatic	どの背景色を使うか
ImageSize	Automatic	表示するグラフィックスの全体的な大きさ
Lighting	Automatic	3次元の表面を色付けするのにどの疑似照明を使うか

Graphics3DのすべてのオプションはNOFFからインポートする際に返すことができる．

詳細属性：

"BinaryFormat"

True

ファイルがASCIIあるいはバイナリ形式であるかどうか

バイナリのNOFFファイルは常に設定 "ByteOrdering"->1を使って，情報を"Integer32"と"Real32" のデータタイプとして保持する．

詳細なオプション：

	"InvertNormals"	False	頂点法線の方向を逆にするかどうか
	"VerticalAxis"	{0,0,1}	ファイル内で使用される座標系に想定される方向

デフォルトでMathematica は，NOFF形式で使用された座標系で，垂直軸が第3座標に対応するものと想定する．

設定"VerticalAxis"->{0, 1, 0}で，Mathematica は，NOFFからインポートする際には変換 {x, y, z}->{x, -z, y} を，NOFFにエキスポートする際には逆変換を，すべてのグラフィックス座標に適用する．