Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Vectorscopes and Waveforms

If you are looking for quick solution to plot various vector scopes and waveforms feel free to download this repository. I have created an easy to use and very basic user interface to display additional information about your image. If you are used to working with vectorscopes for example from Premiere Pro and you are missing them say in Lightroom Desktop for example, this may be a "good enough" workaround for you. Simply screenshot the image and you can see the respective scopes (YUV, YUV but with RGB color) or waveforms (Luminance, RGB, RGB Parade). You can either manually refresh after you made some changes or work in continous mode where everything refreshes automatically.

Disclaimer: At this stage this has only been a "weekend project" for me and it basically fullfills all my needs. I may add new features sometime, but for now I just want to use it as is. Feel free to contribute and improve the project. It should be available for the photography community and everybody who finds these features useful in their editing workflow.

There is also an executable file for windows in the repository. It is the easiest way to use the tool and recommended for everyone who does not want to edit the files/ contribute new features, etc.

Everything is free. However if you think the interface helps you and your workflow and you want to support this project, I will gladly accept any donations (Even if you only have a symbolic dollar to spare, it is still greatly appreciated.)

Cheers Julian


Features

Plot Types

  • Vectorscope YUV: Displays YUV color data in a vectorscope format.
  • Vectorscope Color: Visualizes data in YUV space but pixels are displayed in RGB colors (Takes longer to generate, and is therefore not available in the continous mode)
  • Waveform Luma: Displays the luminance waveform.
  • Waveform RGB: Shows the waveform of RGB channels.
  • RGB Parade: Visualizes the RGB channels side-by-side.

GUI Components

  • Plot Panel: Displays the plots dynamically based on user selection.
  • Control Panel: Allows users to:
    • Select plot types.
    • Choose the arrangement of plots (e.g., vertical, horizontal, or 2x2).
    • Toggle continuous mode for live updates.
    • Take screenshots and define Regions of Interest (ROI).
    • Select the active monitor for data visualization.

Continuous Mode

  • Automatically refreshes plots at a fixed interval for real-time updates.

Requirements

  • Python 3.8+
  • PyQt5
  • matplotlib
  • numpy
  • OpenCV
  • mss

Install dependencies using pip:

pip install PyQt5 matplotlib numpy opencv-python mss
pip install -r requirements.txt

Usage Instructions

  1. Screenshot & ROI:
    • Click Take Screenshot.
    • Define the Region of Interest (ROI) by selecting an area on the screen.
  2. Choose Arrangement: Select the layout (Vertical, Horizontal, 2x2) from the dropdown.
  3. Monitor Selection: Use the spinner to select the active monitor.
  4. Select Plots: Check the boxes in the Control Panel to choose which plots to display.
  5. Continuous Mode: Toggle continuous mode for live updates.
  6. Refresh Plots: Click Refresh to manually update the plots.

File Structure

  • lightroom_gui.py: The main application file containing the GUI logic.
  • lightroom_gui.exe: Executable file for Windows.

Contributing

Feel free to fork the repository and submit pull requests with enhancements or bug fixes. Please ensure the code is properly documented and tested.


Contact

For questions or support, please reach out to:


Releases

Sponsor this project

Packages

Contributors

Languages