What's new in HH6

Elevate your creative process with HH6 Usine Hollyhock! Experience seamless creation with the new Kiosk Mode, perfect for interactive installations and educational purposes. Unleash your imagination with the innovative Laser Engine and explore a plethora of new modules designed for audio, MIDI, video, etc. Enjoy a refreshed user interface for an intuitive and streamlined experience. Dive into the revolutionary Procedures for unparalleled CPU optimization and thread safety.

HH6 is your gateway to next-level show control artistry, redefining the boundaries of digital creativity.

More than 200 new features

Usine has been significantly enhanced for greater CPU efficiency, featuring a lighter and color-rich graphical user interface. This latest update includes over 200 new features, including innovative module inlets, various modules, enhanced interfaces, and more.

Procedures

Procedure is a new concept introduced in HH6. Although similar to sub-patches, procedures offers many advantages.

• they are calculated on demand, unlike sub-patches which are executed permanently, and allow a good optimization of the CPU.
• a procedure can be defined in a patch and be called from any other patch anywhere in the workspace, eventually at the same time because they are thread-safe. This makes it possible to implement reusable code and memory optimization.
• a procedure is by definition iterative and allows you to perform calculations, on the separate elements of an array, like a for loop would do in a traditional programming language.

Note: see Tutorial : Use Procedures

New kiosk mode

In HH6, you can transform any workspace in a stand-alone application (also called kiosk mode), to be used, for example, in teaching situations or in autonomous installations. See setup-panel-tab-kiosk. More specifically, if you do not want the user to change anything in your workspace, as it should be, for example, in interactive terminals.

Note: see Tutorial : Create Stand-Alone Application

Laser engine

Usine include a new laser engine.

Comming Soon...

Note: see Tutorial : Laser Engine

• Setup tab Laser
• Laser Modules
• Tutorial : Laser Engine
• Device Output Laser
• Laser Player ILDA
• Laser Spline to Laser
• Laser Video to Laser

Video Mapping

Video mapping, also known as projection mapping, is a technology used to turn objects, often irregularly shaped, into a display surface for video projection. These objects can be complex industrial landscapes, such as buildings, small indoor objects, or theatrical stages. HH6 provides two dedicated modules for projective an euclidian mapping.

• Video Mapping Grid
• Video Mapping Grid Projection

New modules

• Array Crop

Deletes elements of an array considering that the array is a matrix of nb columns in x nb lines in elements.

• Array Delete

Deletes elements of an array.

• Array Difference Array Out

Gives positions of changes of an array. Helps to retrieve which values have changed inside an array. Unlike the array-difference outputs are arrays.

• Array Max ABS Value

Calculates the maximum of the absolute values of an array.

• Array Mid Value

Calculates the mid value of an array as follow:

out = (max_value - min_value ) / 2

• Array Normalize

Normalize the array to ensure that it is in the range [0..1].

• ArrayDistance (USER MODULE)

Calculates the DTW distance between two arrays.The closer the two arrays are, the lower the distance will be.

• Audio Delay Amplitude Time

Audio multi delay with amplitude and time array inputs. Can be typically used WFS calculation. Note: Very similar to audio-delay-cloud module but can calculate several inputs at the same time.

• Audio Filter FIR

Finite impulse response audio filter (FIR).

• Audio Pan VBAP Distance Amplitude 2D

Vector based Amplitude Panning coefficient (VBAP).

• Bitwise Constant

Bitwise constant value.

• Bitwise CRC32

Calculates the CRC32 (Cyclic Redundancy Check) of bitwise array. See https://en.wikipedia.org/wiki/Cyclic_redundancy_check.

• Bitwise String to Bitwise

Converts a string into a bitwise number.

• Bitwise to Bit Array

Converts bitwise flow into an array made of 0 and 1 according the binary representation of the bitwise.

• Color Change Format

Transforms Usine colors (RGB) into another format like BRG,BGR,GBR,GRB,RBG,YUV.

• Comma-Text Combine

