legui

KO | EN

gitlite — search

#ai #llm #golang #android #deep-learning #linux #docker #java #awesome #cli #vue #pytorch #ios #open-source

(★ 341)

Java OpenGL GUI library. Created for using with latest LWJGL (LWJGL 3).

파일 탐색기

최종 버전 다운로드 (.zip)

- - codeql-analysis.yml
  - github.yml
  - github_pr.yml
- CODE_OF_CONDUCT.md
- CONTRIBUTING.md
- dependabot.yml
- FUNDING.yml
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- legui_api.png
- preview.png
- Preview2.png
.gitignore
build.gradle
CHANGELOG.md
gradle.properties
gradlew
gradlew.bat
intellij-java-style.xml
LICENSE
lombok.config
pom.xml
README.md
settings.gradle

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![legui_api](https://raw.githubusercontent.com/SpinyOwl/legui/develop/images/legui_api.png)
![preview](https://raw.githubusercontent.com/SpinyOwl/legui/develop/images/preview.png)

# LEGUI
[![Discord](https://img.shields.io/discord/245558983123927040.svg?slongCache=true&label=Discord&logo=discord&style=for-the-badge)](https://discord.gg/6wfqXpJ)
![REPO SIZE](https://img.shields.io/github/repo-size/SpinyOwl/legui.svg?style=for-the-badge)
![CODE SIZE](https://img.shields.io/github/languages/code-size/SpinyOwl/legui.svg?style=for-the-badge)
[![STABLE VERSION](https://img.shields.io/badge/dynamic/xml?url=https%3A%2F%2Fraw.githubusercontent.com%2FSpinyOwl%2Frepo%2Freleases%2Fcom%2Fspinyowl%2Flegui%2Fmaven-metadata.xml&query=%2F%2Fmetadata%2Fversioning%2Flatest&style=for-the-badge&label=latest%20version&color=blue)](https://github.com/SpinyOwl/repo/tree/releases/com/spinyowl/legui)  
[![Sonar Quality Gate](https://img.shields.io/sonar/alert_status/SpinyOwl_legui?logo=sonarcloud&server=https%3A%2F%2Fsonarcloud.io&style=for-the-badge)](https://sonarcloud.io/dashboard?id=SpinyOwl_legui)
[![License](https://img.shields.io/github/license/SpinyOwl/legui.svg?style=for-the-badge)](https://raw.githubusercontent.com/SpinyOwl/legui/develop/LICENSE)
![Build and publish](https://img.shields.io/github/actions/workflow/status/SpinyOwl/legui/github.yml?branch=develop&style=for-the-badge&label=build)

## Community and Support
You can join the community in [the Discord server!](https://discord.gg/6wfqXpJ) I also encourage everyone to voice your suggestions, comments, and questions in the Discord.

If you'd like to help support and sustain this library, please consider becoming a donor!  
<a href='https://ko-fi.com/J3J4L9ASJ' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi1.png?v=3' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>

# TOC

* [LEGUI - What is it?](#legui---what-is-it)
* [Contribution to LEGUI](#contribution-to-legui)
* [System requirements](#system-requirements)
* [OpenGL state touched by the backend](#opengl-state-touched-by-the-backend)
* [Usage](#usage)
*
    * [Dependencies](#dependencies)
*
    *
        * [Add dependency repo](#add-dependency-repo)
*
    *
        * [Add dependency (Maven)](#add-dependency-maven)
*
    *
        * [Add dependency (Gradle)](#add-dependency-gradle)
*
    * [Demos](#demos)
* [Projects using LEGUI](#projects-using-legui)
*
    * [Modeler by Cout970](#modeler-by-cout970)
* [Links](#links)

## LEGUI - [What is it?](https://spinyowl.github.io/legui/)

GUI implementation for using with LWJGL3.

This gui library made for using with OpenGL port (LWJGL) to allow programmers fast and easy
integrate user interface to their OpenGL apps written in Java or Kotlin.  
API is close to Swing API.

### Examples

<table>
    <tr>
        <td>Radio button and text input</td>
        <td>Widgets</td>
        <td>TextArea</td>
    </tr>
    <tr>
        <td align="center"><img src="https://i.imgur.com/NMP2jll.gif" /></td>
        <td align="center"><img src="https://i.imgur.com/8iL2xPd.gif" /></td>
        <td align="center"><img src="https://i.imgur.com/WQxSN6n.gif" /></td>
    </tr>
    <tr>
        <td>Button, togglebutton, checkbox, selectbox</td>
        <td>Sliders</td>
        <td>ScrollPanel</td>
    </tr>
    <tr>
        <td align="center"><img src="https://i.imgur.com/kuTOdAk.gif" /></td>
        <td align="center"><img src="https://i.imgur.com/Te70Ek9.gif" /></td>
        <td align="center"><img src="https://i.imgur.com/RGuIpZ0.gif" /></td>
    </tr>
</table>

## Contribution to LEGUI

See the [contribution guide](.github/CONTRIBUTING.md) for more information.

## System requirements

LEGUI requires Java 11+.

## OpenGL state touched by the backend

Default renderer made on top of NanoVG which touches following states:

When textures are uploaded or updated, the following pixel store is set to
defaults: `GL_UNPACK_ALIGNMENT`, `GL_UNPACK_ROW_LENGTH`, `GL_UNPACK_SKIP_PIXELS`
, `GL_UNPACK_SKIP_ROWS`. Texture binding is also affected. Texture updates can happen when the user
loads images, or when new font glyphs are added. Glyphs are added as needed start and end
of `render()` method.

The data for the whole frame is buffered and flushed in end of rendering. The following code
illustrates the OpenGL state touched by the rendering code:

```C
	glUseProgram(prog);
	glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
	glEnable(GL_CULL_FACE);
	glCullFace(GL_BACK);
	glFrontFace(GL_CCW);
	glEnable(GL_BLEND);
	glDisable(GL_DEPTH_TEST);
	glDisable(GL_SCISSOR_TEST);
	glColorMask(GL_TRUE, GL_TRUE, GL_TRUE, GL_TRUE);
	glStencilMask(0xffffffff);
	glStencilOp(GL_KEEP, GL_KEEP, GL_KEEP);
	glStencilFunc(GL_ALWAYS, 0, 0xffffffff);
	glActiveTexture(GL_TEXTURE0);
	glBindBuffer(GL_UNIFORM_BUFFER, buf);
	glBindVertexArray(arr);
	glBindBuffer(GL_ARRAY_BUFFER, buf);
	glBindTexture(GL_TEXTURE_2D, tex);
	glUniformBlockBinding(... , GLNVG_FRAG_BINDING);
```

## Usage

### Dependencies

#### Add dependency repo

For using this library you should add these urls as repositories:  
For **[LWJGL](https://github.com/LWJGL/lwjgl3)** and **[JOML](https://github.com/JOML-CI/JOML)**
dependencies  
`https://oss.sonatype.org/content/repositories/snapshots/` - for snapshots  
`https://oss.sonatype.org/content/repositories/releases/` - for releases  
Also you can add your own versions of these libraries
using [LWJGL form](https://www.lwjgl.org/download).

For **LEGUI** and **[CBCHAIN](https://github.com/SpinyOwl/cbchain)** dependency  
`https://raw.github.com/SpinyOwl/repo/releases`

And add this dependency to your build script:

#### Add dependency (Maven):

```xml

<dependency>
    <groupId>com.spinyowl</groupId>
    <artifactId>legui</artifactId>
    <version>${legui_version}</version>
</dependency>
 ```

#### Add dependency (Gradle):

```groovy
// LEGUI - https://github.com/SpinyOwl/legui
compile group: 'com.spinyowl', name: 'legui', version: "${legui_version}";
  ```

### Demos:

All examples located under [demo](/src/main/java/com/spinyowl/legui/demo/) package.

## Projects using LEGUI:

### Modeler by Cout970

> Open 3D Modeling Tool  ([Cout970/Modeler](https://github.com/cout970/Modeler))  
> This tool is written in Kotlin, using LWJGL3 for rendering and Legui to build user interfaces
<table>
  <tr>
    <td><img src="https://i.imgur.com/BWWotpp.png" alt="3d view"/></td>
    <td><img src="https://i.imgur.com/5HfHfy4.png" alt="texture editing"/></td>
  </tr>
</table>

### FMT by Fexcraft

> Fex's Modelling Toolbox  ([Fexcraft/FMT](https://github.com/Fexcraft/FMT))  
> A Tool to create Models basing on the "TMT" (updated and maintained version of Fex/FCL) Library.
<table>
  <tr>
    <td><img src="http://fexcraft.net/files/app_data/fmt-page/javaw_2020-05-02_17-34-09.png"/></td>
    <td><img src="http://fexcraft.net/files/app_data/fmt-page/javaw_2020-05-02_17-35-10.png"/></td>
  </tr>
</table>

## Links

[LWJGL - Lightweight Java Game Library 3](https://github.com/LWJGL/lwjgl3)  
[JOML – Java OpenGL Math Library](https://github.com/JOML-CI/JOML)  
[CBCHAIN - Callback Chain for LWJGL3](https://github.com/SpinyOwl/cbchain)  
[NanoVG -Small antialiased vector graphics rendering library for OpenGL.](https://github.com/memononen/nanovg)

## Statistics
![Alt](https://repobeats.axiom.co/api/embed/0cbc0ac5fb5a710ac355daafa6e1a5475109bfac.svg "Repobeats analytics image")

legui

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

legui

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README