Skip to content

Commit

Permalink
Release VisUI 1.5.1 (#377)
Browse files Browse the repository at this point in the history
  • Loading branch information
czyzby authored Dec 10, 2022
1 parent 4bf70db commit 25aa59f
Show file tree
Hide file tree
Showing 3 changed files with 17 additions and 8 deletions.
17 changes: 13 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,11 @@ VisUI is licensed under Apache2 license meaning that you can use it for free in

Please refer to [libGDX documentation](https://libgdx.com/wiki/articles/dependency-management-with-gradle) if you don't know how to mange dependencies with Gradle. Alternatively JAR can be downloaded from [Maven repository](http://search.maven.org/#search|gav|1|g%3A%22com.kotcrab.vis%22%20AND%20a%3A%22vis-ui%22). If you are creating new project, you can use gdx-setup to automatically add VisUI for you. (press 'Show Third Party Extension' button)

#### Manual Gradle setup:
#### Manual Gradle setup:

Open build.gradle in project root.
In ``ext`` section under ``allprojects`` add:
```grovy
```groovy
visuiVersion = '1.X.X'
```
Look at [CHANGES](https://github.com/kotcrab/vis-ui/blob/master/ui/CHANGES.md) file to see what version of VisUI you can use
Expand All @@ -29,7 +30,7 @@ for your version of libGDX. Note that using not matching versions is likely to c
api "com.kotcrab.vis:vis-ui:$visuiVersion"
```

**HTML dependency** (only if you are using HTML)
**HTML dependency** (only if you are using GWT):
```groovy
api "com.kotcrab.vis:vis-ui:$visuiVersion:sources"
```
Expand Down Expand Up @@ -84,6 +85,7 @@ Create your UI like always, for extra skin features you have to use Vis widgets
Using Vis widgets is necessary for proper focus border management. All VisUI widgets constructors do not have Skin argument, they are using VisUI.skin field.

### VisTable

VisTable allows to easily set default spacing for vis components, construct it like this:
```
VisTable table = new VisTable(true);
Expand All @@ -96,28 +98,35 @@ table.addSeparator(true) //vertical
```

### Using different `SkinScale`s

Default VisUI skin can be too small for high resolution screens or mobile devices, in that case you can load a upscaled skin version simply by calling:
```
VisUI.load(SkinScale.X2);
```

### Internal classes

Classes inside `com.kotcrab.vis.[...].internal` packages are considered private and aren't part of public API. Changes to that classes won't be listed in change log.

### Default title align

Default title align for VisWindow and VisDialog is `Align.left` this can be changed by calling:
```java
VisUI.setDefaultTitleAlign(int align)
```
Calling this method does not affect windows that have been already created.

## Modifying skin

[Raw skin files](https://github.com/kotcrab/vis-ui/tree/master/ui/assets-raw) are available if you would like to modify them. After you pack them using libGDX texture packer, add generated atlas to your project with [uiskin.json, default.fnt and font-small.fnt](https://github.com/kotcrab/vis-ui/tree/master/ui/src/main/resources/com/kotcrab/vis/ui/skin/x1) and load it by calling:
```java
VisUI.load(Gdx.files.internal("path/to/your/modified/files/uiskin.json"))
```
Consider using USL if you want to extend existing VisUI styles. [Read more](https://github.com/kotcrab/vis-ui/wiki/USL)

## See also

* [vis-ui-contrib](https://github.com/kotcrab/vis-ui-contrib) - Community driven extension, utilities and skins for VisUI
* [ktx](https://github.com/czyzby/ktx) - Kotlin utilities for libGDX applications, especially the [ktx-vis](https://github.com/czyzby/ktx/tree/master/vis) and [ktx-style-vis](https://github.com/czyzby/ktx/tree/master/vis-style) modules
* [ktx](https://github.com/czyzby/ktx) - Kotlin utilities for libGDX applications.
The [ktx-vis](https://github.com/czyzby/ktx/tree/master/vis) and
[ktx-style-vis](https://github.com/czyzby/ktx/tree/master/vis-style) modules provide Kotlin APIs for VisUI.
6 changes: 3 additions & 3 deletions ui/CHANGES.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
#### Version: 1.5.1-SNAPSHOT (libGDX 1.11.0)
#### Version: 1.5.1 (libGDX 1.11.0)
- Updated to libGDX 1.11.0
- **Changed**: [#374](https://github.com/kotcrab/vis-ui/issues/374) - `ToastManager` now supports 'center' horizontal alignment for 'top' and 'bottom' alignments.
- Also `ToastManager.updateToastsPositions` and `ToastManager` member variables are now protected, allowing further customization of the toast positions.
- **Added**: [#374](https://github.com/kotcrab/vis-ui/issues/374) - `ToastManager` now supports 'center' horizontal alignment for 'top' and 'bottom' alignments.
- `ToastManager.updateToastsPositions` and `ToastManager` member variables are now protected, allowing further customization of the toast positions.

#### Version: 1.5.0 (libGDX 1.10.0)
- Updated to libGDX 1.10.0
Expand Down
2 changes: 1 addition & 1 deletion ui/build.gradle
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
group = 'com.kotcrab.vis'
version = '1.5.1-SNAPSHOT'
version = '1.5.1'

apply plugin: "java"
apply plugin: 'maven'
Expand Down

0 comments on commit 25aa59f

Please sign in to comment.