mirror of https://github.com/bjornbytes/lovr.git
Update README;
This commit is contained in:
parent
40e6f6a81c
commit
e01cfb0b47
87
README.md
87
README.md
|
@ -1,40 +1,39 @@
|
||||||
<p align="center"><a href="http://lovr.org"><img src="src/resources/logo.png" width="160"></a></p>
|
# <p align="center"><a href="https://lovr.org"><img src="https://lovr.org/static/img/README.png" width="256"/></a></p>
|
||||||
|
|
||||||
<h1 align="center">LÖVR</h1>
|
> **A simple Lua framework for rapidly building VR experiences.**
|
||||||
|
|
||||||
LÖVR is a simple framework for creating virtual reality experiences with Lua, based on [LÖVE](http://love2d.org).
|
|
||||||
|
|
||||||
[**Homepage**](https://lovr.org) | [**Documentation**](https://lovr.org/docs) | [**Slack**](https://join.slack.com/ifyouwannabemylovr/shared_invite/MTc5ODk2MjE0NDM3LTE0OTQxMTIyMDEtMzdhOGVlODFhYg)
|
|
||||||
|
|
||||||
[![Build status](https://ci.appveyor.com/api/projects/status/alx3kdi35bmxka8c/branch/master?svg=true)](https://ci.appveyor.com/project/bjornbytes/lovr/branch/master)
|
[![Build status](https://ci.appveyor.com/api/projects/status/alx3kdi35bmxka8c/branch/master?svg=true)](https://ci.appveyor.com/project/bjornbytes/lovr/branch/master)
|
||||||
[![Version](https://img.shields.io/github/release/bjornbytes/lovr.svg?label=version)](https://github.com/bjornbytes/lovr/releases)
|
[![Version](https://img.shields.io/github/release/bjornbytes/lovr.svg?label=version)](https://github.com/bjornbytes/lovr/releases)
|
||||||
|
|
||||||
Features
|
[**Site**](https://lovr.org) | [**Docs**](https://lovr.org/docs) | [**Slack**](https://lovr.org/slack)
|
||||||
---
|
|
||||||
|
|
||||||
- Easily create VR using simple Lua scripts
|
<p align="left">
|
||||||
- Automatically detects and renders to connected VR headsets (works without a headset too!)
|
|
||||||
- 3D graphics API supporting primitives, fonts, shaders, skyboxes, framebuffers, etc.
|
|
||||||
- Import 3D models from obj, fbx, collada, or glTF files, including materials and animations.
|
|
||||||
- Create projects for Windows, macOS, Linux, or WebVR
|
|
||||||
- Spatialized audio
|
|
||||||
- 3D physics
|
|
||||||
|
|
||||||
Screenshots
|
|
||||||
---
|
|
||||||
|
|
||||||
<p align="center">
|
|
||||||
<span><img src="http://lovr.org/static/img/wattle.jpg" width="32%"/></span>
|
<span><img src="http://lovr.org/static/img/wattle.jpg" width="32%"/></span>
|
||||||
<span><img src="http://lovr.org/static/img/levrage.jpg" width="32%"/></span>
|
<span><img src="http://lovr.org/static/img/levrage.jpg" width="32%"/></span>
|
||||||
<span><img src="http://lovr.org/static/img/planets.jpg" width="32%"/></span>
|
<span><img src="http://lovr.org/static/img/planets.jpg" width="32%"/></span>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
Features
|
||||||
|
---
|
||||||
|
|
||||||
|
- **Cross-Platform** - Runs on Windows, Mac, Linux, and even on the web using WebAssembly and WebVR.
|
||||||
|
- **Cross-Device** - Support for many HMDs including HTC Vive, Oculus Touch, Windows MR headsets. There's also a keyboard/mouse VR simulator so you can prototype without hardware.
|
||||||
|
- **Beginner-friendly** - Simple VR scenes can be created in just a few lines of Lua.
|
||||||
|
- **Fast** - Writen in C99 and scripted with LuaJIT, includes optimized single-pass stereo rendering.
|
||||||
|
- **Asset Import** - Supports 3D models (glTF, FBX, OBJ), skeletal animation, HDR textures, cubemaps, fonts, etc.
|
||||||
|
- **Spatialized Audio** - Audio is automatically spatialized using HRTFs.
|
||||||
|
- **3D Rigid Body Physics** - Including 4 collider shapes and 4 joint types.
|
||||||
|
- **Compute Shaders** - For high performance GPU tasks, like particles.
|
||||||
|
- **Multiplayer** - Includes enet for multi-user VR experiences.
|
||||||
|
- **Umlauts** - !!!
|
||||||
|
|
||||||
Getting Started
|
Getting Started
|
||||||
---
|
---
|
||||||
|
|
||||||
You can download precompiled binaries from the [website](https://lovr.org). There, you
|
It's really easy to get started making things with LÖVR! Grab a copy of the executable from <https://lovr.org/download>,
|
||||||
can also find documentation and a set of tutorials and examples. Here is the hello world example
|
then write a `main.lua` script and drag its parent folder onto the executable. Here are some example projects to try:
|
||||||
for LÖVR:
|
|
||||||
|
#### Hello World
|
||||||
|
|
||||||
```lua
|
```lua
|
||||||
function lovr.draw()
|
function lovr.draw()
|
||||||
|
@ -42,10 +41,6 @@ function lovr.draw()
|
||||||
end
|
end
|
||||||
```
|
```
|
||||||
|
|
||||||
To run it, first create a folder for your project and put the code in a file called `main.lua`.
|
|
||||||
Then, just drop the `project` folder onto `lovr.exe` (or run `lovr.exe path/to/project` on the
|
|
||||||
command line). Put on your headset and you should see the text at the front of your play area!
|
|
||||||
|
|
||||||
#### Spinning Cube
|
#### Spinning Cube
|
||||||
|
|
||||||
```lua
|
```lua
|
||||||
|
@ -62,41 +57,21 @@ function lovr.load()
|
||||||
end
|
end
|
||||||
|
|
||||||
function lovr.draw()
|
function lovr.draw()
|
||||||
model:draw()
|
local x, y, z = 0, 0, 0
|
||||||
|
model:draw(x, y, z)
|
||||||
end
|
end
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Audio
|
You can also find lots of other WebVR examples on the [docs page](https://lovr.org/docs).
|
||||||
|
|
||||||
```lua
|
Resources
|
||||||
function lovr.load()
|
|
||||||
local sound = lovr.audio.newSource('darudeSandstorm.ogg')
|
|
||||||
sound:play()
|
|
||||||
end
|
|
||||||
```
|
|
||||||
|
|
||||||
Documentation
|
|
||||||
---
|
---
|
||||||
|
|
||||||
Documentation and examples are available on the [website](https://lovr.org/docs).
|
- [**Documentation**](https://lovr.org/docs): Guides, tutorials, examples, and API documentation.
|
||||||
|
- [**Slack Group**](https://lovr.org): For general LÖVR discussion and support.
|
||||||
Community
|
- [**Nightly Builds**](https://lovr.org/download/nightly): Nightly builds for Windows.
|
||||||
---
|
- [**Compiling Guide**](https://lovr.org/docs/Compiling): Information on compiling LÖVR from source.
|
||||||
|
- [**Contributing**](CONTRIBUTING.md): Guide for helping out with development :heart:
|
||||||
> If you wanna be my LÖVR, you gotta get with my friends
|
|
||||||
> *- Spice Girls*
|
|
||||||
|
|
||||||
Feel free to join the [LÖVR Slack](https://join.slack.com/ifyouwannabemylovr/shared_invite/MTc5ODk2MjE0NDM3LTE0OTQxMTIyMDEtMzdhOGVlODFhYg) for questions, info, and other discussion.
|
|
||||||
|
|
||||||
Compiling
|
|
||||||
---
|
|
||||||
|
|
||||||
To compile from source, see the [Compiling Guide](https://lovr.org/docs/Compiling).
|
|
||||||
|
|
||||||
Contributing
|
|
||||||
---
|
|
||||||
|
|
||||||
Contributions are welcome! See [`CONTRIBUTING`](CONTRIBUTING.md) for more information.
|
|
||||||
|
|
||||||
License
|
License
|
||||||
---
|
---
|
||||||
|
|
Loading…
Reference in New Issue