diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-pydmxcontrol.spec | 426 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 428 insertions, 0 deletions
@@ -0,0 +1 @@ +/PyDMXControl-2.0.0.tar.gz diff --git a/python-pydmxcontrol.spec b/python-pydmxcontrol.spec new file mode 100644 index 0000000..d337ab9 --- /dev/null +++ b/python-pydmxcontrol.spec @@ -0,0 +1,426 @@ +%global _empty_manifest_terminate_build 0 +Name: python-PyDMXControl +Version: 2.0.0 +Release: 1 +Summary: A Python 3 module to control DMX using OpenDMX or uDMX. Featuring fixture profiles, built-in effects and a web control panel. +License: GPLv3 +URL: https://github.com/MattIPv4/PyDMXControl/ +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/73/3a/1ac98a5695a3e4f25008dc8928ab51da55b0e27a83605f91ac657b214c52/PyDMXControl-2.0.0.tar.gz +BuildArch: noarch + +Requires: python3-pyusb +Requires: python3-udmx-pyusb +Requires: python3-pyftdi +Requires: python3-pyserial +Requires: python3-flask +Requires: python3-pygame + +%description +<!-- Content --> +## Installation +Install via pip **(recommended)** + pip install -U PyDMXControl +Install via pip **with audio support** + pip install -U PyDMXControl[audio] +Install via GitHub **(development version, with audio)** + pip install -U git+https://github.com/MattIPv4/PyDMXControl#egg=PyDMXControl[audio] +## Features + * FIXTURE profiles per manufacturer ([see all included profiles](https://github.com/MattIPv4/PyDMXControl/tree/master/PyDMXControl/profiles)) + * Generic dimmer fixture included, single channel + * RGB (3-channel) fixture with virtual dimmer built-in + * EFFECT module/library support ([see all packaged effects](https://github.com/MattIPv4/PyDMXControl/tree/master/PyDMXControl/effects)) + * Intensity dim chase provided, configurable speed and offset provided + * Included is a fixture color chase effect, unlimited number of colors supported + * Effects can be applied to individual fixtures or multiple as a group + * OpenDMX and uDMX works out of the box + * Package developed on and tested extensively with a uDMX system + * OpenDMX (FTDI) controller also provided, as well as direct serial + * Extensible for custom [transmitting controllers](https://github.com/MattIPv4/PyDMXControl/blob/master/PyDMXControl/controllers/_TransmittingController.py) + * CUSTOM callbacks supported with an internal ticker + * Have actions take place on their own at certain times using the callback ticker + * THREADED to allow continuous runtime + * Run your own blocking scripts whilst PyDMXControl continues to output data + * WEBSITE control panel built in + * Global and individual fixture intensity control via sliders + * Quick access to callback functions globally and for each fixture + * Color picker for individual fixtures as well as specific channel control + * JSON fixture configurations + * Load fixture configurations from JSON files into the controller + * Save your current set of fixtures out to JSON files for later use + * Optional AUDIO playback supported + * Play audio tracks whilst PyDMXControl continues to run lighting control + * Uses pygame for best cross-platform and audio format support +## Example Usage +An example of how to get a single dimmer working with PyDMXControl, +providing the web control panel and the console debug system once started. +```python +# Import the OpenDMX or uDMX controller from PyDMXControl, +# this will be how the data is outputted. +from PyDMXControl.controllers import OpenDMXController +# from PyDMXControl.controllers import uDMXController +# Import the fixture profile we will use, +# the simple Dimmer in this example. +from PyDMXControl.profiles.Generic import Dimmer +# Create an instance of the uDMX controller, +# this holds all the fixture information and outputs it. +# This will start outputting data immediately. +dmx = OpenDMXController() +# dmx = uDMXController() +# Add a new Dimmer fixture to our controller +# and save it to a variable so we can access it. +# We give it a name so it's easier to identify in the debug control options. +fixture = dmx.add_fixture(Dimmer, name="My_First_Dimmer") +# Next, dim the intensity of the fixture from it's initial value of zero +# to full, which is represented as 255 in DMX. +# This is done over 5000 milliseconds, or 5 seconds. +fixture.dim(255, 5000) +# We can now start the web control panel built into PyDMXControl. +# This will output the web address in console, but should be http://0.0.0.0:8080 +# This runs in the background and so we can continue to do other things still. +dmx.web_control() +# The console debug mode can also be started if required, +# this provides basic control options in the console of the program. +# This is blocking however and so the script will not continue past here until +# the debug control is exited. This won't stop DMX output. +dmx.debug_control() +# Once the console debug mode is exited the script will continue, to stop it +# exiting and stopping DMX output when can use a built-in sleep function. +# This sleep function will wait until enter is pressed in the console before continuing. +dmx.sleep_till_enter() +# With everything done, you can terminate the DMX output and the program by calling +# the close method of the controller. +# This will cleanly close any threads in use and stop DMX output. +dmx.close() +``` +> For a "real life" example, please take a look at [my home automation office lighting script](https://github.com/MattIPv4/home-automation/blob/master/lighting/office.py). +## What is the point of this? +Just messing around with using Python to control/send DMX.\ +Supports fixture profiling; Has defaults for a standard fixture and fixtures that need virtual dimmers.\ +Prebuilt profiles for generic fixtures (Single dimmer, RGB LED, Custom (set your own number of channels)). +Has a debug shell that allows control of fixture channel values and access to general callbacks. Additionally, provides +an advanced web control panel with access to global callbacks, fixture helpers, fixture colors and control over +individual fixture channels. +Currently, output is supported via OpenDMX, uDMX or raw serial.\ +If someone wants to buy me an Enttec USB DMX Pro then I'll try make it work with that too. +Thank you to Dave Hocker, author of [pyudmx](https://github.com/dhocker/udmx-pyusb/), for his work on pyudmx and his + advice via email in solving some of the issues making this library behave with uDMX. +<!-- Contributing --> +## Contributing +Contributions are always welcome to this project!\ +Take a look at any existing issues on this repository for starting places to help contribute towards, or simply create your own new contribution to the project. +Please make sure to follow the existing standards within the project such as code styles, naming conventions and commenting/documentation. +When you are ready, simply create a pull request for your contribution and I will review it whenever I can! +### Donating +You can also help me and the project out by sponsoring me through [GitHub Sponsors](https://github.com/users/MattIPv4/sponsorship) (preferred), contributing through a [donation on PayPal](http://paypal.mattcowley.co.uk/) or by supporting me monthly on my [Patreon page](http://patreon.mattcowley.co.uk/). +<p> + <a href="https://github.com/users/MattIPv4/sponsorship" target="_blank"> + <img src="https://img.shields.io/badge/GitHub%20Sponsors-MattIPv4-blue.svg?logo=github&logoColor=FFF&style=flat-square" alt="GitHub Sponsors"/> + </a> + <a href="http://patreon.mattcowley.co.uk/" target="_blank"> + <img src="https://img.shields.io/badge/Patreon-IPv4-blue.svg?logo=patreon&logoColor=F96854&style=flat-square" alt="Patreon"/> + </a> + <a href="http://paypal.mattcowley.co.uk/" target="_blank"> + <img src="https://img.shields.io/badge/PayPal-Matt%20(IPv4)%20Cowley-blue.svg?logo=paypal&logoColor=00457C&style=flat-square" alt="PayPal"/> + </a> +</p> +<!-- Discussion & Support --> +## Discussion, Support and Issues +Need support with this project, have found an issue or want to chat with others about contributing to the project? +> Please check the project's issues page first for support & bugs! +Not found what you need here? +* If you have an issue, please create a GitHub issue here to report the situation, include as much detail as you can! +* _or,_ You can join our Slack workspace to discuss any issue, to get support for the project or to chat with contributors and myself: +<a href="http://slack.mattcowley.co.uk/" target="_blank"> + <img src="https://img.shields.io/badge/Slack-MattIPv4-blue.svg?logo=slack&logoColor=blue&style=flat-square" alt="Slack" height="30"> +</a> + +%package -n python3-PyDMXControl +Summary: A Python 3 module to control DMX using OpenDMX or uDMX. Featuring fixture profiles, built-in effects and a web control panel. +Provides: python-PyDMXControl +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-PyDMXControl +<!-- Content --> +## Installation +Install via pip **(recommended)** + pip install -U PyDMXControl +Install via pip **with audio support** + pip install -U PyDMXControl[audio] +Install via GitHub **(development version, with audio)** + pip install -U git+https://github.com/MattIPv4/PyDMXControl#egg=PyDMXControl[audio] +## Features + * FIXTURE profiles per manufacturer ([see all included profiles](https://github.com/MattIPv4/PyDMXControl/tree/master/PyDMXControl/profiles)) + * Generic dimmer fixture included, single channel + * RGB (3-channel) fixture with virtual dimmer built-in + * EFFECT module/library support ([see all packaged effects](https://github.com/MattIPv4/PyDMXControl/tree/master/PyDMXControl/effects)) + * Intensity dim chase provided, configurable speed and offset provided + * Included is a fixture color chase effect, unlimited number of colors supported + * Effects can be applied to individual fixtures or multiple as a group + * OpenDMX and uDMX works out of the box + * Package developed on and tested extensively with a uDMX system + * OpenDMX (FTDI) controller also provided, as well as direct serial + * Extensible for custom [transmitting controllers](https://github.com/MattIPv4/PyDMXControl/blob/master/PyDMXControl/controllers/_TransmittingController.py) + * CUSTOM callbacks supported with an internal ticker + * Have actions take place on their own at certain times using the callback ticker + * THREADED to allow continuous runtime + * Run your own blocking scripts whilst PyDMXControl continues to output data + * WEBSITE control panel built in + * Global and individual fixture intensity control via sliders + * Quick access to callback functions globally and for each fixture + * Color picker for individual fixtures as well as specific channel control + * JSON fixture configurations + * Load fixture configurations from JSON files into the controller + * Save your current set of fixtures out to JSON files for later use + * Optional AUDIO playback supported + * Play audio tracks whilst PyDMXControl continues to run lighting control + * Uses pygame for best cross-platform and audio format support +## Example Usage +An example of how to get a single dimmer working with PyDMXControl, +providing the web control panel and the console debug system once started. +```python +# Import the OpenDMX or uDMX controller from PyDMXControl, +# this will be how the data is outputted. +from PyDMXControl.controllers import OpenDMXController +# from PyDMXControl.controllers import uDMXController +# Import the fixture profile we will use, +# the simple Dimmer in this example. +from PyDMXControl.profiles.Generic import Dimmer +# Create an instance of the uDMX controller, +# this holds all the fixture information and outputs it. +# This will start outputting data immediately. +dmx = OpenDMXController() +# dmx = uDMXController() +# Add a new Dimmer fixture to our controller +# and save it to a variable so we can access it. +# We give it a name so it's easier to identify in the debug control options. +fixture = dmx.add_fixture(Dimmer, name="My_First_Dimmer") +# Next, dim the intensity of the fixture from it's initial value of zero +# to full, which is represented as 255 in DMX. +# This is done over 5000 milliseconds, or 5 seconds. +fixture.dim(255, 5000) +# We can now start the web control panel built into PyDMXControl. +# This will output the web address in console, but should be http://0.0.0.0:8080 +# This runs in the background and so we can continue to do other things still. +dmx.web_control() +# The console debug mode can also be started if required, +# this provides basic control options in the console of the program. +# This is blocking however and so the script will not continue past here until +# the debug control is exited. This won't stop DMX output. +dmx.debug_control() +# Once the console debug mode is exited the script will continue, to stop it +# exiting and stopping DMX output when can use a built-in sleep function. +# This sleep function will wait until enter is pressed in the console before continuing. +dmx.sleep_till_enter() +# With everything done, you can terminate the DMX output and the program by calling +# the close method of the controller. +# This will cleanly close any threads in use and stop DMX output. +dmx.close() +``` +> For a "real life" example, please take a look at [my home automation office lighting script](https://github.com/MattIPv4/home-automation/blob/master/lighting/office.py). +## What is the point of this? +Just messing around with using Python to control/send DMX.\ +Supports fixture profiling; Has defaults for a standard fixture and fixtures that need virtual dimmers.\ +Prebuilt profiles for generic fixtures (Single dimmer, RGB LED, Custom (set your own number of channels)). +Has a debug shell that allows control of fixture channel values and access to general callbacks. Additionally, provides +an advanced web control panel with access to global callbacks, fixture helpers, fixture colors and control over +individual fixture channels. +Currently, output is supported via OpenDMX, uDMX or raw serial.\ +If someone wants to buy me an Enttec USB DMX Pro then I'll try make it work with that too. +Thank you to Dave Hocker, author of [pyudmx](https://github.com/dhocker/udmx-pyusb/), for his work on pyudmx and his + advice via email in solving some of the issues making this library behave with uDMX. +<!-- Contributing --> +## Contributing +Contributions are always welcome to this project!\ +Take a look at any existing issues on this repository for starting places to help contribute towards, or simply create your own new contribution to the project. +Please make sure to follow the existing standards within the project such as code styles, naming conventions and commenting/documentation. +When you are ready, simply create a pull request for your contribution and I will review it whenever I can! +### Donating +You can also help me and the project out by sponsoring me through [GitHub Sponsors](https://github.com/users/MattIPv4/sponsorship) (preferred), contributing through a [donation on PayPal](http://paypal.mattcowley.co.uk/) or by supporting me monthly on my [Patreon page](http://patreon.mattcowley.co.uk/). +<p> + <a href="https://github.com/users/MattIPv4/sponsorship" target="_blank"> + <img src="https://img.shields.io/badge/GitHub%20Sponsors-MattIPv4-blue.svg?logo=github&logoColor=FFF&style=flat-square" alt="GitHub Sponsors"/> + </a> + <a href="http://patreon.mattcowley.co.uk/" target="_blank"> + <img src="https://img.shields.io/badge/Patreon-IPv4-blue.svg?logo=patreon&logoColor=F96854&style=flat-square" alt="Patreon"/> + </a> + <a href="http://paypal.mattcowley.co.uk/" target="_blank"> + <img src="https://img.shields.io/badge/PayPal-Matt%20(IPv4)%20Cowley-blue.svg?logo=paypal&logoColor=00457C&style=flat-square" alt="PayPal"/> + </a> +</p> +<!-- Discussion & Support --> +## Discussion, Support and Issues +Need support with this project, have found an issue or want to chat with others about contributing to the project? +> Please check the project's issues page first for support & bugs! +Not found what you need here? +* If you have an issue, please create a GitHub issue here to report the situation, include as much detail as you can! +* _or,_ You can join our Slack workspace to discuss any issue, to get support for the project or to chat with contributors and myself: +<a href="http://slack.mattcowley.co.uk/" target="_blank"> + <img src="https://img.shields.io/badge/Slack-MattIPv4-blue.svg?logo=slack&logoColor=blue&style=flat-square" alt="Slack" height="30"> +</a> + +%package help +Summary: Development documents and examples for PyDMXControl +Provides: python3-PyDMXControl-doc +%description help +<!-- Content --> +## Installation +Install via pip **(recommended)** + pip install -U PyDMXControl +Install via pip **with audio support** + pip install -U PyDMXControl[audio] +Install via GitHub **(development version, with audio)** + pip install -U git+https://github.com/MattIPv4/PyDMXControl#egg=PyDMXControl[audio] +## Features + * FIXTURE profiles per manufacturer ([see all included profiles](https://github.com/MattIPv4/PyDMXControl/tree/master/PyDMXControl/profiles)) + * Generic dimmer fixture included, single channel + * RGB (3-channel) fixture with virtual dimmer built-in + * EFFECT module/library support ([see all packaged effects](https://github.com/MattIPv4/PyDMXControl/tree/master/PyDMXControl/effects)) + * Intensity dim chase provided, configurable speed and offset provided + * Included is a fixture color chase effect, unlimited number of colors supported + * Effects can be applied to individual fixtures or multiple as a group + * OpenDMX and uDMX works out of the box + * Package developed on and tested extensively with a uDMX system + * OpenDMX (FTDI) controller also provided, as well as direct serial + * Extensible for custom [transmitting controllers](https://github.com/MattIPv4/PyDMXControl/blob/master/PyDMXControl/controllers/_TransmittingController.py) + * CUSTOM callbacks supported with an internal ticker + * Have actions take place on their own at certain times using the callback ticker + * THREADED to allow continuous runtime + * Run your own blocking scripts whilst PyDMXControl continues to output data + * WEBSITE control panel built in + * Global and individual fixture intensity control via sliders + * Quick access to callback functions globally and for each fixture + * Color picker for individual fixtures as well as specific channel control + * JSON fixture configurations + * Load fixture configurations from JSON files into the controller + * Save your current set of fixtures out to JSON files for later use + * Optional AUDIO playback supported + * Play audio tracks whilst PyDMXControl continues to run lighting control + * Uses pygame for best cross-platform and audio format support +## Example Usage +An example of how to get a single dimmer working with PyDMXControl, +providing the web control panel and the console debug system once started. +```python +# Import the OpenDMX or uDMX controller from PyDMXControl, +# this will be how the data is outputted. +from PyDMXControl.controllers import OpenDMXController +# from PyDMXControl.controllers import uDMXController +# Import the fixture profile we will use, +# the simple Dimmer in this example. +from PyDMXControl.profiles.Generic import Dimmer +# Create an instance of the uDMX controller, +# this holds all the fixture information and outputs it. +# This will start outputting data immediately. +dmx = OpenDMXController() +# dmx = uDMXController() +# Add a new Dimmer fixture to our controller +# and save it to a variable so we can access it. +# We give it a name so it's easier to identify in the debug control options. +fixture = dmx.add_fixture(Dimmer, name="My_First_Dimmer") +# Next, dim the intensity of the fixture from it's initial value of zero +# to full, which is represented as 255 in DMX. +# This is done over 5000 milliseconds, or 5 seconds. +fixture.dim(255, 5000) +# We can now start the web control panel built into PyDMXControl. +# This will output the web address in console, but should be http://0.0.0.0:8080 +# This runs in the background and so we can continue to do other things still. +dmx.web_control() +# The console debug mode can also be started if required, +# this provides basic control options in the console of the program. +# This is blocking however and so the script will not continue past here until +# the debug control is exited. This won't stop DMX output. +dmx.debug_control() +# Once the console debug mode is exited the script will continue, to stop it +# exiting and stopping DMX output when can use a built-in sleep function. +# This sleep function will wait until enter is pressed in the console before continuing. +dmx.sleep_till_enter() +# With everything done, you can terminate the DMX output and the program by calling +# the close method of the controller. +# This will cleanly close any threads in use and stop DMX output. +dmx.close() +``` +> For a "real life" example, please take a look at [my home automation office lighting script](https://github.com/MattIPv4/home-automation/blob/master/lighting/office.py). +## What is the point of this? +Just messing around with using Python to control/send DMX.\ +Supports fixture profiling; Has defaults for a standard fixture and fixtures that need virtual dimmers.\ +Prebuilt profiles for generic fixtures (Single dimmer, RGB LED, Custom (set your own number of channels)). +Has a debug shell that allows control of fixture channel values and access to general callbacks. Additionally, provides +an advanced web control panel with access to global callbacks, fixture helpers, fixture colors and control over +individual fixture channels. +Currently, output is supported via OpenDMX, uDMX or raw serial.\ +If someone wants to buy me an Enttec USB DMX Pro then I'll try make it work with that too. +Thank you to Dave Hocker, author of [pyudmx](https://github.com/dhocker/udmx-pyusb/), for his work on pyudmx and his + advice via email in solving some of the issues making this library behave with uDMX. +<!-- Contributing --> +## Contributing +Contributions are always welcome to this project!\ +Take a look at any existing issues on this repository for starting places to help contribute towards, or simply create your own new contribution to the project. +Please make sure to follow the existing standards within the project such as code styles, naming conventions and commenting/documentation. +When you are ready, simply create a pull request for your contribution and I will review it whenever I can! +### Donating +You can also help me and the project out by sponsoring me through [GitHub Sponsors](https://github.com/users/MattIPv4/sponsorship) (preferred), contributing through a [donation on PayPal](http://paypal.mattcowley.co.uk/) or by supporting me monthly on my [Patreon page](http://patreon.mattcowley.co.uk/). +<p> + <a href="https://github.com/users/MattIPv4/sponsorship" target="_blank"> + <img src="https://img.shields.io/badge/GitHub%20Sponsors-MattIPv4-blue.svg?logo=github&logoColor=FFF&style=flat-square" alt="GitHub Sponsors"/> + </a> + <a href="http://patreon.mattcowley.co.uk/" target="_blank"> + <img src="https://img.shields.io/badge/Patreon-IPv4-blue.svg?logo=patreon&logoColor=F96854&style=flat-square" alt="Patreon"/> + </a> + <a href="http://paypal.mattcowley.co.uk/" target="_blank"> + <img src="https://img.shields.io/badge/PayPal-Matt%20(IPv4)%20Cowley-blue.svg?logo=paypal&logoColor=00457C&style=flat-square" alt="PayPal"/> + </a> +</p> +<!-- Discussion & Support --> +## Discussion, Support and Issues +Need support with this project, have found an issue or want to chat with others about contributing to the project? +> Please check the project's issues page first for support & bugs! +Not found what you need here? +* If you have an issue, please create a GitHub issue here to report the situation, include as much detail as you can! +* _or,_ You can join our Slack workspace to discuss any issue, to get support for the project or to chat with contributors and myself: +<a href="http://slack.mattcowley.co.uk/" target="_blank"> + <img src="https://img.shields.io/badge/Slack-MattIPv4-blue.svg?logo=slack&logoColor=blue&style=flat-square" alt="Slack" height="30"> +</a> + +%prep +%autosetup -n PyDMXControl-2.0.0 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-PyDMXControl -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Thu May 18 2023 Python_Bot <Python_Bot@openeuler.org> - 2.0.0-1 +- Package Spec generated @@ -0,0 +1 @@ +f88cc1ad01b091e488d901a61ac59e01 PyDMXControl-2.0.0.tar.gz |