Settings

From Nutcracker Wiki
Revision as of 22:36, 25 August 2015 by Gmachado (Talk | contribs)

Jump to: navigation, search


Settings

Sequence settings

Info/Media

The Info/Media tab displays information about the sequence including the xLights/Nutcracker release that was used to create the sequence, the number of models saved, the Sequence Type (i.e. Media or animated), if media has been specified then the name and location of the media file. The sequence duration, the sequence timing and whether the media tags should be overwritten.

The sequence type, media file name or location, the sequence duration and whether media tags can be overwritten can be changed from this tab after the sequence has been created.


Metadata

The Metadata tab enables the media metadata to be entered or updated. The attributes supported are the author, email, website, song, artist, album, music url and a comment. This information does not drive any functionality in xLights/Nutcracker.

xLights/Nutcracker will parse and retrieve the information from the media file. It won't update any information entered on the media/info screen unless the Overwrite Media Tags setting on the Media/Info screen is ticked.

Timings

The Timings tab enables you to create or import one or more sets of timing marks on timing tracks for the audio of your sequence. This screen is part of the flow when creating a new sequence or can be accessed via this tab at any time after creating a sequence to add additional timing tracks. Note: This component uses the VAMP plug-ins to generate the timing marks.

You can create new timings (which use the VAMP plugins) or you can import external (Audacity ) timings files.


Data Layers

When should you use the data layer to import effects ? Typically if you have sequences from other sequencers such as LSP, LOR, Vixen, HLS that you wish to use within xLights/Nutcracker. The imported sequence is mapped very efficiently as a data image rather than individual effects. After importing the sequencer you can:

  • Save it ( an .fseq file is created) and run it within xLights/Nutcracker or via the Falcon Player
  • Add xLights/Nutcracker effects to new models via the sequencer
  • Selectively override some of the effects from the imported models within xLights/Nutcracker.

You cannot however ‘edit’ any of the imported effects directly. In order to do that see the Import Effects function. The data layer embeds the CONVERT tab into the sequence. The process is used to convert an incoming file from another sequencer into an *.iseq file. Therefore, Vix, Lms, Seq, and Hls data into an ISEQ file.


Render On Save

The default setting is to render all the effects of all the models and groups when saving the xml. If this setting is unticked (i.e. to turn off), then it will only save the XML when you click Save / Save As, resulting in a very fast save operation. Then you can render using the Render All button when you really need to create an fseq file or need to make sure what you are previewing is fully up to date.

Tool Icon Size

This function enables you to change the size of the tool icons that are used to represent the effects on the effects ribbon.

Grid Spacing

This function enables you to change the size (i.e. width of each band) of the sequencer grid.

Grid Icon Backgrounds

When an effect such as the Morph effect is placed between timing marks (as an example over several seconds long), a representation of the color changes over time for that effect. If you select Off, then the effect on the sequencer grid will only show the generic effect icon and not the colors. Not all effects have this difference.

Grid Node Values

This function provides the ability to turn off the effect displaying colors at the node level. Turing it off improves rendering performance and is recommended where effects are only being dropped at the model level. The value can be turned back on as required.

Render Mode

If the Render Mode is set to Erase (which is the default value), then the fseq file is erased before every render. If set to Canvas Mode, then the data in the fseq is not cleared before a render, rendering is done over the old data.

Note: If set to Canvas mode, deleting an effect will still show when played until it is overridden with a new effect. Imagine a 6 foot painting in which you paint over a 4 foot section. The 2 foot original section is still visible.


Effect Assist Window

The effect Assist Window displays a grid which pictorially depicts how an effect is being drawn internally. Not all effects support this capability. Always On will display the window in all cases, Always Off won’t display the window and Toggle Mode will display the window if the effect supports it, else won't display the window if the effect does not have this capability.

Reset Toolbars

The Reset Toolbar option, when selected will reset the Toolbars to the default locations the next time xLights/Nutcracker is started.