Metadata-Version: 2.4
Name: bqplot-image-gl
Version: 1.6.1
Summary: An ipywidget image widget for astronomical purposes
Project-URL: Homepage, https://github.com/glue-viz/bqplot-image-gl
Author-email: "Maarten A. Breddels" <maartenbreddels@gmail.com>
License: MIT
License-File: LICENSE
Keywords: ipython,jupyter,widgets
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: IPython
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.7
Requires-Dist: bqplot>=0.12
Requires-Dist: ipywidgets>=7.0.0
Requires-Dist: pillow
Requires-Dist: typing-extensions
Description-Content-Type: text/markdown

# bqplot-image-gl

An ipywidget image widget for showing images in bqplot using WebGL.
Used for https://github.com/glue-viz/glue-jupyter

(currently requires latest developer version of bqplot)

## Usage

### ImageGL

See https://py.cafe/maartenbreddels/bqplot-image-gl-demo for a demo of the ImageGL widget.

Preview image:
![preview image](https://py.cafe/preview/maartenbreddels/bqplot-image-gl-demo)



# Installation

To install use pip:

    $ pip install bqplot-image-gl

# Installation (developers)

    # make sure you have node
    $ conda install -c conda-forge nodejs

    # clone the repo
    $ git clone https://github.com/glue-viz/bqplot-image-gl.git
    $ cd bqplot-image-gl

    # install in dev mode
    $ pip install -e .
    # symlink the share/jupyter/nbextensions/bqplot-image-gl directory
    $ jupyter nbextension install --py --symlink --sys-prefix --overwrite bqplot_image_gl
    # enable the extension (normally done by copying the .json in your prefix)
    $ jupyter nbextension enable --py --sys-prefix bqplot_image_gl
    # for jupyterlab (>=3.0), symlink share/jupyter/labextensions/bqplot-image-gl
    $ jupyter labextension develop . --overwrite

## workflow for notebook

    $ (cd js; npm run watch:nbextension)
    # make changes and wait for bundle to automatically rebuild
    # reload jupyter notebook

## workflow for lab

    $ (cd js; npm run watch:labextension)
    # make changes and wait for bundle to automatically rebuild
    # reload jupyterlab
