nanDECK

https://nandeck.com/
Admin
nanDECK is a powerful software that allows users to design and create custom playing cards, board...
Tokens:64,339
Snippets:1,061
Trust Score:7.5
Update:3 months ago
Show doc for...
Tokens:
Raw
### Arrow Angle Examples

Source: https://nandeck.com/archives/170

Examples demonstrating the use of arrow angle parameters.

```nanDECK
line=1,1,1,5,1,#000000,0.1,,1  
line=1,1,3,5,3,#000000,0.1,,1,,20  
line=1,1,5,5,5,#000000,0.1,,1,,60  
line=1,1,7,5,7,#000000,0.1,,1,,-20
```

--------------------------------

### Initialize card size for maze generation

Source: https://nandeck.com/archives/tag/new-version

Example setup for using the FRAMEMAZE function with non-rectangular shapes.

```nanDECK
cardsize=20,20
```

--------------------------------

### HTMLIMAGE Rotation Syntax and Example

Source: https://nandeck.com/archives/170

Syntax and usage example for rotating images.

```nanDECK
HTMLIMAGE="range", key, "image file", width, height, flag PTMBLREICDH, **angle**
```

```nanDECK
htmlfont=default,arial,24,,#000000,center  
htmlimage=1,(d),shieldcomb.png,0.8,0.8,PM,-90  
htmltext=1,"nan(d)ECK",0,0,100%,100%,#FFFFFF,0,BE,100,default
```

--------------------------------

### Example Usage of BACKGROUND Directive

Source: https://nandeck.com/feed

A complete example demonstrating the definition of multiple rectangles and frames, followed by the application of the BACKGROUND directive.

```nanDECK
rectangle=1,0.5,0.5,5,2,#FFFF00
rectangle=1,0.5,3,5,4,#00FF00
rectangle=1,0.5,7.5,1,1,#FF0000
rectangle=1,2,7.5,2,1,#FF0000
rectangle=1,4.5,7.5,1,1,#FF0000
<a0>=0,0,6,9,!#FFFFFF
<a1>=0.5,0.5,5,2,#000000%2#FFFF00%5
<a2>=0.5,3,5,4,#000000%2#00FF00%5
<a3>=0.5,7.5,1,1,@#000000%2@#FF0000%5@
<a4>=2,7.5,2,1,@#000000%2@#FF0000%5@
<a5>=4.5,7.5,1,1,@#000000%2@#FF0000%5@
background=1,0,0,6,9,a*
```

--------------------------------

### FRAMECLOCK Distance and Angle Examples

Source: https://nandeck.com/archives/date/2025/04

Demonstrates logarithmic/linear distance adjustments and automatic angle sequence generation.

```nanDECK
cardsize=3,9  
[sp1]=frameclock(0,0,3,3,0.2,0.2,100,0,100,0,1440,1)  
[sp2]=frameclock(0,3,3,3,0.2,0.2,100,0,100,0,1440,1,R)  
[sp3]=frameclock(0,6,3,3,0.2,0.2,100,0,100,0,1440,1,I)  
ellipse=1,<sp1*>,#FF0000#FFFFFF@360  
ellipse=1,<sp2*>,#00FF00#FFFFFF@360  
ellipse=1,<sp3*>,#0000FF#FFFFFF@360
```

```nanDECK
cardsize=6,6  
[a]=frameclock(10%,10%,80%,80%,15%,15%,12)  
font=arial,24,,#000000  
text=1,"{°}",<a*>,center,center,{a_ang?°}
```

--------------------------------

### Configure HTML Borders and Fonts

Source: https://nandeck.com/archives/author/nand

Initial setup for HTML borders and fonts using various styles and margins.

```nanDECK
htmlborder=font_c,**rectangle|dashed,#0000FF|#FF0000,2%|1%**,5%,5%,5%,5%  
htmlfont=font_b,arial,8,,#000000,justify,0,0,0,,,0,5%  
htmlmargins=font_b,5%,5%,5%,5%,bottom  
htmlborder=font_b,**rectangle|double,#0000FF|#FF0000,2%|1%**,5%,5%,5%,5%  
htmltext=1-{(text)},[text],0,0,100%,100%,#FFFFFF,0,BE,100,font_t  
htmltext=1-{(text)},[text],0,0,100%,100%,#FFFFFF,0,BE,100,font_c  
htmltext=1-{(text)},[text],0,0,100%,100%,#FFFFFF,0,BE,100,font_b
```

--------------------------------

### Iterative label definition examples

Source: https://nandeck.com/archives/199

Examples demonstrating the use of for-next cycles to define labels, including corrections for power-of-two calculations.

```nanDECK
[lab(count)]%,(count),1,9 = {(count)^2}
```

```nanDECK
[lab1]=1  
[lab2]=4  
[lab3]=9  
[lab4]=16  
[lab5]=25  
[lab6]=36  
[lab7]=49  
[lab8]=64  
[lab9]=81
```

