gradio/js/imageeditor/CHANGELOG.md

@gradio/imageeditor

0.1.5

Fixes

• #6799 c352811 - Adds docstrings for gr.WaveformOptions, gr.Brush, and gr.Eraser, fixes examples for ImageEditor, and allows individual images to be used as the initial value for ImageEditor. Thanks @abidlabs!

0.1.4

Patch Changes

• Updated dependencies [5d51fbc, 34f9431]:
  • @gradio/upload@0.5.4
  • @gradio/client@0.9.1
  • @gradio/image@0.5.1

0.1.3

Patch Changes

• Updated dependencies [6a9151d, 21cfb0a, d76bcaa, 67ddd40, 053bec9, bdf81fe, 4d1cbbc, 5177132]:
  • @gradio/image@0.5.0
  • @gradio/upload@0.5.3
  • @gradio/client@0.9.0
  • @gradio/wasm@0.4.0
  • @gradio/icons@0.3.2
  • @gradio/atoms@0.4.0
  • @gradio/statustracker@0.4.2

0.1.2

Patch Changes

• Updated dependencies [b639e04, 206af31]:
  • @gradio/image@0.4.2
  • @gradio/icons@0.3.1
  • @gradio/atoms@0.3.1
  • @gradio/statustracker@0.4.1
  • @gradio/upload@0.5.2

0.1.1

Patch Changes

• Updated dependencies [71f1a1f99]:
  • @gradio/client@0.8.2
  • @gradio/image@0.4.1
  • @gradio/upload@0.5.1

0.1.0

Highlights

New ImageEditor component (#6169 9caddc17b)

A brand new component, completely separate from Image that provides simple editing capabilities.

• Set background images from file uploads, webcam, or just paste!
• Crop images with an improved cropping UI. App authors can event set specific crop size, or crop ratios (1:1, etc)
• Paint on top of any image (or no image) and erase any mistakes!
• The ImageEditor supports layers, confining draw and erase actions to that layer.
• More flexible access to data. The image component returns a composite image representing the final state of the canvas as well as providing the background and all layers as individual images.
• Fully customisable. All features can be enabled and disabled. Even the brush color swatches can be customised.

def fn(im):
    im["composite"] # the full canvas
    im["background"] # the background image
    im["layers"] # a list of individual layers


im = gr.ImageEditor(
    # decide which sources you'd like to accept
    sources=["upload", "webcam", "clipboard"],
    # set a cropsize constraint, can either be a ratio or a concrete [width, height]
    crop_size="1:1",
    # enable crop (or disable it)
    transforms=["crop"],
    # customise the brush
    brush=Brush(
      default_size="25", # or leave it as 'auto'
      color_mode="fixed", # 'fixed' hides the user swatches and colorpicker, 'defaults' shows it
      default_color="hotpink", # html names are supported
      colors=[
        "rgba(0, 150, 150, 1)", # rgb(a)
        "#fff", # hex rgb
        "hsl(360, 120, 120)" # in fact any valid colorstring
      ]
    ),
    brush=Eraser(default_size="25")
)

Thanks @pngwn!

Fixes

• #6502 070f71c93 - Ensure image editor crop and draw cursor works as expected when the scroll position changes. Thanks @pngwn!

@gradio/image