bitmap-plus-plus 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 26cc798a428abcd5dfb6804b130b93edd71bb29af43a8216c0ef0dca5ee8c507
+  data.tar.gz: b8d86daa2e8a0365f797bfd19072474dc8fdb5990b4d53848ba926f23d70d32d
+SHA512:
+  metadata.gz: 8e16e38f6d6062c00a89f5a02ec861adedd8042a895c57180442a335d68cfea5633251a1dff8879758da1a4fb3f0ee007802b4af309ca607503a4f35a3bafa86
+  data.tar.gz: db0ae17cd9a1898cae31ccdef8442e0fbfbb462809f4e6909060ddbb6cc3aeb14a84c655bab701a5ae9841dd77b50c4fedeb911f25a5f512e7af5dc374146090

data/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+## [1.0.0] - 2025-12-29
+
+### Added
+- Initial release of BitmapPlusPlus Ruby bindings
+- Complete Ruby bindings for the BitmapPlusPlus C++ library using Rice
+- Support for creating and manipulating 24-bit BMP images
+- Drawing primitives:
+  - `draw_line` - Draw lines using Bresenham's algorithm
+  - `draw_rect` / `fill_rect` - Draw rectangle outlines and filled rectangles
+  - `draw_triangle` / `fill_triangle` - Draw triangle outlines and filled triangles
+  - `draw_circle` / `fill_circle` - Draw circle outlines and filled circles using midpoint algorithm
+- Pixel manipulation:
+  - `get(x, y)` / `set(x, y, color)` - Get/set pixels by coordinates
+  - `[]` / `[]=` - Array-style access by linear index
+  - `Bmp::Pixel` class with RGB component access
+- Image transformations (immutable, return new bitmaps):
+  - `flip_v` - Vertical flip
+  - `flip_h` - Horizontal flip
+  - `rotate_90_left` - 90-degree counter-clockwise rotation
+  - `rotate_90_right` - 90-degree clockwise rotation
+- File I/O:
+  - `save(filename)` - Save to BMP file
+  - `load(filename)` - Load from BMP file
+  - Constructor accepts filename to load on creation
+- Iterator support:
+  - `each` - Iterate over all pixels
+  - `each_reverse` - Reverse iteration
+- 32 predefined color constants (Aqua, Beige, Black, Blue, etc.)
+- `Bmp::BitmapHeader` struct for accessing BMP file header information
+- `Bmp::Exception` for error handling
+- RBS type signatures for static type checking
+- Minitest test suite
+- Example scripts (fractals, random colors, drawing primitives)
+
+### Dependencies
+- Ruby >= 3.0.0
+- Rice >= 4.8 (C++ binding library)
+- C++17 compatible compiler

data/LICENSE

@@ -0,0 +1,25 @@
+Copyright (C) 2025 Charlie Savage
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGE.

data/README.md

@@ -0,0 +1,75 @@
+# BitmapPlusPlus
+
+Ruby bindings for [BitmapPlusPlus](https://github.com/baderouaich/BitmapPlusPlus), a simple, fast, and lightweight C++ library for creating and manipulating 24-bit BMP images.
+
+## About This Project
+
+This gem serves as both a useful library and a **practical example of using [Rice](https://github.com/ruby-rice/rice) to create Ruby bindings for C++ libraries**.
+
+The binding code in `ext/BitmapPlusPlus-rb.cpp` is well-commented and can serve as a reference for your own Rice projects.
+
+## Features
+
+- Create and manipulate 24-bit BMP images
+- Drawing primitives: lines, rectangles, triangles, circles
+- Fill operations for shapes
+- Pixel-level access and manipulation
+- Image transformations: flip (horizontal/vertical), rotate (90 degrees)
+- Load and save BMP files
+- 32 predefined colors
+- Iterator support for pixel enumeration
+
+## Quick Start
+
+```ruby
+require 'bitmap-plus-plus'
+
+# Create a new 640x480 bitmap
+image = Bmp::Bitmap.new(640, 480)
+
+# Clear with a background color
+image.clear(Bmp::White)
+
+# Draw a red rectangle
+image.draw_rect(10, 10, 100, 50, Bmp::Red)
+
+# Draw a filled blue circle
+image.fill_circle(200, 200, 50, Bmp::Blue)
+
+# Save to file
+image.save("output.bmp")
+```
+
+## Installation
+
+```bash
+gem install bitmap-plus-plus --preset <linux-release|macos-release|windows-release>
+```
+
+For detailed installation options including building from source and CMake builds, see the [Installation Guide](https://ruby-rice.github.io/BitmapPlusPlus-ruby/installation/).
+
+## Documentation
+
+Full documentation is available at **[https://ruby-rice.github.io/BitmapPlusPlus-ruby/](https://ruby-rice.github.io/BitmapPlusPlus-ruby/)**
+
+- [Usage Guide](https://ruby-rice.github.io/BitmapPlusPlus-ruby/usage/) - Complete usage documentation
+- [Examples](https://ruby-rice.github.io/BitmapPlusPlus-ruby/examples/) - Runnable example scripts
+- [API Reference](https://ruby-rice.github.io/BitmapPlusPlus-ruby/api/Bmp/Bitmap/) - Detailed API documentation
+- [Rice Guide](https://ruby-rice.github.io/BitmapPlusPlus-ruby/rice-guide/) - Rice features demonstrated in this project
+
+## License
+
+This gem is available under the [BSD-2-Clause License](LICENSE).
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## Acknowledgments
+
+- [BitmapPlusPlus](https://github.com/baderouaich/BitmapPlusPlus) - The original C++ library by Bader Ouaich
+- [Rice](https://github.com/ruby-rice/rice) - C++ to Ruby binding library