```nanDECK
[lab(count)]%,(count),1,9={2^(count)}
```

```nanDECK
[lab1]=2  
[lab2]=4  
[lab3]=8  
[lab4]=16  
[lab5]=32  
[lab6]=64  
[lab7]=128  
[lab8]=256  
[lab9]=512
```

--------------------------------

### Define Poker Probability Rules with TAGS

Source: https://nandeck.com/archives/108

Example configuration for evaluating poker hand probabilities using the TAGS directive.

```nanDECK
tag=1-52,value,1|2|3|4|5|6|7|8|9|10|11|12|13  
tag=1-13,suite,1  
tag=14-26,suite,2  
tag=27-39,suite,3  
tag=40-52,suite,4  
tags=suite|value,$aaaaa|==1011121301,Royal flush  
tags=suite|value,$aaaaa|£1111!1>14,Straight flush  
tags=value,$aaaab,Four of a kind  
tags=value,$aabbb,Full house  
tags=suite,$aaaaa,Flush  
tags=value,£1111!1>14,Straight  
tags=value,$aaabc,Three of a kind  
tags=value,$aabbc,Two pairs  
tags=value,$aabcd,One pair  
tags=value,$abcde,No pair
```

--------------------------------

### Configure HTML Margins, Borders, and Text

Source: https://nandeck.com/archives/date/2024/10

Initial setup for HTML font, margin, and border styles used in nanDECK layouts.

```nanDECK
htmlmargins=font_c,5%,5%,5%,5%,center  
htmlborder=font_c,**rectangle|dashed,#0000FF|#FF0000,2%|1%**,5%,5%,5%,5%  
htmlfont=font_b,arial,8,,#000000,justify,0,0,0,,,0,5%  
htmlmargins=font_b,5%,5%,5%,5%,bottom  
htmlborder=font_b,**rectangle|double,#0000FF|#FF0000,2%|1%**,5%,5%,5%,5%  
htmltext=1-{(text)},[text],0,0,100%,100%,#FFFFFF,0,BE,100,font_t  
htmltext=1-{(text)},[text],0,0,100%,100%,#FFFFFF,0,BE,100,font_c  
htmltext=1-{(text)},[text],0,0,100%,100%,#FFFFFF,0,BE,100,font_b
```

--------------------------------

### LINE directive distance parameter

Source: https://nandeck.com/archives/339

Examples showing how to set the distance between elements in LINE patterns.

```nanDECK
line=1,0,0,100%,20%,#FF0000,3%,O  
line=1,0,20%,100%,40%,#FF0000,3%,O,0,0,0,0,**0.1**  
line=1,0,40%,100%,60%,#FF0000,3%,O,0,0,0,0,**0.5**  
line=1,0,60%,100%,80%,#FF0000,3%,O,0,0,0,0,**1**
```

--------------------------------

### Define card properties

Source: https://nandeck.com/examples

Individual keyword examples for setting deck size, borders, fonts, and text placement.

```nanDECK
cards = 18
```

```nanDECK
border = rectangle
```

```nanDECK
font = arial, 28, B, #0000FF  
font = arial, 28, B, #FF0000  
font = arial, 28, B, #000000
```

```nanDECK
text = 1, "SEER", 0, 3, 6, 3, center
```

```nanDECK
text = 2-4, "WEREWOLF", 0, 3, 6, 3, center
```

```nanDECK
text = 5-18, "VILLAGER", 0, 3, 6, 3, center
```

--------------------------------

### COLORCHANGE Noise Effect Examples

Source: https://nandeck.com/archives/date/2025/04

Demonstrates applying noise and pixelated effects to text and images.

```nanDECK
font=arial,256,,#000000  
text=1,"A",0,0,100%,100%  
colorchange=1,0,0,100%,50%,,,25,N
```

```nanDECK
font=arial,256,,#000000  
text=1,"A",0,0,100%,100%  
colorchange=1,0,0,100%,50%,,,25,NC
```

```nanDECK
cardsize=5,5  
image=1,Earth.jpg,0,0,100%,100%,0,P  
colorchange=,0,0,100%,100%,,,10,P
```

```nanDECK
cardsize=5,5  
image=1,Earth.jpg,0,0,100%,100%,0,P  
colorchange=1,0,0,100%,100%,,,30,O
```

--------------------------------

### Configure Interlaced Hexgrid Coordinates

Source: https://nandeck.com/archives/author/nand

Example of using the 2 flag in HEXGRID to implement interlaced coordinate systems.

```nanDECK
font=arial,12,,#000000
hexgrid=1,0,0,100%,50%,10%,C.,#000000,empty,0.5%
hexgrid=1,0,50%,100%,50%,10%,2.,#000000,empty,0.5%
```

--------------------------------

### Define COUNTER and TEXT directives

Source: https://nandeck.com/archives/123

