Reference/API

Store contents of Wavefront OBJ file, use for reading files.

• T is the scalar type, I is the index type, ColorT is used for RGBA colors
• nv: numberof vertices
• positiondim number of coordinates (2,3,3)
• texcoorddim number of texture coordinates (1,2,3)
• position coordinates of vertex positions
• texcoord texture coordinates
• normal coordinates of normals (always 3 coordinates per normal)
• fdegree vector of face degrees
• vidx indices of vertices (positions) spanning faces
• tidx indices of texture coordinates, may be discontinuous (i.e., possibly >1 per vertex)
• nidx indices of normal vectors, may be discontinuous (i.e., possibly >1 per vertex)
• vcolor per vertex color as ColorT

See also Wavefront OBJ and vertex color

See also writeobjmesh

Construct OBJBuffer

mesh = createmesh(obj::OBJBuffer;
                  template::Mesh=createmesh(; real_type=T),
                  position=Val(:x),
                  normal=Val(:n),
                  texcoord=Val(:u))

Create mesh from obj that was read by readobj using template and the specified attribute names.

• Attributes which are not defined in obj will be disabled!
• Attributes which are not defined in template are not copied from obj.

See also OBJBuffer, `toggleattributes!

mesh = createmesh(::OBJ[; real_type=Float64, dimx=Val(3), dimu=Val(2)])

Create an empty mesh with all attributes that may be read from an OBJ file: position, normal, and texture coordinates:

• vertex attributes :x, :n, :u, :c
• face attributes: :n
• half-edge attributes :n, :u

The latter stores texture coordinates and normals that are defined for each vertex of a face.

copy!(mesh, obj,
      Val(NX), Val(NU),
      Val(:x), Val(:n), Val(:u), Val(:c))

Helper that copies contents of [OBJBuffer])@ref) obj to mesh using dimensions NX and NU and the provided attributes for position, normal, texture coordinates, and color.

See also OBJBuffer, createmesh

Does OBJBuffer provide texture coordinates per face?

Does OBJBuffer provide vertex normals per face?

Does OBJBuffer store vormal vectors coordinates?

Does OBJBuffer store texture coordinates?

Does OBJBuffer store vertex colors?

Does OBJBuffer provide texture coordinates?

Does OBJBuffer provide per-vertex normals?

Are normals given per vertex? Alternative is per face.

Are texture coordinates given per vertex? Alternative is per face.

Does OBJBuffer represent a triangle mesh?

Get number of faces in OBJBuffer

Get number of normal vectors in OBJBuffer

N = normal(obj)
ns = normal(obj, Val(3))

Get normals stored in OBJBuffer as N::Matrix{T} with normals in columns or ns::Vector{SVector{T, 3}}.

Get number of texture coordinates in OBJBuffer

Get number of vertices in OBJBuffer

X = position(obj)
xs = position(obj, Val(N))

Get vertex positions stored in OBJBuffer as X::Matrix{T} with positions in columns or xs::Vector{SVector{T, N}} (where N must match positiondim.

Get dimension of positions in OBJBuffer (2, 3, 4)

obj = readobj(io[; realtype=Float64, indextype=Int32, color_type=PMeshIO.RBGA)

Reads OBJ file from io and returns OBJBuffer obj.

See also OBJBuffer, writeobjmesh

U = texcoord(obj)
us = texcoord(obj, Val(N))

Get texcoords stored in OBJBuffer as U::Matrix{T} with texture coordinates in columns or us::Vector{SVector{T, N}} (where N must match texcoorddim.

Get dimension of texture coordinates in OBJBuffer (2, 3)

Enable of disable attributes provided by mesh depending on what is provided by OBJBuffer.

See also createmesh

Update number of vertices and dimensions of OBJBuffer after reading.