| Name | pyguilib JSON |
| Version |
0.0.5
JSON |
| download |
| home_page | |
| Summary | Graphical User Interface made for the Pygame multimedia applications library with the intention to facilitate the creation and/or management of the user interface. |
| upload_time | 2024-02-06 16:46:43 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.8 |
| license | MIT License Copyright (c) 2023 Guilherme Daghlian Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
graphical user interface
user interface
pygame
game
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# pyguilib
pyguilib is a free and open-source cross-platform graphical user interface library for the multimedia applications development library [Pygame](https://github.com/pygame/pygame). This library aims to simplify the process of creating and managing user interfaces by providing an abstraction inspired by Roblox's interface system.
Before installing pyguilib, ensure that Python is installed on your machine. You can check this by running the following command in your terminal or command prompt:
```
python --version
```
If Python is not installed, you can download and install it from the official
Once Python is installed, you can proceed to install pyguilib using the following command:
```
pip install pyguilib
```
<details>
<summary>Components</summary>ㅤ<!---Invisible Space--->
<i>PyGuiInstance represents the very core of every component. Containing the base properties and methods for all the components.</i>
* <details>
<summary>Constructor</summary>
```python
PyGuiInstance(
draw_order = 0,
background_color = Color(140, 140, 140),
background_transparency = 255,
border_color = Color(0, 0, 0),
border_size = 0,
position = UDim2(0, 0, 0, 0),
size = UDim2(1, 0, 1, 0),
anchor_point = Vector2(0, 0),
layout_order = 0,
parent = None,
name = None,
**_,
)
```
+ `draw_order`: (int): The order in which the GUI instance is drawn.
+ `background_color` (Color): The background color of the GUI instance.
+ `background_transparency` (float): The transparency of the GUI instance background.
+ `border_color` (Color): The color of the GUI instance border.
+ `border_size` (int): The size of the GUI instance border.
+ `position` (UDim2): The position of the GUI instance relative to its parent.
+ `size` (UDim2): The size of the GUI instance relative to its parent.
+ `anchor_point` (Vector2): The anchor point around which the GUI instance is positioned and scaled.
+ `layout_order` (int): The order in which the GUI instance is laid out.
+ `parent` (Optional[PyGuiInstance]): The parent GUI instance.
+ `name` (str): The name of the GUI instance.
+ `**_`: Additional keyword arguments.
</details>
* <details>
<summary>Methods</summary>
+ `build()` -> `PyGuiInstance`: Build the GUI instance and add it to the parent.
+ `get_property_changed_signal(property_name: str)` -> `PyGuiSignal`: Get the signal for property changes.
+ `update(events: List[Event])`: Update the GUI instance based on events.
+ `clear()`: Clear the GUI instance.
+ `draw()`: Draw the GUI instance.
</details>
* <details>
<summary>Properties</summary>
+ `visible` (bool): Property indicating whether the GUI instance is visible.
+ `draw_order` (int): Property indicating the draw order of the GUI instance.
+ `background_color` (Color): Property indicating the background color of the GUI instance.
+ `background_transparency` (float): Property indicating the transparency of the GUI instance background.
+ `border_color` (Color): Property indicating the border color of the GUI instance.
+ `border_size` (int): Property indicating the border size of the GUI instance.
+ `position` (UDim2): Property indicating the position of the GUI instance.
+ `absolute_position` (Vector2): Property indicating the absolute position of the GUI instance.
+ `size` (UDim2): Property indicating the size of the GUI instance.
+ `absolute_size` (Vector2): Property indicating the absolute size of the GUI instance.
+ `anchor_point` (Vector2): Property indicating the anchor point of the GUI instance.
+ `layout_order` (int): Property indicating the layout order of the GUI instance.
+ `parent` (Optional[PyGuiInstance]): Property indicating the parent GUI instance.
+ `name` (str): Property indicating the name of the GUI instance.
+ `BLOCKING_SCREEN_BUFFER_UPDATE` (int): Property to block screen buffer updates.
</details>
---
<i>Frame class representing a container with layout capabilities.</i>
* Inherits from:
`PyGuiInstance`
`PyGuiLayoutContainer`
* <details>
<summary>Constructor</summary>
```python
Frame(**kwags)
```
+ `**kwags`: Additional keyword arguments used by PyGuiInstance and/or PyGuiLayoutContainer.
</details>
---
<i>ImageLabel class representing an image label component.</i>
* Inherits from:
`PyGuiInstance`
* <details>
<summary>Constructor</summary>
```python
ImageLabel(
image_color = Color(255, 255, 255),
image_transparency = 255,
**kwags
)
```
+ `image_color`: (Color): The image color.
+ `image_transparency` (int): The image transparency.
+ `**kwags`: Additional keyword arguments used by PyGuiInstance.
</details>
---
<i>TextBox class represents a GUI component for text input.</i>
* Inherits from:
`TextLabel`
`PyGuiInstance`
* <details>
<summary>Constructor</summary>
```python
TextBox(
placeholder_text = "TextBox",
placeholder_text_color = Color(255, 0, 0),
placeholder_text_transparency = 255,
text_font = Font("Arial", self.text_size),
text_editable = True,
clear_text_on_focus_lost = False,
selection_color = Color(255, 255, 255),
selection_transparency = 170,
cursor_blink_interval = 0.5,
cursor_appeareance = function(text_box: TextBox) -> Surface,
**kwags
)
```
+ `placeholder_text` (str): The current placeholder text.
+ `placeholder_text_color` (Color): The current color of the placeholder text.
+ `placeholder_text_transparency` (int): The current transparency of the placeholder text.
+ `placeholder_text_font` (pygame.font.Font): The current font used for the placeholder text.
+ `text_editable` (bool): True if the text is editable, False otherwise.
+ `clear_text_on_focus_lost` (bool): True if text should be cleared on focus lost, False otherwise.
+ `selection_start` (int): The starting index of the text selection.
+ `selection_end` (int): The ending index of the text selection.
+ `cursor_position` (int): The current cursor position.
+ `**kwags`: Additional keyword arguments used by TextLabel and/or PyGuiInstance.
</details>
* <details>
<summary>Methods</summary>
+ `is_focused()`: Check if the TextBox is currently focused.
+ `capture_focus()`: Capture focus for the TextBox.
+ `release_focus(enter_pressed: bool = False)`: Release focus for the TextBox.
+ `placeholder_text()`: Get or set the placeholder text.
+ `placeholder_text_color()`: Get or set the color of the placeholder text.
+ `placeholder_text_transparency()`: Get or set the transparency of the placeholder text.
+ `placeholder_text_font()`: Get or set the font used for the placeholder text.
+ `text_editable()`: Get or set the flag indicating whether the text is editable.
+ `clear_text_on_focus_lost()`: Get or set the flag indicating whether to clear text on focus lost.
+ `selection_start()`: Get the starting index of the text selection.
+ `selection_end()`: Get the ending index of the text selection.
+ `cursor_position()`: Get the current cursor position in the text.
</details>
* <details>
<summary>Properties</summary>
+ `placeholder_text` (str): The current placeholder text.
+ `placeholder_text_color` (Color): The current color of the placeholder text.
+ `placeholder_text_transparency` (int): The current transparency of the placeholder text.
+ `placeholder_text_font` (pygame.font.Font): The current font used for the placeholder text.
+ `text_editable` (bool): True if the text is editable, False otherwise.
+ `clear_text_on_focus_lost` (bool): True if text should be cleared on focus lost, False otherwise.
+ `selection_start` (int): The starting index of the text selection.
+ `selection_end` (int): The ending index of the text selection.
+ `cursor_position` (int): The current cursor position.
</summary>
---
<i>TextLabel class represents a GUI component for displaying text.</i>
* Inherits from:
`PyGuiInstance`
* <details>
<summary>Constructor</summary>
```python
TextLabel(
text = "TextLabel",
text_color = Color(255, 255, 255),
text_transparency = 255,
text_size = 16,
text_font = Font("Arial", self.text_size),
border_color = Color(0, 0, 0),
border_size = 1,
text_x_alignment = TextXAlignment.CENTER,
text_y_alignment = TextYAlignment.CENTER,
**kwags
)
```
+ `text` (str): The text content.
+ `text_color` (Color): The text color.
+ `text_transparency` (int): The text transparency.
+ `text_size` (int): The text size.
+ `text_font` (pygame.font.Font): The text font.
+ `text_border_color` (Color): The text border color.
+ `text_border_size` (int): The text border size.
+ `text_x_alignment` (TextXAlignment): The text horizontal alignment.
+ `text_y_alignment` (TextYAlignment): The text vertical alignment.
+ `**kwags`: Additional keyword arguments used by PyGuiInstance.
</details>
* <details>
<summary>Methods</summary>
+ `text_position()`: Calculates the position of the text based on alignment.
+ `text_bounds()`: Gets the bounding box of the text.
</details>
* <details>
<summary>Properties</summary>
+ `text` (str): The text content.
+ `text_color` (Color): The text color.
+ `text_transparency` (int): The text transparency.
+ `text_size` (int): The text size.
+ `text_font` (pygame.font.Font): The text font.
+ `text_border_color` (Color): The text border color.
+ `text_border_size` (int): The text border size.
+ `text_x_alignment` (TextXAlignment): The text horizontal alignment.
+ `text_y_alignment` (TextYAlignment): The text vertical alignment.
</details>
* <details>
<summary>Enums</summary>
+ `TextXAlignment`
+ LEFT: Align text to the left.
+ CENTER: Center-align text.
+ RIGHT: Align text to the right.
+ `TextYAlignment`
+ TOP: Align text to the top.
+ CENTER: Center-align text vertically.
+ BOTTOM: Align text to the bottom.
</details>
---
<i>VideoLabel class represents a GUI component for displaying a GIF.</i>
* Inherits from:
`PyGuiInstance`
* <details>
<summary>Constructor</summary>
```python
VideoLabel(
gif_playback_speed = 1,
gif_color = Color(255, 255, 255),
gif_transparency = 255,
**kwags
)
```
+ `gif_playback_speed` (str): The GIF playback speed.
+ `gif_color` (Color): The GIF color.
+ `gif_transparency` (int): The GIF transparency.
+ `**kwags`: Additional keyword arguments used by PyGuiInstance.
</details>
* <details>
<summary>Methods</summary>
+ `pause()`: Placeholder method for pausing the GIF.
+ `resume()`: Placeholder method for resuming the GIF.
</details>
* <details>
<summary>Properties</summary>
+ `current_gif_frame` (int): Index of the current GIF frame.
+ `gif_playback_speed` (int): The GIF playback speed.
+ `gif_color` (Color): The GIF color.
+ `gif_transparency` (int): The GIF transparency.
</details>
</details>
<details>
<summary>Layouts</summary>ㅤ<!---Invisible Space--->
<i>PyGuiLayoutStyle class represents a layout style for PyGuiInstance.</i>
* <details>
<summary>Constructor</summary>
```python
PyGuiLayoutStyle(
on_layout_instance_child_added = lambda: None,
on_layout_instance_child_removed = lambda: None,
on_layout_applied = lambda: None,
on_layout_removed = lambda: None,
layout_order_manager = lambda: None,
**kwags
)
```
+ `on_layout_instance_child_added (Optional[Callable[[Any], Any]])`: Callback for child addition to the layout.
+ `on_layout_instance_child_removed (Optional[Callable[[Any], Any]])`: Callback for child removal from the layout.
+ `on_layout_applied (Optional[Callable[[Any], Any]])`: Callback for when the layout is applied.
+ `on_layout_removed (Optional[Callable[[Any], Any]])`: Callback for when the layout is removed.
+ `layout_order_manager (Optional[Callable[[Any], Any]])`: Callback for managing the layout order.
+ `**kwargs`: Additional keyword arguments.
</details>
* <details>
<summary>Properties</summary>
+ `instance` (PyGuiInstance): The associated PyGuiInstance.
+ `horizontal_alignment` (HorizontalAlignment): The horizontal alignment of child instances.
+ `vertical_alignment` (VerticalAlignment): The vertical alignment of child instances.
+ `fill_direction` (FillDirection): The fill direction for child instances.
+ `sort_order` (SortOrder): The sorting order for child instances.
</details>
* <details>
<summary>Enums</summary>
+ `HorizontalAlignment`
+ LEFT: Aligns child instances to the left of the parent instance.
+ CENTER: Aligns child instances to the center of the parent instance.
+ RIGHT: Aligns child instances to the right of the parent instance.
+ `VerticalAlignment`
+ TOP: Aligns child instances to the top of the parent instance.
+ CENTER: Aligns child instances to the center of the parent instance.
+ BOTTOM: Aligns child instances to the bottom of the parent instance.
+ `FillDirection`
+ HORIZONTAL: Aligns child instances horizontally.
+ VERTICAL: Aligns child instances vertically.
+ `SortOrder`
+ NAME: Sorts child instances by name.
+ LAYOUT_ORDER: Sorts child instances by layout order.
+ CUSTOM: Sorts child instances by custom order.
</details>
___
<i>PyGuiListLayout class represents a list layout style for a PyGui instance.</i>
* Inherits from:
`PyGuiLayoutStyle`
* <details>
<summary>Constructor</summary>
```python
PyGuiListLayout(
horizontal_padding = UDim(0, 0),
vertical_padding = UDim(0, 0),
top_margin = Udim(0, 0),
bottom_margin = Udim(0, 0),
left_margin = Udim(0, 0),
right_margin = Udim(0, 0),
**kwags
)
```
+ `horizontal_padding (UDim)`: The horizontal padding for child instances.
+ `vertical_padding (UDim)`: The vertical padding for child instances.
+ `top_margin (UDim)`: The top margin for child instances.
+ `bottom_margin (UDim)`: The bottom margin for child instances.
+ `left_margin (UDim)`: The bottom margin for child instances.
+ `right_margin (UDim)`: The left margin for child instances.
+ `**kwargs`: Additional keyword arguments used by PyGuiLayoutStyle.
</details>
* <details>
<summary>Properties</summary>
+ `horizontal_padding (UDim)`: The horizontal padding for child instances.
+ `vertical_padding (UDim)`: The vertical padding for child instances.
+ `top_margin (UDim)`: The top margin for child instances.
+ `bottom_margin (UDim)`: The bottom margin for child instances.
+ `left_margin (UDim)`: The bottom margin for child instances.
+ `right_margin (UDim)`: The left margin for child instances.
</details>
</details>
<details>
<summary>Services</summary>ㅤ<!---Invisible Space--->
<i>TweenService is used as an interface to directly apply constant</i>
* <details>
<summary>Classes</summary>
<details>
<summary>Tween</summary>
<i>Represents a tween animation.</i>
* <details>
<summary>Constructor</summary>
```python
Tween(
instance,
properties,
duration,
tween_type = TweenType.LINEAR
)
```
+ `gif_playback_speed` (str): The GIF playback speed.
+ `instance` (PyGuiInstance): The PyGuiInstance to be tweened.
+ `properties` (Dict[str, Any]): A dictionary of properties to be tweened.
+ `duration` (float): The duration of the tween in seconds.
+ `tween_type` (TweenType): The type of tween to be used.
</details>
* <details>
<summary>Methods</summary>
+ `play()`: Starts or resumes the tween.
+ `pause()`: Pauses the tween (Not implemented).
+ `cancel()`: Cancels the tween and resets the PyGuiInstance properties.
</details>
* <details>
<summary>Properties</summary>
+ `alpha` (float): Current progress of the tween as a value between 0 and 1.
</details>
</details>
</details>
* <details>
<summary>Enums</summary>
+ `TweenStatus`
+ PLAYING: The Tween is currently playing.
+ PAUSED: The Tween is paused.
+ CANCELED: The Tween has been canceled.
+ ENDED: The Tween has ended.
+ `TweenType`
+ LINEAR: Linear interpolation.
+ SINE_IN, SINE_OUT, SINE_IN_OUT: Sine easing functions.
+ QUAD_IN, QUAD_OUT, QUAD_IN_OUT: Quadratic easing functions.
+ CUBIC_IN, CUBIC_OUT, CUBIC_IN_OUT: Cubic easing functions.
+ QUART_IN, QUART_OUT, QUART_IN_OUT: Quartic easing functions.
+ QUINT_IN, QUINT_OUT, QUINT_IN_OUT: Quintic easing functions.
+ EXPO_IN, EXPO_OUT, EXPO_IN_OUT: Exponential easing functions.
+ CIRC_IN, CIRC_OUT, CIRC_IN_OUT: Circular easing functions.
+ BACK_IN, BACK_OUT, BACK_IN_OUT: Back easing functions.
+ ELASTIC_IN, ELASTIC_OUT, ELASTIC_IN_OUT: Elastic easing functions.
+ BOUNCE_IN, BOUNCE_OUT, BOUNCE_IN_OUT: Bounce easing functions.
</details>
___
<i>Service to help facilitate the process of listening for user inputs.</i>
* <details>
<summary>Functions</summary>
+ `release_focus(action_name: str, callback: Callable[[Any], Optional[ActionResult]], events: List[int], priority: int = 0, internal: bool = False)`: Binds an action to specific events and assigns a callback function to handle the action.
+ `unbind_action(action_name: str)`: Unbinds an action based on its name.
</details>
* <details>
<summary>Enums</summary>
+ `ActionResult`
+ SINK: The action was handled and should not be passed to other callbacks.
+ PASS: The action was not handled and should be passed to other callbacks.
</details>
</details>
<details>
<summary>Utilities</summary>ㅤ<!---Invisible Space--->
<i>Represents a signal in PyGui, allowing connections to callback functions.</i>
* <details>
<summary>Classes</summary>
* <details>
<summary>PyGuiConnection</summary>
<i>Represents a connection between a PyGuiSignal and a callback function.</i>
* <details>
<summary>Constructor</summary>
```python
PyGuiConnection(signal, callback)
```
+ `signal (PyGuiSignal)`: The PyGuiSignal to be connected to.
+ `callback (Callable[[Any], Any])`: The callback function to be connected.
</details>
* <details>
<summary>Methods</summary>
+ `disconnect(self)`: Disconnects the connection from the associated PyGuiSignal.
</details>
</details>
* <details>
<summary>PyGuiSignal</summary>
<i>Represents a signal in PyGui, allowing connections to callback functions.</i>
* <details>
<summary>Methods</summary>
+ `connect(self, callback: Callable[[Any], Any])` -> `PyGuiConnection`: Connects a callback function to the PyGuiSignal and returns a PyGuiConnection.
+ `fire(self, arguments: Any = None)`: Fires the PyGuiSignal, invoking all connected callback functions.
+ `wait(self)`: Placeholder method for potential future use.
</details>
</details>
</details>
___
<i>UDim represents an scaleable (1D and 2D) user interface dimension (UDim) with a scale and offset.</i>
* <details>
<summary>Classes</summary>
* <details>
<summary>UDim</summary>
<i>Represents a one-dimensional user interface dimension (UDim) with a scale and offset.</i>
* <details>
<summary>Constructor</summary>
```python
UDim(scale, offset, scale_y, offset_y)
```
+ `scale` (float): The scaling factor of the UDim.
+ `offset` (float): The offset of the UDim.
</details>
* <details>
<summary>Properties</summary>
+ `scale` (float): The scaling factor of the UDim.
+ `offset` (float): The offset of the UDim.
</details>
</details>
* <details>
<summary>UDim2</summary>
<i>Represents a two-dimensional user interface dimension (UDim2) with separate X and Y dimensions.</i>
* <details>
<summary>Constructor</summary>
```python
UDim2(scale_x, offset_x, scale_y, offset_y)
```
+ `scale_x` (float): The scaling factor of the X dimension.
+ `offset_x` (float): The offset of the X dimension.
+ `scale_y` (float): The scaling factor of the Y dimension.
+ `offset_y` (float): The offset of the Y dimension.
</details>
* <details>
<summary>Properties</summary>
+ `x` (UDim): The UDim instance for the X dimension.
+ `y` (UDim): The UDim instance for the Y dimension.
</details>
</details>
</details>
</details>
Contributions to pyguilib are welcome! If you encounter any issues or have suggestions for improvements, please open an issue on the GitHub repository.
Raw data
{
"_id": null,
"home_page": "",
"name": "pyguilib",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "Graphical User Interface,User Interface,PyGame,Game",
"author": "",
"author_email": "Guilherme Daghlian <gm.daghlian@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/b8/1c/b1311ac30c969d2d5e7cb05399dca9b6c19c6b75de5417e91ba596f96aee/pyguilib-0.0.5.tar.gz",
"platform": null,
"description": "# pyguilib\r\n\r\npyguilib is a free and open-source cross-platform graphical user interface library for the multimedia applications development library [Pygame](https://github.com/pygame/pygame). This library aims to simplify the process of creating and managing user interfaces by providing an abstraction inspired by Roblox's interface system.\r\n\r\n\r\n\r\nBefore installing pyguilib, ensure that Python is installed on your machine. You can check this by running the following command in your terminal or command prompt:\r\n```\r\npython --version\r\n```\r\nIf Python is not installed, you can download and install it from the official\r\n\r\nOnce Python is installed, you can proceed to install pyguilib using the following command:\r\n```\r\npip install pyguilib\r\n```\r\n\r\n\r\n<details>\r\n <summary>Components</summary>\u3164<!---Invisible Space--->\r\n \r\n \r\n \r\n <i>PyGuiInstance represents the very core of every component. Containing the base properties and methods for all the components.</i>\r\n * <details>\r\n <summary>Constructor</summary>\r\n\r\n ```python\r\n PyGuiInstance(\r\n draw_order = 0,\r\n background_color = Color(140, 140, 140),\r\n background_transparency = 255,\r\n border_color = Color(0, 0, 0),\r\n border_size = 0,\r\n position = UDim2(0, 0, 0, 0),\r\n size = UDim2(1, 0, 1, 0),\r\n anchor_point = Vector2(0, 0),\r\n layout_order = 0,\r\n parent = None,\r\n name = None,\r\n **_,\r\n )\r\n ```\r\n + `draw_order`: (int): The order in which the GUI instance is drawn.\r\n + `background_color` (Color): The background color of the GUI instance.\r\n + `background_transparency` (float): The transparency of the GUI instance background.\r\n + `border_color` (Color): The color of the GUI instance border.\r\n + `border_size` (int): The size of the GUI instance border.\r\n + `position` (UDim2): The position of the GUI instance relative to its parent.\r\n + `size` (UDim2): The size of the GUI instance relative to its parent.\r\n + `anchor_point` (Vector2): The anchor point around which the GUI instance is positioned and scaled.\r\n + `layout_order` (int): The order in which the GUI instance is laid out.\r\n + `parent` (Optional[PyGuiInstance]): The parent GUI instance.\r\n + `name` (str): The name of the GUI instance.\r\n + `**_`: Additional keyword arguments.\r\n </details>\r\n * <details>\r\n <summary>Methods</summary>\r\n \r\n + `build()` -> `PyGuiInstance`: Build the GUI instance and add it to the parent.\r\n + `get_property_changed_signal(property_name: str)` -> `PyGuiSignal`: Get the signal for property changes.\r\n + `update(events: List[Event])`: Update the GUI instance based on events.\r\n + `clear()`: Clear the GUI instance.\r\n + `draw()`: Draw the GUI instance.\r\n </details>\r\n * <details>\r\n <summary>Properties</summary>\r\n \r\n + `visible` (bool): Property indicating whether the GUI instance is visible.\r\n + `draw_order` (int): Property indicating the draw order of the GUI instance.\r\n + `background_color` (Color): Property indicating the background color of the GUI instance.\r\n + `background_transparency` (float): Property indicating the transparency of the GUI instance background.\r\n + `border_color` (Color): Property indicating the border color of the GUI instance.\r\n + `border_size` (int): Property indicating the border size of the GUI instance.\r\n + `position` (UDim2): Property indicating the position of the GUI instance.\r\n + `absolute_position` (Vector2): Property indicating the absolute position of the GUI instance.\r\n + `size` (UDim2): Property indicating the size of the GUI instance.\r\n + `absolute_size` (Vector2): Property indicating the absolute size of the GUI instance.\r\n + `anchor_point` (Vector2): Property indicating the anchor point of the GUI instance.\r\n + `layout_order` (int): Property indicating the layout order of the GUI instance.\r\n + `parent` (Optional[PyGuiInstance]): Property indicating the parent GUI instance.\r\n + `name` (str): Property indicating the name of the GUI instance.\r\n + `BLOCKING_SCREEN_BUFFER_UPDATE` (int): Property to block screen buffer updates.\r\n </details>\r\n\r\n ---\r\n \r\n \r\n \r\n <i>Frame class representing a container with layout capabilities.</i>\r\n * Inherits from:\r\n `PyGuiInstance`\r\n `PyGuiLayoutContainer`\r\n * <details>\r\n <summary>Constructor</summary>\r\n \r\n ```python\r\n Frame(**kwags)\r\n ```\r\n + `**kwags`: Additional keyword arguments used by PyGuiInstance and/or PyGuiLayoutContainer.\r\n </details>\r\n\r\n ---\r\n\r\n \r\n \r\n <i>ImageLabel class representing an image label component.</i>\r\n * Inherits from:\r\n `PyGuiInstance`\r\n * <details>\r\n <summary>Constructor</summary>\r\n \r\n ```python\r\n ImageLabel(\r\n image_color = Color(255, 255, 255),\r\n image_transparency = 255,\r\n **kwags\r\n )\r\n ```\r\n + `image_color`: (Color): The image color.\r\n + `image_transparency` (int): The image transparency.\r\n + `**kwags`: Additional keyword arguments used by PyGuiInstance.\r\n </details>\r\n\r\n ---\r\n\r\n \r\n \r\n <i>TextBox class represents a GUI component for text input.</i>\r\n * Inherits from:\r\n `TextLabel`\r\n `PyGuiInstance`\r\n * <details>\r\n <summary>Constructor</summary>\r\n \r\n ```python\r\n TextBox(\r\n placeholder_text = \"TextBox\",\r\n placeholder_text_color = Color(255, 0, 0),\r\n placeholder_text_transparency = 255,\r\n text_font = Font(\"Arial\", self.text_size),\r\n text_editable = True,\r\n clear_text_on_focus_lost = False,\r\n selection_color = Color(255, 255, 255),\r\n selection_transparency = 170,\r\n cursor_blink_interval = 0.5,\r\n cursor_appeareance = function(text_box: TextBox) -> Surface,\r\n **kwags\r\n )\r\n ```\r\n + `placeholder_text` (str): The current placeholder text.\r\n + `placeholder_text_color` (Color): The current color of the placeholder text.\r\n + `placeholder_text_transparency` (int): The current transparency of the placeholder text.\r\n + `placeholder_text_font` (pygame.font.Font): The current font used for the placeholder text.\r\n + `text_editable` (bool): True if the text is editable, False otherwise.\r\n + `clear_text_on_focus_lost` (bool): True if text should be cleared on focus lost, False otherwise.\r\n + `selection_start` (int): The starting index of the text selection.\r\n + `selection_end` (int): The ending index of the text selection.\r\n + `cursor_position` (int): The current cursor position.\r\n + `**kwags`: Additional keyword arguments used by TextLabel and/or PyGuiInstance.\r\n </details>\r\n * <details>\r\n <summary>Methods</summary>\r\n \r\n + `is_focused()`: Check if the TextBox is currently focused.\r\n + `capture_focus()`: Capture focus for the TextBox.\r\n + `release_focus(enter_pressed: bool = False)`: Release focus for the TextBox.\r\n + `placeholder_text()`: Get or set the placeholder text.\r\n + `placeholder_text_color()`: Get or set the color of the placeholder text.\r\n + `placeholder_text_transparency()`: Get or set the transparency of the placeholder text.\r\n + `placeholder_text_font()`: Get or set the font used for the placeholder text.\r\n + `text_editable()`: Get or set the flag indicating whether the text is editable.\r\n + `clear_text_on_focus_lost()`: Get or set the flag indicating whether to clear text on focus lost.\r\n + `selection_start()`: Get the starting index of the text selection.\r\n + `selection_end()`: Get the ending index of the text selection.\r\n + `cursor_position()`: Get the current cursor position in the text.\r\n </details>\r\n * <details>\r\n <summary>Properties</summary>\r\n \r\n + `placeholder_text` (str): The current placeholder text.\r\n + `placeholder_text_color` (Color): The current color of the placeholder text.\r\n + `placeholder_text_transparency` (int): The current transparency of the placeholder text.\r\n + `placeholder_text_font` (pygame.font.Font): The current font used for the placeholder text.\r\n + `text_editable` (bool): True if the text is editable, False otherwise.\r\n + `clear_text_on_focus_lost` (bool): True if text should be cleared on focus lost, False otherwise.\r\n + `selection_start` (int): The starting index of the text selection.\r\n + `selection_end` (int): The ending index of the text selection.\r\n + `cursor_position` (int): The current cursor position.\r\n </summary>\r\n\r\n ---\r\n \r\n \r\n \r\n <i>TextLabel class represents a GUI component for displaying text.</i>\r\n * Inherits from:\r\n `PyGuiInstance`\r\n * <details>\r\n <summary>Constructor</summary>\r\n\r\n ```python\r\n TextLabel(\r\n text = \"TextLabel\",\r\n text_color = Color(255, 255, 255),\r\n text_transparency = 255,\r\n text_size = 16,\r\n text_font = Font(\"Arial\", self.text_size),\r\n border_color = Color(0, 0, 0),\r\n border_size = 1,\r\n text_x_alignment = TextXAlignment.CENTER,\r\n text_y_alignment = TextYAlignment.CENTER,\r\n **kwags\r\n )\r\n ```\r\n + `text` (str): The text content.\r\n + `text_color` (Color): The text color.\r\n + `text_transparency` (int): The text transparency.\r\n + `text_size` (int): The text size.\r\n + `text_font` (pygame.font.Font): The text font.\r\n + `text_border_color` (Color): The text border color.\r\n + `text_border_size` (int): The text border size.\r\n + `text_x_alignment` (TextXAlignment): The text horizontal alignment.\r\n + `text_y_alignment` (TextYAlignment): The text vertical alignment.\r\n + `**kwags`: Additional keyword arguments used by PyGuiInstance.\r\n </details>\r\n * <details>\r\n <summary>Methods</summary>\r\n \r\n + `text_position()`: Calculates the position of the text based on alignment.\r\n + `text_bounds()`: Gets the bounding box of the text.\r\n </details>\r\n * <details>\r\n <summary>Properties</summary>\r\n\r\n + `text` (str): The text content.\r\n + `text_color` (Color): The text color.\r\n + `text_transparency` (int): The text transparency.\r\n + `text_size` (int): The text size.\r\n + `text_font` (pygame.font.Font): The text font.\r\n + `text_border_color` (Color): The text border color.\r\n + `text_border_size` (int): The text border size.\r\n + `text_x_alignment` (TextXAlignment): The text horizontal alignment.\r\n + `text_y_alignment` (TextYAlignment): The text vertical alignment.\r\n </details>\r\n * <details>\r\n <summary>Enums</summary>\r\n\r\n + `TextXAlignment`\r\n + LEFT: Align text to the left.\r\n + CENTER: Center-align text.\r\n + RIGHT: Align text to the right.\r\n + `TextYAlignment`\r\n + TOP: Align text to the top.\r\n + CENTER: Center-align text vertically.\r\n + BOTTOM: Align text to the bottom.\r\n </details>\r\n\r\n ---\r\n\r\n \r\n \r\n <i>VideoLabel class represents a GUI component for displaying a GIF.</i>\r\n * Inherits from:\r\n `PyGuiInstance`\r\n * <details>\r\n <summary>Constructor</summary>\r\n\r\n ```python\r\n VideoLabel(\r\n gif_playback_speed = 1,\r\n gif_color = Color(255, 255, 255),\r\n gif_transparency = 255,\r\n **kwags\r\n )\r\n ```\r\n + `gif_playback_speed` (str): The GIF playback speed.\r\n + `gif_color` (Color): The GIF color.\r\n + `gif_transparency` (int): The GIF transparency.\r\n + `**kwags`: Additional keyword arguments used by PyGuiInstance.\r\n </details>\r\n * <details>\r\n <summary>Methods</summary>\r\n \r\n + `pause()`: Placeholder method for pausing the GIF.\r\n + `resume()`: Placeholder method for resuming the GIF.\r\n </details>\r\n * <details>\r\n <summary>Properties</summary>\r\n\r\n + `current_gif_frame` (int): Index of the current GIF frame.\r\n + `gif_playback_speed` (int): The GIF playback speed.\r\n + `gif_color` (Color): The GIF color.\r\n + `gif_transparency` (int): The GIF transparency.\r\n </details>\r\n</details>\r\n\r\n<details>\r\n <summary>Layouts</summary>\u3164<!---Invisible Space--->\r\n\r\n \r\n\r\n <i>PyGuiLayoutStyle class represents a layout style for PyGuiInstance.</i>\r\n * <details>\r\n <summary>Constructor</summary>\r\n\r\n ```python\r\n PyGuiLayoutStyle(\r\n on_layout_instance_child_added = lambda: None,\r\n on_layout_instance_child_removed = lambda: None,\r\n on_layout_applied = lambda: None,\r\n on_layout_removed = lambda: None,\r\n layout_order_manager = lambda: None,\r\n **kwags\r\n )\r\n ```\r\n + `on_layout_instance_child_added (Optional[Callable[[Any], Any]])`: Callback for child addition to the layout.\r\n + `on_layout_instance_child_removed (Optional[Callable[[Any], Any]])`: Callback for child removal from the layout.\r\n + `on_layout_applied (Optional[Callable[[Any], Any]])`: Callback for when the layout is applied.\r\n + `on_layout_removed (Optional[Callable[[Any], Any]])`: Callback for when the layout is removed.\r\n + `layout_order_manager (Optional[Callable[[Any], Any]])`: Callback for managing the layout order.\r\n + `**kwargs`: Additional keyword arguments.\r\n </details>\r\n * <details>\r\n <summary>Properties</summary>\r\n\r\n + `instance` (PyGuiInstance): The associated PyGuiInstance.\r\n + `horizontal_alignment` (HorizontalAlignment): The horizontal alignment of child instances.\r\n + `vertical_alignment` (VerticalAlignment): The vertical alignment of child instances.\r\n + `fill_direction` (FillDirection): The fill direction for child instances.\r\n + `sort_order` (SortOrder): The sorting order for child instances.\r\n </details>\r\n * <details>\r\n <summary>Enums</summary>\r\n\r\n + `HorizontalAlignment`\r\n + LEFT: Aligns child instances to the left of the parent instance.\r\n + CENTER: Aligns child instances to the center of the parent instance.\r\n + RIGHT: Aligns child instances to the right of the parent instance.\r\n + `VerticalAlignment`\r\n + TOP: Aligns child instances to the top of the parent instance.\r\n + CENTER: Aligns child instances to the center of the parent instance.\r\n + BOTTOM: Aligns child instances to the bottom of the parent instance.\r\n + `FillDirection`\r\n + HORIZONTAL: Aligns child instances horizontally.\r\n + VERTICAL: Aligns child instances vertically.\r\n + `SortOrder`\r\n + NAME: Sorts child instances by name.\r\n + LAYOUT_ORDER: Sorts child instances by layout order.\r\n + CUSTOM: Sorts child instances by custom order.\r\n </details>\r\n ___\r\n\r\n \r\n\r\n <i>PyGuiListLayout class represents a list layout style for a PyGui instance.</i>\r\n * Inherits from:\r\n `PyGuiLayoutStyle`\r\n * <details>\r\n <summary>Constructor</summary>\r\n\r\n ```python\r\n PyGuiListLayout(\r\n horizontal_padding = UDim(0, 0),\r\n vertical_padding = UDim(0, 0),\r\n top_margin = Udim(0, 0),\r\n bottom_margin = Udim(0, 0),\r\n left_margin = Udim(0, 0),\r\n right_margin = Udim(0, 0),\r\n **kwags\r\n )\r\n ```\r\n + `horizontal_padding (UDim)`: The horizontal padding for child instances.\r\n + `vertical_padding (UDim)`: The vertical padding for child instances.\r\n + `top_margin (UDim)`: The top margin for child instances.\r\n + `bottom_margin (UDim)`: The bottom margin for child instances.\r\n + `left_margin (UDim)`: The bottom margin for child instances.\r\n + `right_margin (UDim)`: The left margin for child instances.\r\n + `**kwargs`: Additional keyword arguments used by PyGuiLayoutStyle.\r\n </details>\r\n * <details>\r\n <summary>Properties</summary>\r\n\r\n + `horizontal_padding (UDim)`: The horizontal padding for child instances.\r\n + `vertical_padding (UDim)`: The vertical padding for child instances.\r\n + `top_margin (UDim)`: The top margin for child instances.\r\n + `bottom_margin (UDim)`: The bottom margin for child instances.\r\n + `left_margin (UDim)`: The bottom margin for child instances.\r\n + `right_margin (UDim)`: The left margin for child instances.\r\n </details>\r\n</details>\r\n\r\n<details>\r\n <summary>Services</summary>\u3164<!---Invisible Space--->\r\n\r\n \r\n \r\n <i>TweenService is used as an interface to directly apply constant</i>\r\n * <details>\r\n <summary>Classes</summary>\r\n\r\n <details>\r\n <summary>Tween</summary>\r\n \r\n <i>Represents a tween animation.</i>\r\n * <details>\r\n <summary>Constructor</summary>\r\n \r\n ```python\r\n Tween(\r\n instance,\r\n properties,\r\n duration,\r\n tween_type = TweenType.LINEAR\r\n )\r\n ```\r\n + `gif_playback_speed` (str): The GIF playback speed.\r\n + `instance` (PyGuiInstance): The PyGuiInstance to be tweened.\r\n + `properties` (Dict[str, Any]): A dictionary of properties to be tweened.\r\n + `duration` (float): The duration of the tween in seconds.\r\n + `tween_type` (TweenType): The type of tween to be used.\r\n </details>\r\n * <details>\r\n <summary>Methods</summary>\r\n \r\n + `play()`: Starts or resumes the tween.\r\n + `pause()`: Pauses the tween (Not implemented).\r\n + `cancel()`: Cancels the tween and resets the PyGuiInstance properties.\r\n </details>\r\n * <details>\r\n <summary>Properties</summary>\r\n \r\n + `alpha` (float): Current progress of the tween as a value between 0 and 1.\r\n </details>\r\n </details>\r\n </details>\r\n * <details>\r\n <summary>Enums</summary>\r\n\r\n + `TweenStatus`\r\n + PLAYING: The Tween is currently playing.\r\n + PAUSED: The Tween is paused.\r\n + CANCELED: The Tween has been canceled.\r\n + ENDED: The Tween has ended.\r\n \r\n + `TweenType`\r\n + LINEAR: Linear interpolation.\r\n + SINE_IN, SINE_OUT, SINE_IN_OUT: Sine easing functions.\r\n + QUAD_IN, QUAD_OUT, QUAD_IN_OUT: Quadratic easing functions.\r\n + CUBIC_IN, CUBIC_OUT, CUBIC_IN_OUT: Cubic easing functions.\r\n + QUART_IN, QUART_OUT, QUART_IN_OUT: Quartic easing functions.\r\n + QUINT_IN, QUINT_OUT, QUINT_IN_OUT: Quintic easing functions.\r\n + EXPO_IN, EXPO_OUT, EXPO_IN_OUT: Exponential easing functions.\r\n + CIRC_IN, CIRC_OUT, CIRC_IN_OUT: Circular easing functions.\r\n + BACK_IN, BACK_OUT, BACK_IN_OUT: Back easing functions.\r\n + ELASTIC_IN, ELASTIC_OUT, ELASTIC_IN_OUT: Elastic easing functions.\r\n + BOUNCE_IN, BOUNCE_OUT, BOUNCE_IN_OUT: Bounce easing functions.\r\n </details>\r\n\r\n ___\r\n\r\n \r\n \r\n <i>Service to help facilitate the process of listening for user inputs.</i>\r\n * <details>\r\n <summary>Functions</summary>\r\n\r\n + `release_focus(action_name: str, callback: Callable[[Any], Optional[ActionResult]], events: List[int], priority: int = 0, internal: bool = False)`: Binds an action to specific events and assigns a callback function to handle the action.\r\n + `unbind_action(action_name: str)`: Unbinds an action based on its name.\r\n </details>\r\n * <details>\r\n <summary>Enums</summary>\r\n\r\n + `ActionResult`\r\n + SINK: The action was handled and should not be passed to other callbacks.\r\n + PASS: The action was not handled and should be passed to other callbacks.\r\n </details>\r\n</details>\r\n\r\n<details>\r\n <summary>Utilities</summary>\u3164<!---Invisible Space--->\r\n\r\n \r\n\r\n <i>Represents a signal in PyGui, allowing connections to callback functions.</i>\r\n * <details>\r\n <summary>Classes</summary>\r\n\r\n * <details>\r\n <summary>PyGuiConnection</summary>\r\n \r\n <i>Represents a connection between a PyGuiSignal and a callback function.</i>\r\n * <details>\r\n <summary>Constructor</summary>\r\n \r\n ```python\r\n PyGuiConnection(signal, callback)\r\n ```\r\n + `signal (PyGuiSignal)`: The PyGuiSignal to be connected to.\r\n + `callback (Callable[[Any], Any])`: The callback function to be connected.\r\n </details>\r\n * <details>\r\n <summary>Methods</summary>\r\n \r\n + `disconnect(self)`: Disconnects the connection from the associated PyGuiSignal.\r\n </details>\r\n </details>\r\n * <details>\r\n <summary>PyGuiSignal</summary>\r\n \r\n <i>Represents a signal in PyGui, allowing connections to callback functions.</i>\r\n * <details>\r\n <summary>Methods</summary>\r\n \r\n + `connect(self, callback: Callable[[Any], Any])` -> `PyGuiConnection`: Connects a callback function to the PyGuiSignal and returns a PyGuiConnection.\r\n + `fire(self, arguments: Any = None)`: Fires the PyGuiSignal, invoking all connected callback functions.\r\n + `wait(self)`: Placeholder method for potential future use.\r\n </details>\r\n </details>\r\n </details>\r\n\r\n ___\r\n \r\n \r\n\r\n <i>UDim represents an scaleable (1D and 2D) user interface dimension (UDim) with a scale and offset.</i>\r\n * <details>\r\n <summary>Classes</summary>\r\n\r\n * <details>\r\n <summary>UDim</summary>\r\n \r\n <i>Represents a one-dimensional user interface dimension (UDim) with a scale and offset.</i>\r\n * <details>\r\n <summary>Constructor</summary>\r\n \r\n ```python\r\n UDim(scale, offset, scale_y, offset_y)\r\n ```\r\n + `scale` (float): The scaling factor of the UDim.\r\n + `offset` (float): The offset of the UDim.\r\n </details>\r\n * <details>\r\n <summary>Properties</summary>\r\n \r\n + `scale` (float): The scaling factor of the UDim.\r\n + `offset` (float): The offset of the UDim.\r\n </details>\r\n </details>\r\n * <details>\r\n <summary>UDim2</summary>\r\n \r\n <i>Represents a two-dimensional user interface dimension (UDim2) with separate X and Y dimensions.</i>\r\n * <details>\r\n <summary>Constructor</summary>\r\n \r\n ```python\r\n UDim2(scale_x, offset_x, scale_y, offset_y)\r\n ```\r\n + `scale_x` (float): The scaling factor of the X dimension.\r\n + `offset_x` (float): The offset of the X dimension.\r\n + `scale_y` (float): The scaling factor of the Y dimension.\r\n + `offset_y` (float): The offset of the Y dimension.\r\n </details>\r\n * <details>\r\n <summary>Properties</summary>\r\n \r\n + `x` (UDim): The UDim instance for the X dimension.\r\n + `y` (UDim): The UDim instance for the Y dimension.\r\n </details>\r\n </details>\r\n </details>\r\n</details>\r\n\r\n\r\n\r\nContributions to pyguilib are welcome! If you encounter any issues or have suggestions for improvements, please open an issue on the GitHub repository.\r\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2023 Guilherme Daghlian Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
"summary": "Graphical User Interface made for the Pygame multimedia applications library with the intention to facilitate the creation and/or management of the user interface.",
"version": "0.0.5",
"project_urls": {
"Homepage": "https://github.com/gmdvv2003/pyguilib"
},
"split_keywords": [
"graphical user interface",
"user interface",
"pygame",
"game"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1a3e2d69f13b761fe99783dfbbd2b49998cf43c5ffddc2fb5c6e6abdd7bf4a66",
"md5": "c2a4d6fbb7e03e192c30899a67a063fe",
"sha256": "cd666cba384faa460dfc3f3d37b035503494c1b431965f525c43c671b814968d"
},
"downloads": -1,
"filename": "pyguilib-0.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c2a4d6fbb7e03e192c30899a67a063fe",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 35262,
"upload_time": "2024-02-06T16:46:34",
"upload_time_iso_8601": "2024-02-06T16:46:34.801313Z",
"url": "https://files.pythonhosted.org/packages/1a/3e/2d69f13b761fe99783dfbbd2b49998cf43c5ffddc2fb5c6e6abdd7bf4a66/pyguilib-0.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b81cb1311ac30c969d2d5e7cb05399dca9b6c19c6b75de5417e91ba596f96aee",
"md5": "cad472f9168609e40257638a80f178ec",
"sha256": "b6b004e73be9c968da3aea296ed467428a3b14534115a2f456641b7531eabd07"
},
"downloads": -1,
"filename": "pyguilib-0.0.5.tar.gz",
"has_sig": false,
"md5_digest": "cad472f9168609e40257638a80f178ec",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 31279,
"upload_time": "2024-02-06T16:46:43",
"upload_time_iso_8601": "2024-02-06T16:46:43.190626Z",
"url": "https://files.pythonhosted.org/packages/b8/1c/b1311ac30c969d2d5e7cb05399dca9b6c19c6b75de5417e91ba596f96aee/pyguilib-0.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-06 16:46:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gmdvv2003",
"github_project": "pyguilib",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pyguilib"
}
