https://github.com/cyotek/cyotek.windows.forms.imagebox

The ImageBox is a custom control for displaying images. It supports zooming, scrolling, panning, region selection and much more!
https://github.com/cyotek/cyotek.windows.forms.imagebox

c-sharp cyotek hacktoberfest imagebox winforms-controls

Last synced: about 2 months ago
JSON representation

The ImageBox is a custom control for displaying images. It supports zooming, scrolling, panning, region selection and much more!

• Host: GitHub
• URL: https://github.com/cyotek/cyotek.windows.forms.imagebox
• Owner: cyotek
• License: mit
• Created: 2012-08-24T16:20:05.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2022-12-29T14:18:41.000Z (over 2 years ago)
• Last Synced: 2025-03-28T09:07:47.214Z (about 2 months ago)
• Topics: c-sharp, cyotek, hacktoberfest, imagebox, winforms-controls
• Language: C#
• Homepage: http://cyotek.com/blog/tag/imagebox
• Size: 19.5 MB
• Stars: 198
• Watchers: 32
• Forks: 75
• Open Issues: 25
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Cyotek ImageBox Control

## About

The `ImageBox` is a lightweight owner drawn control for displaying images. It

supports zooming, scrolling, panning, region selection and much more! In

addition to the traditional mode of binding to an `Image`, you can also use a

*virtual mode*, and provide your own custom drawing whilst retaining all the

`ImageBox` functionality. 

The `ImageBox` control also provides convenient helper methods for translating

points, rectangles and sizes according to the current zoom level and scroll

position of the control - this makes it easy to scale custom drawing to fit the

control.

As well as the different behaviours offered, the `ImageBox` also supports a

large number of display properties. The background of the control can display a

solid colour, or a coloured grid in various sizes. You can also configure how

the grid is to be drawn, for example just around the image bounds, or the full

control bounds. Other options include the pixel grid, which is displayed when

zooming in on an image to highlight each pixel, custom border styles for

surrounding the image, and many other properties. You can also display text, and

specifying formatting and alignment options.

## Example Screenshots

![ImageBox control demonstration](https://static.cyotek.com/files/articleimages/imgbox-5a.png)

![Virtual mode demonstration, where the ImageBox can be used without a backing image](https://static.cyotek.com/files/articleimages/imgbox-6a.png)

![The ImageBox can display a pixel grid when zooming in](https://static.cyotek.com/files/articleimages/imgbox-6b.png)

## License

The `ImageBox` control is licensed under the MIT License. See `license.txt` for

the full text.

## Further Reading

For more information on this control, see the

[articles tagged withimagebox](https://www.cyotek.com/blog/tag/imagebox) at

cyotek.com.