Example script demonstrating the use of COUNTER and TEXT directives to manage card content based on range and counter values.

```nanDECK
CARDS=3  
FONT=”Arial Narrow”,12,,#000000  
COUNTER=1-3,A,1  
TEXT=1,”{A}”,0,0,6,9  
TEXT=2,”{1A1}”,0,0,6,9  
TEXT={A},”Hello”,0,0,6,9
```

--------------------------------

### Configure Icon Borders and Tiling

Source: https://nandeck.com/archives/449

Uses the tenth parameter of ICON to define border strings and the Q flag in ICONS to repeat the tiling process.

```nanDECK
cardsize=12,8  
icon=,01,tiles\tile1.png,100,100,0,0,100,0,0000  
icon=,02,tiles\tile2.png,100,100,0,0,100,0,0001  
icon=,03,tiles\tile3.png,100,100,0,0,100,0,0002  
icon=,04,tiles\tile4.png,100,100,0,0,100,0,0011  
icon=,05,tiles\tile5.png,100,100,0,0,100,0,0012  
icon=,06,tiles\tile6.png,100,100,0,0,100,0,0021  
icon=,07,tiles\tile7.png,100,100,0,0,100,0,0022  
icon=,08,tiles\tile8.png,100,100,0,0,100,0,0101  
icon=,09,tiles\tile9.png,100,100,0,0,100,0,0102  
icon=,10,tiles\tile10.png,100,100,0,0,100,0,0111  
icon=,11,tiles\tile11.png,100,100,0,0,100,0,0112  
icon=,12,tiles\tile12.png,100,100,0,0,100,0,0121  
icon=,13,tiles\tile13.png,100,100,0,0,100,0,0122  
icon=,14,tiles\tile14.png,100,100,0,0,100,0,0202  
icon=,15,tiles\tile15.png,100,100,0,0,100,0,0211  
icon=,16,tiles\tile16.png,100,100,0,0,100,0,0212  
icon=,17,tiles\tile17.png,100,100,0,0,100,0,0221  
icon=,18,tiles\tile18.png,100,100,0,0,100,0,0222  
icon=,19,tiles\tile19.png,100,100,0,0,100,0,1111  
icon=,20,tiles\tile20.png,100,100,0,0,100,0,1112  
icon=,21,tiles\tile21.png,100,100,0,0,100,0,1122  
icon=,22,tiles\tile22.png,100,100,0,0,100,0,1212  
icon=,23,tiles\tile23.png,100,100,0,0,100,0,1222  
icon=,24,tiles\tile24.png,100,100,0,0,100,0,2222  
icons=1,,0,0,12,8,2,2,0,OQ,center,center,100,2
```

--------------------------------

### HTMLFONT Rotation Example

Source: https://nandeck.com/archives/170

Example of rotating characters within an HTMLTEXT block.

```nanDECK
htmlfont=default,arial,24,,#000000,center  
htmlfont=rotated,arial,24,,#FF0000,,0,0,0,,,0,0,,0,-45  
htmltext=1,"nanD<rotated>E</rotated>CK",0,0,100%,100%,#FFFFFF,0,BE,100,default
```

--------------------------------

### Configure HTMLIMAGE with transparency and text overlays

Source: https://nandeck.com/archives/288

Demonstrates using HTMLIMAGE with various flags for text positioning and transparency settings.

```nanDECK
htmlfont=font1,arial,16,,#000000  
htmlfont=font2,arial,16,,#FF0000  
htmlimage=,(d1),deer.png,20%,20%,P  
htmlimage=,(d2),deer.png,20%,20%,P,0,0,0,0,0,50  
htmlimage=,(d3),deer.png,20%,20%,PG  
htmlimage=,(d4),deer.png,20%,20%,PG,0,0,0,0,0,100,font2  
htmlimage=,(d5),deer.png,20%,20%,PGU  
htmltext=1,"Alpha (d1)(d2).",0,0,100%,20%,#FFFFFF,0,BE,100,font1  
htmltext=1,"Text (d3One)(d4Two)(d5Three).",0,20%,100%,20%,#FFFFFF,0,BE,100,font1
```

--------------------------------

### CONTOUR Directive Example

Source: https://nandeck.com/feed

Example usage of the CONTOUR directive to apply borders to text and HTML elements.

```nanDECK
font=arial,16,,#000000
text=1,"Lorem Ipsum",10%,10%,80%,20%,center,wwcenter
htmlfont=default,arial,12,,#000000,justify
htmlmargins=default,6%,6%,6%,6%
htmltext=1,"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",10%,30%,80%,60%,#FFFFFF,0,BE,100,default
font=arial,16,,#FF0000
text=1,"10",0%,80%,20%,20%,center,wwcenter
text=1,"20",80%,80%,20%,20%,center,wwcenter
contour=1,0,0,100%,100%,#FFFFFF#FF0000#000000,3%
```

--------------------------------

