HISE Tutorial Part II

This chapter guides you through the process of importing samples into HISE.

We'll be using samples with well-formatted file names, that means that the mapping information can be fully extracted from the names without having to use the mapping editor.

There are a multitude of ways to map audio files in the sampler, from drag 'n drop to batch processing via regex commands. However I strongly recommend using a strict file naming scheme. There is a powerful file name parser in HISE which allows to map the samples automatically so if you do it right, you'll never have to touch the mapping editor ever.

You can download a sample set ready to be imported into HISE here:

Musicbox Samples

For the sake of simplicity, extract and copy all samples you want to import into the Samples subfolder of the new project (you can also opt to redirect the sample folder to another location, which is useful if you have a large sample library on another hard disk).

You need to create a sampler module that the samples will be imported to. Click on the + icon next to the "Master Chain" label and select "Sampler".

You can use multiple sampler modules within one patch (and for more complex projects it is obligatory to do so). However for our little tutorial, one sampler should be enough (we'll be adding some synths later too).

Now open the file browser (make sure you're in full screen mode with all three panels shown and click on the folder icon on the left panel). Go to the project root folder (you can quickly navigate to the current project folder by clicking on the star icon and select Current Project Folder).

Drag samples into the map editor

Double click on the sample folder, select all samples (Cmd / Strg + A) and drag them into the map of the sampler. Select "Filename Token Parser" and press OK".


Use the file import dialog to extract the mapping information

Before we setup the right settings in the next window, let's take a look at one filename:

1        2  3  4
  1. The instrument name (and can be ignored for mapping)
  2. The note name which will be used for mapping
  3. The low velocity limit
  4. And the high velocity limit

The filename is split into tokens which are vertically arranged and can be assigned to different mapping properties. Select these properties for each token:

  1. Ignore
  2. Single Key
  3. Low Velocity
  4. High Velocity

and press OK:


For a detailed explanation of the file import dialog, please refer to the chapter in the Reference Manual.

Fix the mapping

In a ideal world, you could start playing now with the samples and proceed to the next part. However the current mapping has two issues:

  1. There are gaps between notes because it is not chromatically sampled.
  2. The note names are off by two octaves

So we need to get our hands a little dirty and fix those issues manually in the sample map editor. To fix the gaps, select all samples by dragging the lasso and click on the "Close vertical gaps icon".

To fix the octave offset, press and hold down the Alt key (that the cursor changes to the hand) and move the selection two octaves up):


That's it. You now have a perfectly mapped sample set ready to be played. In the next chapters we will add some modulators and effects to the patch.