Merge N comma-text into a single comma-text respectively.

• Comma-Text Combine Inverse

Split a comma-text into N comma-text respectively.

• Comma-Text Delete

Deletes one or several elements of a comma-text.

Settings

comma text in

Input comma-text flow(s).

comma text out

Output comma-text flow(s).

delete index

Index of the first element to delete in the comma-text.

delete count

Number of elements to delete, starting at the positi...

• Comma-Text Insert

Insert one element in a comma-text.

• Comma-Text Set Size

Sets the size of a of a comma-text. Deletes ending elements to reduce the size or adds blanks elements (empty strings) to increase.

• Conversion Frequency to Linear

Converts a frequency scale into a linear scale (value are in the [0..1]).

• Conversion Linear to Frequency

Converts a linear scale into a frequency scale (value are in the [0..1]).

• Data Accumulation

Accumulate incoming data values and returns the sum and average. The accumulation is done each time the input value changes.

• Data Filter Hysteresis

Hysteresis data filter. Only input changes greater than the hysteresis value are sent to the output.

Note: Typically can be used to avoid small changes of the input.

• Data Generator Perlin Noise

Generates 1D Perlin noise random data. See https://en.wikipedia.org/wiki/Perlin_noise.



• Device Audio Driver Settings

Gets informations about the current audio driver.

• Device Output Audio Selection Multi

Provides a direct access to selected outputs of the audio out sound card device. Works as the device-output-audio-selection but for multi-channels and array inputs.

• Device Output Laser

Sends laser flow to a laser device.

• Dialog Input Box

Opens the standard input dialog box.



• External Device Set Mouse

Simulate a mouse, position and left-click. The target is the main window of Usine.



• External Wacom Tablet

Gives Wacom tablet information.

• Filename Get Temp Filename

Returns a temporary filename located in the system temp folder.

• Global Array Reset

Reset a global array to its reset values.

• Global Array Watch Modified

Watch a list of global arrays and send a trigger when one of the list is modified.

Settings

name

Name of the global array.

name suffix

Defines if a suffix is added automatically at the end of the name to produce names like MYARRAY-1, MYARRAY-2,etc.

• no suffix
• poly voice num - 1...
• Input Bitwise

Gets the incoming Bitwise flow.

• Input Comma-Text

Gets the incoming comma-text flow.

• Laser Spline to Laser

Transforms a spline into a set of points that can be handled by a laser compatible device. Can also merge the output with an incoming laser flow.



• Light Plot Channels List

Gets the list of all fixtures and channels of the plots.

• Light Send Channel Name

Send DMX values to a set of channel. The list of available channels can be given by the module light-plot-channels-list.

• Main Menu

Creates a main menu for the application. The structure of the menu is defined as an indented text (with spaces) representing the menu's structure.



• Math FMOD Circular

Float modulo but the output value is always positive in the range [0..B].

    Out = A - B*trunc(A/B)
    if Out <0 then Out = Out + B

• Math Formula

Math formula parser. Calculate a formula with variable inputs ie. A * Log(B) + Sqrt(C)

• MIDI Decoder MSC

Decode a MSC (MIDI Show Control) from a MIDI sysex flow.

• MotionRecognition (USER MODULE)

This module uses machine learning to try and recognize multiple movements set by the user. Although this module is meant for use with accelerometers as a data source, you may try to use other data sources with some success.

• Network PosiStageNet

PosiStageNet protocole client. See https://posistage.net/ for more info.

• Network RTTrPM

RTTrPM (Real-Time Tracking Protocol) client. See RTTrPM for more info.

• Output Bitwise

Bitwise output module.

• Output Comma Text

Comma-text flow output module.

Note: This module appears in sub-patches as inlet or outlet.

This modules works only in sub-patches.

Settings

out

Output string(s).

caption

Inlet/outlet caption which appears in sub-patches.

once in poly

Determines if the module inlet/out...

• Output MIDI Global

Send MIDI to all available and active MIDI output devices.

• Output MIDI ID

