Sticker Library

Where to find it:


NodeGraph / Right Mouse Click / Annotations /

Main Window / Extension Pack / Nodegraph / Annotations /


Shortcuts (Nodegraph Only): ALT + Scrolllock

       


The Icon Library Shelf allows you to choose from one of Extension Pack's Standard Libraries of Icons or add your own.

New Shelf Tabs can be added globally and shared among team members.





Icons can be colorized with a color and a blend mode to make it more representative of your actual material.

Press the "R" Button to reset it to the default white color.


The initial Node Size can be defined relative to the original icon size, but can be changed at any time later in the

Node Properties


In addition you can use the CTRL+SPACE Node Context Menu to adjust its size






Tabs are the visual representations of Folders on your hard disc.You can add as many tabs as you wish to organize your icons.

By default the Icon Library has several Tabs containing pre-made icons for you to choose from.


You can add an icon to the nodegraph by double clicking on it or closing  the dialog via the button at the bottom






Buttons in the upper right corner of the Window interact with the Tabs - adding, removing, renaming, thumbnail size



Create a new Tab

 

Allows you to add a new Tab to the Icon Shelf

A dialog will appear asking you to specify a Tab Name and a location on disc to load images from



oTab Names need to be unique


oThe Destination Path can be a path from an existing tab in which case you get a duplicate


oThe Destination Path can be loaded by multiple people, allowing you to have a shared folder with a common icon library

oSupported Image formats to load are 


1.BMP,

2.GIF

3.JPG, JPEG

4.PNG

5.BPM

6.PGM

7.TIF

8.TGA

9.SVG

10.PPM

11.XBM

12.XPM



Tabs can be added for all members of team globally using an Environment Variable



Create new Tab from Filter

 

Allows you to add a new Tab from the currently active Tab Filter.

A new dialog will appear asking to specify a Tab Name.



oTab Names need to be unique



Delete current Tab

 

Removes the current Tab. Only the Tab is removed, no actual content is deleted



Rename current Tab

 

Renames the current Tab



Icon Size

 

Determines the Icon Thumbnail in the Icon Shelf Dialog


Tiny:

35x35 px

Small:

58x58 px

Medium: 

90x90 px

Big: 

125x125 px

Large:

200x200 px

Huge:

400x400 px

                

       



The Filter Bar allows to filter the current tab


Clear Filter

Removes the Filtering from the Filtering Field


Filter Field


Filter the current Tab. Filtering is done by:


oFile Name

oAliases



Filtering Operators are 



Comma (,)____________


Separate multiple search terms or search term operators via a comma. If any of the terms is found the icon is displayed


e.g.: architectural, blood will display any icon that has  'architectureal' or 'blood' in its name or aliases



🞙Plus (+)_____________


The Plus (+) operator stipulates a combination of terms that are required to be a filter match


e.g.: architectural+gothic will display any icon that has both architectural and gothic in its name or aliases



🞙Exclamation Mark (!)_____________


The Exclamation Mark  (!) operator excludes a search term


e.g.: 


Search String 'architectural ' will give you three icons as result

Search String  'architectural+!marble '  will only give you two icons as result, since the Term 'marble'  is marked to be excluded.



You can combine operators e.g. Scratches+2d+!Vertical,cracks+3d will display any icon that has 


o 'Scratches' and '2d' in its name or tags but only if it doesn't contain 'Vertical'

o 'cracks' and '3d' in its name or aliases



You can easily create a new tab from the result of the filtering using the Create new Tab from Filter Button



The Icon Location displays 


othe current Tab's Data Location on Disc

oallows the reloading of the current Tab



Additional Image Library Options


A icon can have a custom thumbnail that is displayed in the Tab.

If the Icon Browser discovers two files with the same file name but a .thumb. in its name, it will

use that file for displaying the icon in the Library, while using the second file for the actual Image Note.


This can be handy if you have non-square icons that would disturb the layout in your tab.



It is possible to define aliases for icons.

Aliases are displayed in the tooltip and are also evaluated when filtering a tab.



To add Aliases to a folder with Icons, we need to define a 'Aliases.json' file which can be done with any texteditor such as notepad


A Json file Alias File might look like this


{

       "architectural" : ["building","greek","roman","urban","city","historic"],

       "armor" : ["armour","greek","roman","steel","character"]

}


Its content is enclosed in two curly brackets {}.

Each line then has the identical format


"FILENAME_LOWERCASE" : ["ALIAS A",ALIAS B","ALIAS C"]


Each Text is lowercase and enclosed in " ".

The list of Aliases is all enclosed in square brackets [ ].


"armor" : ["armour","greek","roman","steel","character"]


In the above case the file armor.svg would receive the aliases armour, greek, roman, steel and character.




The Size and Position of the Shelf Window is saved between sessions. If you ever need to reset its size and position to the default

go to


1.Extension Pack Menu in Mari Main Window

2.Choose Nodegraph / Annotations / Reset Icon Shelf Size and Position






While adding Tabs manually is easy enough to do, maybe you want to set up a shared icon shelf for all your team members.

The easiest way to do this is by setting a global environment variable that will automatically add a Tab to all your team's shelves.


The Environment Variable to set is called MARI_EP_ICONSHELF_FOLDER and supports multiple paths separated with a semi-colon


Example


MARI_EP_ICONSHELF_FOLDER = \server\library\materialIcons;\server\ourProject\projectIcons


will create two Tabs:


oa tab called 'materialIcons' pointing to  \server\library\materialIcons

oa tab called 'projectIcons' pointing to \server\ourProject\projectIcons