### Configure HTML Text Formatting

Source: https://nandeck.com/feed

Demonstrates using HTMLFONT, HTMLMARGINS, and HTMLBORDER to style text blocks with different alignments and border types.

```nanDECK
[text]="Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."
htmlfont=font_t,arial,8,,#000000,justify,0,0,0,,,0,5%
htmlmargins=font_t,5%,5%,5%,5%,top
htmlborder=font_t,rectangle|dotted,#0000FF|#FF0000,2%|1%,5%,5%,5%,5%
htmlfont=font_c,arial,8,,#000000,justify,0,0,0,,,0,5%
htmlmargins=font_c,5%,5%,5%,5%,center
htmlborder=font_c,rectangle|dashed,#0000FF|#FF0000,2%|1%,5%,5%,5%,5%
htmlfont=font_b,arial,8,,#000000,justify,0,0,0,,,0,5%
htmlmargins=font_b,5%,5%,5%,5%,bottom
htmlborder=font_b,rectangle|double,#0000FF|#FF0000,2%|1%,5%,5%,5%,5%
htmltext=1-{(text)},[text],0,0,100%,100%,#FFFFFF,0,BE,100,font_t
htmltext=1-{(text)},[text],0,0,100%,100%,#FFFFFF,0,BE,100,font_c
htmltext=1-{(text)},[text],0,0,100%,100%,#FFFFFF,0,BE,100,font_b
```

--------------------------------

### Get Font Name Function

Source: https://nandeck.com/archives/449

Syntax for the FONTNAME function to retrieve a font name by its index.

```nanDECK
[name] = FONTNAME(number)
```

--------------------------------

### Configure Page Borders and Guidelines

Source: https://nandeck.com/archives/date/2024/10

Sets up page borders with specific guideline styles and thickness.

```nanDECK
page=21,29.7,portrait,hv  
border=none,#000000,0,**line,#FF0000#0000FF#FF0000**,0.2,0.5,0.5,1,0,0,**0.05**  
gap=0.5,0.5  
font=arial,64,,#000000,#FFFF00  
text=1-9,{§},0,0,100%,100%
```

--------------------------------

### Draw a polygon with curved sides

Source: https://nandeck.com/archives/288

Example of using the POLYGON directive with new bezier curve parameters.

```nanDECK
polygon=1,20%,20%,60%,60%,5,0,#FF0000,#0000FF,2%,,,100,1,1,0.5,-0.5
```

--------------------------------

### Define Guidelines with BORDER

Source: https://nandeck.com/archives/339

Configure guideline styles and thickness using the BORDER directive.

```nanDECK
page=21,29.7,portrait,hv
border=none,#000000,0,line,#FF0000#0000FF#FF0000,0.2,0.5,0.5,1,0,0,0.05
gap=0.5,0.5
font=arial,64,,#000000,#FFFF00
text=1-9,{§},0,0,100%,100%
```

--------------------------------

### Generate Geometric Frame Patterns

Source: https://nandeck.com/feed

Demonstrates the use of various frame generation functions like framebar, frameclock, framebezier, framebox, and framehex to create complex shapes.

```nanDECK
cardsize=6,6
[seq1]=50|100|125
[seq2]=50|60|70|80|90|100|100|90|80|70|60|50
[one]=framebar(1,1,5,5,1,1,12,[seq2])
[two]=frameclock(1,1,4,4,1,1,12,0,[seq2])
[three]=framebezier(1,1,4,1,2,5,5,5,1,1,12,[seq2])
[four]=framebox(1,1,4,4,1,1,N,[seq1],[seq1])
[five]=framehex(1,1,4,4,0.5,N,[seq1],[seq1])
[six]=framehex(1,1,4,4,0.5,AN,[seq1],[seq1])
rectangle=1,<one*>,#000000,empty,1%
rectangle=2,<two*>,#000000,empty,1%
rectangle=3,<three*>,#000000,empty,1%
rectangle=4,<four*>,#000000,empty,1%
polygon=5,<five*>,6,30,#000000,empty,1%
polygon=6,<six*>,6,0,#000000,empty,1%
```

--------------------------------

### Initialize Image Filter

Source: https://nandeck.com/archives/date/2024/10

Basic initialization for image filtering settings.

```nanDECK
htmlfont=default,arial,32,,#FFFFFF,center  
htmlmargins=default,0,0,0,0,center
```

--------------------------------

### Randomize Icons with ICONS Flag

Source: https://nandeck.com/archives/449

Example of using the O flag in the ICONS directive to randomize icon placement from a defined set.