Send MIDI to a MIDI output devices identified by an ID.

• Output MIDI Name

Send MIDI to a MIDI output devices identified by a name.

• Panel Browser

Creates a browser panel with up to 8 tabs. Each tab can contain 12 different root paths.



• Panel Embedded Web Page

Displays a web page or html/javascript content directly embedded into a panel of Usine.



• Panel Line

Simple panel on which lines are drawn.

• Panel OpenGL

Simple panel on which is drawn a video in OpenGL format.

• Procedure

Define a procedure to be called by a procedure-call module. See procedures.



• Procedure Call

Execute (call) a procedure defined by a procedure module. See procedures.



• Procedure Loop Counter

Return various informations about the current procedure iteration.

• Procedure On Execution

Send 1 when the procedure is executing.

• String Constant

Constant string value.

• String Hash

Returns the Hash of string. See https://en.wikipedia.org/wiki/Hash_function.

• String Random

Generates a random string.

• Synchro Idle Clock

Sends a trigger (clock) at the Usine refresh rate interval (around 25 ms by default, see setup-panel-tab-global).

Note: If several modules are used in a path/workspace this clock ensure that, statically, the triggers are not sent at the same time.

• System Clipboard

Gets or sets the content of the OS clipboard.

• Text Editor

Small and simple text editor.

• Timecode Decoder LTC

Decode a LTC (Linear TimeCode) audio flow and set, optionally, the main timecode.

• Timecode Decoder MTC

Decode a MTC (MIDI TimeCode) from a MIDI flow and set, optionally, the main timecode.

• Timecode Generator LTC

Generates a LTC (Linear TimeCode) according the main timecode.

• MIDI Generator MTC

Generates a MTC (MIDI TimeCode) according the main timecode.

• Trigonometric Degree to Radian

Converts degrees to radians. Radian = Angle° * π / 180.

• Trigonometric Radian to Degree

Converts radian to degree. Degree° = radian * 180 / π.

• UltraLeap (USER MODULE)

Receive data from a UltraLeap UltraLeap external device. Note: The UltraLeap module is compatible with the old Leap Motion device.

• Usine Global Informations

Returns global informations of Usine engine state as a Json string. Those informations are normally used in the Remote control of Usine from Internet.

• Usine Hidden String

Creates a personal Hidden String. If the user type the hidden string with the keyboard it will send a trigger. See hidden-strings.

• Usine Main Grid Active Elements List

Gets current main grid list of actives elements their line number, fade states and fade coefficients. See grid-panel.

2 active lements at the cursor position

• Usine On MIDI Receive

Sends a 1 value when Usine receives MIDI on any MIDI-input device.

• Usine On OSC Receive

Sends a 1 value when Usine receives an OSC messages on any opened port.

• Usine Toolbox Settings

Retrieves and set various settings of the current toolbox-panel.

• Usine Trace Settings

Gives an access to settings and main commands of the trace-panel.

Note: See trace-panel for more info.

• Usine Trace String

Prints a string value in the trace-panel.

• Usine Translator String

Read and translate an identifier in the translator file. Note: The main translator file is located in the /Resources/Lang folder. But it can also be additionalLanguage.en.txt anywhere in the Usine's package, especially the /Deploy folder.

• Video Color Get Pixel Color

Returns the colors of pixels in a video frame.

• Video Draw Fill Circle

Fill circles on a video flow.



• Video Draw Line to

Draw only differences of coordinates of input points.



• Video Draw Line to Path

Try to draw a path with only differences of coordinates of input points.



• Video Mapping Grid

Maps a video flow according points positions on a grid.



• Video Mapping Grid Projection

Maps a video flow according points positions on a grid with a projection algorithm (perspective).



Note: For a more conventional mapping use video-mapping-grid module.

• Video NDI Send

Sends a video (and audio) flow to NDI network.

Settings

video in

Video input flow(s).

process time

Total time used for the calculation of the module.

active

Activate the sending of the video on the network.

in

Left and right audio channels to send. Note: Usine audio engine must be...