spec out .1line file type

This commit is contained in:
Travis Shears 2026-01-07 10:08:55 +01:00
parent 5b76ace84f
commit 92bda852a5
Signed by: travisshears
GPG key ID: CB9BF1910F3F7469

View file

@ -4,23 +4,39 @@
1.0.0
## Overview
Brief description of what .1line files are for and why they exist.
The .1line file format is designed to hold very low resolution pixel images. It differs from many other image formats because
it stores the order the pixels were drawn to enable animation.
At this time there is no color or alpha channel support just a pixel or no pixel for every x,y in an image.
## File Extension
- Extension: `.1line`
- MIME Type: `text/x-1line` (or `application/x-1line` if not plain text)
## Character Encoding
UTF-8 (or specify your encoding)
## Encoding
## Format Description
Detailed description of the format rules.
The file should follow the following format:
## Syntax
Formal or semi-formal syntax definition.
```
width (max 255)
height (max 255)
termination byte (255)
```
## Examples
An example file converted from binary to text would looks something like this. Commas
are only there to show the different numbers and would not be in the data.
```
88
34
255
0,0,1,0,2,0,3,0,4,0,5,255
```
### Valid Examples
```/dev/null/example.1line
(example content)
Or in hexadecimal:
```
58
22
FF
0000010002000300040005FF
```