Web Layer

The Web layer provides the ability to render HTML5 webpages as content in Designer. However, Disguise goes further and allows you to ‘hook’ and integrate your web pages to the time.

Key features of the layer

• Bookmarks for navigation (with thumbnails)

• Ability to send ‘Javascript Commands’ to the open web page (see field called Command) – i.e. PageTransitions.nextPage(2, 1)

• Ability to send 5 custom timeline float values into the page via JavaScript. Provides the ability to animate items in your web page in sequence with the timeline, or change font sizes.

• Ability to send various standard timeline clock information into the page via JavaScript

• Support for transparent background pages. E.g. body { background-color: rgba(0, 0, 0, 0); }, hence allowing you to composite items into (like a twitter feed).

• Support for simple user interaction with the page from 3 (see the ‘Interact’ button at the top of the Web Layer).

• Locally hosted HTML5 pages

Browser feature support

The browser has the following attributes:

• Utilises software renderer (as Designer has exclusive lock of the GPU)

• Browsers are ‘sand boxed’ in separate processes to prevent negative impact on Designer

• Supports HTML5

• Utilises WebKit -> Based off Chromium (check “about:version ” URL for exact version using this path: Interact → URL: “about:version ” → go)

• Adobe Flash is not supported, but the system is capable of running limited Flash Plugin functionality. Flash must be installed independently on the machine in question.

• WebGL is not supported

• three.js and other libraries that utilise hardware GPU rendering are not supported

Warning

Layer instances reset every time universal crossfade is triggered. This means that web layers will fade out/into themselves even if the same page is used across sections.

Common Layer Properties

Preview Thumbnail

This property is a small preview window at the top of the editor showing you what the layer output looks like.

Blend Mode

BlendMode controls how the output of the layer is composited with the layers below. Layers are rendered in a bottom-up order: layers at the top can modify the output of the layers below

Changing brightness of a content layer in Designer is actually controlling the value of the alpha of the layer. Even when displaying a HAP video, the software will composite the layer with a controllable layer of alpha - one per layer.

There are two ways of expressing alpha in an image:

Straight alpha is al alpha channel which functions just like RGB. Alpha acts as a fourth channel of information per pixel which is as independent of the other three as R, G and B are of each other. For example, with straight alpha it is possible to have RGB = 255 (white) and alpha = 0 (fully transparent) on the same pixel. Internally generated content, such as gradient layer, are generated with straight alpha. This is the preferable style of alpha and considering the cleaner method of the two.

Premultiplied alpha takes the alpha and applies it to the values of the RGB channels per pixel. The more transparent something gets with premultiplied alpha, the closer it gets to black - as if the content is sitting on a black table. Premultipled is the default output of Adobe Photoshop or AfterEffects. the result is our pixel at 255 RGB (full white) with 0 alpha would be calculated as a black pixel in the final image.

Here are expanations of what each individual blend mode will do.

Over

Makes a layer fully opaque. Premultipies all alpha onto the RGB value of each pixel. Alpha = black, so adjusting the brightness of a layer in Over blend mode makes it darker.

Alpha

Default blend mode. It will apply alpha values as a transparency if the alpha is present. Brightness changes will make the layer more or less transparent.

Add

Adds the value of each RGB pixel together. Always creates a brighter result. Values clamp at 255.

Multiply

Reads the level of each subpixel as a level between 0.0 and 1.0, and multiplies source with blend. The result is always a darker image overall. For example: white x grey = 0.5. White turns transparent, black takes precedence. Alpha is applied in the same fashion as the Over Blend mode.

Mask

Choose mask when you want to multiple out content upwards in the stack of layers, rather than downwards. In order to make this work you have to use the same mapping on the layer set to mask and the layer on top.

Multiply-Fade

The same as Multiply, but will make use of the alpha channel to calculate transparency in the source and blend layers. Since maximum transparency is premultiplied, alpha results in black. This will ignore black created through premultiplying.

Multiply-Alpha

Multiply with straight alpha. This mode assumes that the alpha has not been premultiplied onto the RGB values and will not apply a correction to the semi-transparent pixels.

Premultiply Alpha

Like how Multiply-fade will ignore the darkening caused by premultiplying, this blend mode will do the same with Alpha.

Colour Burn

Blend mode increases the contrast to darken the base colour while reflecting the blend colour. The darker the blend colour, the more intensely the colour will be applied in the base image. White as the blend colour produces no change. Using the colour burn blend mode can produce some harsh results at full opacity. The colour burn blend mode can be used to make tonal and colour adjustments to a layer.

Screen

This blend mode looks at each channels colour information and multiplies the inverse of the blend and base colous. The result is always a lighter colour. Screening with black leaves the colour unchanged. Screening with white produces white. The effect is similar to projecting multiple images on top of each other - where bright white is fully opaque, black is fully transparent and 50% grey is 50% transparent.

Overlay

Multiplies or screens the colours, depending on the base colour. Patterns or colours overlay the existing pixels while preserving the highlights and shadows of the base colour. The base colour is not replaced, but mixed with the blend colour to reflect the lightness or darkness of the original colour.