```nanDECK
cardsize=12,8  
icon=,01,tiles\tile1.png  
icon=,02,tiles\tile2.png  
icon=,03,tiles\tile3.png  
icon=,04,tiles\tile4.png  
icon=,05,tiles\tile5.png  
icon=,06,tiles\tile6.png  
icon=,07,tiles\tile7.png  
icon=,08,tiles\tile8.png  
icon=,09,tiles\tile9.png  
icon=,10,tiles\tile10.png  
icon=,11,tiles\tile11.png  
icon=,12,tiles\tile12.png  
icon=,13,tiles\tile13.png  
icon=,14,tiles\tile14.png  
icon=,15,tiles\tile15.png  
icon=,16,tiles\tile16.png  
icon=,17,tiles\tile17.png  
icon=,18,tiles\tile18.png  
icon=,19,tiles\tile19.png  
icon=,20,tiles\tile20.png  
icon=,21,tiles\tile21.png  
icon=,22,tiles\tile22.png  
icon=,23,tiles\tile23.png  
icon=,24,tiles\tile24.png  
icons=1,,0,0,12,8,2,2,0,O,center,center,100,2
```

--------------------------------

### Define Interlaced Hexagon Grids

Source: https://nandeck.com/archives/339

Example of using interlaced coordinates to define hexagon grids with consistent movement rules.

```nanDECK
font=arial,12,,#000000  
hexgrid=1,0,0,100%,50%,10%,**C.**,#000000,empty,0.5%  
hexgrid=1,0,50%,100%,50%,10%,**2.**,#000000,empty,0.5%
```

--------------------------------

### HTMLBORDER styling with sequences

Source: https://nandeck.com/archives/339

Demonstrates using sequences of values in HTMLBORDER to define different styles for edges and corners.

```nanDECK
[text]="Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."  
htmlfont=font_t,arial,8,,#000000,justify,0,0,0,,,0,5%  
htmlmargins=font_t,5%,5%,5%,5%,top  
htmlborder=font_t,**rectangle|dotted,#0000FF|#FF0000,2%|1%**,5%,5%,5%,5%  
htmlfont=font_c,arial,8,,#000000,justify,0,0,0,,,0,5%  
htmlmargins=font_c,5%,5%,5%,5%,center  
htmlborder=font_c,**rectangle|dashed,#0000FF|#FF0000,2%|1%**,5%,5%,5%,5%  
htmlfont=font_b,arial,8,,#000000,justify,0,0,0,,,0,5%  
htmlmargins=font_b,5%,5%,5%,5%,bottom  
htmlborder=font_b,**rectangle|double,#0000FF|#FF0000,2%|1%**,5%,5%,5%,5%  
htmltext=1-{(text)},[text],0,0,100%,100%,#FFFFFF,0,BE,100,font_t  
htmltext=1-{(text)},[text],0,0,100%,100%,#FFFFFF,0,BE,100,font_c  
htmltext=1-{(text)},[text],0,0,100%,100%,#FFFFFF,0,BE,100,font_b
```

--------------------------------

### Generate game icons with GAMEICONS

Source: https://nandeck.com/feed

Creates a PNG bitmap from game-icons.net and returns the file path.

```nanDECK
[label] = GAMEICONS(code, color, size)
```

--------------------------------

### Define Polygon Rules

Source: https://nandeck.com/archives/449

Examples of using rules in POLYGON directives to draw custom side patterns, curves, and point positioning.

```nanDECK
cardsize=10,10  
polygon=1,10%,10%,80%,80%,6,30,#000000,empty,2%,,,,,,,,2,2=0|25|-25|0  
polygon=,10%,10%,80%,80%,6,30,#FF0000,empty,1%
```

```nanDECK
cardsize=10,10  
polygon=1,10%,10%,80%,80%,6,30,#000000,empty,2%,,,,,,,,2,2=*0|75|-75|0  
polygon=,10%,10%,80%,80%,6,30,#FF0000,empty,1%
```

```nanDECK
cardsize=10,10  
polygon=1,10%,10%,80%,80%,6,30,#000000,empty,2%,,,,,,,,23,2=0|25|-25|0&3=*0|75|-75|0  
polygon=,10%,10%,80%,80%,6,30,#FF0000,empty,1%
```

```nanDECK
cardsize=10,10  
polygon=1,10%,10%,80%,80%,6,30,#000000,empty,2%,,,,,,,,2,2=0|25|-25|0%0|10|20|100  
polygon=,10%,10%,80%,80%,6,30,#FF0000,empty,1%
```

--------------------------------

### Configure star shaped gradients with parameters

Source: https://nandeck.com/archives/date/2023/04

Sets specific parameters for compression, rotation, and scatter for star gradients.

```nanDECK
gradients=1,1.2,90,,0,0,,4,0.3,5
rectangle=1,0,0,100%,100%,#FF0000#FFFFFF#00FFFF#FFFFFF#0000FF@410
```

--------------------------------

### Define INFOFILE function

Source: https://nandeck.com/feed

Retrieves file information such as existence, width, or height based on the provided flag.

```nanDECK
[name] = INFOFILE(flag, filename)
```

--------------------------------

### MODULEPDF directive usage

Source: https://nandeck.com/archives/339

