Object Files (.obj)

文件格式

---

以#号开始的为注释行。 # this is a comment

 

An OBJ file contains several types of definitions: # 顶点坐标, with (x,y,z[,w]) coordinates, w is optional. v 0.123 0.234 0.345 1.0 v ... ... # 贴图坐标, in (u,v[,w]) coordinates, w is optional. vt 0.500 -1.352 [0.234] vt ... ... # 法向量, in (x,y,z) form; 不要求是单位法向量. vn 0.707 0.000 0.707 vn ... ... # 面片 f 1 2 3 f 3/1 4/2 5/3 f 6/4/1 3/5/3 7/6/5 f ... ...

 

 

---

Face definitions

 

面片的定义使用顶点坐标、贴图坐标和法向量坐标的索引。

Faces are defined using lists of vertex, texture and normal indices. Polygons such as quadrilaterals can be defined by using more than three vertex/texture/normal indices.

OBJ files also support free form curved surface objects such as NURB surfaces.

There are several ways to define a face, but each face line definition starts with "f" character.

Vertex

A valid vertex index starts from 1 and match first vertex element of vertex list previously defined. Each face can contain more than three elements.

f v1 v2 v3 v4 ...

表示这个面片由顶点列表中的第v1个顶点、第v2个顶点、第v3个顶点和第v4个顶点连接而成。

索引值从1开始。(也可以取负值，表示从最后一个顶点开始数上去。)

 

Vertex/texture-coordinate

Each texture coordinate index must follow with no space the first slash. Texture coordinates index are optional. A valid texture coordinate index starts from 1 and match first texture coordinate element of texture coordinate list previously defined. Each face can contain more than three elements. f v1/vt1 v2/vt2 v3/vt3 ...

Vertex/texture-coordinate/normal

Each normal index must follow with no space the second slash. Normals index are optional. A valid normal index starts from 1 and match first normal element of normal list previously defined. Each face can contain more than three elements.
f v1/vt1/vn1 v2/vt2/vn2 v3/vt3/vn3 ...
Vertex/normal

As texture coordinates are optional, one can define geometry without them, but one must put the normal index after second slash.
f v1//vn1 v2//vn2 v3//vn3 ...

 

---

 

References:

http://en.wikipedia.org/wiki/Wavefront_.obj_file

http://people.sc.fsu.edu/~jburkardt/txt/obj_format.txt

http://www.cppblog.com/lovedday/archive/2008/06/13/53153.html

http://mailao.ycool.com/post.1905836.html