Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[Docs] Updated readme file for release
- Loading branch information
1 parent
e02093b
commit 3b65e66
Showing
1 changed file
with
65 additions
and
53 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,66 +1,78 @@ | ||
OpenTK | ||
====== | ||
|
||
The Open Toolkit is an advanced, low-level C# library that wraps OpenGL, OpenGL ES and OpenAL. It is suitable for games, scientific applications and any other project that requires 3d graphics, audio or compute functionality. | ||
|
||
This is the official GIT repository of the project: | ||
|
||
https://github.com/opentk/opentk | ||
|
||
|
||
Project website: http://www.opentk.com/ | ||
Official git repository: https://github.com/opentk/opentk | ||
Features | ||
======== | ||
|
||
- Create cutting-edge graphics with OpenGL 4.4 and OpenGL ES 3.0. | ||
|
||
- Integrate 3d into Windows.Forms, WPF or GTK# applications. | ||
|
||
- Write once run everywhere: support for Windows, Mac OS X, Linux, Xamarin.Android and Xamarin.iOS. | ||
|
||
- Use strong types and inline documentation to improve your code flow and catch errors sooner. | ||
|
||
|
||
|
||
- Create cutting-edge graphics with OpenGL 4.4 and OpenGL ES 3.0 | ||
- Spice up your GUI with 3d graphics | ||
- Improve your code flow with strong types and inline documentation | ||
- Write once run everywhere! | ||
|
||
OpenTK is available on Windows, Linux, Mac OS X, *BSD, SteamOS, Android and iOS. It can be used standalone or integrated into a GUI (Windows.Forms, WPF, GTK+, Qt, VTK, ...) | ||
|
||
Binaries and NuGet packages available at http://www.opentk.com | ||
|
||
|
||
Roadmap | ||
======= | ||
|
||
- Merge opentk/opentk (upstream) with mono/opentk (Xamarin) | ||
- Add Portable Class Library (PCL) target | ||
- Add multitouch API | ||
- Add new platforms: NaCL, emscripten, Windows Metro, Ouya, Raspberry PI | ||
- Improve OpenCL bindings | ||
- Improve math library | ||
|
||
|
||
Contributing | ||
============ | ||
|
||
1. Install git and a C# IDE (see requirements section below) | ||
2. Fork the _develop_ branch of https://github.com/opentk/opentk | ||
3. Commit your changes in small, incremental steps with clear descriptions | ||
4. When ready, issue a Pull Request (PR) against the _develop_ branch of https://github.com/opentk/opentk | ||
|
||
For details on coding style and best practices, refer to https://github.com/opentk/opentk/wiki/Contributing | ||
|
||
|
||
Requirements | ||
============ | ||
|
||
OpenTK is designed to be used in an IDE with auto-completion and documentation tooltips: | ||
- Visual Studio 2005 or higher | ||
- Xamarin Studio 2.x or higher | ||
- MonoDevelop 2.x or higher | ||
- SharpDevelop 3.x or higher | ||
|
||
You can develop on your favorite operating system. Compiled binaries can be deployed without recompilation on: | ||
- Windows | ||
- Linux | ||
- Mac OS X | ||
|
||
For: | ||
- Android | ||
- iOS | ||
you will need to recompile your code with Xamarin (http://xamarin.com/download) | ||
|
||
|
||
|
||
- Windows (XP/Vista/7/8), Linux, Mac OS X, *BSD, SteamOS, Android or iOS | ||
- For graphics, OpenGL drivers or a suitable emulator, such as [ANGLE](https://github.com/opentk/opentk/tree/Dependencies/Readme.txt) | ||
- For audio, OpenAL drivers or [OpenAL Soft](https://github.com/opentk/opentk/tree/Dependencies/Readme.txt) | ||
- To develop desktop applications: Visual Studio, Xamarin Studio, MonoDevelop or SharpDevelop | ||
- To develop Android applications: Xamarin Studio or the Xamarin Extensions for Visual Studio | ||
- To develop iOS applications: Xamarin Studio and XCode | ||
|
||
|
||
Documentation | ||
============= | ||
|
||
The Documentation/ folder contains extensive documentation on OpenGL, OpenGL ES and OpenAL. Start with these: | ||
|
||
- OpenGL 4.4 API Reference.pdf | ||
or | ||
- OpenGL ES 3.0 API Reference.pdf | ||
|
||
Your favorite IDE will display inline documentation for all OpenTK APIs. Tutorials can be found in the [OpenTK Manual](http://www.opentk.com/doc) | ||
|
||
|
||
|
||
Your favorite IDE will display inline documentation for all OpenTK APIs. Additional information can be found in the [OpenTK Manual](http://www.opentk.com/doc) and in the [opentk/Documentation/](https://github.com/opentk/opentk/tree/develop/Documentation) folder. | ||
|
||
Technical documentation about the implementation of OpenTK can be found in the [Technical Wiki](https://github.com/opentk/opentk/wiki). | ||
|
||
|
||
Need Help? | ||
========== | ||
|
||
The community hangs out at the [OpenTK forums](http://www.opentk.com/forum) | ||
|
||
If you hit a bug, post an issue on https://github.com/opentk/opentk/issues | ||
|
||
|
||
Post your questions at the [OpenTK forums](http://www.opentk.com/forum). | ||
Report bugs at https://github.com/opentk/opentk/issues | ||
License | ||
======= | ||
|
||
The Open Toolkit is distributed under the permissive MIT/X11 license and is absolutely free. | ||
|
||
The Open Toolkit is distributed under the permissive MIT/X11 license and is absolutely free. | ||
|
||
http://www.opentk.com/project/license |