https://github.com/sambecker/ase-palette
Create and manage Adobe ASE palettes
https://github.com/sambecker/ase-palette
Last synced: 8 months ago
JSON representation
Create and manage Adobe ASE palettes
- Host: GitHub
- URL: https://github.com/sambecker/ase-palette
- Owner: sambecker
- License: mit
- Created: 2019-03-11T03:51:33.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-01-16T00:51:43.000Z (over 4 years ago)
- Last Synced: 2024-08-08T18:04:56.794Z (almost 2 years ago)
- Language: Ruby
- Homepage: https://rubygems.org/gems/ase-palette
- Size: 59.6 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# 🎨 ASEPalette
[
](https://rubygems.org/gems/ase-palette)
[
](https://rubygems.org/gems/ase-palette)
Create and manage Adobe ASE color palettes in Ruby.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'ase-palette'
```
## Usage
### 🚀 Load
```ruby
require 'ase-palette'
```
### 📝 Write
```ruby
# Create a palette
palette = ASEPalette.new
# Add a color
palette.add_color ASEPalette::Color::RGB.new "Red", 255, 0, 0
# Add a color to a group
palette.add_color ASEPalette::Color::CMYK.new "Yellow", 100, 0, 0, 0, group_name: "My Group"
```
### 📖 Read
```ruby
# Access top-level colors
palette.colors.each do |color|
puts "Found color #{color.name}"
end
# Access colors from groups
palette.groups.each do |group|
puts "Found group #{group.name}"
group.colors.each do |color|
puts "- #{color.name}"
end
end
# Access all colors, including those from groups, as a flat array
palette.colors(include_from_groups: true).each do |color|
puts "Found color #{color.name}, which may or may not belong to a group"
end
```
### 🖋 Edit
```ruby
# Remove a color, including those from groups
palette.remove_color_with_name "Red"
# Remove a group and all of the colors in it
palette.remove_group_with_name "Group Name"
```
### ⬆️ Export
```ruby
# Store file
IO.binwrite('palette.ase', palette.to_binary)
# Send file (from Rails controller)
respond_to do |format|
format.ase {
send_data palette.to_binary, type: 'application/octet-stream', filename: 'palette.ase'
}
end
```
### ⬇️ Import
```ruby
# Open palette from file
palette = ASEPalette.open 'path/to/palette.ase'
# Access palette colors
puts palette
# ASEPalette 2.0
# --------------
#
# Red, RGB: 255/0/0, :global
#
# Group 1:
# Violet, RGB: 90/0/255, :global
# Blue, RGB: 0/0/255, :global
# Green, RGB: 50/255/50, :global
#
# Group 2
# Orange CMYK, CMYK: 0/80/100/0, :global
# Yellow CMYK, CMYK: 0/20/100/0, :global
#
# Group 3
# PANTONE Yellow C, LAB: 89/-1/111, :spot
# PANTONE Orange 021 C, LAB: 61/66/85, :spot
#
# --------------
# 7 colors, 2 groups
```
## Development
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/sambecker/ase-palette.
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).