Examples of using the MODULEPDF directive to add editable fields to PDF files with varying font and alignment settings.

```nanDECK
font=arial,12,,#FF0000,#00FF00  
modulepdf="result.pdf","source.pdf",1,1,1,10,2  
font=times new roman,20,,#00FF00,#FF0000  
modulepdf="result.pdf","source.pdf",1,1,5,10,4,"Two",CENTER,ON  
font=arial,12,,#FF0000,#00FF00  
modulepdf="result.pdf","source.pdf",2,1,10,10,2,"Three",RIGHT,OFF,ON
```

--------------------------------

### Configure Image Filters

Source: https://nandeck.com/archives/date/2024/10

Demonstrates applying and resetting image filters using the IMAGEFILTER directive.

```nanDECK
htmltext=1,"Lorem Ipsum",0,0,100%,33%,#0000FF,0,E,100,default  
imagefilter=lanczos,solid,"mask.png"
htmltext=1,"Lorem Ipsum",0,33%,100%,33%,#0000FF,0,E,100,default  
imagefilter=lanczos,solid,""
htmltext=1,"Lorem Ipsum",0,66%,100%,33%,#0000FF,0,E,100,default
```

--------------------------------

### Define frame positions along a bezier curve

Source: https://nandeck.com/archives/288

Example of using FRAMEBEZIER to position frames along a curve, followed by drawing the frames and the curve itself.

```nanDECK
[a]=framebezier(1,1,5,1,1,8,5,8,0.5,0.5,6,100,0-25-35-65-75-100)  
ellipse=1,<a*>,#FF0000  
bezier=1-3,1,1,5,1,1,8,5,8,#000000,0.1
```

--------------------------------

### Apply and Reset Image Filters

Source: https://nandeck.com/archives/author/nand

Demonstrates applying a Lanczos image filter with a mask and resetting it using an empty parameter.

```nanDECK
imagefilter=lanczos,solid,"mask.png"
htmltext=1,"Lorem Ipsum",0,33%,100%,33%,#0000FF,0,E,100,default
imagefilter=lanczos,solid,""
htmltext=1,"Lorem Ipsum",0,66%,100%,33%,#0000FF,0,E,100,default
```

--------------------------------

### Command-line Parameter /EXPORTTTS

Source: https://nandeck.com/archives/449

Triggers an automatic export to Tabletop Simulator from the command line.

```APIDOC
## /EXPORTTTS

### Description
Allows for automatic export to a Tabletop Simulator save file directly from the command line.
```

--------------------------------

### Configure HTML borders

Source: https://nandeck.com/archives/date/2024/10

Demonstrates applying multiple values to HTMLBORDER to define different styles for edges and corners.

```nanDECK
[text]="Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."  
htmlfont=font_t,arial,8,,#000000,justify,0,0,0,,,0,5%  
htmlmargins=font_t,5%,5%,5%,5%,top  
htmlborder=font_t,**rectangle|dotted,#0000FF|#FF0000,2%|1%**,5%,5%,5%,5%  
htmlfont=font_c,arial,8,,#000000,justify,0,0,0,,,0,5%
```

--------------------------------

### Define icon properties with ICON

Source: https://nandeck.com/archives/380

Configures icon placement and transparency using offset and alpha parameters.

```nanDECK
ICON = "range", key, "image file", _width factor, height factor, offset x, offset y, alpha_
```

--------------------------------

### GAMEICONS Function

Source: https://nandeck.com/archives/449

Creates a PNG bitmap from game-icons.net and returns the file path.

```APIDOC
## GAMEICONS

### Description
Creates a PNG bitmap corresponding to an icon from game-icons.net and returns its path for use with directives like IMAGE or ICON.

### Syntax
[label] = GAMEICONS(code, color, size)

### Parameters
- **code** (numeric/string) - Required - The icon code (viewable via CTRL+F5).
- **color** (string) - Optional - The color of the icon (defaults to black).
- **size** (numeric) - Optional - The size in pixels (defaults to 512).
```

--------------------------------

### Generate a maze with FRAMEMAZE

Source: https://nandeck.com/archives/149

Creates a maze structure from edge frames and renders the solution and start/end points.

```nanDECK
[x] = 20  
[y] = 20  
CARDSIZE = [x], [y]  
[cell] = FRAMEBOX(0, 0, [x], [y], 1, 1)  
[edge] = FRAMEPER(cell, 0.1)  
[maze] = FRAMEMAZE(edge, [x], [y], 0, 0, S)  
RECTANGLE = 2, <mazesolution>, #FFFF00  
ELLIPSE = 1-2, <mazestart>, #FF0000  
ELLIPSE = 1-2, <mazeend>, #00FF00  
RECTANGLE = 1-2, <maze>, #0000FF  
FONT = Arial, 10, T, #000000  
TEXT = 2, {°}, <mazesolution>
```

--------------------------------

### ICONS Command

