Hello everyone, a new version of nanDECK is available, with bug fixes and these new features:

Exporting to Screentop.gg

This thread explains how to export a list of frames as anchors for Screentop.gg:

https://boardgamegeek.com/thread/3473299/export-frames-as-anchors-in-screentopgg

New FRAMEPATTERN function

In this thread you can find the explanation and some examples:

https://boardgamegeek.com/thread/3473486/new-function-framep…

New INFOSHEETS function

This function returns a sequence with all the names of the sheets read from a spreadsheet (in the form filename!sheetname), the syntax is:

[name] = INFOSHEETS(filename)

New HTMLTOANSI function

This function converts HTML Unicode character codes (when read from a spreadsheet) to ANSI codes, useful when a special code must be used both in HTMLTEXT (then use the label directly) and in IMAGE or SAVE (then use this function to convert it). The syntax is:

[label] = HTMLTOANSI([label])

New FRAMEREC directive

Normally frames and subframes (frames within frames) are interpreted, i.e. two levels of frames. If a higher level of nesting is needed, three, four or more can be specified with this command. The syntax is:

FRAMEREC = number

New LINKSORT directive

With this line before the LINK you can change the reading order of a linked file, indicating the field by which it should be sorted (the D flag is used to indicate that the sorting is in descending order, while N indicates that the field is numeric). The syntax is:

LINKSORT = "field", flag DN

Added N flag in COLORCHANGE for a noise effect

Example (the level parameter indicates the intensity of the effect):

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

Added C flag in COLORCHANGE to add random colors to noise effect

Example:

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

Added P flag in COLORCHANGE for a pixelated effect

Example (the level parameter indicates the intensity of the effect):

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

Added O flag to COLORCHANGE for a pixel sorting effect (on brightness)

Example (the level parameter indicates the minimum brightness):

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

Added Q flag to COLORCHANGE for a descending pixel sorting effect

Added gradient type parameter in GRADIENTS directive

In the 11th parameter you can indicate a series of characters to say that the transition must be blended (Z), sharp (0), or random (with various levels of intensity (1..9,A..K). Example:

gradients=1,1,0,,0,0,,1,0,0,01AZ
rectangle=1,0,0,100%,100%,#0000FF#FFFFFF#00FF00#FF0000#FFFFFF@90

Added jpeg compression parameter to CMYK directive

In the fifth parameter of the CMYK directive you can indicate the level of compression used for jpeg images (when saved with the SAVE directive). The parameter is a number from 0 (maximum compression and minimum quality) to 100 (maximum quality and minimum compression).

Added position and transparency parameters to ICON directive

Now in the ICON directive you can specify an offset and an individual transparency level icon by icon. The syntax is:

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

Added base transparency in png to SAVE directive

In the seventh parameter of the SAVE command you can indicate (in the format #XX) a global transparency level for the entire image (from 00 = completely transparent to FF = completely solid).

Added I and H flags in CALC function to get ascii codes/characters

In CALC function, with the I flag you get the ASCII code of the character indicated as a parameter, with the H flag you get the character corresponding to the numeric code indicated as a parameter.

Added I and R flags in FRAMECLOCK to change the frame distance

Normally a spiral in FRAMECLOCK places elements at an increasing logarithmic distance, with the R flag an inverse logarithmic distance is used, while with the I flag the distance is linear. Example:

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

Added creation of a sequence of angles in FRAMECLOCK function

When the FRAMECLOCK function is used, a sequence with the suffix _ang, containing the rotation angles of the frames, is created in addition to the frame sequence. Example:

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

Added creation in FRAMEMELD of a frame using center points

Normally, to calculate the resulting frame, you look at the top, left, right, and bottom edges of all the frames specified in the parameters. Now, in addition to this mode, a second resulting frame is created (with the suffix _avg) that instead considers the midpoints of each frame, calculates its overall midpoint, and adds double the average distance to indicate the size). This is useful for frames in a hexagonal grid.

Added O flag in SAVEPDF to open the PDF when it is created

With the O flag, once a PDF has been created with the SAVEPDF directive, it is also opened with the default reader.

Added N flag in JOINIF to not add elements when test is false

In JOINIF, one element is normally added for a positive condition, and another (or an empty element) for a negative condition. Using the N flag, no element is added for a negative condition.

Added option in TOKENIZE to create a sequence with all elements

In TOKENIZE the second parameter indicates which element to extract from the sequence, if you leave it empty then a sequence with all the elements will be created as a result.

Added token and rotation maps parameters to TOKEN directive

The positions and rotations of tokens in the virtual table can now be stored (in two files respectively) using one button and reloaded by indicating the files in the fifteenth and sixteenth parameters of the TOKEN directive. There are two examples in this thread:

https://boardgamegeek.com/thread/3401882/article/45153951#45…

Added L flag in TOKEN to disable mouse wheel

If a token is defined with a sequence of images, the mouse wheel is normally used to select one. The L flag disables this functionality.

Added S flag in TOKEN to rotate them 60°

Normally a token is rotated 90° with the right mouse button. With the S flag it is rotated 60° instead.

Added type parameter to MODULEPDF directive
Added type parameter to PDFMODULE function

By default a textbox is added in a MODULEPDF/PDFMODULE line, now with CHECKBOX in the 12th parameter you can add a checkbox in the PDF module.

Added SEPARATOR and TRIMVALUE options in SEQUENCE..ENDSEQUENCE

Within a SEQUENCE..ENDSEQUENCE structure, you can use a TRIMVALUE=ON/OFF line to trim spaces before and after the value, and a SEPARATOR=<character> line to specify a character other than the standard | character between the field name and the value.

Discord server:

https://discord.gg/KTjyDBRYWE

BGG guild:

https://boardgamegeek.com/guild/454