Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lillyschramm/eps-easy
A litle Java-UI-Lib
https://github.com/lillyschramm/eps-easy
Last synced: 1 day ago
JSON representation
A litle Java-UI-Lib
- Host: GitHub
- URL: https://github.com/lillyschramm/eps-easy
- Owner: LillySchramm
- License: gpl-3.0
- Created: 2019-09-07T20:19:55.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-02-08T00:32:21.000Z (almost 4 years ago)
- Last Synced: 2024-11-08T18:53:33.574Z (about 2 months ago)
- Language: Java
- Homepage: https://eps-dev.de
- Size: 86.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EPS-EASY
A litle Java-UI-Lib
## What is EPS-EASY?
EPS-EASY is a Java-Libary based on JavaAWT. I write this to take the time, that GUI-writing takes, away so the user can focus on his main project.
You dont trust me?
With this few lines:
```java
Form main = new Form("main");
Text sampletext = new Text("sampletext");
sampletext.setPos(500, 300);
sampletext.setText("Hello World!");
Window.addForm(main);
main.add(sampletext);
EPS.start();
```
...You will get this result:
## Usage
All GUI elements must be placed on a `Form` and this Form needs to get initalized to the `window`.
Example for a blank window:
```java
Form main = new Form("main");
Window.addForm(main);
EPS.start();
```
The window pops up with the command `EPS.start()`.
Any object needs a ID in its constructor. With that you can get the object later just by ID.
## Content
### Forms
Forms are the base of all GUI elements in EPS-EASY
##### Constructor
`Form form = new Form(String ID);`
##### Add objects
You can add any object by `add(object)`
#### Important methods
|Method|Resulut|Description|
|--------|-----|----------|
|setScrollMultiplyer(int mult)|-|Set the scroll multiplyer|
|setMaxScroll(int max)|-|Set the max scroll height (in pixel)|
|add(object)|-|Add one of the folowing objects to the form: Text, InputField, Button, TextField, Image|
|setBackground_Image(Image img)|-|Set a image as background. Instead of a image you can also use a `String path`|
|setBackground_Color(Color background_Color)|-|Set the backgroundcolor. Only will show if there isnt a background image set|
|getInputField()|`List`|Returns a list of all Inputfields in the form.|
|getTextField()|`List`|Returns a list of all Textfields in the form.|
|getButton()|`List`|Returns a list of all Buttons in the form.|
|getImage()|`List`|Returns a list of all Images in the form.|
|getText()|`List`|Returns a list of all Text in the form.|
#### Change forms
To change between forms use:
`Window.setAKT_FORM_ID(String aKT_FORM_ID)`
### Text
A simple oneliner text
#### Constructor
`Text text = new Text(String ID);`
#### Important methods
|Method|Resulut|Description|
|--------|-----|----------|
|setCanScroll(boolean canScroll)|-|Set `true` if it should get effected by scrolling. (default: `false`)|
|setActive(boolean active)|-|Set `true` if it sould be visible. (default: `true`)|
|setPos(int x, int y)|-|Set the x/y position.|
|setTextSize(int textSize)|-|Set the textsize|
|setTextColor(Color textColor)|-|Set the textcolor|
|setText(String text)|-|Set the text|
|setFontFamily(String fontFamily)|-|Set the fontFamily|
### TextField
A simple multilined text within bounds
#### Constructor
`TextField textField = new TextField(String ID)`
#### Important methods
|Method|Resulut|Description|
|------|-------|----------|
|setPos(int x, int y)|-|Set the x/y position|
|setCanScroll(boolean canScroll)|-|Set `true` if it should get effected by scrolling. (default: `false`)|
|setActive(boolean active)|-|Set `true` if it sould be visible. (default: `true`)|
|setMaxWidth(int maxWidth)|-|Set the maxWidth (default: `500`)|
|setBordersize(int bordersize)|-|Set the bordersize (default: `4`)|
|setHasBackground(boolean hasBackground)|-|Set `true` if it should get an extra background (default: `false`)|
|setHasBorder(boolean hasBorder)|-|Set `true` if it should get an border. (default: `true`)
|setBorderColor(Color borderColor)|-|Set the bordercolor.|
|setBackgroundColor(Color backgroundColor)|-|Set the backgroundcolor|
|setTextSize(int textSize)|-|Set the textsize|
|setTextColor(Color textColor)|-|Set the textcolor|
|setText(String text)|-|Set the displayed text|
|setFontFamily(String fontFamily)|-|Set the fontfamily|
### Button
#### Examples
Say "Hi!" on click
```java
samplebutton1.setPos(300, 300);
samplebutton1.setText("Click me!");
samplebutton1.setOnClick(new OnClick() {
@Override
public void OnClick() {
System.out.println("Hi!");
}
});
```
Change form on click
```java
samplebutton2.setPos(300, 500);
samplebutton2.setText("Change form");
samplebutton2.setOnClick(new ChangeForm("formID"));
```
### Important methods
|Method|Resulut|Description|
|------|-------|----------|
|setNotActive(`Color color_notActive` OR `Image image`)|-|Set the color/image that shows when the button is set to "non active"|
|setStateNormal(`String PATH` OR `Color color`)|-|Set the color/image that shows when the button is in active state|
|setStateHover(`String PATH` OR `Color color`)|-|Set the color/image that shows when the button is in hover state|
|setStatePressed(`String PATH` OR `Color color`)|-|Set the color/image that shows when the button is in pressed state|
|setPos(int X, int Y)|-|Set the X/Y position|
|setOnClick(OnClick onClick)|-|Set the onclick interface|
|setOnHover(OnHover onHover)|-|Set the onhover interface|
|setHeight(int height)|-|Set the button height|
|setWidth(int width)|-|Set the button width|
With time, I am gonna add all elements in the API to this list.