Source: https://nandeck.com/archives/449

Places multiple icons on a card. New features include the Q flag for repeating until tiles are exhausted, the E flag for six-sided hexagonal grids, the G flag to prevent resizing during rotation, and a nineteenth parameter for external border sequences.

```APIDOC
## ICONS

### Description
Places a set of icons on the card. Supports flags for tiling, hexagonal grids, and rotation behavior, as well as specific parameters for external border definitions.

### Parameters
- **Parameter 19** (string) - Optional - A sequence defining external borders on the four sides (top, right, bottom, left).
- **Parameter 20** (integer) - Optional - Specifies the number of columns for hexagonal grids (used with E flag).
- **Flags**
  - **Q** - Repeats the process until all tiles are used.
  - **E** - Enables six-sided icons for flat-top hexagonal grids.
  - **G** - Maintains original dimensions during icon rotation.
```

--------------------------------

### Replicate sequence lines with MULTI

Source: https://nandeck.com/archives/199

Use the MULTI keyword within a SEQUENCE..ENDSEQUENCE block to repeat subsequent lines a specified number of times.

```nanDECK
SEQUENCE=  
text|one  
**MULTI=2**  
text|two  
**MULTI=1**  
text|three  
ENDSEQUENCE
```

--------------------------------

### Configure star shaped gradients with GRADIENTS

Source: https://nandeck.com/archives/262

Sets parameters for compression, rotation, point factor, twist, and scatter for star gradients.

```nanDECK
gradients=1,1.2,90,,0,0,,4,0.3,5  
rectangle=1,0,0,100%,100%,#FF0000#FFFFFF#00FFFF#FFFFFF#0000FF@410
```

--------------------------------

### Export Decks to Tabletop Simulator

Source: https://nandeck.com/archives/449

Script to define card text and deck composition for direct export to a Tabletop Simulator save file.

```nanDECK
font=arial,96,,#000000  
text=1-100,{§},0,0,100%,100%  
font=arial,64,G,#000000  
text=101,"Back A",0,0,100%,100%  
text=102,"Back B",0,0,100%,100%  
text=103,"Back C",0,0,100%,100%  
text=104-123,"Back {§-103}",0,0,100%,100%  
  
deck=1-20,"One",#FF0000,20,N,101,-10,-10  
deck=21-50,"Two",#FF0000,20,N,102,10,-10  
deck=51-100,"Three",#FF0000,20,R,103,-10,10  
deck=1-20,"Four",#FF0000,20,N,104-123,10,10
```

--------------------------------

### Create a label sequence with LOOKUP

Source: https://nandeck.com/archives/262

Returns the positions of values from a list within a sequence.

```nanDECK
[sequence] = LOOKUP(alpha|gamma|delta, alpha|beta|gamma|delta)
```

--------------------------------

### Apply pixelated and sorting effects with COLORCHANGE

Source: https://nandeck.com/archives/380

Demonstrates the use of P and O flags in COLORCHANGE for pixelation and brightness-based pixel sorting.

```nanDECK
cardsize=5,5  
image=1,Earth.jpg,0,0,100%,100%,0,P  
colorchange=,0,0,100%,100%,,,10,P
```

```nanDECK
cardsize=5,5  
image=1,Earth.jpg,0,0,100%,100%,0,P  
colorchange=1,0,0,100%,100%,,,30,O
```

--------------------------------

### ICONS Command

Source: https://nandeck.com/archives/date/2026/05

The ICONS command includes new flags (Q, E, G) and parameters for managing icon sequences, hexagonal grids, and rotation behavior.

```APIDOC
## ICONS

### Description
Manages a collection of icons. New functionality includes the Q flag for repeating until tiles are used, the E flag for six-sided hexagonal icons, and the G flag to maintain dimensions during rotation.

### Parameters
- **Q Flag** - Repeats the process until all tiles are used.
- **E Flag** - Enables six-sided icon support (flat-top hexagonal).
- **G Flag** - Maintains original dimensions during icon rotation.
- **19th Parameter** (string) - Defines external border sequences for the four sides.
- **20th Parameter** (integer) - Specifies the number of columns for hexagonal grids.
```

--------------------------------

### BACKGROUND/VORONOI Command

Source: https://nandeck.com/archives/449

Configures background or Voronoi patterns. The K flag enables the use of Minkowsky distance.

```APIDOC
## BACKGROUND / VORONOI

### Description
Configures background or Voronoi generation settings.

### Flags
- **K** - Enables the use of Minkowsky distance for the pattern calculation.
```

--------------------------------

### Link multiple files with LINK

Source: https://nandeck.com/archives/356

Uses a sequence of filenames, such as those generated by DIRFILES, to link multiple data sources.

```nanDECK
[a]=dirfiles("data*.xlsx")  
link=[a]
```

--------------------------------

### ICON Directive

Source: https://nandeck.com/archives/date/2025/04

