TimePicker JSON Settings Example

This example demonstrates how to configure a TimePicker widget using settings loaded from a JSON file. Instead of using interactive controls to modify the TimePicker's appearance and behavior, this example reads all settings from a configuration file.

Files

• json_settings_example.py - The main example application
• timepicker_settings.json - The configuration file containing all settings

Configuration File Format

The timepicker_settings.json file supports the following settings:

{
    "theme": "Light",          // Can be "Light", "Dark", or "Custom"
    "width": 180,             // Width of the TimePicker (100-400)
    "height": 120,            // Height of the TimePicker (80-300)
    "item_height": 40,        // Height of each time item (20-80)
    "visible_items": 3,       // Number of visible items (3-7)
    "text_color": "#333333",  // Text color in hex format
    "background_color": "#FFFFFF",  // Background color in hex format
    "highlight_color": "#E3F2FD",  // Selection highlight color in hex format
    "scroll_speed": 18.0,     // Scrolling speed (1.0-50.0)
    "smoothness": 0.90,       // Scrolling smoothness (0.1-1.0)
    "animation_duration": 300  // Animation duration in milliseconds (100-2000)
}

Features

• JSON Configuration: All settings are loaded from a JSON file
• Settings Display: Shows current settings in a monospace font
• Theme Support: Built-in support for Light and Dark themes
• Fallback Values: Default values are used if the JSON file is missing or invalid
• Time Display: Shows the currently selected time
• Read-only Interface: Settings can only be changed by editing the JSON file

Usage

1. Configure the TimePicker by editing timepicker_settings.json
2. Run the example:

   python json_settings_example.py

Theme Settings

Light Theme (Default)

{
    "theme": "Light",
    "text_color": "#333333",
    "background_color": "#FFFFFF",
    "highlight_color": "#E3F2FD"
}

Dark Theme

{
    "theme": "Dark",
    "text_color": "#FFFFFF",
    "background_color": "#121212",
    "highlight_color": "#1F1F1F"
}

Custom Theme

Set "theme": "Custom" and specify your own colors using hex values:

{
    "theme": "Custom",
    "text_color": "#YOUR_COLOR",
    "background_color": "#YOUR_COLOR",
    "highlight_color": "#YOUR_COLOR"
}

Value Ranges

• width: 100-400 pixels
• height: 80-300 pixels
• item_height: 20-80 pixels
• visible_items: 3-7 items
• scroll_speed: 1.0-50.0
• smoothness: 0.1-1.0
• animation_duration: 100-2000 milliseconds

Error Handling

If the JSON file is missing or contains invalid settings, the example will:

1. Print an error message to the console
2. Use default values for all settings
3. Continue running with the default configuration

Dependencies

• Python 3.6+
• PySide6
• timepicker_control (custom module)

Install required packages:

pip install PySide6
pip install timepicker-control

Notes

• Settings are read-only during runtime
• Changes to the JSON file require restarting the application
• The window has a minimum size of 600x400 pixels
• All color values must be in hex format (e.g., "#FFFFFF")