2023-03-13 02:23:47 +00:00
|
|
|
# SSTV Image Tools C++ Library
|
|
|
|
|
|
|
|
|
|
Currently in development but it's functional. Will be used with the MWAV library to create SSTV images.
|
|
|
|
|
|
|
|
|
|
A simple library for manipulating images into common SSTV image formats using Magick++.
|
|
|
|
|
|
2023-03-13 22:54:19 +00:00
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
### Convert an image to the size specified by the SSTV mode and add a call sign
|
2023-03-13 22:43:56 +00:00
|
|
|
```cpp
|
2023-03-13 22:49:26 +00:00
|
|
|
SstvImage image(SstvImage::Mode::ROBOT_36_COLOR, "test1.png");
|
2023-03-13 22:43:56 +00:00
|
|
|
image.AddCallSign("N0CALL");
|
|
|
|
|
image.Write("converted_test1.png");
|
|
|
|
|
```
|
2023-03-13 22:49:26 +00:00
|
|
|
test1.png | converted_test1.png
|
|
|
|
|
:-------------------------:|:-------------------------:
|
|
|
|
|
<img src="https://user-images.githubusercontent.com/19292194/224849070-d1468c89-010d-46bd-af68-72c0e7516e87.png" width="450"> | <img src="https://user-images.githubusercontent.com/19292194/224849046-d80b2945-028a-4301-9520-3f03c7a88681.png" width="300">
|
2023-03-13 22:43:56 +00:00
|
|
|
|
2023-03-13 22:54:19 +00:00
|
|
|
### Get RGB values of specific pixels
|
2023-03-13 22:43:56 +00:00
|
|
|
```cpp
|
|
|
|
|
SstvImage image(SstvImage::Mode::ROBOT_36_COLOR, "example/test1.png");
|
|
|
|
|
/*
|
|
|
|
|
From this point forward image is the size of the specified mode.
|
|
|
|
|
For example, Robot36 is 320x256.
|
|
|
|
|
*/
|
|
|
|
|
image.AddCallSign("N0CALL");
|
|
|
|
|
|
|
|
|
|
SstvImage::Pixel pixel;
|
|
|
|
|
pixel = image.GetPixel(128, 91, pixel); // Get Pixel returns false if the pixel is out of bounds
|
|
|
|
|
|
|
|
|
|
std::cout << (int)pixel.r << " " << (int)pixel.g << " " << (int)pixel.b << std::endl;
|
2023-03-13 22:54:19 +00:00
|
|
|
// This will output "0 191 0"
|
2023-03-13 22:43:56 +00:00
|
|
|
```
|
|
|
|
|
|
2023-03-13 22:54:19 +00:00
|
|
|
***
|
|
|
|
|
|
|
|
|
|
## Current Functionality
|
|
|
|
|
|
2023-03-13 02:23:47 +00:00
|
|
|
Basic Features:
|
|
|
|
|
- Overlay call sign and ~~message text~~
|
|
|
|
|
- Convert the image to the proper color space
|
|
|
|
|
- Get the values for individual pixels
|
|
|
|
|
- ~~Add Data to the image~~
|
|
|
|
|
|
|
|
|
|
Supported SSTV Image Formats:
|
|
|
|
|
- Robot24
|
|
|
|
|
- Robot36
|
|
|
|
|
- Robot72
|
|
|
|
|
- ~~Robot8 B/W~~
|
|
|
|
|
- ~~Robot16 B/W~~
|
|
|
|
|
|
|
|
|
|
Tested with jpeg, and png images, support for other Magick++ supported formats has not been tested.
|
|
|
|
|
|
|
|
|
|
Magick++ (7.1) with ``libjpeg62-dev``, ``libpng-dev``, ``libfreetype6-dev`` is required.
|
|
|
|
|
|
|
|
|
|
***
|
|
|
|
|
|
|
|
|
|
Example Image Sources:
|
|
|
|
|
|Image File|Source|License|
|
|
|
|
|
|:--------:|:----:|:-----:|
|
2023-03-13 22:54:19 +00:00
|
|
|
|``example/test1.png``|[Wikipedia](https://en.wikipedia.org/wiki/File:Philips_PM5544.svg)|GNU 1.2|
|
|
|
|
|
|``example/test2.png``|[Wikipedia](https://en.wikipedia.org/wiki/File:TwibrightLinksTestCard.png)|GNU 1.2|
|
|
|
|
|
|``example/test3.jpg``|[Wikipedia](https://en.wikipedia.org/wiki/File:SMPTE_Color_Bars.svg)|Public Domain|
|
