https://github.com/fabianwe/gomosaic
gomosaic is a mosaic image generator written entirely in Golang
https://github.com/fabianwe/gomosaic
golang image-analysis image-generation image-processing mosaic mosaic-images
Last synced: 7 months ago
JSON representation
gomosaic is a mosaic image generator written entirely in Golang
- Host: GitHub
- URL: https://github.com/fabianwe/gomosaic
- Owner: FabianWe
- License: apache-2.0
- Created: 2018-10-02T14:42:00.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-12-22T19:43:06.000Z (almost 6 years ago)
- Last Synced: 2024-06-21T01:57:34.144Z (over 1 year ago)
- Topics: golang, image-analysis, image-generation, image-processing, mosaic, mosaic-images
- Language: Go
- Size: 185 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gomosaic
gomosaic is an mosaic image generator written entirely in Go. In short: It manages an image database and given a query image returns the image composed or "approximated" of images from the database. The methods implemented are mostly based on "On the use of CBIR in image mosaic generation" by Yue Zhang, 2002, University of Alberta.
For more information see the [Wiki](https://github.com/FabianWe/gomosaic/wiki).
## Background
The project originate from a Golang introduction course where I was looking for a project for the participants. Over time I became more and more interested and started working on this project.
## Examples
Orignal image (Kybfelsen by Freiburg, photo by me) transformed into a mosaic with 70x50 tiles:
For more examples check the [Wiki's example page](https://github.com/FabianWe/gomosaic/wiki/Examples).
## Installation
If you are a developer and want to play around / use this library just run `go get -u github.com/FabianWe/gomosaic`.
If you just want to use the software please check the [release](https://github.com/FabianWe/gomosaic/releases) page for downloads. Currently binaries are uploaded for linux and windows with am64, if you need something else please contact me or compile for yourself. You should rename the file to plan gomosaic or gomosaic.exe (instead of for example mosaic mosaicamd64.exe).
For usage instructions see [here](https://github.com/FabianWe/gomosaic/wiki/Usage). Currently it can only run in command line mode, I'm planning to write a GUI though.
## Bugs
There are probably bugs in this software, though it worked fine for "useful"
inputs. Please open an issue on github or send an email to fabianwen#posteo.eu
(replace # with @).
## Nice ways to extend the software
Implement color coherence vectors as mentioned in Yue Zhang, 2002. Also the same image gets selected again and again for a query image, especially with big areas of nearly the same color. Implement a mechanism that prevents this.
## License
Copyright 2018 Fabian Wenzelmann
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
### Tird Party Licenses
See [here](https://github.com/FabianWe/gomosaic/wiki/License).