udhos / gwob

gwob - Pure Go Golang parser for Wavefront .OBJ 3D geometry file format

gwob

gwob - Pure Go Golang parser for Wavefront .OBJ 3D geometry file format

Install

Install with Go Modules (Go 1.11 or higher)

git clone https://github.com/udhos/gwob
cd gwob
go install

Install without Go Modules (Go before 1.11)

go get github.com/udhos/gwob
cd ~/go/src/github.com/udhos/gwob
go install github.com/udhos/gwob

Usage

Import the package in your Go program:

import "github.com/udhos/gwob"

Example:

// Error handling omitted for simplicity.

import "github.com/udhos/gwob"

options := &gwob.ObjParserOptions{} // parser options

o, errObj := gwob.NewObjFromFile("gopher.obj", options) // parse/load OBJ

// Scan OBJ groups
for _, g := range o.Groups {
    // ...
}

Example

Run the example:

cd example
go run main.go

You can supply a custom input OBJ by setting the env var INPUT:

INPUT=gopher.obj go run main.go

If you specify any command line argument, the OBJ will be dumped to stdout:

go run main.go d

See directory example.

Documentation

See the GoDoc documentation.

gwob's Issues

Why are float64 parsed, but only exposed as float32 ?

The parsing is made using float64.
But once inserted in public structures, it's exposed as float32, why ?

Shouldn't we switch all the exposed float to 64 bit long floats ?

Support obj writer

Wish to have a simple writer support for convenience :)