This repo is not used anymore. Development of Orca was moved here: https://github.com/orca-app/orca https://orca-app.dev/
Go to file
Martin Fouilleul b223abcd5b add current features to Readme 2023-09-10 15:00:58 +02:00
doc add current features to Readme 2023-09-10 15:00:58 +02:00
ext Auto-formatting with clang-format 2023-08-19 15:52:11 +02:00
resources This commit restructures the codebase to melt the milepost platform layer into the main orca codebase. 2023-08-13 15:28:57 +02:00
samples Documentation and some API cleaning 2023-09-10 12:29:40 +02:00
scripts vblank notification: win32 2023-09-08 20:58:11 -07:00
sketches Documentation and some API cleaning 2023-09-10 12:29:40 +02:00
src Documentation and some API cleaning 2023-09-10 12:29:40 +02:00
tests - Added oc_file_open_with_request() to request new file capability for a given path. This presents user with a message box allowing them to accept or deny the request. 2023-09-02 11:00:28 +02:00
.clang-format clang-format: use custom brace/indent style 2023-08-22 20:18:04 +00:00
.gitignore Makes sketches compile and run with changes introduced by renaming pass. 2023-08-28 12:37:33 +02:00
.orcaroot Convert build scripts to Python (#31) 2023-08-08 09:38:43 +00:00
Readme.md add current features to Readme 2023-09-10 15:00:58 +02:00
orca Detect Orca source from anywhere and make scripts work from anywhere 2023-08-18 16:44:28 +02:00
orca.bat Convert build scripts to Python (#31) 2023-08-08 09:38:43 +00:00

Readme.md

DISCLAIMER: This project is very much a Work In Progress. We're making it accessible in this very early state so that participants to the Wheel Reinvention Jam 2023 can try it out and maybe use it as their jamming platform. Expect bugs, missing and/or incomplete features, unstable APIs, and sparse documentation. Some current issues might be a show stopper for you, so make sure you can build and run the sample apps before jumping in. If you do choose to try out Orca anyway, well thanks! We'll do our best to answer your questions, and we'd really appreciate to hear your feedback!

Orca


Orca is a devlopment platform and runtime environment for cross-platform, sandboxed graphical WebAssembly applications. In this early MVP you can:

  • Receive mouse and keyboard input
  • Draw paths, images and text using a 2D vector graphics API.
  • Draw 2D/3D graphics using OpenGL ES 3.1 (minus a few features)
  • Build user interfaces using our UI API and default widgets.
  • Read and write files using a capability based API.

Installing

//TODO: Ben can you complete this section?

Clone the repo: git clone git@git.handmade.network:hmn/orca.git.

Cd to the orca directory and build the Orca runtime:

cd orca
./orca dev build-runtime

Install the orca dev tools:

./orca dev install

Building the sample Orca apps

Cd to the sample project directory and run its build script:

cd samples/pong
./build.sh

On macOS this creates a Pong.app bundle in samples/pong that you can double click to run. On Windows this creates a Pong directory in samples/pong. You can launch the app by running Pong/bin/Pong.exe.

Writing an Orca app

The following documents can help you write an application using the Orca APIs:

  • The Quick Start Guide will walk you through writing and building a simple example application.
  • The samples folder contains sample applications that show various aspects of the Orca API and support library:
    • clock is a simple clock showcasing vector graphics and the time API.
    • breakout is a mini breakout game making use of the vector graphics API.
    • triangle shows how to draw a spining triangle using the GLES API.
    • fluid is a fluid simulation using a more complex GLES setup.
    • ui showcases the UI API and Orca's default UI widgets.
  • The API Cheatsheets provide a list of Orca API functions, grouped by topic.

Building and bundling an Orca app

//TODO: Ben, can you complete this section? Or should that be in the QuickStart guide?

You must compile your application along with the Orca support code, into a WebAssembly module. The command orca src cflags can help you set up your compiler's flags to do so.

Once you have built your WebAssembly module, you can invoke the command orca bundle to bundle it with your apps resources and the Orca runtime to produce an application.

License

Orca is distributed under the terms of the GNU Affero General Public License version 3, with additional terms in accordance with section 7 of AGPLv3. These additional terms ensure that:

  • Modified versions of Orca must reasonably inform users that they are modified.
  • You can distribute your application's WebAssembly modules under the terms of your choice, and are not required to license them under the terms of the AGPLv3.

Copyright and License details can be found in LICENSE.txt