Skip to content

Commit 5294c12

Browse files
committed
update documentation/reference
1 parent 1d12f4d commit 5294c12

File tree

17 files changed

+606
-349
lines changed

17 files changed

+606
-349
lines changed

documentation/reference/MODULES.md

Lines changed: 0 additions & 22 deletions
This file was deleted.

documentation/reference/README.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,9 @@
1-
# Layeredimage Modules
1+
# Layeredimage Index
22

3-
> Auto-generated documentation modules index.
3+
> Auto-generated documentation index.
44
5-
Full list of [Layeredimage](README.md#layeredimage-index) project modules.
5+
A full list of `Layeredimage` project modules.
66

7-
- [Layeredimage Index](README.md#layeredimage-index)
87
- [Layeredimage](layeredimage/index.md#layeredimage)
98
- [Blend](layeredimage/blend.md#blend)
109
- [Io](layeredimage/io/index.md#io)
Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
# Blend
22

3-
> Auto-generated documentation for [layeredimage.blend](../../../layeredimage/blend.py) module.
3+
[Layeredimage Index](../README.md#layeredimage-index) /
4+
[Layeredimage](./index.md#layeredimage) /
5+
Blend
46

5-
Provide blending functions with blendmodes...
7+
> Auto-generated documentation for [layeredimage.blend](../../../layeredimage/blend.py) module.
68
7-
- [Layeredimage](../README.md#layeredimage-index) / [Modules](../MODULES.md#layeredimage-modules) / [Layeredimage](index.md#layeredimage) / Blend
9+
- [Blend](#blend)
Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,16 @@
11
# Layeredimage
22

3+
[Layeredimage Index](../README.md#layeredimage-index) /
4+
Layeredimage
5+
36
> Auto-generated documentation for [layeredimage](../../../layeredimage/__init__.py) module.
47
5-
Use this module to read, and write to a number of layered image formats.
8+
- [Layeredimage](#layeredimage)
9+
- [Modules](#modules)
10+
11+
## Modules
612

7-
- [Layeredimage](../README.md#layeredimage-index) / [Modules](../MODULES.md#layeredimage-modules) / Layeredimage
8-
- Modules
9-
- [Blend](blend.md#blend)
10-
- [Io](io/index.md#io)
11-
- [LayeredImage](layeredimage.md#layeredimage)
12-
- [LayerGroup](layergroup.md#layergroup)
13+
- [Blend](./blend.md)
14+
- [Io](io/index.md)
15+
- [LayeredImage](./layeredimage.md)
16+
- [LayerGroup](./layergroup.md)
Lines changed: 24 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,44 @@
11
# Common
22

3-
> Auto-generated documentation for [layeredimage.io.common](../../../../layeredimage/io/common.py) module.
3+
[Layeredimage Index](../../README.md#layeredimage-index) /
4+
[Layeredimage](../index.md#layeredimage) /
5+
[Io](./index.md#io) /
6+
Common
47

5-
Do file io - Common Operations for file readers/writers.
8+
> Auto-generated documentation for [layeredimage.io.common](../../../../layeredimage/io/common.py) module.
69
7-
- [Layeredimage](../../README.md#layeredimage-index) / [Modules](../../MODULES.md#layeredimage-modules) / [Layeredimage](../index.md#layeredimage) / [Io](index.md#io) / Common
8-
- [blendModeLookup](#blendmodelookup)
9-
- [expandLayersToCanvas](#expandlayerstocanvas)
10+
- [Common](#common)
11+
- [blendModeLookup](#blendmodelookup)
12+
- [expandLayersToCanvas](#expandlayerstocanvas)
1013

1114
## blendModeLookup
1215

13-
[[find in source code]](../../../../layeredimage/io/common.py#L13)
16+
[Show source in common.py:13](../../../../layeredimage/io/common.py#L13)
17+
18+
Get the blendmode from a lookup table.
19+
20+
#### Signature
1421

1522
```python
1623
def blendModeLookup(
17-
blendmode: Any,
18-
blendLookup: dict[Any, Any],
19-
default: Any = BlendType.NORMAL,
24+
blendmode: Any, blendLookup: dict[Any, Any], default: Any = BlendType.NORMAL
2025
) -> BlendType:
26+
...
2127
```
2228

23-
Get the blendmode from a lookup table.
29+
2430

2531
## expandLayersToCanvas
2632

27-
[[find in source code]](../../../../layeredimage/io/common.py#L23)
33+
[Show source in common.py:23](../../../../layeredimage/io/common.py#L23)
34+
35+
Return layers and throw a warning if the image has groups.
36+
37+
#### Signature
2838

2939
```python
30-
def expandLayersToCanvas(
31-
layeredImage: LayeredImage,
32-
imageFormat: str,
33-
) -> list[Image]:
40+
def expandLayersToCanvas(layeredImage: LayeredImage, imageFormat: str) -> list[Image]:
41+
...
3442
```
3543

36-
Return layers and throw a warning if the image has groups.
44+
Lines changed: 22 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,42 @@
11
# Gif
22

3-
> Auto-generated documentation for [layeredimage.io.gif](../../../../layeredimage/io/gif.py) module.
3+
[Layeredimage Index](../../README.md#layeredimage-index) /
4+
[Layeredimage](../index.md#layeredimage) /
5+
[Io](./index.md#io) /
6+
Gif
47

5-
Do file io - GIF.
8+
> Auto-generated documentation for [layeredimage.io.gif](../../../../layeredimage/io/gif.py) module.
69
7-
- [Layeredimage](../../README.md#layeredimage-index) / [Modules](../../MODULES.md#layeredimage-modules) / [Layeredimage](../index.md#layeredimage) / [Io](index.md#io) / Gif
8-
- [openLayer_GIF](#openlayer_gif)
9-
- [saveLayer_GIF](#savelayer_gif)
10+
- [Gif](#gif)
11+
- [openLayer_GIF](#openlayer_gif)
12+
- [saveLayer_GIF](#savelayer_gif)
1013

1114
## openLayer_GIF
1215

13-
[[find in source code]](../../../../layeredimage/io/gif.py#L14)
16+
[Show source in gif.py:14](../../../../layeredimage/io/gif.py#L14)
17+
18+
Open a .gif file into a layered image.
19+
20+
#### Signature
1421

1522
```python
1623
def openLayer_GIF(file: str) -> LayeredImage:
24+
...
1725
```
1826

19-
Open a .gif file into a layered image.
27+
2028

2129
## saveLayer_GIF
2230

23-
[[find in source code]](../../../../layeredimage/io/gif.py#L32)
31+
[Show source in gif.py:32](../../../../layeredimage/io/gif.py#L32)
32+
33+
Save a layered image as .gif.
34+
35+
#### Signature
2436

2537
```python
2638
def saveLayer_GIF(fileName: str, layeredImage: LayeredImage) -> None:
39+
...
2740
```
2841

29-
Save a layered image as .gif.
42+
Lines changed: 56 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,53 +1,51 @@
11
# Io
22

3+
[Layeredimage Index](../../README.md#layeredimage-index) /
4+
[Layeredimage](../index.md#layeredimage) /
5+
Io
6+
37
> Auto-generated documentation for [layeredimage.io](../../../../layeredimage/io/__init__.py) module.
48
5-
Do file io.
6-
7-
- [Layeredimage](../../README.md#layeredimage-index) / [Modules](../../MODULES.md#layeredimage-modules) / [Layeredimage](../index.md#layeredimage) / Io
8-
- [exportFlatImage](#exportflatimage)
9-
- [extNotRecognised](#extnotrecognised)
10-
- [openLayerImage](#openlayerimage)
11-
- [saveLayerImage](#savelayerimage)
12-
- Modules
13-
- [Common](common.md#common)
14-
- [Gif](gif.md#gif)
15-
- [Layered](layered.md#layered)
16-
- [Lsr](lsr.md#lsr)
17-
- [Ora](ora.md#ora)
18-
- [Pdn](pdn.md#pdn)
19-
- [Psd](psd.md#psd)
20-
- [Tiff](tiff.md#tiff)
21-
- [Webp](webp.md#webp)
22-
- [Xcf](xcf.md#xcf)
9+
- [Io](#io)
10+
- [exportFlatImage](#exportflatimage)
11+
- [extNotRecognised](#extnotrecognised)
12+
- [openLayerImage](#openlayerimage)
13+
- [saveLayerImage](#savelayerimage)
14+
- [Modules](#modules)
2315

2416
## exportFlatImage
2517

26-
[[find in source code]](../../../../layeredimage/io/__init__.py#L101)
18+
[Show source in __init__.py:101](../../../../layeredimage/io/__init__.py#L101)
19+
20+
Export the layered image to a unilayer image file.
21+
22+
#### Signature
2723

2824
```python
2925
def exportFlatImage(fileName: str, layeredImage: LayeredImage) -> None:
26+
...
3027
```
3128

32-
Export the layered image to a unilayer image file.
29+
3330

3431
## extNotRecognised
3532

36-
[[find in source code]](../../../../layeredimage/io/__init__.py#L23)
33+
[Show source in __init__.py:23](../../../../layeredimage/io/__init__.py#L23)
34+
35+
Output the file extension not recognised error.
36+
37+
#### Signature
3738

3839
```python
3940
def extNotRecognised(fileName: str):
41+
...
4042
```
4143

42-
Output the file extension not recognised error.
4344

44-
## openLayerImage
4545

46-
[[find in source code]](../../../../layeredimage/io/__init__.py#L32)
46+
## openLayerImage
4747

48-
```python
49-
def openLayerImage(file: str) -> LayeredImage:
50-
```
48+
[Show source in __init__.py:32](../../../../layeredimage/io/__init__.py#L32)
5149

5250
Open a layer image file into a layer image object.
5351

@@ -64,14 +62,19 @@ Open a layer image file into a layer image object.
6462

6563
- `LayeredImage` - a layered image object
6664

67-
## saveLayerImage
68-
69-
[[find in source code]](../../../../layeredimage/io/__init__.py#L68)
65+
#### Signature
7066

7167
```python
72-
def saveLayerImage(fileName: str, layeredImage: LayeredImage) -> None:
68+
def openLayerImage(file: str) -> LayeredImage:
69+
...
7370
```
7471

72+
73+
74+
## saveLayerImage
75+
76+
[Show source in __init__.py:68](../../../../layeredimage/io/__init__.py#L68)
77+
7578
Save a layered image to a file.
7679

7780
#### Arguments
@@ -86,3 +89,25 @@ Save a layered image to a file.
8689
#### Returns
8790

8891
None
92+
93+
#### Signature
94+
95+
```python
96+
def saveLayerImage(fileName: str, layeredImage: LayeredImage) -> None:
97+
...
98+
```
99+
100+
101+
102+
## Modules
103+
104+
- [Common](./common.md)
105+
- [Gif](./gif.md)
106+
- [Layered](./layered.md)
107+
- [Lsr](./lsr.md)
108+
- [Ora](./ora.md)
109+
- [Pdn](./pdn.md)
110+
- [Psd](./psd.md)
111+
- [Tiff](./tiff.md)
112+
- [Webp](./webp.md)
113+
- [Xcf](./xcf.md)

0 commit comments

Comments
 (0)