"go-ogre3d" is a slim wrapper of ogre3d for use in game projects that use ogre3d for graphics.
Ogre3d has a huge codebase, and we do not aim to provide a generic, complete interface to it all. Instead it will start off very small, based on developing requirements, and grow with the game project.
Make sure they are in the library load path (e.g. windows: on the PATH; linux: /usr/lib or similar)
- Install Ogre (http://www.ogre3d.org/ https://bitbucket.org/cabalistic/ogredeps)
- Install llcoi (https://bitbucket.org/fire/llcoi)
- Fetch using 'go get'
$ go get github.com/fire/go-ogre3d
You can verify that it works by running the sample included in the gogre3d sources
$ cd $GOPATH/src/github.com/fire/go-ogre3d/sample
$ go run sample.go
You should see the following ogre:
- Arrow keys: rotate head
- Mouse X/Y axis: rotate head
- Mouse left button: reset head orientation
- ESCAPE: exit sample
The functionality of gogre3d is directly dependant on llcoi exposing the required functionality. Especially during the early stages, gogre3d will only expose a small subset of llcoi, which in turn only exposes basic ogre functionality.
Feel free to create an issue on this github project page if you require specific Ogre features that are not exposed yet. I'm constantly working on it as part of my other projects and I might be able to just put it in for you. But bear with me, this is not my full-time job, so it might take a while.
However, if you're somewhat familiar with Ogre and know a bit of C/C++ it shouldn't take more than a few minutes to do it yourself. If you're afraid of C/C++ - don't be. Embrace it and grow.
I encourage you to contribute whatever you add back to the projects - it's not an official part of Ogre, and needs the community in order to expand.
go-ogre3d is /not/ a port of ogre to golang. It's a wrapper, and in fact it's really just a really slim wrapper on top of the already slim C wrapper llcoi (https://bitbucket.org/fire/llcoi). gogre3d compiles and links only to llcoi. llcoi, however, obviously depends on Ogre (and OIS).
As far as go-ogre3d is concerned, llcoi is the only requirement. However, your application might not run if other runtime deps are missing. Obviously Ogre itself has many other dependencies. Depending on how you built llcoi, OIS, Ogre and their dependencies must be available in order to use gogre3d. Installing Ogre is way outside of this scope.
- llcoi
- ogre_interface.h
- ois_interface.h
- libllcoi.so
- OIS
- libOIS.so
- Ogre
- libOgreMain.so
- (.. other run-time and compile-time dependencies ...)
/usr/bin/ld: cannot find -lllcoi
collect2: ld returned 1 exit status
Fix: make sure llcoi library is on the library load path
libllcoi.so: undefined reference to `Ogre::Root::... etc.Fix: make sure i.e. OgreMain is on the library load path
go-ogre3d uses #cgo (which effectively uses gcc) to include and link to C header and libraries. If you want to point to custom locations of llcoi/ogre dependencies, you can use #cgo directives to do so. Refer to the golang cgo documentation for details: http://golang.org/cmd/cgo/
- Better Mouse input
- Move input into "gois" package
- Subpackages for mouse/keyboard, useful for constants (gogre3d.KC_UP isn't nice, something like key.UP would be better)
- Expose more of llcoi's functionality, particularly scene/node/entity/light/camera basics
- Idiomatic Go API
- Maybe simplifiy installation including llcoi somehow? maybe provide prebuilt binaries including ogre for 'plug-n-play' effect?
go-ogre3d is licensed under the MIT license. You can find a copy in the LICENSE file, or online at http://opensource.org/licenses/mit-license.php Copyright (c) 2012 Raphael Estrada (http://www.galaktor.net)