[File mask engine]

> What is a file mask?

A file mask is a string used to generate an output file name. Actually file mask is used in CUE Splitter to generate audio, M3U and CUE file names. A file mask can contain one or more token. A token is a string formed by a percentile sign % followed by an identification character, for example A, t, n, c, and so on. Each token will be replaced by its corrisponding text value when time to generate a file name arrives. File mask is case sensitive, so %A is different from %a. Writing a file mask like "%a - %t" can be interpreted as "artist name - song title", so the %a token will be replaced by the artist name and the %t token by song title. Let's see the list of currently defined tokens...

▲Top

> Defined tokens

Here is the list of currently defined tokens in CUE Splitter. The screenshot above can help you a lot to understand how a token will be associated to its text value, so view it repeatedly. Defined tokens are:

Let's see some examples now....

▲Top

> Example 1 - Default file mask

In this example we examine the situation of the screenshot above. The default file mask is used, that is "(%n) [%a] %t", in other words "(current track number) [artist name] song title". Here is the generated file names:

▲Top

> Example 2 - Complex file mask

In this example we use a complex file mask like this "{Track %n of %N} %a - %t (year %y, genre %g)". Here is the generated file names:

▲Top

> Example 3 - Simple file mak

In this example we use a very simple file mask like this "%n-%t". Here is the generated file names:

▲Top