Places an icon with configurable dimensions, offset, and transparency.

```APIDOC
## ICON

### Description
Adds an icon to the layout with specific positioning and transparency settings.

### Syntax
ICON = "range", key, "image file", width factor, height factor, offset x, offset y, alpha
```

--------------------------------

### INFOFILE Function

Source: https://nandeck.com/archives/339

Returns information about a specified file.

```APIDOC
## INFOFILE

### Description
Returns information read from the file indicated among the parameters.

### Syntax
[name] = INFOFILE(flag, filename)

### Flags
- E: Returns 1 if file is present, 0 if not.
- W: Returns the width of the image file.
- H: Returns the height of the image file.
```

--------------------------------

### DISPLAY Directive

Source: https://nandeck.com/feed

Displays an image file with support for reading partial areas.

```APIDOC
## DISPLAY

### Description
Displays an image file, now supporting reading only a partial area of the card surface.

### Syntax
DISPLAY = "image file", first card, last card, width, "range", transparent color, "mask file", bitplanes, pos x, pos y, width, height

### Parameters
- **pos x, pos y, width, height** (numbers) - Defines the partial area of the image to read.
```

--------------------------------

### Apply HTML List Formatting

Source: https://nandeck.com/archives/339

Use flags 1 and 2 in HTMLFONT to render bulleted or numbered lists.

```nanDECK
[text]="First element<br>Second element<br>Third element<br>Fourth element<br>Fifth element"
htmlfont=font1,arial,12,1,#FF0000
htmlfont=font2,arial,12,2,#0000FF
htmltext=1,[text],0,0,100%,50%,#FFFFFF,0,BE,100,font1
htmltext=1,[text],0,50%,100%,50%,#FFFFFF,0,BE,100,font2
```

--------------------------------

### Use FRAMEDISK with hexagon flags

Source: https://nandeck.com/archives/414

Calculates disk size based on hexagons rather than numeric distance.

```nanDECK
font=arial,4,,#000000  
[all]=framehex(0,0,6,9,0.3,N)  
[disk]=framedisk(all90,all42,H)  
text=1,µ,<all*>  
polygon=1,<disk>,6,30,#000000,empty,0.05
```

--------------------------------

### HTMLBORDER Syntax

Source: https://nandeck.com/archives/date/2022/03

Syntax for HTMLBORDER including transparency and height constraints.

```nanDECK
HTMLBORDER=htmlfont, type RECTANGLE / DOTTED / DASHED / DOUBLE / GROOVE / RIDGE / INSET / OUTSET / NONE, html color, thickness, gap top, gap left, gap right, gap bottom, corner rounding, html color, **alpha, min. height, max. height**
```

--------------------------------

### FONT Command

Source: https://nandeck.com/archives/author/nand

Configures font settings with a new flag to manage contrast when using transparency.

```APIDOC
## FONT

### Description
Configures font properties. The 'L' flag reduces contrast on edges when the 'T' (transparency) flag is active.

### Parameters
- **Flags** (string) - Optional - 'L' flag to reduce edge contrast.
```

--------------------------------

### Configure Track Spacing with TRACK/TRACKRECT

Source: https://nandeck.com/feed

Use minus-separated values in the links parameter to define the number of spaces to draw in track sections.

```nanDECK
cardsize=20,15
[range]=1-8
[tracks]=4
[flags]=L|LH|L|LH|C|CH|C|CH
[links]=||1-2-3-4|1-2-3-4|||1-2-3-4|1-2-3-4
[revlinks]=||4-3-2-1|4-3-2-1|||4-3-2-1|4-3-2-1
track=[range],10,12,5,12,1.5,#000000,[tracks],6,[flags],0.05,1,1,,[links]
track=[range],4,11,3,4,1.5,#000000,[tracks],8,[flags],0.05,2,0.5,,[links]
track=[range],4,2.75,6,2.5,1.5,#000000,[tracks],3,[flags],0.05,2,0.5,,[links]
track=[range],7.5,3.5,8,7.5,1.5,#000000,[tracks],6,[flags],0.05,2,0.5,,[links]
track=[range],9.5,9,16,9,1.5,#000000,[tracks],8,[flags],0.05,1,2,,[revlinks]
track=[range],17.25,10.1,17.25,10.9,1.5,#000000,[tracks],1,[flags],0.05,2,0.5,,[links]
track=[range],16,12,10,12,1.5,#000000,[tracks],8,[flags],0.05,2,0.5,,[links]
```

--------------------------------

### Generate rotation angles with FRAMECLOCK

Source: https://nandeck.com/archives/380

Demonstrates the automatic creation of a sequence containing frame rotation angles.

```nanDECK
cardsize=6,6  
[a]=frameclock(10%,10%,80%,80%,15%,15%,12)  
font=arial,24,,#000000  
text=1,"{°}",<a*>,center,center,{a_ang?°}
```
Tokens:
Raw