Hard Light

Multiplies or screens the colours, depending on the blend colour. The effects is similar to shining a harsh spotlight on the image. If the blend colour (light source/top layer) is lighter than 50% grey, the image is lightened as if it were screened. This is useful for adding highlights to an image. If the blend colour is darker than 50% grey, the image is darkened as if it were multiplied. This is useful for adding shadows to an image. Painting with pure black or white results in pure black or white.

Soft Light

Darkens or lightens the colours, depending on the blend colour. The effect is similar to shining a diffused spotlight on the image. If the blend colour (light source/top layer) is lighter than 50% grey, the image is lightened as it if were dodged. If the blend colour is darker than 50% grey, the image is darkened as if it were burned in. Painting with pure black or white produces a distinctly darker or lighter area, but does not result in pure black or white.

Darken

Looks as the colour information in each channel and selects the base or blend colour - whichever is darker - as the result colour. Pixels lighter than the blend colour are replaced and pixels darker than the blend colour do not change.

Lighten

Looks at the colour information in each channel and selects the base or blend colour - whichever is lighter - as the result colour. Pixels darker than the blend colour are replaced and pixels lighter than the blend colour do not change.

Difference

Looks at the colour information in each channel and subtracts either the blend colour from the base colour or the base colour from the blend colour depending on which has the greater brightness value. Blending with white inverts the base colour values and blending with black produces no change.

Exclusion

Creates an effects similar to but lower in contrast than the difference mode. Blending with white inverts the base colour values. Blending with black produces no change.

Colour Dodge

Looks at the colour information in each channel and brightens the base colour to reflect the blend colour by decreasing contrast between the two. Blending with black produces no change.

Hard Mix

Adds the RGB channels of the blend colour to the RGB values of the base colour. If the resulting sum for a channel is 255 or greater, it receives a value of 255; if it is less than 255 it receives a value of 0. Therefore all blended pixels have RGB channels of either 0 or 255. This changes all pixels to primary additive colours (RGB), white or black.

Brightness

This property (which appears as a light bulb icon) controls the brightness of the layer output.

If the layers blend mode is set to Alpha, then reducing the brightness to 0 also reduces the opacity of the layer to 0. This can be useful when you want to dissolve from one layer to the next. In that case, you can place the new layer above the old layer and increase its brightness level.

Mapping

The mapping property controls how the layer output is mapped onto the screen(s) in the Stage level.

For information on mapping, including how to use the different mapping types offered by Designer, please see the chapter CContent Mapping.

Palette

This points to the still image file that defines the bitmap from which the tint colour is taken. The default palette ( HSVPAL ) consists of the complete range of hues and saturations. Selecting this property will open the Texture object library, which shows all of the still image files saved on your local hard-drive in the DxTexture older.

To control the location within the current palette bitmap, and thus control the colour, you have to edit the xCol and yCol values (see the section for xCol, yCol).

To change the current palette bitmap:

1. Left-click palette to open the Texture object library.
2. Left-click the still image file you want to use for the palette bitmap.

If you want to use a palette bitmap other than the standard still images provided in Designer, you will need to use a custom still image file.

See the Placing media files for a project sub-chapter to understand where to place a custom still image file and how to access it in Designer. Also save the file to a supported file format.

xCol, yCol

These properties control the coordinates within the current palette bitmap where the output colour is sampled from. The default value is 0,0 which points at the color white (if you are using the HSVPAL palette). Multiplying white with the colors of the chosen content simply generates the original content colors. Colour X controls the horizontal position, where 0 is the leftmost edge and 255 is the rightmost edge. Colour Y controls the vertical position, where 0 is the top edge and 255 is the bottom edge.

For example, to saturate the video clip red, change the Colour Y value to 255 and use 0 for the Colour X value. These coordinates refer to the color red in the palette which is being multiplied with the colors of the existing content.

When you are using the default palette HSVPAL , Colour Y controls saturation, and Colour X controls hue.

Colour Shift

The colour shift property allows you to perform a number of colour-correction operations on the output of a layer.

Colour Shift objects can also be attached to individual video files within the Video layer.

Colour Shift property performs colour-corrections on the output of a visual layer

Colour Shift properties are:

Saturation scale

When set to 1, no change is applied to the image. When set to 0, the image is desaturated to black and white. When set higher than 1, the image is hypersaturated.

Saturation scale (from left to right): s=0, s=0.5, s=1, s=2

Hue shift

RGB controlled

This property controls how the min/max levels and gamma corrections are applied. If set to together, then the min, max and gamma values are the same for the red, green and blue channels. If set to separate , the min,max and gamma values can be controlled separately for red, green and blue. The latter setting allows you to apply fine colour balance controls to the image.

Min

This sets the lowest brightness level found in the image. All pixels at this level are scaled down to zero brightness. Increasing this value enforces shadows and dark levels in the image and can be used to reduce low-level compression artifacts in an image or video frame.

Increasing min equally across red, green and blue enforces shadows, whereas increasing min on an individual channel has the effect of shifting the colour balance away from that colour. For example, increasing red min shifts the image towards cyan.

min = 00 (left), min = 96 (right)

red.min = 0 (left), red.min = 96 (right)

Max

This sets the highest brightness level found in the image. All pixels at this level are scaled up to the maximumm level, i.e. 255. Decreasing this value brightens any highlights in the image. This is useful when the source image is too dark.

max = 255 (left), max = 260 (right)

If you set min to 255 and max to 0, the image (or single channel) will be inverted.

Invert all (left), invert red (right)

Gamma

When gamma is set to 1, no change is made to the image. Reducing gamma brightens highlights while increasing gamma darkens lowlights. The maximum and minimum brightness levels remain the same.

Gamma scale (from left to right): g=0.5, g=1, g=1.5

Web Layer Properties

Interact

Opens an interaction window so that you can control the web page in real time.

Bookmark

The bookmark for the web page you wish to browse. If you change the bookmark along the timeline, the new webpage will load in the background and then be presented.

Command

The Javascript command you wish to issue. You can fire commands along a timeline that manipulate the site, such as turning the page, etc.

Size

Two modes:

Match Mapping - this sets the size of the website canvas to match that of the Mapping it is being applied to.

Custom - allows you to manually set the size (Width/Height) of the web browser. The browser canvas will then be scaled up to match the Mapping.

Custom Parameters

Name X: The name of the JavaScript function you wish to call every frame. The function name in Javascript will be d3.customParam1(x)

Value X: The value you wish to pass into the JavaScript function.

Clear Cache

Clears the web browsers cache.

Reset Browser

Tears down and resets the web browsing session.

Bookmarks

Bookmarks are the way you select your web layers content.

The options in a bookmark are:

URL

This address can be a web address or file address.

• Web addresses are prefixed with http:// or https://

• File addresses relate to HTML5 files contained within your d3 project folder structure. All locally stored html5 files should be under project_folder/objects/Web/sub_folder. For example, a sample page is located in every new project at “file:///sample pages/slide heading.html”.

Background

The web layer is capable of rendering pages with transparent backgrounds to allow you to composite, or with white backgrounds.

For transparent backgrounds to function correctly, the web page must set its background to be transparent.

Example CSS: **  body { background-color: rgba(0, 0, 0, 0); }

Zoom

Allows you to text zoom with correctly rendered fonts. This is similar to pressing Ctrl+/- in a regular browser.

Interact

You are able to directly interact with web pages using a small browser. To open the browser, click the interact button.

While this window has focus, you are able to interact with the webpage including:

• Typing

• Clicking links

• Scrolling with the mouse wheel

You can change the size of the interaction window with the Scale or 50%/100% buttons.

JavaScript Commands

Creating JS commands is very straightforward.

1. Create a JS Command and fill in the javascript you want executed in the browser.
2. Place the command on the timeline at the time you want it executed.

When the timeline is playing and crosses over the keyframe for the command, it will be executed.

JavaScript Functions

The Web layer contains five pairs of Name/Value.

Every frame will call a function in your web page with ‘Name’ entered in that string (in the ‘d3.’ namespace), passing it a single float ‘Value’.

d3.customParam1(1.0)

Essentially is ‘pushing’ the data into your webpage.

You can then write the corresponding function to do with as you please. NB: functions must be in the d3 namespace.

var g_size = 0 // here's an example global variable which d3 will set

​

var d3 =

{
    /* You can specify the names of custom functions in d3. Below are some defaults. */
    /* Every function is called every frame */

    customParam1: function(myVal) { g\_size = myVal }, // set the global
    variable in this function

    customParam2: function(myVal) {},
    customParam3: function(myVal) {},
    customParam4: function(myVal) {},
    customParam5: function(myVal) {},

    /* Below are the inbuilt d3 functions that give your custom HTML5 content a context*/

    lockedTime: function(tBeats) {

    },

    normalTime: function(tBeats) {

    },

    globalTime: function(tBeats) {

    },

    bpm: function(tBeats) {

    },

    status: function(statusString) {

    },

    dmxUniverses: function(universe, data) {

    }
}


    function setup() {
        createCanvas(1920, 1080);
        background(222);
    }

    function draw() {
    ellipse(mouseX, mouseY, 50 + 50 \* g\_size, 50 + 50 \* g\_size);
    // use the global variable to modify content.
}

You can download an example project using JS/HTML from our Resources page in the Web Interaction section at this link.

Standard JavaScript Functions

These JavaScript functions are designed to allow the web page to respond to changes to the Disguise timeline. They are called every frame on the web browser. If the HTML5 page has been coded to respond to these functions, then it will according

d3.lockedTime(float) — Time in beats within the current layer.

d3.normalTime(float) — Time in beats within the current layer, but carries on counting up. (See video player behaviour to get the idea).

d3.globalTime(float) — Time in beats within the whole track.

d3.bpm(float) — Current BPM of the track.

d3.status(string) — Provides the play head status. Either: “playing”, “holding”, “stopped”.

d3.dmxUniverses(array[int], array[array[int]]) — Provides a dump of the universes selected in the layer editor.

Proprietary video codecs (like h264) are not supported currently.