Home

User Manual - Nutcracker

1. Description Prerequisite information One or multiple colors can be used for the effect Object to Draw Defines the shape of the object that will ripple The Circle is the default and the mos commonly selected value A Square and Triangle shape can also be selected Movement Defines the direction of the ripple i e Explode Outwards and Implode Inwards Thickness Controls the thickness of each line of the ripple Cycle Count Defines the number of cycles that the shape should explode implode within the given ti frame of the effect Indicates whether the ripple effect should render as is a 3D or 2D effect xLights Nutcracker page 89 Shimmer Effect Icon Sequencer representation ee Description The Shimmer effect provides an effect whereby the lights rapidly turn on and off Prerequisite information One or multiple colors can be used for the effect Option Settings Description Duty Factor Defines what percentage of the total cycle the lights will shimmer on For the rest of the tim in the cycle they will be off Cycle Count Defines the number of cycles shimmer on followed by an off period that will be repeated the timeframe of the effect Use All colors If ticked then the shimmer effect generates a pulse effect rather than a shimmer effect wit the selected colors pulsing off and on in sequence xLights Nutcracker page 90 Shockwave Effect Icon Sequencer representation me
2. Mixer Add Fade Time T Tripple Wave Level 2000 1500 ms Currley Shift_Hor Speed Burning Text 2000 1500 ms Configure generator Configure generator i Stripes_Hor Set L Set R Effect Level Strobe Effect Level Rep Rem Up Dwn Add L Add R irecti irecti Direction Toggle Direction Toggle Save Load Clear RepL RepR Up Dwn Methode Manual Methode Manual Rem Clear Save Load Start playing Audio Source Primary Sound Cap imi Scene Time ms 4000 Fade Time ms 1000 a a a amp 6 TY Very mn f a a ee Start Stop T Upper Limit Fader Linear z Timer Value Timer Value V2 0 3 running 25 FPS a ain c 2014 by R Heller Add scene to play list www SolderLab de Turn on Turn on z z Trigger Level u xLights Nutcracker page 74 Life Effect Icon Sequencer representation EH Description The Life effect simulates the Game of Life cellular automation model From Wikipedia The universe of the Game of Life is an infinite two dimensional orthogonal grid of square cells each of which is in one of two possible states alive or dead Every cell interacts with its eight neighbours which are the cells that are horizontally vertically or diagonally adjacent Prerequisite information One or multiple colors can be used for the effect Cells to Start Controls the number of cells that the effects starts with Selects the type of pattern Four values can be selected Controls the speed at which the pattern an
3. In order to change your show Directory select Select Show Folder from the File menu press F9 or click on the Change button against the Show Directory on the Setup tab You will be prompted to navigate to and select a new directory folder to select Ensure that you have the correct xLights Nutcracker xml files xlights_keybindings xml xlights_networks xml and xlights_rgbeffects xml in your new directory BackUp Backing up your critical files and sequences should be done regularly as good practice xLights Nutcracker page 129 a What should be backuped Anything you require to run your show but in particular your xml sequences your media files and your user specific xLights Nutcracker configuration files The xLights Nutcracker configuration files are located in your show directory and are xlights_keybindings xml xlights_networks xml and xlights_rgbeffects xml Tip Pressing F10 anytime anywhere will backup your XML files for your and store them in a zip file with the date and time the backup was created You can press F10 as many times as you like and should do this at least once per sequencing session Alternatively from the File menu select Backup File Playlist View Audio Import Settings Help New Sequence Ctri n Open Sequence CTRL o Save Sequence CTRL S Close Sequence Select Show Folder Fo gt Backup F10 Quit Alt F4 You will be presented will a message indicating where a backup will be create
4. A split screen will be displayed On the left the Available Files from the Show Directory are displayed On the right the Playlist and the items within are displayed Filtering on the options against the Files line enables xLights Nutcracker sequences video and audio files to be selected from the Show Directory Use the arrows provided to add remove files one or all files from the Available File list to the Playlist Within the Playlist section use the Green arrows to change the sequence of the item Test Convert Layout Schedule Setup Papagayo Sequencer Xmas 2013 Playlist 1 Available Files Playlist Fibs AU Wedeo valgt Mowe Mod Sb Set delay Play Bern Play All Show Directory Filename Delay 5 He s the Aue Santa tiag H sChristmas Time Again_testhideo Lith DrurmmaeBboy_matedacetseg PilTertteeg Meigh Fide freq Sleigh Ridesseq SpeninerSarnples tseq xLights Nutcracker page 131 In order to introduce a pause i e delay between items in the playlist click on the item and then click the Set delay button Test Convert Layout Schedule Setup Papagayo Sequencer Xmas 2013 Playlist 1 Available Files Playlist File JAudio Video i xLights MovieMode dh Wb Setdelay Playitem Play All Show Directory Filename Delay 5 He s the Aussie Santafseg it sChnstmas Time Again _testvideo fseg 0 Tet D j n P Amount of delay after the selected them has finished playing Enter the number of
5. Musical Sequence If creating a music sequence click on Musical Sequence xLights Nutcracker page 126 a A Choose Audio File window will open defaulting to your media directory Change the file type from MP3 if using another type of media then select your media file Select the frames per second fps for your sequence The most common one used is 20fps 50ms 40fps 25ms AVIS EX 10fps 100ms This option defines the smallest division in the sequence Higher FPS options result in larger file sizes If you re not sure choose 20fps Press Skip gt gt on the next screen Other Optional Tasks Edit Metadata Import Timings Done gt gt If creating an xLights Nutcracker sequence at this stage you can select Done and import timing marks later either via the Timings menu or by Right Clicking on the Sequencer menu Alternatively you can click on the Timings tab now this will lead to the Timings menu xLights Nutcracker page 127 a On the Timing menu you can select one or more of a number of timing bar options which will generate timing marks automatically similar to those that can be done via Audacity If you click on the Edit Metadata tab this will lead to the Sequence Settings dialog box At this stage a new empty sequence has been created You can e Select Save to save the sequence in your show directory you will be prompted for a sequence name e Click on the Seque
6. if using the LMS to xLights Nutcracker via Data Layer import option channel numbers need to match models between LMS and xLights Nutcracker configurations xLights Nutcracker page 172 Online Support Groups xLights Nutcracker has an excellent online support community The main dedicated forum is the Nutcracker forum located at http nutcracker123 com forum Another support group is a Facebook group called Official xLights Nutcracker Support Group https www facebook com groups 628061113896314 Other online artefacts include e The xLights Nutcracker Wiki http www nutcracker123 com wk index php title Main_Page e xLights Nutcracker Tutorials http www nutcracker123 com wk index php title Tutorials e xLights Nutcracker FAQs http www nutcracker123 com wk index php title FAQs xLights Nutcracker page 173
7. number default is 1 If you have 4 outputs setup on your setup tab being universes 1 through 4 all with 510 channels for the model set as Start Channel 1 From Output 2 its real start channel in the fseq would be channel 511 first channel of the second output Sometimes keeping track on a per universe basis is easier than the raw count from the very first channel e Starting corner is used to define where the first node starts in a multidimensional model i e a matrix or mega tree See to the default value of Bottom Left if running from left to right or Bottom Right if running from right to left e Part of my display Tick this option if this model is to appear on the Layout screen In most circumstances this should be selected However where the same physical item Spinner has been defined using more than one model definition Spinner and spinner matrix for ease of programming the effects then one of them should have the attribute selected and the other should not e Model Brightness Adjustment This can be used to change reduce the brightness of the lights for a specific model The intensity of the lights is accordingly changed reduced from its default value of 100 Most of the time here is now a Model Brightness slider where you can reduce or increase but 99 of the time you reduce the brightness of the model in the FSEQ Note There is also a Preview Brightness slider in the Appearance dialog wher
8. when you drop the Face effect select the first timing track Lyrics and the effects from that timing track will be duplicated Checking for Unknown words in the dictionary This step will help eliminate any words that NutcrackerPapagayo may not have in its library As you breakdown words in NutcrackerPapagayo occasionally you may see that there is no phonetic breakdown of the word placed in the timing track As shown below afi 1 i 7 k 7 p aad a r e oaa A nay xLights Nutcracker page 119 As you can see there is no pink phonemes below the work honkey This means that the word is not in any of the NutcrackerPapagayo dictionaries which are standard_dictionary extended_dictionary and user_dictionary These dictionaries contain information that assist NutcrackerPapagayo in converting each word into phonemes Each word in the dictionary is listed with its associated phonemes As NutcrackerPapagayo proceeds with the breakdown process there may occasionally be a word that it cannot find in these dictionary files When this happens there is a simple process to add that word to the user_dictionary When Nutcracker is first installed this file is located in this folder C Program Files x86 xLights This folder is the default folder that Nutcracker is installed into This can change if you decide to install Nutcracker somewhere else To keep this file from being overwritten in future installs you should move the
9. 100 ms or select from one of the options in the list Note This component uses the VAMP plug ins to generate the timing marks Sequence Settings wo es Map Channels Select New Timing Interval L00ms Empty Bar and Beat Tracker Bars Bar and Beat Tracker Beat Count Bar and Beat Tracker Beat Spectral Difference Bar and Beat Tracker Beats Key Detector Key Key Detector Key Mode Key Detector Tonic Pitch Note Onset Detector Note Onsets Note Onset Detector Smoothed Detection Function Polyphonic Transcription Segmenter quEence Done Tempo and Beat Tracker Beats F Tempo and Beat Tracker Tempo Tonal Change Tonal Change Detection Function 512 Selecting one of the options then presents a window where you can either select the defaults or change the timing name or any of the plug in settings Click Ok and the audio track will be analysed and a timing track will be created You can then click New again to select another timing track Beats to be created xLights Nutcracker page 146 Sequence Settings u E l Timing Mame Bar and Beat Tracker Estimate bar and beat locations Plugin Settings D a 4 0 2 Beats per Bar Don t Create Sequence Click Ok and the audio track will be analysed and a timing track will be created You can then click New again to select another timing track Beats to be created Click Done when complete Sequence Sting a ea Don t Create Se
10. AML Versiom 4 1 13 Models 4 Sequence Type Media ki Medi D Users d228081 Documents My xLights Sequences 2015Sequences Sleigh Ride mp3 edia Sequence Duration 182 230 E Overwrite Media Tags Sequence Timing 50 ms Done xLights Nutcracker page 144 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 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 After updating any data Click on Done to Update a Info Media Meta Dat Author Email Website Song All Want For Christmas Is You Artist Mariah Carey Album Music URL Comment 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 xLights Nutcracker page 145 a Sequence Seng aN a New Clicking on New will present you with a list of options You can either select a fixed value such as 50 or
11. Description The Shockwave effect describes a circular object that starts small and expands to a larger circle The effect can be configured to do the opposite i e start as a large circle and shrink to a smaller one Prerequisite information One or multiple colors can be used for the effect If multiple colors are used then as the effect expands or contracts the circle color will cycle through the selected colors Center X Y Controls the center of the effect Moving either value changes the horizontal or vertical axis position Controls the size of the circle effect by changing the starting or ending radius values If the Radius 2 value is set to be gt than the Radius 1 value then the effect will contract inwards rather than expand outwards Controls the amount of the colored component of the effect and the rest of the black background component Controls the speed at which the effect expands and contracts Blend Edges If selected the circle colors will have a fuzzy look If not selected the edges of the circle will have a sharp look xLights Nutcracker page 91 single Strand Effect Icon Description Sequencer representation A The single strand effect is an effect that is used to implement chases and other such staggered effects on models that are single dimensional in nature such as house outlines arches as well as AC models Prerequisite information One or multiple colors can be used for the eff
12. F nT meai Model Group All Singing Face New P10 Matrix Group P10 Matrix MTREE on J Ld he mt l at Cd pia HouseHorGroup HouseVert Group Icicles Group Pipes Group Insert Layer Above Insert Layer Below Play Model Export Model Toggle Strands Promote Node Effects Edit Display Elements From the sequencer grid view right click on a model name and click on the Toggle Nodes option to display all strands for the model With the strands view open i e displayed right click on a strand to either toggle the strands closed or to Toggle Nodes and display the nodes for a strand xLights Nutcracker page 42 P10 Matrix Strand J Strand 2 Strand 3 Strand 4 Togg le Strands Export Model Strand 5 Toggle Nodes Strand 6 Promote Node Effects Strand 7 Strand amp Strand 9 Strand 10 Strand 11 Edit Display Elernents P10 Matrix Node 1 i a i Node 2 Node 3 Node 4 Node 5 Node Node 7 Node amp Node 9 This is often useful to see how a particular effect has been rendered down to the node level Custom Model definition xLights Nutcracker enables you to define models that do not fit into the concept of predesigned common shapes For example a snowman outline reindeer outline a singing face etc In order to define sucha model create a new model select the Display As attribute as Custom and select a layout size width and height Medel Mama 9 Sarege
13. This option enables you to import sequences from other sequencers However in many cases it generates a large number of effects In most cases importing of RGB effects as Data Layers will suffice There could be some cases A C channel data or LOR singing face sequences where it is desirable to import using the Import Effects function The following example describes how to use this function to import an Arch effect from an LSP msq sequence 1 First ensure that you have created or opened an existing sequence that has the models added to the sequencer that you wish to import to 2 Then click on Import Effects from the Import tab and select the LSP sequence the same process can be used for other supported sequence types from the drop down list After a short while while the sequence data is being parsed the following screen will be displayed i Themea O E amaii a Ada bieda Farima Psp by aand EOR it ta mari bis pg arom Miappiay xLights Nutcracker page 140 3 Click on the drop down arrow and you will be presented with a list of models that you have defined on the sequencer Select a model and Click on the Add Model for Import and press Enter The following screen will be displayed Map Chernels l Model Strand Node Channel Color ral Aral Stand 1 Aral Stand 1 Pech 1 Aral Tand 1 Racie 2 ral Stand 1 Raie ral Stand 1 Blache 4 Aral Stand 1 Made Arzal tand 1 Nade Arcal Sten
14. mixed 12 different ways with the layer below it for a combination of thousands possibilities within a single timing cell Usually 4 6 layers is plenty enough though for the most discriminating user depending on the model shape and size Why would you even want multiple layers on a model Layers on a model is like layers on a cake Each layer adds a bit to the effect produced at the end Much like layering your popcorn with butter or salt It s easy to think of each layer of being additive like a food recipe but you can also use layers to be subtractive as well using layer masks to reveal only a portion of alayer See the table below for the different layer blending options Think of a color wash in red with a layer of snowflakes Normally you would picture a red model with the white snowflakes You could change the layer masking so that the model was black and showed red on the snowflakes Some effects like Morph can be applied to only a portion of a model so using layers you can get multiple morphs on a Mega Tree that look like interleaving fingers for example Combining two spirals in opposing directions on a mega tree also can create stunning effects To add layers to a model right click the model in the sequencer tab and choose Add Layer above or below the current layer When setting the layer blending modes the current layer is considered layer 1 and the layer below is considered layer 2 xLights Nutcracker page 107 Layer Blendi
15. working with is reflected in the associated and open windows to the left of the grid Tip Select and open the Views Window menu and select windows to be opened Changing an Effect From the Color window you can change the Colors that apply to the effect as well as the Sparkles Brightness and Contrast values Tip if this window is not open select and open the Window from the Views Window menu You can save all your window positions as a Perspective for easy recall From the Effect Settings window you can change various options attributes that are applied to the effect Selecting Colors For any effect you can change the initial colors selected for the effect by selecting a different color or colors from the Color Window Color x WOO gt fol fol fol fol fo Sparkles p 20 2l Brightness p 10 8 Contrast p 0 a xLights Nutcracker page 103 Tip Double Clicking on the any of the color icons E EE E opens up a Palette window where the standard colors can then be replaced with a new standard color or a custom color can be selected Basic colors BEERS E EnEn EEEE JEERES BEERE IEEE Custom colors Tip One you tailor an effect then use the effect again to a new timing mark the effect will have all the same settings as the previous effect did However if you were to highlight any other effect with different colors selected then the colors will change to the
16. 051C Program Files xLights piano T as us Include in library Sharewith Burr New folder 2 Name i Datz mocified Type Size ites iktop H Plano 83KeyShapeMap 18 05 2015 9 53AM Tet Document 3 KB nn oads Piano ExampleFaceMinShapeMap 18 05 2015 9 53AM Text Document 1 KE cent Places By Piano ExampleFaceMinShapes 16 05 2015 9 55AM PNG image 1 KB By Piano ExampleKeyEdgeShapes Item type 2NG image pPNG image 1 KB ries By Piano ExampleKeyTopShapes Dimensions 35x6 png image 1 KE ers Size 197 bytes cuments _ EB Piano readme rere ext Document 2 KB sic PlanoTestNotes 18 05 2015 9 53AM Text Document 2 KB Select the Piano ExampleKey TopShapes png file Click on the Cue Shape Map button From the same directory select the Piano 88KeyShapeMap txt file Click on the Cues button Navigate to your songs directory or the location where the polyphonic notes file has been saved and select the notes txt file xLights Nutcracker page 81 a 11 Select a style for the keys the of keys the of rows and the placement of the keys Option Settings Description Style Select the style of the effect of Keys Number of keys to be used for the effect Rows Number of rows to be used for the effect Co Tip Select a Style of Equalizer bars or Player Piano scroll Select a Placement of Bottom Middle xLights Nutcracker page 82 Pictures G Effect Icon Aa Sequencer representation M D
17. Corto Feri fo fe TF N Mia ight Rama Contre Reg Je af JT eM fide Moun MII ig ems onre se Recut foa e gt j ohon E aaob Fea weak aAa o p X Haro Mouth BB fiama Coed Reo fo fe fo X Pugh I Rana Conirc_ fo fp Abo o oO Pad oj Pap O N ligt Ramones Ree oe fn f De Punkin O N cg Rema or Rene fs ae z Me Pump Oe Foye J le J ES 2 x fPunckin A games Corse Repa J foo fe s F W Pumpkins O E Ama Conk re qJ foo A fe Abo i t If there are any channels missing use the Add Channels function to add the missing unused channel 1 Note that in the image the Unit id is 03 and the Channels Circuit values run from 1 to 16 However referring to the LOR Unit Id to DMX channel mapping table Unit id 03 corresponds to Channel number 33 If Units prior to Unit 3 have not been defined then you need to define them so as to utilise the missing channels Use the Insert Device function to Insert Device Above the current device Unit 03 as a LOR 16 channel device Unit id 01 Repeat this step and add another device Unit id 02 xLights Nutcracker page 165 GES Lhe Hien J LS ST een S OT LO ee I Hame Wnt F lrechocke bare yn D om charre rreg F Add ae a group LOR CTB Settings Therefore Channels 1 32 Unit 1 and 2 have been defined even if not requir
18. Delete Delete All ka xLights 4 BETA Ve 4 FF File Playlist View Audio Import Settings Help X 0 cy w C Users Ed Desktop Christmas 2015 Nutcracker Network Type Port LOR NotConnected E131 MULTICAST E131 MULTICAST E131 MULTICAST E131 MULTICAST E131 MULTICAST E131 MULTICAST E131 MULTICAST E131 MULTICAST E131 MULTICAST E131 MULTICAST VA 7 T TSE m N Shaa O ML i Setup Test Convert Layout Schedule Papagayo Sequencer Baud Rate or E1 31 Univ 57600 2 own non amp w Be e Oo a L Num Cha 510 510 a xLights Vixen FPP M Channels 1 to 510 Channels 511 to 1020 Channels 1021 to 1530 Channels 1531 to 2040 Channels 2041 to 2550 Channels 2551 to 3060 Channels 3061 to 3570 Channels 3571 to 4080 Channels 4081 to 4590 Channels 4591 to 5100 Channels 5101 to 5610 xLights Nutcracker page 20 QAe Goy 2 Enabled Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Ne M hems A Pol VV a There could be large matrices to be implemented via P10 or P5 panels running off a BeagleBone Black controller A null output can reserve a huge number of channels but not actually output anything if the Output to Lights function is on A model can still be sequenced as normal and viewed on all the windows just as any other output Click on Add Null and specify the number of channels to be reserved The corresponding number of channels will be created N
19. Mapping Frahled Save Setup a E131 PALL TiC AST 1 fa Channels 1 to 64 Yes Add USE Add E131 mudd Pu Change Delete Delete All For the three devices were defined in LOR only 48 channels need to be defined but to preserve a buffer for future use an extra 16 channels corresponding to an additional LOR device i e a total of 64 channels will be defined in Universe 1 as E1 31 Model definition Next create a new Model definition that matches the LOR Channels of Unit 03 Lets say that this was 16 single channels Trees In that case create a model Small Tree 1 with 1 channel The start channel must be set to 33 not 1 as this corresponds to the ha channel of Unit 3 xLights Nutcracker page 168 Model Name Small Treel Individual Start Chans Display As Tree 360 Start Type of String Single Color Custom Actual of Strings 1 of RGB Nodes per String 1 of Strands per String 1 Start Channel 33 From Output 1 Starting Corner Top Left Top Right Bottom Left Bottom Right Part of my display W Model Brightness p 0 Adjustment First Strand for Export 1 OK Cancel Appearance Names Faces Then you can copy the model update the name Small Tree 2 and change the starting channel to 34 and repeat this for all 16 channels increasing the start channel by 1 each time until the last one is 48 Tip If within the LOR Unit 03 definition there are unused channels
20. Render On Save A fz SEL Tool Icon Size oe d Spacing AMS 2013 Playlist 1 Grid Icon Backgrounds Grid Node Values Render Mode Effect Assist Window Reset Toolbars xLights Nutcracker page 153 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 Sequence Settings A lec ip a amp Render On Save Be Zee Tool Icon Size Grid Spacing Xmas 2013 Playlist 1 Grid Icon Backgrounds Grid Node Values l ikain hatal im Render Mode 7 Erase Mode Effect Assist Window b Canvas Mode Reset Toolbars 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 This is the how canvas mode works Effect Assist Window o l Sequence Settings A Da fg a Render On Save Tool Icon Size a a i a E Grid Spacing Grid Icon Backgrounds Grid Node Values Render Mode e Effect Assist Window gt Always On Reset Toolbars Always Off Toggle Mode Alw
21. The date time must conform the the RFC822 standard format Properly formatted examples are Fri 25 Dec 2015 00 00 00 0100 Fri 25 Dec 2015 00 00 00 EST Fri 25 Dec 2015 00 00 00 MST Fri 25 Dec 2015 00 00 00 0800 These must be specified in the Text field without any quotes seconds 100 Will execute a 100 second countdown In the following examples 0100 refers to your time GMT hours Change accordingly Or you can use GMT EST etc to date d h m s Fri 25 Dec 2015 00 00 00 0100 Will display 33d 3h 38m 14 to date h m s Fri 25 Dec 2015 00 00 00 0100 Will display 3h 38m 14 the time is calculated to th next day in hours mins secs to date m or s Fri 25 Dec 2015 00 00 00 0100 Will display 217m the time is calculated to the ne day in minutes to date s Fri 25 Dec 2015 00 00 00 0100 Will display 13011 the time is calculated to the ne day in seconds Ito date tofmt Fri 25 Dec 2015 00 00 00 0100 D Will display 133 This setting is used to adjust the initial position of the text Either the vertical Y or t horizontal X position of the text is adjusted depending on the value of the Moveme setting For a value of None or a horizontal movement such as Left Right adjusting t setting will move the initial position of the text vertically xLights Nutcracker page 99 Tree Effect Icon Sequencer representation mam Description The Tree effect creates a
22. Users d228081 Documents My xLights Seque Media Directory Change D Users d228081 Documents My xLights Seque Lighting Networks Save Setup Cire Sets up an 1 31 connection over ethernet oe Add USB Supported devices include those made by jlsys SanDevices Advatek Lights and Entec Also supports the Lynx EtherDongle and E1 31 projects on DIYC Add 1 31 Add Null The untverse numbers entered here should match the universe numbers defined on your E131 device IP Address MULTICAST Starting Universe 1 of Universes 1 One uput E Last Channel 512 Select Multicast Starting Universe 1 of Universes 10 Last Channel 512 and press okay This will create 10 universes each of 512 channels starting from Universe 1 to Universe 10 The start and end channels are automatically calculated and displayed in the last column Click on Save Setup to save the network created Click on the New Sequence Icon or Select File New Sequence and follow the outline described in New Sequence Click on the Sequencer tab and if you have not already done so either create default timing marks say every 5 seconds or create a Timing Track via the Settings Sequence Settings Timings tab Alternatively just to get going quickly you can set the default New Timing timing mark off by un ticking it This will enable you to drop an effect anywhere Note You need to either select a Timing Track with some timing marks on it o
23. a special System created view It contains all the models that have been defined for the sequence that is open only i e it does not span sequences It also determines the rendering order Any model added to any other view when a sequence is open automatically gets reflected in the Master View of that sequence Models can be deleted i e removed from any view at any time Note If you attempt to delete a model from the Master View you will be prompted to confirm the deletion as deleting the model from the Master View will remove all effects that you have created against that model for the sequence that you have open If you add a Timing Track to a view it will be added to all views that you have defined xLights Nutcracker page 58 Effect Presets Presets are a way to save an effect and easily recall it later to speed up Sequencing To save an effect which can span layers and models as a preset highlight the effects that you want to save right click and select Effect Presets waa PP Pr ys A 6a KWH SAM Bweo y e VECO GB equencer Efect Presess Apply Preset ioo ang Boo j 1000 F emm emes 3 User Group New Preset Update Preset dali Add Group Rename Dete ginga _ s f ERT pee OK _ n gt a a Under the Favorites tree you can first create a group that describes the type of effect that you are going to save Spirals Bars etc C
24. and filename A single row is created for each model and includes the model name display as name attribute string type string count node count start channel start node part of my display model brightness adjustment value xLights Nutcracker page 45 Examples 1 Single Arch Model name Arch 1 with 25 nodes starting from channel 6001 Model Name Archi individual Start Chans Display As Start End Type of String 1 6001 6075 ofArches 1 ofNodesperArch 25 Foflights per Node 1 Start Channel 6001 From Qutput 1 Starting Comer S Top Left Top Right C Bottom Left Bottom Right Part of my display F Model Brightness p 0 z Adjustment A 360 degree Mega Tree visually 30 strings of 25 pixels on each string however physically made of 15 strings of 50 pixels each Each string starts from the bottom goes up to the top of the tree and loops back down So half the number of physical strings are required The first node is in the front bottom left and starts from channel address 9200 Model Model Name MITREE E individual Start Chans Display As Surt emd Type of String RGB Nodes et Ha n 2 9350 9439 Actual of Strings 15 E 3 9500 9649 4 9650 9799 of RGB Nodes per String 50 5 oaoo 9940 e 10099 of Strands per Stri 2 a oa 7 10100 10249 Start Channel 9200 l From Output 1 8 105 10393 a 1000 10549 Starting Corner Top Left Top Right 10
25. be re used later Note The Delete button is used to delete a Preset The Clear Grid is used to clear any details mapped so that you can start again and the Copy First is used to copy the Voice 1 column to all the other columns Click on Click to Create New Sequence A message will be displayed indicating completion 8 Save the sequence 9 Click on the Open Sequence icon then select the sequence created in the previous step 10 Click on the Render All icon and then play the sequence xLights Nutcracker page 34 a The Papagayo images cannot be edited once they have been added to the sequencer If you need to make any changes you have to do make the changes in the PGO file and reimport Note You can then add additional models to the sequence drop effects on them and continue as usual Sequencer setup Test Convert Layout Schedule Papagayo Sequencer The sequencer is where the majority of time will be spent and where most of the functionality that the user sees resides The main areas and functions of the Sequence tab are as follows i xLights 4 BETA Ver 4 2 0 Aug amp 2 File Playlist View Audio Import Settings Help E Na DORFROSBLUERsMa 2ECOSASRSASeER N Setup Test Convert Layout Schedule Papagayo Sequencer Xmas 2013 Playlist 1 douse Preview E View 1 15 00 1 20 00 1 25 00 1 30 00 1 35 00 1 40 00 1 45 00 1 50 00 1 55 00 0 E
26. colors of the effect that you have selected Single Channel Colors Single Channel colors react only to the color that they are defined as If you define them as single color blue then it will only react to the blue channel You can set any color and it will route the blue portion of that color to that model If you send White R 255 G 255 B 255 to a single color blue model then it will turn fully blue If you send blue it will turn fully blue If you send red or green it won t turn on at all If you send pink which is R 255 G 0 B 128 you will get a half brightness blue You can therefore include those single color models inside a group and they will react to the colors dropped on the group Any of the blue components of the RGB values assigned to that model will cause it to fire at the associated brightness of the component The strings will light up with the intensity of the color for each channel So if you send Purple R 128 G 0 B 128 that will light up all the Red and Blue strings but only about 50 intensity Tip If you just want a string to turn on full brightness without worrying about it then use White xLights Nutcracker page 104 Moving and Stretching effects An effect or group of effects can be moved by highlighting the effect or range and moving it along the Same model row rows on the grid forwards or backwards Hold the Shift key to move multiple effects Tip Effects can be stretched by using the Alt key an
27. hiatus ff irl E anihi ra a peel Jer pk ae pi Prevs F fe help Chanm l Outputs E1 31 BEE LEO Panels Other Enable LED Panel Output Start Channel 11600 Panel Layout WxH irg F Channe Coumi 12255 Single Panel Size WEH 32 16 Save Cnt will que chara to BEB nad LED Parla tab LEO Panel Layout 0 2 o 2 PF Pd 0 2 Olo 2 0 S F l lo 1 lo 1 O P 3 Pa j 0 1 i P 3 z P 1 0 2 is physical output number P Is panel number on physical output Arrow indicates panel orientation click arrow to rotate On the E1 31 page the Enable E1 31 should not be ticked and no E1 31 channel definition is required as E1 31 is not used to drive the panels the output is memory mapped Note If wishing to use the Falcon Player Bridge mode then E1 31 needs to be defined Please refer to the Falcon Player site for details xLights Nutcracker page 158 Coming over From LOR Running LOR Controller in DMX Mode LOR to DMX Channel conversion The following table describes the conversion of a LOR Unit id toa DMX address As an example if you have a controller with a Unit id of 03 then when converted to run under DMX the channel ranges will be 33 to 48 LOR Unit ID DMX Address LOR Unit ID DMX Address e CC e e e p e e fe p e e fe p e e p xLights Nutcracker page 159 Running LOR in DMX mode The following diagram shows a
28. i i Er l EEF 8 H Li 1 7 i 1 Pai 1 i H 1 7 I bk E ob ET II 1 L z 2 Play Model If the Model Preview window is open you can play the model effects in the window by right clicking to the left of the sequencer grid and selecting Play Model The sequencer will start playing and the effects in this window will focus on the selected window You can also achieve the same result by clicking on an effect against the model in the grid and then selecting Play xLights Nutcracker page 48 Model Group All Singing Face New P10 Matrix Group P10 Matrix FAH MTREE Insert Layer Above Arches Group Insert Layer Below Archl Arch Play Model Arch Export Model Arch Toggle Strands Arch Promote Node Effects Arch Edit Display Elements HouseHorbroup Export Model This function is used if you wish to export effects from your model to another sequencer such as LOR LSP Vixen HLS It can also be used to export an eseq effect sequence to the Raspberry Pi Falcon Player Effect files are fseq format files with an eseq extension These special sequence files contain only the channels for a specific effect and always start at channel 1 in the sequence file The actual starting channel offset for the Effect is specified when you run it or configure the Effect in an Event on the FP Tip Eseq effect sequences can be played on the FP any time while a main fseq sequence is running and you can have as many effect sequences r
29. lank to the output dictionary That can be peed for saomah procemnng of th page Click the work link Another webpage similar to this will appear Pape i epee te k Index of tools product 1411311357_03081 RETIE Last modifed Sire Descriptin Parent Director ki piin duct 21 Sep 14 10 55 JE G 084k eeonlog 21 Sep 2014 10 55 232 Eal DEE Tan 21 Sep 2014 1088 J3 xLights Nutcracker page 122 Here click the file with the dict extension such as 0548 dict then a web page will appear with the words and their phoneme breakdown as shown below i x E Aticmued W WN pa I ey ee ore Sit y fa a4 Before following the rest of this process close the current sequence and exit Nutcracker If your user_dictionary is not open open it now Highlight and copy this list and paste it into your open user_ dictionary and save the newly modified file There is a small bug in Nutcracker at the time this document was written which you need to compensate for After pasting in the newly added words do a search and replace with a Space for any tab characters in the user_dictionary This process will work for one to how ever many words that you have But if you just want to quickly check one word past the following link into your browser http www speech cs cmu edu cgi bin cmudict This is the online CMU Pronouncing Dictionary Here you will look up each word that Papagayo did not find in its dictionaries Lets t
30. of 0 and ending of 100 will result in a ramp up aS opposed to an On effect with hard edges Be sure to set the blending option of the On effect to layer 1 is mask Make sure the cycle count is set to 1 and you have a color selected doesn t matter which color since it s a mask xLights Nutcracker page 62 Butterfly Sequencer representation I __ Effect Icon Description The Butterfly effect creates seemingly random patterns of color swirling around based on an initial set of parameters Prerequisite information None Colors Rainbow or Palette can be selected If Palette is selected then the colors from the Color selection window are used Style Up to 5 different styles can be selected for the effect Bkgrd Chunks Controls whether and how sections of black color are to be used between the colors Bkgrd Skip Used in conjunction with the background chunks to skip the black background Controls the speed with which the effects change Direction Controls whether the effect moves outwards or reverses direction Tip Butterfly style 2 generates radial patterns that look great on round models such as snowflakes stars globes etc In the context of fast Fourier transform algorithms a butterfly is a portion of the computation that combines the results of smaller discrete Fourier transforms DFTs into a larger DFT or vice versa breaking a larger DFT up into sub transforms The name butterfly com
31. on the dropdown arrow in the box at the top of the window and follow the same process described in the example above Tip In order to Improve performance of the imported effects and reduce the memory footprint in the sequencer tab right click against each of the imported model names and select Promote Node Effects This will search through the node level On and Color Wash effects and if the same effect is on all the nodes at the exact same times it will be removed from the nodes and placed on the Model xLights Nutcracker page 143 Time 1 14 919 Insert Layer Above Insert Layer Below Play Model ArchS Export Model m Arch Toggle Nodes Promote Node Effects Edit Display Elernents 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 Sequence Settings O eeeeeee S Filename O Users d228081 Documents My xLights Sequences 2015Sequences P10T est xml
32. otter ta User Manual Intentionally left blank for all the missing models xLights Nutcracker page 1 Table of Contents Chapter One Introduction Acknowledgements Preface from Sean Meighan History xLights Nutcracker Chapter Two Quick Start Guide Chapter Three Installation Downloading xLights Nutcracker Windows Macintosh Linux Installing Windows Macintosh Chapter Four Tabs Setup Directories Show Directory Media Directory Lighting Networks Save Setup Add USB Add E1 31 Add NULL Change Delete or Delete All Test Convert Layout Build Model from Preview Schedule Running the Schedule Papagayo Coro faces option Images option Sequencer Windows Timing Tracks Models New Model definition Appearance xLights Nutcracker page 2 Names Strands and Nodes Custom Model definition Rename a Model Modify a Model Copy a Model Node layout Export csv Play Model Export Model Import Model Model groups Render All Timeline and Waveform Views Effect Presets Built In Effects Off Effect On Effect Bars Butterfly Circles ColorWash Curtain Faces Fan Eire Fireworks Galaxy Garlands Glediator Life Lightning Marquee Pixel Editor Matrix Drawing Tool Playing a video file as an effect Pinwheel Plasma Ripple Shimmer Shockwave Single Strand Snow Flakes xLights Nutcracker page 3 Snow Storm Spirals Spirograph Strobe Text Tree Twinkle Wave Adding a
33. page 92 Snow Flakes Effect Icon Sequencer representation fe Description The Snowflake effect paints a picture of falling particles i e a similar to snowflakes falling on snow Prerequisite information This effect works best with a single color selected Multiple colors can be selected and depending on the type of the snowflake either one color or multiple colors will be used Defines the relative of flakes that should be used for the effect from a small number to a large number Up To five different forms of flakes can be generated Controls the speed at which the flakes descend Accumulate Defines whether the snowflakes accumulate at the bottom of the effect or disappear It this option is selected then they will accumulate xLights Nutcracker page 93 Snow Storm Effect Icon Sequencer representation Description The Snowstorm effect paints a picture of particles blowing i e a similar to an ice or dust storm Prerequisite information One or multiple colors can be used for the effect Defines the relative of particles that should be used for the effect from a small number to a large number Trail length Defines and controls the length of the trail that the particles leave before fadin out Controls the speed at which the flakes descend xLights Nutcracker page 94 Spirals Effect Icon Sequencer representation M Description The Spiral effect provides diff
34. s the Aussie Sant Delete He s the Aussie Sant a Singing Face Position Singing Facet MTREE P10 Matrix i sill Hide All Move Up 6 66 6686 CAA E D Model Preview Model Preview The Model Preview window displays the effects on a model as the sequence is playing With the window open right click on the model name when on the sequencer tab and select Play model xLights Nutcracker page 135 Time 0 37 29 Insert Layer Above Insert Layer Below Play Model Export Model Toggle Nodes Promote Node Effects Edit Display Elements House Preview The House Preview window displays the effects of your entire display where the Part of my Display attribute of model has been ticked douse Prewiew Effect Settings The Effect Settings window displays the current or last effect that is being worked with If an effect on the grid is selected or a new effect dragged to the grid then this window gets updated with the current effect Use the window to modify the attributes of the effect as required The results of the change are displayed in the model window when selected and in the House Preview window when the sequence is played Effect Settings x Update F5 i al T gt xLights Nutcracker page 136 Colors The Colors window enables the user to change displays the current or last effect that is being worked with If an effect on the grid is
35. selected or a new effect dragged to the grid then this window gets updated with the current effect Use the window to modify the attributes of the effect as required The results of the change are displayed in the model window when selected and in the House Preview window when the sequence is played MMOOOo fa Ce ce fl i Sparkles p 20 A Brightness p 100 Contrast p g By clicking on one of the colors the color box will appear allowing you to choose or create any color you desire To create a custom color click on the Define Custom Colors gt gt button Color Eai Basic colors N Bee Z E pE E g BE REE EE ERE Eee ee EERE EE EEE SEE EH Bi Custom colors Sparkles Brightness Contrast Layer Blending xLights Nutcracker page 137 Layer Blending Blending E Morph Normal p 0 Fade In 0 00 Fade Out 0 00 tre m CL Persistent The first option of Morph is used with two or more layers If selected effect 1 will morph blend fade into Effect 2 midway through the timing interval in which the effects are placed The drop down list has 12 different blending Effect Dropper The Effect Dropper window displays all the supported effects and enables you to select a required effect and drag it to the sequence grid Effects x LI I x ial l it v m 5 F ith m a a m a m s z Mi E a rss F i Wi The same functionality can also be obtained using the effects from the effects win
36. t get the right options if something is highlighted xLights Nutcracker page 86 Pinwheel Effect Icon Sequencer representation rH Description The Pinwheel effect generates a rotating pinwheel arrangement or radial rays type of effect Prerequisite information None Defines the number of radial arms to be used for the pinwheel C Defines the outer circumference of the effect Controls whether the arms should be straight or twist clockwise or counterclockwise within the rotation Controls the color thickness of each arm e eera xLights Nutcracker page 87 Plasma Effect Icon Sequencer representation _ Description The Plasma effect generates cycles of changing color to give an illusion of a liquid organic movement effect Prerequisite information None Option Settings Description Color Choice Normal or 4 other preset values if Normal is selected then one or more colors from the palette can be used to define the colors of the effect Add Twist to Defines how much the components of the movementi e the ripple twists Effect Line Density Controls the thickness of each line of the ripples within the effect Controls the rate of change of the ripple movement within the effect xLights Nutcracker page 88 Ripple Effect Icon Sequencer representation 5 The Ripple effect generates a ripple like spreading movement of color similar to when an object is dropped into water
37. the circumference of the marquee that will be skipped b the pixel color ie will be dark If selected reverses the direction of the effect to counterclockwise Scale x y Used to control the scale i e boundary of the marquee effect Defined as a from 100 to 100 if Offset in Pixels is not ticked Defined as number of Pixels from 100 to 100 if Offsetin Pixels is ticked Offset in Pixels Used to specify exact number of pixels rather than for offset see Scale x y X axis Y axis Used to control the center position of the marquee effect within the model Center Used to warp the effect horizontally around the model xLights Nutcracker page 77 Meteors Effect Icon Sequencer representation a el Description The Meteor effect generates a number of meteor like streaks of color Prerequisite information None Colors Defines whether the Rainbow collection of colors is to be used for the effect or whether colo are to be selected from the Palette If Palette is selected then the colors used will be the one selected via the Color window for the effect Selects the direction of the meteors Eight options are possible including Up Down Implod Explode etc Controls the number of particles used for the effect Trail Length Controls the length of the tail of the meteor Swirl intensity Controls whether the meteor moves smoothly or swirls oscillates Controls the speed of the meteor effect Tip Hi
38. the model either clockwise or counterclockwise Used most effectively on models such as a mega tree or a matrix Prerequisite information One or many colors can be used for the effect If multiple colors are selected then the blades of the fan will be made up of the selected colors meee Blades Angle Angle of each blade from center Blades Elements How many segments each blade is divided into default is 1 Controls the swell i e the amount of time that the fan swells out Options Duration Options Acceleration Controls how quickly the fan swells out and then back in Options Reverse Reverses the direction of the rotation of the fan effect Options Blend Edges Each edge blends to black Turning it off converts the fan effect to a full circle at thee end of each swell xLights Nutcracker page 68 Tip Playing with the radius values i e making radius 2 less than radius 1 can provide some interesting effects Tip You can create four Fan effects that each take up about one quadrant of your model matrix house and have them all doing different thing with their arms blending at the edges The four positions would be x25 y25 x25 y75 x75 y75 x75 y25 xLights Nutcracker page 69 aa D Effect Icon Sequencer representation e Description The Fire effect creates an effect that appears as licks of flames Used most effectively on models such as a mega tree or a matrix Prerequisite informati
39. you do not have to create a model for that channel or channel range For example let s say within Unit 03 channels 10 14 are not used In which case you would create 9 Trees 1 9 and then another 2 trees for 15 16 This is different to the setup tab where you must cover the entire range of channels from 1 onwards The next step is to use the Layout tab to align the models the Trees as required Save the model definition Import sequence data Create a new music sequence add timing tracks and add the models you have defined to the sequencer tab Using the Import Import Effects menu change the Import file file to LOR Music Sequence LMS navigate to where the LOR LMS file is and select the file to Import On the Channel mapping screen add all the xLights Nutcracker models these will appear on the left hand side Do not select the Map by Strand CCR option in this case xLights Nutcracker page 169 a Double Click in the Channel column in line with the model name You will be presented with a list of LOR models as identified by the labels in LOR Select the channel and repeat for all the models Save the mapping first so that you can re use it later Click Ok to start the process After you which click on the Render All icon and play the sequence Tip If you were importing data from a Singing face where your model has multiple channels then you need to double click in the Channel column but agai
40. your show directory Lighting Networks Each Universe or section of Universe should be defined ensuring that the start and number of channels match your models Tip As described under Chapter Two Quick Start Guide you can start with a default set of configuration values and then come back to change or update the details before testing your lights physical output xLights Nutcracker page 17 Save Setup One you have your lighting network setup clicking on Save Setup will save your configuration If you forget to save don t worry you ll be prompted upon exiting xLights Nutcracker asking if you want to save your network setup Add USB This option is to be used to define a DMX Pixelnet LOR dongle D Light Renard or OpenDMX setup Each USB choice is described in the text found below the drop down selection As you select a different choice the text assists you in identifying the best choice for your USB dongle Leahey me A or LOR or D Light controllers in DMX mode tec DMX USB Pro Lynx DMX dongle king com or DIY Blinky dongle uld be 512 or less unless you are using gle in which case it can be up to 3036 Connection Details Port v Baud Rate Last Channel 3 rgb s Add E1 31 Clicking on the Add E1 31 button will display the following screen xLights Nutcracker page 18 2EDUSBSS 7S Re Sequencer Xmas 2013 Playlist 1 Pe 3 setup ee E Sets up an 1 31 connection over ether
41. 0 e of Strands per String Start Channel 1 From Output 1 Starting Corner Top Left Top Right Bottom Left Bottom Right Part of my display V Model Brightness y 0 Adjustment First Strand for Export 1 OK Cancel Appearance Names Faces Specify a Model name and the type of model Display as The supported types are Tree 270 Tree 180 Tree 90 Tree Flat Tree Ribbon Vert Matrix Horiz Matrix Single Line Arches Window Frame Star Wreath Custom Sphere 360 Sphere 2 0 Sphere 180 The Actual of Strings corresponds to the physical number of strings for that model Typically an arch or a candy cane will have one string but models such as a mega tree or a matrix will have many strings See the examples of a Mega tree and matrix below xLights Nutcracker page 39 a of RGB Nodes per String represents the physical number of light nodes bulbs or pixels of Strands per String is usually 1 except in the scenario where a physical string has been folded in which case it can be 2 3 4 etc The Start Channel defines the starting channel number for the first node of the model The From Output in most cases is set to 1 as default and the start channel is then used to define the absolute channel number However it is possible to use a different definition setup wherein The start channel for the model is calculated based on the start channel that is offset from this From Output
42. 0 E 6 5 E 6 6E 6 6 6 6 8 6 6 E 6 E E E 6 E E HE H6 E H vane ffect Settings x Update F5 W Model Group All iil Singing Face New Tet Linel Li i ine in Line2 Line3 Line P10 Matrix a MTREE Fnnt timac na Arches Group s i HouseHorGroup color X HouseVert Group v a w Ww a Icicles Group nH Pipes Group f fel fe fe t z a Spinner Group rae escrow Brightness wo Can p 0 Candy Canes Group p 4 p On the left hand side of the sequencer a list of open Windows are displayed To select additional Windows click on View Windows and select the windows that you wish to have displayed if the window is not open xLights Nutcracker page 35 a Ziaylist view Audio import settings Help BE Zoom In m me pS Dy thu Zoom Out ithe E N E a ZECCA ella Perspectives E Comanca Conv Windows gt Sequence Elements bo Model Preview TOKAI House Preview Views Effect Settings Colors Timing Effect Dropper Perspectives HonseHorGroun You can close a Window or move them around or if you have an additional monitor configured then one or move Windows can be moved to the alternate monitor The Windows are described in the View Windows section Tip You can save the windows that you normally have open as your default perspective These windows will then be opened when you load xLights Timing Tracks xLights Nutcracker can support mu
43. 07 24 15 gt 3 4 5 6 4 July 2015 Sun Mon Tue Wed Thu Fri 28630 1 2 5 6 T 8 9 1 13 14 15 16 19 0 4 22 2 27 28 39 30 7 a 3 4 2 6 OK Cancel Click on Schedule Playlist and you will be presented with a Schedule Playlist window Sage Tm Come lap Eberi Pee ee Dr l Fevietiing ky PL GS di a a Pada i rere AN a ried od Leng Pe Tae Hipi ha Petia Flip Tiaan ikri Change eat on ba ones Click on the Playlist drop down window and select the Playlist xLights Nutcracker page 29 a Select the start and end times the date or dates this schedule is applicable to and other attributes such as e Repeat whether the playlist should loop back and restart if the length of the songs in the playlist is less than the schedule duration Play first item only once This option is useful if you have an Intro to your show at the beginning Play last item only once This option is useful if you have a finale to your show at the end Random order Used if you want the events in the playlist to play in random fashion i e not sequentially Click on OK when done You must click on Save Schedule to save the schedule and any changes You can specify different schedules for different dates in your date range As an example to create a different schedule for the weekend repeat the steps above and select say a different end time for the Saturday and Sunday Click OK when done Friday July 24 2015 18 00 to
44. 1055 10699 11 1070 10849 Bottorn Left D Bottom Right 12 108 10969 13 11000 11149 Part of my di vy i art of my display E a 14 hus 11299 Model Brightness o 0 z 15 1130 11449 Adjustment aa First Strand for Export 1 OK ce LAppeamnce Nemes xLights Nutcracker page 46 2 A Candy Cane with a single channel string of about 20 lights in it The start channel address is 50 and since it is non RGB only one address is used The Display as is a Single Line Model Name CandyCanel Individual Start Chans Display As Single Line Start End Actual S of Strings 1 2 of lights per String 1 wa 1 Start Channel 50 From Output 1 Starting Commer Top Left Top Right Bottom Left Bottom Right Part of my display UI Model Brightness g 0 2 Adjustment Co Eea Cann tame 3 A vertical Pipe containing an RGB strip of 10 pixels The start channel address is 7250 The Display As is a Single Line Model Modea Name Pipel Individual Start Chans Display As SingleLine 0 Start End Type of String RBGNods LO 7269 Actual of Strings 1 Sof RGB Nodes per String 10 ma 1 Start Channel 7240 From Qutput 1 Starting Comer C Top Left Top Right Bottom Left Botton Right Part of my display Model Brightness J 0 Adjustment cme me 4 A horizontal matrix used to define a P10 panel matrix Each panel is 32 W x 16 H pixels and the panel matrix is 8 panels
45. 115 Vi ew Time 0 00 00 La HEH HHHH n S oe dont carn Breakdown Phrase Model Group All Singing Face New A list of words will be generated for the phrase in a timing track just below the phrase bevy ZA SUA SE FUU me 0 00 00 Hl n C a O s C L o L lt L lt dont care about Christmas i i Chri Model Group All Singing Face Mew Outline Eyes Open Eyes Closed O Mouth Top Lip Oval Mouth xLights Nutcracker page 116 Breakdown Words You can break down all the words into phonemes by right clicking on the Timing Track to the left of the Papagayo icon and selecting the Breakdown Words option This will breakdown all the words into phonemes or you can do this in sections ie Highlight a group of words right click and accept the Breakdown Word or Breakdown Selected Words option If the Breakdown Selected Words option does not appear ensure that your cursor is not pointing on a word otherwise you may only see the Breakdown Word option A list of phonemes will be generated for the word or words phrase in a timing track just below the word timing track View ou JU LUY SEW 334 Paha su sown IA Ime 0 00 00 ee ee ee ee oe AH N l l 22 i cont AH HEHE HEHEHE HER HE HE HEHEHE Model Group All Singing Face New Outline Eyes Open Eyes Closed O Mouth Top Lip Oval Mouth Middle Lip Bottom Lip Zoom in to see the w
46. 21 00 Xmas 2013 Playlist 1 Run Schedule 5 Saturday July 25 2015 l 18 00 to 22 00 Xmas 2013 Playlist 1 Save Schedule Sunday July 26 7015 18 00 to 21 00 Xmas 2013 Playlist 1 Schedule Playlist Monday July 27 2015 h Tuesday July 28 2015 Update Selected Items Wednesday July 29 2015 Delete Selected Items Show Dates Change Start o7 24 15 End 07 29 15 To change any schedule select the schedule item from the list and click on Update Selected items To delete any item select the schedule item and click on Delete Selected items Running the Schedule To run the schedule ensure that the Output to Lights button has been selected and click the Run Schedule option As each scheduled item is executed the log details are displayed in the window on the right You can clear the details by clicking on the Clear button on the right You can save the log detail by clicking on the Save button on the right You will be prompted for a file name for the log file xLights Nutcracker page 30 sir Favorites Name EE Desktop Ji Images J Downloads MatrixOverlay EL Recent Places SingingFace2 Jb SingingFacelmageC Date 21 07 2015 2 38 PM 14 07 2015 2 49 PM 11 07 2015 9 24 AM 11 07 2015 8 44 AM xLights Nutcracker page 31 Fapagayp setup Test Convert Layout Schedule Papagayo Sequencer The Papagayo tab enables you to import a Papagayo PGO file or files and convert the mouth mov
47. Copy First Voice 1 Voice 2 Voice 3 Voice 4 Model Name Singing Face Singing Face2 choose choose Face Outline 1 Mouth AI 5 8 J 1 73 F2 P29 aia 2 24 GS5 P7 Mouth etc 6 3 16 G8 P9 Mouth FV 5 4 8 K15 L18 Mouth L 5 5 18 C13 Tl Mouth MBP 5 A Marth O 4 5 Click on the Model name under each Voice Column and select the Model Name that the PGO file should map to In this example the PGO file has a Voice 1 and Voice 2 defined 6 Click on each of the subsequent entries in the column and select the channels from your custom model that the phoneme should map to In order to select more than one channel use the Ctrl key to select multiple channels and then press Enter 7 Click on Save to save the preset name so that the mapping can be re used later Note The Delete button is used to delete a Preset The Clear Grid is used to clear any details mapped so that you can start again and the Copy First is used to copy the Voice 1 column to all the other columns 8 Click on Click to Create New Sequence A message will be displayed indicating completion 9 Save the sequence 10 Click on the Open Sequence icon and select the sequence that has been created in the previous step 11 Click on the Render All icon and then play the sequence The Papagayo images cannot be edited once they have been added to the sequencer If you need to make any changes you have to do make th
48. Dan Kulp came on to the team and took over the development from Dave Dave went back to hardware design on his new Falcon 16 v2 boards xLights Nutcracker page 6 Document Version 1 00 Initial release xLights Nutcracker 4 2 1 08 2015 Additional content and new warning symbol 09 2015 New effects additional LOR information etc 10 2015 xLights Nutcracker page Chapter Iwo Quick Start Guide This section describes the steps required to use xLights Nutcracker for the first time to create a sequence The details of each step are covered in the respective sections covering that functionality 1 Download and install xLights selecting the defaults See Chapter Three Installation 2 Click on the Setup tab and set the Show directory and Media directory See Chapter Four Tabs 3 While still on the Setup tab setup a default network a At this stage the actual network does not matter as you can change the details later b You can click Add Null and define a block of say 10 000 channels to work with ensure that this is larger than what you will have in all your models or you can define them as E1 31 c For E1 31 click on Add E1 31 xLights Nutcracker page 8 h a sights 4 BEIA Ver 4 2 1 Aug 14 201 File Playlist View Audio Import Settings Help SPOehsSGirnwuaanmeo A BUNS WOR ROSLERams SECO Setup Test Convert Layout Schedule Papagayo Sequencer Xmas Al Directories Show Directory D
49. FEH HEH Model Group All Singing Face Mew Outline Effect Settings Eyes Open Eyes Closed Update F5 O Mouth l i Top Lip Faces Oval Mouth Mouth Movements Middle Lip z Phoneme Bottom Lip P10 Matrix Group S Timing Track Lyrics P10 Matrix MTREE Arches Group Face Definition SingleNode 7 Eyes Show outline The timings should automatically appear against each mouth movement View fo 2600 2500 O00 3100 3200 33 00 34 00 3500 Time 0 00 00 m a na La na a a CN A AA AN OL a AN E ANC E EE CO ee ee E O oe T E E 2 o yrics E a l Care about Chreimh a a Imme EU H t H E E E E HHH Model Group All Singing Face New Outline Eyes Open Eyes Closed O Mouth Top Lip Oval Mouth Middle Lip Bottom Lip xLights Nutcracker page 118 Repeat the process for the next phrase or group of phrases Phrases Lyrics for Voice 2 Similarly repeat for the next Voice by selecting another model Singing Face 2 and the next Timing Track Lyrics 2 When you drop the Face effect on the sequence grid select the second timing track Lyrics 2 as the Timing Track on the Effects option and proceed as described for Voice Tip If you wish to assign a group of phrases words phonemes from one Voice timing Track to another then against the model of the second voice Singing face 2 for the selected group of phrases Chorus
50. Follow the prompts and click on install when ready 6 Click on Finish to complete the installation The xLights Nutcracker software will be installed in the destination location In addition to the software required to run the application the installer also installs a few useful utilities dictionaries and a songs subdirectory The xLights Nutcracker application software 32 bit is installed by default in the xLights Nutcracker subdirectory within your Windows Program Files directory C Program Files xLights The location can be modified during the software install process by the user If you do not have Audacity installed on your computer then you should at least install the Queen Mary Vamp plugins for Audacity For the QM vamp plugin packages that can be installed without Audacity installed first download the plugin package zip file fow WIndows from the following address http isophonics net QMVampPlugins and install on your computer Macintosh 1 Double click on the compressed file that you downloaded MAC 4 1 9 tar 2 Drag the newly created folder containing the xLights Nutcracker application and associated files to the location of your choice The xLights Nutcracker application software folder is created in the same directory as the downloaded file xLights Nutcracker page 14 xLights MAC 4 1 9 tar y al s T e Ss yt xLights MAC 4 1 9 For the QM vamp plugin packages that can be i
51. Group from the layout tab click on Select Model Groups xLights Nutcracker page 51 Hle Flaylist view Audio Import Settings RBUSBeSSeai pt BONET OUARFEDE Setup Test Convert Layout Schedule Now playing D Users d22808 om Zz C J Select Model Groups Preview Models Arch B Arch3 Arch Arch Arrh Ee m From the Model Groups window click on Edit Groups xLights 4 BETA Ver 4 2 0 Aug 8 ile Playlist View Audio Import Settings Help BOeSBes r NIBM MAD Auw s ARH AE Model Groups Model Groups F Arches G Arches Group i Candy Canes Group a gt V Candy Canes Group Sid Group HouseHorGroup E v HouseHorGroup HouseVert Group v HouseVert Group Remove Group Icicles Group IV Icicles Group Lanterns Group 4 V Lanterns Group p V Model Group All l v P10 Matrix Group v Group Details Archi Arch2 Group Name Arch3 Arch4 QK Edit Grows Layout Mode Grid as per preview v Arch5 Arch6 Grid Size 400 CandyCanel CandyCane2 Add to Group Models in Group CandyCane3 CandyCane4 Garane Al i gt Models Save Model Width 50 i s SVM Model Height 50 g Update Group l 0 Click on Add Group to create a new group and replace the name of the group in the Group Name In
52. Nutcracker page 5 Chapter One Introduction hcknowleagements The developers and authors of this manual are volunteers A very special thanks goes out to our families for supporting us in this hobby Without your support we could not do this A very special thanks goes out to Matt Brown and Sean Meighan the original authors of xLights and Nutcracker Pretace from Sean Meighan Welcome to the xLights Nutcracker User Manual We hope that you will find the information that you need to make your Halloween and Christmas shows shine History xLights xLights was created by Matt Brown in 2010 Matt wanted a program that would reliably play his LOR show The original xLights was only a scheduler player It had sophisticated playlists ability to play videos mp3 and wav files Matt created a process to support Renard Pixelnet E1 31 Sacn LOR DMX and Open DMX controllers There was a built in CONVERT tab to change LOR Ims files into xLight XSEQ files Nutcracker 2 x Version 1 0 of Nutcracker was released on Feb 2012 by Sean Meighan Version 1 0 and 2 0 were a web based php application 3 x Matt Brown asked Sean if he could port the Nutcracker code into xLights in December 2012 The result was xLights Nutcracker 3 0 4 x Sean had discussions with Dave Pitts about making a horizontal timeline sound file waveform and drop effects Dave coded up the first Alpha xLights Nutcracker 4 0 in November 2014 In January 2015 Gil Jones and
53. P Mouth O Mouth rest Mouth U Mouth WQ Ds Users Di Users Users De Users Image Placement Eyes Open Eyes Clased Documents My Lights Sequences 2015Sequences Singi Documents My xLights Sequences 7015Sequences Singi Docurments My xLights Sequences 2015Sequences Singi Documents My xLights Sequences 2015Sequences Singi xLights Nutcracker page 112 WI ed Pa Pt LIVI Ld Sb Wa a Pa a t Node Ranges If Node Ranges is selected then the following window will be displayed Type in the list of node numbers pixel numbers for what should be turned for each movement Example 1 12 24 30 If Force custom colors is selected then a color to be turned on can be specified for each line in the definition by double clicking in the Color column to bring up the Color palette Face Definition Name SingleNode Node Ranges Force Custom Colors Click on Add and specify a name for the face definition Snowman Then select the image placement i e Centered or Scaled Then for each mouth position double click in the eyes open column you may need to double click more than once and navigate to and select the face image corresponding to that mouth position You can specify different images for the Eyes Closed position or by default the same image is copied across Click Ok when done xLights Nutcracker page 113 a Caution Images used for pictures and faces u
54. TREE 199R Ch 9795 MTREE 1996 ae Ch970 MTREE 1998 Twinkle 5 55 sell i m Choral MTREE SAR F Twinkle 10 Ch Og MTREE 22006 ChaT MTREE 2008 Twinkle 25 Ch S80 MTREE 1HR Twinkie 50 Ch S801 MTREE 2016 Ch S02 MTREE 2018 Shamarver E Ch 9803 MTREE 2028 Background Ondy 5 D L Ch SM MTREE 2026 Oh 2 MTREE S26 Oh Sa MTREE 203F Oh So MTREE 30 Oh 60 MTREE 22036 Ch fake MTREE SHHR Once you have selected a set of channels you can save this individual set up as a test configuration for future repeat testing by clicking on the Save button and specifying a name for that group of channels You can load a previously saved test configuration by clicking on the Load button Setup Test Convert Layout Schedule Papagayo Sequencer ee ee ere ee ee aoad Use Shaft click Ctrl click or click amp drag to select multiple channels Ch 9784 MTREE 1958 a Standard RGB RGB Cycle Ch 97853 MTREE 1 95R E Ch 9786 MTREE 41566 Select function Background Highlight Ch 9787 MTREE 1968 a of _ Ch 39789 MTREE 1976 Chase Ch 9790 MTREE 1978 Chase 1 3 Ch 9731 MTREE FISAR ani Ch 979 MTREE 1986 Ch9733 MTREE 1988 Chase 1 5 Ch 9794 MTREE 1998 Choos MIREE 1990 Ch 9736 MTREE 1098 Twinkle 5 TH f pripean Twinkle 10 Alternate Different test functions are available for RGB non RGB lights as well as the option to execute different test cycles You can also select
55. The controllers do not need to be physically connected in order of the controllers start address The controllers can be put in any order xLights Nutcracker page 161 R DMX Channel Setup Example LOR Controller 16 Channels DMX Start address 225 Last Channel 241 LOR Channel ID QF 1 BE BBB Bs a r d 4 a 1 ay i a HEFE I 1 yr ae AE ETET I a a ney iii 3 LED Section AE LOR Controller LOR CCR DMX Controller 16 Channels 157 Channels 27 channels DMX start Address 49 DMX Start address 65 DMX Start Address Last channel 64 Last Channel 221 Last Channel 34 LOR Channel ID 04 LOR Channel ID 05 Used with permission from FastEddy ACL Convert a LOR LMS file to play using non LOR hardware This section is based on a video created by Steve Giron The item to be converted is a purchased 12 leg CCR tree sequence The input file should be in LMS format Within xLights Nutcracker go to the Convert tab and from there Select Convert navigate to where the LMS file is and select it Select the Show Verbose Channel Map attribute Click on Start Conversion Error messages are expected for the first run in the status window on the right side Scroll to top of error messages and look at messages that says LOR Network xLights Nutcracker page 162 a Reading C 2727 LOR TSO DREAMS OF FIREFLIES 12 CCR no star2 lrms Reading L IR seq ence channel
56. _rgbeffects xml file in the models section Then update the channel assignment to your setup lt xIgb gt lt models gt model name Big Arch 1 DisplayAs Arches String lype RGB Nodes parml 1 parmz 60 parm3g 1 StartChannel lt model DisplayAs Arches Stringlype RGE Nodes parml 1 parm 50 parmg 1 StartChannel 6484 StartSide B eee ee ee SS Insert new models here ee ee ee E he ht me lt models gt lt effects version 0004 f gt lt gt Tip Use an editor that works well with XML Notepad is a free editor than can be used Ensure that after you paste the xml that the lt models gt end tag is returned to its original position on a new line If you leave that end tag at the end of the last model line it won t work Model groups Model Groups can be used to group a number of similar elements Arch1 Arch6 so that by dropping an effect at the group level the effect will be applied to all models that are part of the group It can also be used to limit what you see on the display by creating a group of selected models and then adding the group to the display on the Layout tab Tip Dropping an effect on a Model group will give different results to dropping the same model on all elements of the group because in the former case the canvas is treated as a whole matrix and then the effect is applied to the models within it Some effects work at the Group level better than others To create a Model
57. able by Control mouse wheel ZOOM OUT Also available by Control mouse wheel Type Type O EFFECT On f EFFECT Fire O EFFECT Off F EFFECT Fan u EFFECT On Fade Up g EFFECT Garlands d EFFECT On Fade Down p EFFECT Pinwheel m EFFECT Morph r EFFECT Ripple C EFFECT Curtain X EFFECT Text EFFECT Circles S EFFECT Spirals b EFFECT Bars Ww EFFECT Color Wash y EFFECT Butterfly n EFFECT Snowflakes Tip The On and Ramp Up Down effects also enables the intensity to be defined as a shortcut key Look at examples in the existing file which has a start intensity set to zero and and end intensity set to 100 xLights Nutcracker page 125 Chapter Hve Menus rile The File menu enables you to create a new xLights Nutcracker sequence open an existing xLights Nutcracker sequence Save Save As or Close a sequence that is currently open select a show directory backup xLights Nutcracker sequences to another directory and quit the xLights Nutcracker application These actions can also be done using shortcut keys and via icons on the top bar of the canvas MDE New Sequence To create a new sequence either use the New Sequence icon select New Sequence from the File menu or press Ctrl N The following screen is displayed Sequence Settings Wizard Info Media Me Musical Sry eN spel w a r 2TA Don t Create Sequence Note if you do change your mind about creating a sequence click on the Don t Create Sequence button
58. ake the first word ooky There is a box below the title Look up the pronunciation for a word or a sentence in CMUdict v 0 7a where you will enter this word Then click the Pronounce it button If a red dot appears with the phrase not in dictionary consider using the LOGIOS tool discussed above which is able to generate missing pronunciations by rule Then you need to click the LOGIOS link which takes you to the previously discussed web page Now that you have updated the user dictionary you should reopen Nutcracker and load the previously saved sequence and find the newly added dictionary words and do a right click Breakdown Word for the missing phonemes xLights Nutcracker page 123 The following now shows the results after adding the word honkey to the user_dictionary file ih F i i HA h PA a e N AATA ST Mwah Aaa iea a j ji H m 0 u mmm b xLights Nutcracker page 124 Shortcuts There are a number of shortcut keys that can be used for functionality or adding effects on the grid These effects are stored in the xlights_keybindings xml file and can be modified by the user Note that you must edit this file while Nutcracker is NOT running Changes will be lost when xLights Nutcracker closes as this file is saved upon exit each time t TIMING ADD Adds a timing mark to the currently selected position S TIMING SPLIT Splits the current timing mark in half ZOOM IN Also avail
59. and change background as well as highlight colors and control the speed of the function using the controls provided Note Output from the test tab is always in RGB sequence It actually turns on every 3rd channel i e 1 4 7 10 etc for red and 2 5 6 11 etc for green etc and then all channels for white A quick way to test your lights to ensure the correct RGB BRG GRB etc is set properly is to turn on channel 1 That should turn on RED Next would be to turn on channel 2 that should be Green and finally Channel 3 should turn on Blue xLights Nutcracker page 22 Convert Setup Test Convert Layout Schedule Papagayo Sequencer The convert function is commonly used to convert a sequence file from one sequencer format to the format of another sequencer or to the format fseq required to run via Falcon Player on a Raspberry Pi or BeagleBone Black controller It is not to be used to convert into an xLights Nutcracker sequence use the Data Layer or Import Import Effects options to achieve that Supported input formats are Selected output formats are xLights Sequences xseq LOR Music Sequences Ims aoe at he LOR Animation Sequences las Falcon Pi Player fseq Vixen Sequences vix Falcon Pi Player Sequences fseq lamt nhir sS Glediator Record File gled FA Sapa q Lynx Conductor Sequences seq K rn a E HLS hlsIdata Sequences hisIdata Vir Vixen 2 1 wir routine file LOR Sequence las or lm
60. annel 23 LOR Name CT3 WARNING CTS Ahh is empty INFO xLights Channel 24 LOR Name CT4 INFO xLights Channel 1 LOR Name CT1 INFO xLights Channel 2 LOR Name CT1 INFO xLights Channel 3 LOR Name CT1 INFO xLights Channel 4 LOR Name CT1 INFO xLights Channel 5 LOR Name CT1 INFO xLights Channel 6 LOR Name CT1 INFO xLights Channel 7 LOR Name CT1 Documentsi My xLights Sequences Blue Christmas Inputs SEQ SCTBLUEAMAS Ims Ahh Outline Eyes Open Eyes Closed Upper Lip Mid Lip Bottom Lip Oh Ahh Outline Outline Eyes Opeh Eyes Closed Upper Lip Mid Lip Bottom Lip Oh With the Show Verbose Channel Map selected the conversion messages display which channels have been converted to equivalent xLights Nutcracker channels This information can then be used to amend the channel mapping and or define additional LOR controllers as required xLights Nutcracker page 25 Layout setup Test Convert Layout Schedule Papagayo Sequencer The layout tab displays a full preview of your show and provides a view of how all the models will appear Setup Test Convert Layout Schedule Papagayo Sequencer Xmas 2013 Playlist 1 Open Now playing D Users d228081 Documents My xLights Sequences 2015Sequences It s Christmas Time Again fseq gt Y Size 1100x500 SetSize Image V Fill Background Brightness p Select Model Groups Preview Models Elemen
61. at Start When used with the stagger option the head of each morph will show prior to the morph moving based on the stagger interval Tip Open and use the Effect Assist window The window will display a grid corresponding to the x y start and end coordinates If you then grab a slider for the morph effect and move it the Effect Assist window shows exactly where the coordinate is being moved to making it easier to determine what is being done to the effect xLights Nutcracker page 80 Effect Icon Sequencer representation Hu Description The Piano effect displays a piano keyboard effects where the keys modulate based on the beat and frequency of the sequence audio the effect also supports representation on user defined shapes besides that of a keyboard layout Prerequisite information A Polyphonic Transcription notes file for the sequence audio you can use Audacity to create this file Procedure 1 2 a a 2 Oo Se Use audacity and for the sequence audio analyse and generate Polyphonic Transcription notes Export this label file and and save the file in your show song directory or any other suitable location Rename the file to notes txt Select the Piano effect and drop it as required on the sequencer grid against the desired model Click on the Shapes button Navigate to the xLights Nutcracker Installation directory then within that navigate to the piano subdirectory a_i x di t Computer
62. aud Rate or El 31 Univ Num Chann xLights Vixen FPP Mapping Enable E131 MULTICAST 30 512 Channels 11800 to 12311 Ves E131 MULTICAST 31 512 Channels 12312 to 12823 Yes E131 MULTICAST 32 512 Channels 12824 to 13335 Yes E131 MULTICAST 33 512 Channels 13336 to 13847 Ves E131 MULTICAST 34 312 Channels 13846 to 14359 Yes E131 MULTICAST 35 512 Channels 14360 to 14871 Ves E131 MULTICAST 36 512 Channels 14872 to 15383 Yes E131 MULTICAST 37 512 Channels 15384 to 15895 Ves E131 MULTICAST 38 212 Channels 15896 to 16407 Yes E131 MULTICAST 39 512 Channels 16408 to 16919 Yes E131 MULTICAST 40 212 Channels 16920 to 17431 Ves E131 MULTICAST 41 512 Channels 17432 to 17943 Ves E131 MULTICAST 42 312 Channels 17944 to 18455 Ves E131 MULTICAST 43 512 Channels 18456 to 18967 Yes El31 MULTICAST 44 512 Channels 18968 to 19479 Yes E131 MULTICAST 45 512 Channels 19480 to 19991 Yes E131 MULTICAST 46 512 Channels 19992 to 20503 Yes E131 MULTICAST 47 312 Channels 20504 to 21015 Yes E131 MULTICAST 48 512 Channels 21016 to 21527 Yes BBB definition On the LEDScape Octoscroller LED Panel page Enable LED panel must be ticked Start channel is 11800 This must match the model definition in xLights The panel layout is 2 x 4 The channel count is calculated The vertical arrows correspond to the Up Down physical setting of the arrows behind the panel P1 for each output is the panel that the output from the Octoscroller is connected to xLights Nutcracker page 157
63. ays 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 xLights Nutcracker page 154 Reset Toolbars Sequence Settings v Render On Save Tool Icon Size Grid Spacing a Grid Icon Backgrounds Grid Node Values a Render Mode gt Effect Assist Window Reset Toolbars The Reset Toolbar option when selected will reset the Toolbars to the default locations the next time xLights Nutcracker is started Help The help tab contains two options within it Content Fl Pressing F1 displays a Help or information window depending on tab the user currently is on Selecting the About option display a window containing xLights Nutcracker release information websites copyright and acknowledgements xLights Nutcracker page 155 Chapter Six Advanced features Configuring Matris Panels as Models In this example the setup consists of 8 P10 panels 4H x 2 W driven via a Beagle Black Bone BBB with an octoscroller running the Falcon Player referred to as the FPBBB Define a model P10Matrix or any name of your choice as a horizontal matrix Set of strings 64 corresponds to number of rows of RGB nodes per string as 64 corresponds to the columns and of strands per string 1 Starting corner Top Left The start channel has
64. been set to 11800 this will vary for your channel configuration and From Output is set to 1 xLights Nutcracker will automatically calculate all the start and end channels on the right C e r r a Medel Mame PDO Mirira Individual Start Chand Cuszom Model pt Heip Display As Horiz Matrix Simi Em Type of Shning RGB Modes 1 T1600 11331 i 2 1i Fae Actual Fof Snngs 64 j IHH 12375 4 17575 L67 fof RGR Modes pi Sring 64 5 13 zs 17760 13941 Fol Randi par anng 7 ii ETE Saat Channel 11800 z From Cutput 1 a ina DR 9 Lis IE Hate Come amp Tep Left Top Regt Mw LIS 13719 1 137 Erab Betiom Left Britiem Fanpht 1 13912 PIDIE 13 14104 iar Part o rey dispiay i 14 u itib Model Eraghtness a 15 Iug ae Adprin 16 1 LETI 17 14877 15063 DE Cancel Appt Manii Faced LE 154 TEEN 19 L 13447 F Ga F Tip The starting corner must be set to Top Left irrespective of how you configure or connect your panels on the BBB xLights Nutcracker page 156 On the xLights Nutcracker Setup tab what you define is not relevant as that information is not carried over to the FPBBB You must however ensure that the channel ranges are covered Therefore you can define them as E1 31 or define a block of channels of type NULL Note If wishing to use the Falcon Player in Bridge mode then the channels pertaining to your matrix must be defined as below and match your model i e they cannot be left blank Network Type Port B
65. ch you then want to be overridden by the imported data layer Using the Up Down buttons allow you to determine which layer will take precedence over the others The highest layer will render last i e on top of the others and so forth Re Import Use this function if you wish to re import and overwrite an imported data layer Normally required if the source i e LSP LOR sequence has been amended in any way and you wish to overwrite the previous import without affecting any other effects that may have been added to the sequence within xLights Nutcracker Select the data layer and click on the re import function after which functionality is the same as the Import function xLights Nutcracker page 151 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 Sequence Settings Render On Save Tool Icon Size d Grid Spacing Grid Icon Backgrounds Grid Node Values Render Mode Effect Assist Window Reset Toolbars 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 ribbo
66. d Click Yes to proceed Every time this step is executed a copy will be created of all the xml files from your show directory into the Backup subdirectory of your show directory A new subfolder is created each time a backup is executed Tip It is a good practice to also separately backup any files that you may have used as inputs to your sequences such as LSP LOR Papagayo files that you imported media files that may have amended with audacity gif or jpegs etc You may also wish to backup any fseq files though this can be recreated by saving the sequence again Backing up the show directory and media directory if it is different to an alternate location is the simplest way to ensure that you have the files required Quit To quit xLights Nutcracker select Quit from the File menu or press ALT F4 If you have a sequence open and the sequence data has not been saved since the last change you will be presented with warning xLights Nutcracker page 130 lt If you click No then you will be returned to the sequence If you select and click Yes then the sequence will be closed without any sequence changes being saved Playlist Playlists are created to be used within the xLights Nutcracker scheduler if you plan on using xLights Nutcracker to run your show rather than the Falcon Player on a Raspberry Pi Add To create a new playlist click on the Add button and provide name for the Playlist in the pop up window
67. d 1 Bode 7 Arzal Stand 1 Made ral Stand l Modes Aral and 1 Aloche 10 Arzal Stand 1 Hace T1 rzal Stand 1 Mode 1 Arzal Stend 1 Nade 13 Aral Stend 1 Hode 14 Aral Stend 1 Node 15 Aral Stand 1 Nade 16 SE Cancel Load Mapping Save Mapping Tip Multiple models can be selected i e you can select another Model Arch 2 and Click on the Add Model for Import again 4 Tick the Map by Strand CCR option to select an entire strand or multiple strands to import at a time Otherwise by not ticking the box you can must select individual nodes to import The individual nodes will disappear and only the first two rows i e model name and Strand name will be displayed 5 Double click in the Channel column against the row that says Arch 1 Strand 1 You may need to double click more than once A drop down list of LSP or other sequencer channels controller strands is display Select the required channel controller strand xLights Nutcracker page 141 a iDESAAA P NEMM Am sbARM 499 ODON Map Channels Candy Cane 1 Candy Cane 2 Condy Care 3 Condy Cane dl Fence Arch 1 Fence Arch 2 reace Arh 3 Fence Archd Fence feck 5 Fench Arch amp tress Serge Gutter H Gutter Left Top 44 H atier Faght Tap El H Hor Lett B5 H Hee Hid Raghk Cal H Righ CS H Wertical Let Bcttom 2 6 Select the required model and press enter You can repeat this for multiple models 7 C
68. d blue circles they would turn a dull green where the circles overlap Bottom Top Effect 2 will appear on the top half of the model Effect 1 will appear on the bottom half of the model Left Right Effect 1 will appear on the left half of the model Effect 2 will appear on the right half of the model Tip Put two effects on a model and step through each of the layering modes to see what they will look like Experience is much better than reading about it xLights Nutcracker page 108 Layer Blending Morph rs ri He 4 ing Blending o g Fade In 0 00 Fade Out 0 00 Persistent This is not to be confused with the Morph Effect This is a layering option that can be applied to any two effects The morph option of layer blending will magically make effect 1 morph into effect 2 during the length of the timing cell that the effects are in You will not see effect 2 at the beginning of the timing cell and you will not see effect 1 at the end of the timing cell Somewhere near the middle you will see the effect 1 morph into effect 2 Layer Blending Mix Slider DI 7 ding Blending E Morph Ss Fade In 0 00 Fade Out 0 00 anj omj am Ce E Persistent This slider adjusts the level of each effect in the combined output of the effects You can use this to just put a hint or more of one effect on another xLights Nutcracker page 109 Layer Blending Persistent Layer Blend
69. d cells live and die xLights Nutcracker page 75 Lightning fi a I Effect Icon Sequencer representation l Description The Lightning effect generates a vertical lightning bolt type of effect Prerequisite information One or multiple colors can be used for the effect White is always selected for the outer edge of the lightning bolt Option Settings Description Number of Segments Defines the number of zig zag segments to be used i the effect Width of Bolt Controls the width of the zig zag A value of 1 will form a straight vertical line Forked Lightning Y N Controls whether the effect generates a forked efefct Top Location x y Defines the coordinates of the top end of the lightning bolt X Movement Controls the movement of the lightning effect horizontally across the effect Can be made to be stationary or move in either direction xLights Nutcracker page 76 Marquee Effect Icon Sequencer representation mH Description The Marquee effect displays scrolling lines or bands of pixels around the edge of an model or from one end of a line to the other Prerequisite information One or multiple colors can be used for the effect If multiple colors are selected then the bands of the effect will be sequentially selected from the colors chosen Controls the proportion wise of the circumference of the marquee effect that the pixels will light up Controls the proportion wise of
70. d dragging one edge of the effect highlighted most commonly the bottom right corner to provide a Chase effect You may need to use Toggle Nodes to view the nodes so as to be able to strect an effect Tip A simple way to do a chase effect is to select a block of cells and hit d for a fade down or u for a fade up If you then need to adjust it drag the end line Copy Paste Delete Effects In order to copy and paste an effect select the individual effect right click and then select Copy Move the cursor to where you want the effect to be copied to right click and select Paste You can also press Ctrl C and Ctrl V to copy and paste the effect In order to copy and paste a range of effects use the cursor to highlight and select a range of cells Then copy followed by paste Tip The copy works on copying effects and not copying grid locations Therefore it will copy the first effect from with the range highlighted and accordingly will paste that effect and others after it that were selected at the grid location when Paste is selected You can delete an effect by selecting the effect in the grid and pressing delete on your keyboard Tip In order to delete multiple effects use the left mouse key to highlight a range of cells and then press delete You can also right click on an effect and choose delete Undo Effect xLights Nutcracker page 105 a Many but not all effect actions can be Undone by Right Clic
71. d the model either clockwise or counterclockwise Used most effectively on models such as a mega tree or a matrix Prerequisite information One or multiple colors can be used for the effect If multiple colors are selected than the spiral will be made up of the selected colors Options Settings Description Defines the x and y coordinates of the center i e focus point of the galaxy effect Defines the lower radius of the galaxy me e me Controls the upper width of the spirals Options Blend Edges Each edge blends to black Turning it off converts the galaxy effect to a full circle att end ofthe rotation Options Inward If the spirals overlap it determines if the spirals will appear to be moving inward outward If there is no overlap this setting will have no effect xLights Nutcracker page 72 Garlands Effect Icon Sequencer representation Era Description The Garland effect creates an effect that simulates a circle of rings that drop on each other depending on the direction of the effect Prerequisite information One or multiple colors can be used for the effect If multiple colors are selected than the spheres will be made up of the selected different colors Garland Type Controls 4 different type of garland effects s Controls the spacing of each cycle of the garland Controls the number of complete cycles of the effect in the given timeframe Stack Direction The direction in which the garland ef
72. dden under the effect drop down box is a meteor type called Icicles xLights Nutcracker page 78 Morph Effect Icon Sequencer representation Description The morph effect creates a movement across a model of one or many strands of lights with a head body and tail Morph looks best on megatrees arches and matrix models Prerequisite information The first 2 colors chosen will be the head color middle 2 colors chosen will be the body colors and the last 2 colors chosen will be the tail colors A morph can start anywhere and end anywhere on a model The starting and ending locations are specified by the X Y coordinates on the Start End tabs essc Desert Morph These options allow the user to quickly choose a commonly used morph type and Quickset Options direction These are customizable after they are selected xLights Nutcracker page 79 Head Duration Defines how long the head will show during the morph before it changes to the body colors Defines a non linear speed for the movement of the morph Repeat Count This is used when selecting a single morph and you want it to repeat x number of times Repeat Skip Sets the number of legs on the model that the morph will skip when the repeat option is enabled Stagger This is used in conjunction with the single line morph and repeat It can be set to positive or negative values for left or right sweeping type morphs Small values look best 1 4 Show Head
73. displayed in the Add to Group window Use the arrows to add or remove models as required and click on the Update Group when done To remove a Model Group select the Model Group and click Remove Group This will not change or remove any of the underlying models however any effects that have been placed at the group level on the sequencer will be removed and the Model group will be removed from the Layout display if it has been added to that display xLights Nutcracker page 53 a _Stars Group Insert Layer Above Starsl i Insert Layer Below Stars Stars2 Play Model Starsd Export Model Arch Toggle Models Arch3 Arch4 Edit Display PEELE O M Tip When on the sequencer tab If you right click on a Model group the window will display a Toggle Models option which will display all the models under the Model group or hide them if you select the option again You can also double click on the Model Group to obtain the same results Render All The Render All icon is used to force a render of all effects that have either been created a within xLights Nutcracker imported via the Import Effects function or has been imported as a Data layer Rendering order The Data Layer order renders bottom to top Therefore what is on the top layer will be done last much like painting the last brush strokes are on the top Model layers also render bottom to top Therefore the bottom layer will be rendered first then th
74. dow BUNS OeaR ROBLES 2ECOSSRE ees Effect Assist The Effect Assist Window is an additional window that helps you determine how an effects is being drawn via a panel view xLights Nutcracker page 138 For example if you open this window against a morph effect the windows will display a grid corresponding to the x y coordinates If you then grab a slider for the morph effect and move it the Effect Assist window shows exactly where the coordinate is being moved to making it easier to determine what is being done to the effect fect Assist You can also grab a corner of the image in the Effect Assist window and move it and have the slider values update in real time Perspectives The Perspectives Window enables you to save your current windows is an additional window that helps you determine how an effects is being drawn via a panel view hudio Speeds This function enables you to to play the audio during sequencing at normal speeds or at slower speeds r Audio Import Settings Help J Play Full Speed Play 3 4 Speed Play 1 2 Speed Play 1 4 Speed Click in the waveform and then select one of the speed options Click Play The audio will then be played at the selected speed and the vertical visual indicator will move along at the speed being played To return to normal speed select Play Full Speed xLights Nutcracker page 139 Import Fle Playlist View Audio Import Settings Help Import Effects
75. e You can also import timing marks created externally the most common being those created via Audacity In order to do this right click on a timing track Time 0 00 00 Add Timing Track Delete Timing Track Sinan Miaa Import Timing Track Singine MTREE Edit Display Elements HouseHorGroup HouseVert Group and select Add Timing Track or Delete Timing Track To import one that has been created externally select Import Timing Track navigate to the txt file containing the timing track and click OK to import it Tip Timings are created just like effects which means they have a duration Every timing effect has a starting edge and an ending edge So you can have a timing effect that goes from 1 to 2 seconds and then another from 3 to 4 seconds with nothing in between 2 and 3 seconds If you want one in there just select a range and hit t then drag the edges over to connect to the existing timing effects Models A model in xLights Nutcracker defines the entire required characteristic about a single physical element of your display Typically it will represent a common item such as an arch a matrix a straight line flood light as well as more esoteric and custom made items such as singing trees candy canes a snowman etc xLights Nutcracker page 37 It defines the type of lights the number of channels and other characteristics required to render the sequence data When a model is defined it is retai
76. e centre of the screen Occasionally it may display at the bottom left corner of the screen In which case at the bottom left corner of the screen a few lines will be highlighted in blue Select and drag those lines to the center of the screen resize and rotate as required and then place in the correct position If you cannot grab the model try increasing the Model Size and Model Rotation values until you can grab and drag the model c Save the layout progressively and when done 6 If your model does not display in the list or you do not want it displayed in this layout click on the Models button and change the Part of my Display attribute accordingly 7 The Preview Model list will list all the models which has the Part of my Display attribute selected along with the Srat Channel and End Channel for each model You can sort on any of the columns by clicking on the column heading itl Select Model Groups Preview Models Select Model Groups Element Start Ch End Ch review Models Matrix 1 7500 Mega Tree 7600 9099 Element Marne 7 Archi 6c Mega Tree 9100 10599 Arch2 ec Arch3 61 Arch z ArchS 62 Arch B aw Dor F 8 If the Overlay checks enabled attribute is selected when you click on the model name in the list it will turn yellow in the layout display to the right If there is a channel overlap with any other model then the other model will turn red 9 You can also use Model Groups
77. e changes in the PGO file and reimport Note You can then add additional models to the sequence drop effects on them and continue as usual xLights Nutcracker page 33 Images option Note You need to pre create an image for each mouth movement The first few steps are common to the Coro face option Then at step 3 Same as step 1 above Same as step 2 above Select the Output Type Image faces Preset Name this defines the mapping between the phonemes and your custom Singing face mapping You can save one or multiple mappings for future re use When using this for the first time Select add new and enter a Preset name when prompted Pwn gt Pi Piet fe dee ieee ee Pp Toetae PFHieaweoc A SBARHB 4 49 OECOY ee Coogee Piikin Fee eto eb ebb ee Deha eh eee ee de ee ee eeeeepee j eee ee i Taiari F agai kyt l i ry thy Ma Dp rars k F4 Bhl bhp oe Fe Ei ki i u A a mh i Tome piped pr E p oe ikp mene md ee omaga im mia ee ey er Pake el r F FPH ER F I Bojar Pgri epee mma gt Lil le i all ois la Fy Cee ph Cente p Ree 5 Click on the Model name under each Voice Column and select the Model Name that the PGO file should map to In this example the PGO file has a Voice 1 which is being mapped to a P10 matrix model 6 Click on each of the subsequent entries in the column and select the images of each face 7 Click on Save to save the preset name so that the mapping can
78. e g 20 0000 NULL Copy the music file to the new folder If the music has been edited and you own the original music it is ok for you to have a copy of the edited file xLights Nutcracker page 142 a Open the sequence click on Render All or Save and then play it You should be able to see how the lights flow in the layout window Study the sequence and determine which models you wish to copy to your own models Tip Print out the model names from the shared sequence as you will need to know those when you import Look for the correct quantity of elements in the donor sequence that will match your elements For example If you have 4 windows but the donor sequence has 8 pick the 4 windows that you want to copy Make a note of the names of each donor model you want to copy to a model of your own layout Watch the sequence several times step 2 Copy just the xml file of the donor sequence to your own show directory Make sure you have the appropriate music file in your own media show directory Close the sequence you were watching go to the setup tab and change the show and media directories back to your own directories If importing into a new sequence then e Create anew musical sequence select timings and add your display elements or select a view e Save the sequence Else Open the sequence you want to import into Select Import Import Effects and select a type of xml Select the donor sequence xml Click
79. e layer above it and do on until the top layer is rendered last However the Models themselves render top to bottom based on how they are laid out in the Master View of the sequence So the top model is rendered first then the next lower model until the last model is reached This is important to keep in mind when you have multiple models or model groups mapped to the same channels such as whole house model group and regular models xLights Nutcracker page 54 Rendering Order based on Master View Model DataLayers Render Order Tip You can change the order of data layers by moving them up or down You can similarly change the order of layers within a model And you can also change the order of models in the master view Timeline and Waveform The top section of the display window is the Timeline section and indicates the scale that the waveform and sequencer is displaying xLights Nutcracker page 55 You can select an area on the timeline depicted by the arrows and you can then play that section once independent of the section highlighted to be played on the waveform At the end of playing that section the highlighted arrows disappear leaving the waveform highlight to be played Clicking anywhere in the timeline or highlighting an area in the timeline initiates auto play without losing the waveform selection The waveform displays a sonographic representation of the audio portion of the media that has b
80. e sequencer tab with the cursor on Timing Track section to the left of the sequencer grid right click and select Edit Display Elements Time 1 14 919 Add Timing Track Delete Timing Track Arch2 Arch3 Import Timing Track Arch4 Edit Display Elements ArchS xLights Nutcracker page 10 From the Sequence Elements pop up window select Master View and click on Add Models Select the Matrix model created Click on Add then close the two windows You should end up with a model added to the sequencer PLO Matrix j Select an Effect as an example the Butterfly effect from the Effects grid and drag it to the sequencer Click on the Render all button k Click on Play to start playing the sequence The effects should display in the Model Preview Window if it is open or in the House Preview Window if that is open Click on the Save Icon to save the sequence and give it a name when prompted Tip To Open and select Windows click on View Windows and select the Window s that you wish to have open m Next click on the Layout tab Click on the Save button below the Models button n Model Groups are described in the Model Groups section however to get going click on Select Model Groups Edit Group Add Group Replace the New Model group with a name such as All Models Then select the model P10 Matrix that you created above Use the right arrow to move it to the Models in Group section Clic
81. e you can then increase that brightness when displayed in the preview Since the preview displays the raw FSEQ data having the model brightness at 40 or something can result in the preview being hard to see kind of dark so increasing the Preview brightness can overcome that e Individual Start Chans For models with multiple strands or elements you can specify the start channel for each strand individually if required This is useful where the channel numbering is not contiguous Appearance The Appearance setting is used to determine how a particular element is displayed when viewed in the Layout House Preview and Model windows By increasing the Pixel Size the appearance of the element a flood or any other small element can be made to display a bigger size The transparency values can be used to adjust how opaque or transparent the element is on the display xLights Nutcracker page 40 Pixel Style Transparency p Black Transparency p Preview Brightness Names Each strand and node can have a name assigned to it This is useful where for example you have single channel models that are grouped together singing faces tombstones etc On the sequencer double clicking on the strand reveals the nodes with meaningful names against them Node Names Outline Eyes Open Eyes Closed O Mouth Top Lip Oval Mouth a Bottom Lip xLights Nutcracker page 41 Strands and Nodes
82. ect Chase colors Chase Chase Size Defines whether the Rainbow collection of colors is to be used for the effect or whethe colors are to be selected from the Palette If Palette is selected then the colors used will be the ones selected via the Color window for the effect Defines the size of the chase effect as a percentage of the total length of the model that will be on during the chase Skips Band Size Skips Skip Size Skips Starting Position Skips Number of Advances Skips Direction Defines the relative size from one to twenty of the strand that will be on Used in conjunction with the Skip Size Defines the relative size from zero to twenty of the strand that will be off Used in conjunction with the Band Size Examples A Band Size of 1 and Skip Size of zero will have the entire effect on A Band Size of 1 and Skip Size of 1 will have half the effect on and half off A Band Size of 2 and Skip Size of 1 will have half the effect on for two units and off for one unit Used to define the starting position of the first part of the strand that will be on Advancing this value advances the component of the strand that will first turn on This defines the relative value of the number of units that the effect will skip before turning on A value of zero will force the effect to be stationary in one position Defines the direction of the skip i e Left right From Middle or To Middle xLights Nutcracker
83. ed After the LOR USB row add in universes of 510 for the E68x controllers scenario 3 A user is using comm 4 and the USB to ethernet dongle How should they be configured Network Type LOR Port COM4 Baud rate 57600 Num channels 160 as example Note Baud Rate of 250000 is for DMX only Scenario 4 A user is setup is a mixture of LOR and DMX Channels i e intermixed LOR DMX LOR DMX LOR Controller 1 LOR Controller 2 LOR Controller 3 DMX Universe 1 ch 1 126 LOR Controller 4 LOR Controller 5 DMX Universe 1 ch 127 183 How should this be configured Option 1 Use Universe 1 for all the LOR and DMX channels Since the DMX is already set channels 1 183 add an LOR entry with Universe 1 starting at 184 until the last channel for controller 5 16 x 5 90 for a total of 274 total channels You can reserve additional channels should you need them later upto 510 512 xLights Nutcracker page 171 Option 2 Keep it simple with DMX Universe 1 LOR Universe 2 and then start with Universe 3 with the RGB controllers Tip All the channels in LOR must be mapped exactly including blank ones in between Setup your AC LOR channels first in XL4 and then start with your first prop in the same order as your LOR sequences Otherwise the convert process will indicate that channels are unmapped Tip LMS to xLights Nutcracker XML via Import Effects is done via model mapping so channel numbers don t matter However
84. ed from the Perspectives window Audio Import Settings Help Bice i Ge i D oom Out i LECL ELMS p Perspectives Save Current Windows Edit Load Windows There are a number of windows that enable simultaneous display of different views in xLights Nutcracker When xLights Nutcracker first loads a default set of windows are displayed Which windows are open can be controlled via the Windows menu by selecting View Windows and then clicking on the required window to open it The window is dropped by default on the left side of the screen however each window can be moved and docked to alternate locations on the same screen or moved to an alternate display screen if connected to your PC MAC View Audio Import Settings Help Zoom In il m kid Bi a Zoom Out BP El a 2M Perspectives i Eala Mansana Enmen k Windows Display Elements Model Preview House Preview er View Effect Settings nd View Colors Timing Effect Dropper odele Effect Assist iming Model mported Timing Perspectives xLights Nutcracker page 134 Display Elements The Display Sequence Elements window enables views Timings as well as models to be defined and updated Functionality for these functions is described in the Views Timings and Models section of this document Sequence Elements View Add Views 2 Master View Second View Delete View Timings Models Timing Model Imported Timing He
85. ed in LOR and channels 33 48 belonging to Unit 03 are the ones that we are interested in Ghostbuster Halloween _I0iins Montetiash Hallewen J01ilvs lt Werewolres Of London kms xLights Nutcracker page 166 a On the xLights Nutcracker setup screen the corresponding channels must be defined You can define it as a USB with a network type of LOR and set up the COM port obtained from the LOR device manager and you will need to try different baud rates i Network Type protecal LOR te LOR controllers attached to amy LOR dongle thew D Max of 8 channels at 9600 baud inhi L Sw SUU Max of 48 channels at 57600 bawd ee Sede Max of 96 channels at 115200 baud Medal Run your controllers in DIM mode for higher throughput ncing ATV Lighting Connection Details Save E E1 30 line Port 2 Not Connected Baud Rate 86 COMI COME Add Last Channel rgb COME rude COMI cOM Cancel ch COM COME coms Delete WACOM 10 VWACOMTI Delete All WACOM 12 a WACOM 13 WACOM 14 WACO S VA COM TE VAC CTT ACOA 1 VAC TS Asias nni However there is sometimes a lag associated with the sequence when you use this option It is preferable to use a DMX to E131 bridge if possible and then define the channels as E131 xLights Nutcracker page 167 lighting Pletwecaies Network Type Fart Rsud Fate or E1 31 Unin Num Chann Lights Vien FPF
86. een associated with the sequence You can control the focus of the waveform e Zoom in on the waveform by double clicking on the waveform Keep double clicking until you ve got a zoom setting you can use Or click on the button AA e To zoom out hold the shift key and double click on the waveform or click on the button Tirne 0 06 743 Singing Face gt la oP When playing the sequence a vertical line indicates the start position and another vertical line extending right through the grid indicates where the audio being played current is The time counter displays the time from the beginning of the sequence that the current position is up to xLights Nutcracker page 56 You can highlight a range on the waveform to play only that section If you move your cursor on the waveform towards either edge of the highlighted area a hand appears and you can use that to move the edge e f the Pause button is selected and then pressed again the sequence will restart from the current position that it stopped at e lf after a Pause if the Play button is pressed then the sequence will restart from the marked Start position Clicking on the Stop button will reset the start position to the beginning of the sequence After Stop has been pressed the Rewind button will start from the beginning of the sequence and the fast forward button will play from the last component of the sequence e Highlighting a porti
87. ement phonemes into effects in xLights Nutcracker for Coro faces mouth movements on a matrix or mega tree Tip Use the native functionality that has been added to xLights Nutcracker to create mouth movements effects for Coro faces or a matrix This functionality has been retained for historical reasons Prior to this step ensure that you have created and saved an xml sequence that at least has the channels to which you will map the mouth movements defined For example if mapping a single voice to a Coro Singing Faces element then create a xLights Nutcracker sequence with that model defined and save the sequence Download v1 3 5 3 from nutcracker123 com nutcracker releasesipapagayoMOD_1 3 5 3_win32 rar 1 Select Fapagayo Input File 2 Select Sequencer Outout File 3 Choose output type ichoose Choosethe output type 4 In the grid below configure how phonemes and face parts are rendered Presets allow settings to be saved and reused again later Preset Name choose X fa Delste Cea Grid Copy First Voice 1 Voice 2 Voice 3 Voice 4 ModelName choose choose choose choose Face Outline Mouth Al Mouth E Mouth etc Mouth FV Mouth L Mouth MEP Math oO Insert Rests Mnimum gap max set Eyes random blink Auto fade each face after set Eyes random let tight Scaled pictures 5 Click to Create new Sequence 1 Open xLights Nutcracker and click on the Papagayo tab Select the PGO file by clicki
88. equencers 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 xLights Nutcracker page 148 e Save it an fseq file is created and run it within xLights Nutcracker or via the Falcon Player e Add xLights Nutcracker effects to new models via the sequencer e 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 This conversion is done in two places e When you a import a data layer e When you press the Render All button Note The purpose of Render All is to render all the effects and data layers to the sequence object without saving to disk The already imported ISEQ file data is used If the source LMS SEQ HLS etc file is changed then you need to go to the Data Layer tab click on that layer and select the Re Import function Import Before using this function a new sequence should have been created or an existing Sequence opened From the Main Menu tab select Sequence Settings and then Data Lay
89. erent representations of two and three dimensional spirals and helix Prerequisite information One or multiple colors can be used for the effect However this effect looks best with at least two colors selected Palette Rep Defines the number of times between one and five that the selected colors are repeated during the duration of the effect Spiral Wraps Controls the vertical orientation of the spiral A value of zero is used for vertical lines and the spirals can be adjusted to lean towards either direction Controls the thickness of the strands of the spiral Controls both the speed and direction that the spirals will move Blend If set then all the colors selected are blended together in each strand of the spiral If not set then each strand uses a different color If set will provide a 3D type of effects Grow The width of each spiral will grow slightly per cycle as it spins Shrink The width of each spiral will shrink slightly per cycle as it spins xLights Nutcracker page 95 Spirograph Effect Icon Sequencer representation eH Description The Spirograph provides an effect described or formed by rolling a circle inside or outside of another circle The point is placed at any point on the rolling circle Prerequisite information Only one color can be used for the effect Defines the speed at which the spirograph will move R Radius outer circle This defines the radius of the outer or fixed circle that i
90. ers Sequence Settings A ee a aa a Info Media Meta Data Timings Data Layers Layers to Render rl Nutcracker i Import Delete Move Up Move Down i i i Click on Import navigate to where your input file LMS LSP etc is change the file type as required and select the file to be imported Click ok xLights Nutcracker page 149 Hera E ising d kl ii few Cems A Veer i ey aes el in LBL CAST Gal no ELL CAST iL Ge BRA GALS I Gin iia Pala SP i aii ji ki 2 i i karap 8 S Pileh CRgewephy To ar TH Ph me pia TID m TAT Sedience Settings A Info Media Meta Data Timings Data Layers Layers to Render E Muteracker E Feliz Navidad_3 seq Source D Users c Documents My xLights Sequences Feliz Navidad Inputs Feliz Navidac Data waiting for file conversion gt Number of Channels lt warting for file converssion gt Channel Offset 0 4 m Import Delete Mowe Up Fue Imipert C o ELS MULTICAST 75 On completion of the import the Data layer details and the number of channels imported to the data later will be displayed The file has been imported converted and stored in an iseq file The normal and default option is for the xLights Nutcracker layer to be on the top and the imported sequence data represented below it When rendered the data is rendered from the lowest layer upwards so the xLights Nutcracke
91. es from the shape of the data flow diagram in the radix 2 case The earliest occurrence in print of the term is thought to be in a 1969 MIT technical report The same structure can also be found in the Viterbi algorithm used for finding the most likely sequence of hidden states xLights Nutcracker page 63 Circles Effect Icon Sequencer representation I a Description The Circles effect creates solid sphere like objects that move seemingly in random fashion on a model Used most effectively on models such as a mega tree or a matrix Prerequisite information One or multiple colors can be used for the effect If multiple colors are selected than the spheres will be made up of the selected different colors isk aeeieen eens rome tess O Causes each circle to blur and have its edges fade to black Tip Place the effect to initially span at least a few seconds After placing the effect on the model adjust the number of circles and the speed down until the circles can be seen moving around and then adjust upwards as required Tip Place the Circles effect on a star and select the Radial option to obtain a nice looking effect xLights Nutcracker page 64 ColorWash Effect Icon Sequencer representation es a Description The ColorWash effect creates a wash effect of the selected color or colors across the model Prerequisite information One or multiple colors can be used for the effect If multiple col
92. escription The Pictures effect is used to import a supported image type gif bmp jpg etc and render that image as an effect while also allowing the image to be manipulated and edited within xLights Nutcracker Prerequisite information The image that is to be imported Procedure Place the Picture effect in on timing cells that you wish to have the effect on a model Click on the effect on the grid and amend the parameters as required First click on the Browse button and navigate to the location of your image select the image and click open or double click to select the image Movement Controls how the image will move across the model layout In addition to directional optio such as left right etc there are a number of special options such as peekaboo scaled fl wave wiggle Movement Controls how fast the image moves across within the effect timeframe Speed Frame Rate Adj When using the pictures effect to play an AVI converted to images with ffmpeg this setting used to set the playback speed if needed to speed up or slow down the playback Start Position Sets the position of the image as it does not need to be centered on the model x y Start Position Used to bound the picture image within the model Defines and controls the coordinates wrap x the bottom left start corner End Position Used to bound the picture image within the model Defines and controls the coordinates x y the top right end corne
93. ext Each line can have a different color Click on the tab i e Line1 Line4 to select the Line of text to be defined For each line of text the following settings can be defined Contains the text that is to be displayed for the line Defines the font that is to be used for the text Click on the attribute to open up a window where the type of font style size color and other related attributes can be defined Movement Defines the direction of the movement of the line of text One of several options are possible such as Left Right Down None etc C If the box next to the Movement setting i e C is ticked then the text will reach the center and stop Controls the speed at which the line of text moves Controls the layout of the line of text The default is Normal however other options to rotate the text at different angles are possible xLights Nutcracker page 98 Count down Defines whether the line of text is to be used as a Countdown Timer The default value is None indicating that it is not a Countdown Timer effect For a count down effect the following options are possible and count down will be based from the time the effect is rendered or finally saved and not from when it is executed in the sequence The concept of the count down timer stems from New Year s eve count down displays If one Knows exactly when the countdown will start then setting this to an appropriate date time is a non issue
94. fects move or drop Up to 8 variations are possible i e Downwards Upwards etc xLights Nutcracker page 73 Glediator Effect Icon l __ Sequencer representation Description The Glediator effect enables the import and use of an effect that has been created using the Glediator software into xLights Nutcracker Prerequisite information Glediator is a 3rd party application that can generate an unlimited number of effects Once an effect has been created it must be saved as a GLED file Procedure Place the Glediator effect in on timing cells that you wish to have the effect on a model Click on the filename prompt and browse and select the gladiator file Tip You must configure Glediator to the X Y dimensions of your model you wish to add effects to You may also use Jinx to create effects It will create a out file which can be used with this effect There is no need to rename the saved output file to gled to use with the Glediator effect The Glediator effect now supports GLED and OUT files e GLEDIATOR Graphical LED Installation AnimaTOR File Options Extras About Curling Text 4000 1000 ms Double Wave Linear Double Wave 4000 4000 ms 4x Rain Stripes_Vert Rotating Colorbar 1000 5000 ms Circles amp Rects Linear Blur Expand amp Rotate 4000 500 ms Single Diamond Black Fade Linear Type Animated_GiF Type Falling Objects Bizzar Fitter None Fitter None xa 500 ms Plasma with dots
95. for Christmas or one for the next year Start a new year directory by copying sequences from the Show Directory of the previous year xLights Nutcracker page 16 Media Directory The xLights Nutcracker Media Directory is where the required audio mp3 and video mp4 media files are kept The media directory can be different to the show directory or can be the same directory This is the default location where xLights Nutcracker will first prompt for or look for media files Tip It is useful to have a common media directory for all shows Alternatively place all of the media for a particular show event in the respective show directory and set both of them to be the same Specifying the names of these directories or changing them can be done by clicking on the Change button found on the Setup tab screen If the two directories have been linked together via the link icon then the user can only change the location of the Show Directory and the same change will apply to the Media Directory linked icon unlinked icon If separate locations are required click on the icon to unlink the directories at which point you can change the location of either directory Caution Images used for pictures and faces use an absolute location reference i e you ory specify the exact location Therefore the location won t change if you change your show directory You may wish to consider having all your images in a separate location outside
96. g Notes The mp4 file name should be enclosed in quotes if it has a space in the name or an unusual character e g ffmpeg i your movie mp4 s 30x50 d png This will create a number of files f1 onwards i e frames f 1 png f 2 png etc The s 30x50 is the size output of the png files to be used for playback on your model where the format is WxH pixels xLights Nutcracker page 85 a f refers to the output filename prefix You could instead have specified outfile d Place the the picture effect on your model and browse and point to the first file i e f 1 png The picture effect will then play the individual files quickly in succession giving the appearance of the video file playing on your model Note Only something 1 will work i e the application looks for the 1 and then only picks the others If you have an entire movie saved you can export just portions of the video file as follows ffmpeg i yourfile avi s 30x50 ss 00 00 00 t 00 03 00 moviel d png This will make a 3 minute capture starting at the beginning The time is noted in hours min sec Tip A quick way is to navigate to the directory with the video file using Windows Explorer Then make sure no files are selected and hold down SHIFT and right click and you should get an option for Open command window here Now you have a DOS prompt already in the right directory without having to figure out how to type all the commands to get there You won
97. hannel number 95 to 556 Universe 71 has 291 channels from Channel number 557 to 847 Universe 5 then has 453 channels from Channel number 848 to 1300 etc Network Type E131 E131 E131 E131 E131 E131 Port Baud Rate or E1 31 Univ MULTICAST 1 MULTICAST 2 MULTICAST 71 MULTICAST 5 MULTICAST T2 MULTICAST T3 Num Chann g4 462 291 453 512 512 xLights Vixen FPP Mapping Channels 1 to 94 Channels 95 to 556 Channels 557 to 847 Channels 848 to 1300 Channels 1301 to 1812 Channels 1813 to 2324 Note If there are gaps in between it is not required to specify the missing channels The following image describes a setup where a LOR network has been listed first Even though only the first 32 channels of the LOR network are used universe 1 has been defined as 510 channels in case more items are to be added to the LOR network without impacting the other channels above If universe 1 is set to 32 channels then Universe 2 will start from 33 onwards that is also a valid configuration EDE Add NULL This type of setup is used as an example where the sequence output will not be used by xLights Nutcracker as a show player but output data to be used for playback on a Raspberry Pi or BeagleBone Black controller Directories Show Directory Change C Users Ed Desktop Christmas 2015 Nutcracker Media Directory Lighting Networks Save Setup Add USB Add 1 31 Add Null Change
98. hannels 29088 to 30623 Yes The Enable value turns on off that output when Output to lights is turned on If it s not enabled no output occurs For example if you have a controller not plugged in testing a different controller disabling that output would not attempt to send anything to that specific controller Trying to send data to a controller that is not connected van in some cases cause delays and lags on the output Highlight the row and Double Click on it to toggle the value Tip Most controllers only support 510 channels per DMX universe The Falcon F16v2 controller supports up to 512 channels per universe If configuring universes for a matrix that will be used on P10 panels those universes should be defined as 512 channels per universe Tip If you have a number of contiguous universes of a fixed number of channels you can enter the starting Universe a multiple of Universes and the Last Channel number of channels click OK and xLights Nutcracker will create the universes for you You can then modify the details after that Alternatively define each Universe by specifying the Universe in the Starting xLights Nutcracker page 19 Universe field set the of Universes to 1 and set the Last Channel to the number of channels in that section of the Universe Press OK The following picture shows a configuration where Universe 1 has 94 channels from Channel number 1 to 94 Universe 2 then has 462 channels from C
99. he left mouse button to draw and fill in the selected color or use the right mouse button to erase what has been drawn The eraser can be used to remove colors on the grid New Image Click on New Image to create a new image The first time you use this function you will be prompted for a directory to store the image files in As an example create an image subdirectory within your show directory You will be presented with an empty grid and you can then draw paint your effect within the grid Click on Save image and name the image The model window will display the model just drawn The model won t be updated until the file is saved Load Image Load Image is used to load a previously saved image or any other supported image If the picture loaded is not as per the model scale you won t be able to edit it Save As Save As can be used to save an effect to a new name Playing a video file as an effect You can play an mp4 avi mov or any of over 100 formats movie on a model such as a matrix or a whole house using the picture effect To get a list of the formats supported type ffmpeg formats at the command line for an output list To play a video as an effect create a temporary directory and copy the video file there Then use the ffmpeg utility to break it up into frames ffmpeg is run from the DOS command line and is included with each release of xLights Nutcracker Example ffmpeg i yourmovie mp4 s 30x50 f d pn
100. hyphenated words such as screa um you should break the word into two words such as screa and um for this list Then In your favorite browser open to the following webpage http www speech cs cmu edu tools lextool html as shown here ped LH ee Teed E EE t 0 AY EHETE STT B 7 LOGIOS Lexicon Tool Thus tool generics A prone AAY trem a heed English words Lf you just wam vo tse bow a ward i proncimced me hee CS eee Be ere oe Ge ee eh a ee Te E Be ee Please Pepe ee ell ee wall ee ae en eed PR Ba a ga er edi vod file Chos Fide marg words tt baad le Pleated pome that diais wub optunal Choe File Hip Mle cheer ok ioe pranin urban COMPILE An example Ef eer mpa file heka Tom tpt file will look eceertheng bebe thos nomcthane like dia left hand might cole conn Helis HILLO ee OH L gi HILLS I HH EH i SH li WORLD ki Bi L Cp eer CoA Me FAP eA Be hyp an etd HaPRER ATED AH AY F A HEFT IRD Then click the Choose File button and browse to find the file you created or enter this name into the file box Then click the Compile button Once the processing has completed another webpage will appear similar to this xLights Nutcracker page 121 2 Lees Belt eg WWW speede LexTool Result Vou dichonasy appears to have been wuccessfulle constructed You tas retoeve your rewelts through thas lusk Jtofes hos hina page contaans hidden text that provides a direct
101. i i te la3 i te 3840 10 10 12 a ui i els 3841 to 4350 Lil i J te 440 E13 14 e te 5370 a O01 2 anneb 33 1 to 3400 j i i j 4 AI te gyt Ensure that Map Empty LMS Channels is not selected else you may get errors as the CCR macros do not have effects in them Reconvert and it should convert with no errors Open the xseq file that was created and play it to view the effects on the layout window You may need to click on the Render All button If you are not playing the sequence though LOR hardware go back to the setup and delete the two LOR entries that you added for the conversion leaving your previous configuration as it was If you are using LOR hardware then these entries will need to be correctly defined xLights Nutcracker page 164 a Converting a LOR sequence and importing into xLights Nutcracker This section is based on a video created by Clyde Lindsey First ensure that within LOR all the channels for the controller have been defined and are in sequence Tools Channel configuration will display an image similar to the following Eyes Open byes Constant Hite HLL ELL TL Hitt nie l JL EET Tack mea S ssi sSC Hamna Color Device Type Ur Cic Sequence E Purckindutine O IN Sh Rama Corro a Ah ADS CI Ear fa 2 ar X Top Moun MR ict Rama
102. ick and select Import Lyrics Type or paste the lyrics into the Window and press OK The words of the lyrics will be evenly distributed across the song Using timing marks Play through the song at regular or reduced speed and use the t key to add timing marks at the beginning of each phrase xLights Nutcracker page 114 Then on the timing track between two timing marks double click and an Edit label box will pop up Type in or copy and paste the words that pertain to the phrase or phrases that belong between the two timing marks Press Ok to accept zj ime 0 00 00 PC PRPC CCC HHH 3 a a N a N gt N N Model Group All Edit Label Singing Face Mew Outline I don t care about Christmas Eyes Open Eyes Closed O Mouth Top Lip Owal Mouth Middle Lip Bottom Lip Repeat for as many phrases as you require or you can do one phrase at a time Breakdown Phrases You can break down all the phrases into words by right clicking on the timing track to the left of the Papagayo icon and selecting the Breakdown Phrases option This will breakdown all the phrases into words or you can do this in sections i e Highlight a phrase or group of phrases right click and accept the Breakdown Phrase option Note There could be a delay of several seconds the first time this is used in each session while the first phrase is broken down due to the loading of the dictionaries xLights Nutcracker page
103. ie Sant Delete Singing Face2 9 He s the Aussie Sant i l D Singing Face Move Up _ mire as SF Pan Mots Mave Downs Show All Hide an i Effect Settings x Multiple views can be defined with each view defining a list of models that are to be displayed and the sequence that they should be displayed in For example A Static Model view may contain all elements that are non RGB An Import Model view may contain only elements that you wish to sequence after importing other data from other sequencers e A Halloween Model view may contain only elements that you wish to sequence for Halloween New models can be added to a view by selecting that view from the Views window within the Sequence Elements window or from the View window to the left of the Waveform and clicking on Add Models Similarly models can be removed from a View by highlighting the model in the Model window within the Sequence Elements window and clicking on Delete Model The position that the model appears within the view can be changed by highlighting the model and clicking on Move Up or Move Down Within each view the models that are part of the view can be marked as visible or non visible via the button to the left of the model Note The visibility is across all sequences and not specific to the sequence that is open So if you make a model non visible it will become non visible in all sequences The Master View is
104. in portrait mode Start channel number is 11800 xLights Nutcracker page 47 Model Name P10 Matric Individual Start Chans Display As Sart ind Type of String RGB Nodes g um 11991 2 11992 183 Actual of Strings 64 3 7s 12375 f 4 12576 12567 of RGB Nodes per String 64 5 12568 12759 z 6 1276 12951 of Strands per String 1 m ia 7 ias 13143 Start Channel 11300 From Output 1 8 I4 13335 9 13336 13527 Starting Comer Top Left D Top Right 10 13528 13719 11 13720 13911 D Bottom Left D Bottom Right 12 13912 14103 13 14104 14295 Part of my display F anol my Seay 14 14296 14487 Model Brightness p o 15 hias 14679 Adjustment 16 14680 14871 9 ca Gappenences nome ia lasot 15255 ane Appearance 18 15064 15255 19 15256 15447 al 1H t 5 A custom singing face Coro face Bioda Mere aget Fare bidievichaal Het Chere Cheon Medel 3 o Hih Jiel Drupliy hi Cantor ie ce AB COEF GHI FPA t ee oP QAS T U Ya tk ME a 7 H ii oh ih lh la da ah Model Wah E a3 FE a 4 i i wi Bi i i E d E i hicdellimght t i i i 2202 9 2 l ss m T i r 7 J r i ii ra a eh TET TET 7 uri Channel irm u E E m ik i i Mk 1 a tk EPG bi ok EF OG wt oP ih ih ik of w i E t tE amp E E i l E F 4 4 4 4 7 E Patel dapi EE ah a ee a a O E E Heda Ergen o IE l E T 4 4 4 a 7 i mm it i i T d amp amp bc T i 7 l g r F a I ca Carpal seis hamri m y EITT x H i
105. ing E Blending E Morph Effect 1 p 51 Fade In 0 00 Fade Out 0 00 CUCL u Ce The Persistent option when enabled does not clear the display buffer before rendering each frame The result is the preview frame remains until overwritten by a subsequent frame For example drop the balls or fan effect on a model select the blending to Effect 1 then toggle Persistent on off You will see a huge difference Doing the same for a Chase effect also results in a very different look The term came from high persistence scopes where each trace just kept layering on top of previous traces Don Julien wrote that code in 2013 xLights Nutcracker page 110 Singing Faces This section describes how Singing Face functionality i e the conversion of phrases from song lyrics or sentences spoken out aloud can be converted to work on Coro faces or Images on a matrix or Mega tree natively in xLights Nutcracker i e without using the Papagayo application Model definition Coro Faces In the model setup screen for the singing face model click on the Faces button Model Name Singing Face New Individual Start Chans Display As Start End Type of String Single Color White aoe a 2 82 G2 Model Width 50 3 83 83 4 84 a4 Model Height 50 5 as as Seis 6 86 86 a T amp l af Start Channel 81 From Output 1 zi a 38 88 Starting Corner n a n a 8 n a n a Part of my display Model Brightness LJ i L Adjustment Ca
106. ing the model name from the Model List window and clicking on the Rename button Enter a new name when requested Note If the model is already part of a Model group you should update the Model Group definition If you don t then xLights Nutcracker will subsequently provide an option to delete or select the new model name when the application is loaded again Modify a Model Details of a model configuration can be amended by selecting the model name from the Model List window and clicking on the Modify button Copy a Model Once a model has been defined a quick way to duplicate definitions is to select the model name from the Model List window and clicking on the Copy button The existing details are copied into a new window Change the name as required and amend any other details such as the Start channel number and Save the changes Node layout Clicking on the Node Layout button opens a window which then displays how the nodes are laid out in the model within each string xLights Nutcracker page 44 Node Layout on eS Bi Name P10 Matrix Display As Horiz Matrix string Type RGB Nodes Start Corner Top Left Total nodes 4096 Height 64 Node ee stating with 1 followed by string number Export csv IciclesR Lanternl Lanternz _ Clicking on the Export CSV button enables details of one or all models to be output to a csv file highlight the models required You will be prompted to specify a location
107. k on Update Group and then Close xLights Nutcracker page 11 Edit Groups o Ensure that the All Models Group is selected in the Model Groups window then click OK to return to the Layout screen Position the P10 Matrix model on the layout as required by dragging and adjusting it described in the Layout section and then click on the Save button on the left side below the Models button to save the Layout details p Return to the Sequencer tab and continue Tip Any model created or changed must be saved first before it becomes available to be seen on the Layout tab To avoid confusion before playing any sequence on the Layout tab click on Render All and then Save the sequence first This is not always necessary but it depends on whether you change any of the default render or save settings Caution Ensure that the MP3 file that you use for your sequences are set to a Constant Bit Rate Use Audacity and export the audio as an MP3 file with Constant Bit Rate and preferably 128 or 192K The sequence will play if it is not a constant bit rate however the audio may not start exactly at the point the cursor is placed on the wave display on the sequencer tab xLights Nutcracker page 12 a Chapter Ihree Installation Downloading ALights Nutoracker Windows The latest release of xLights Nutcracker for Windows can be found at the following link http nutcracker123 com nutcracker releases This page also has link
108. king on the Grid and selecting the Undo action i e Undo effect move or Undo delete etc At this point Ctrl Z to Undo is not supported The Undo actions can be daisy changed i e they can be repeated one after another Selecting Multiple Effects In order to select a group of effects use the left mouse key to select the range of effects The colour of the cells change but also the links in the selected cells will turn to magenta You can only select a group of cells when the cursor looks like a pointing hand i e glove If two arrows are shown then you can t select the cells You may need to zoom in to be able to see and select the required effects Create Random Effects Select and highlight an area on the grid Right click and select the option to Create Random effects Effects will be randomly selected along with different colors and options and effects created in the area highlighted each between consecutive timing marks If there are no timing marks active then a default time value will be used for each effect Click on Play to play the effects You can also use the shortcut key R to achieve the same result by highlighting one or more cells and pressing R xLights Nutcracker page 106 Layers Layering effects gives you the ability to create unlimited stunning effects that could not be created without layers First let s go over the limits Each model may have a up to 200 layers of effects Each layer can be
109. lick and select Align top bottom etc to align the selected objects Which object should they all align to The object you selected first i e which will have the five blue dots is the key object that others will align to When selecting a group you can press shift a box opens and you can drag the mouse around the objects to select the group to align Note There is no Undo for this actions for dragging and setting alignment Build Model from Preview This option which uses the whole house model existed to support xLights Nutcracker 3 x functionality It has been removed Use the Model Group functionality instead which has the same features but is much more flexible and gets updated as models are added or removed xLights Nutcracker page 28 Schedule setup Test Convert Layout Schedule Papagayo Sequencer The Schedule tab is used to define schedules if you are going to use a PC MAC and xLights Nutcracker to run your show Prior to using this function you must have defined at least one playlist via the Playlist function Click on the Change button next to the Show Dates label to select the Show Start and Show End date ranges for your show Select OK when done The date selected will then be copied to the left panel Schedule Playlist Update Selected Items July 2015 Sun Mon Tue Wed Thu 28 23 1 2 Show Dates Change 5 67 8 9 15 16 Delete Selected Items 2 B 14 Start 07 24 15 9 0 A 2 B 26 27 s 2 3 End
110. lick on Save Mapping to Save the mapping The mapping can then be re used by Clicking on the Load Mapping button the next time 8 Click on OK when ready 9 A status message will be displayed at the bottom indicating that the sequence has been imported 10 Click on the Render All button 11 Click on Play 12 Save the sequence as per usual Importing a LOR Sequence Importing a LOR sequence follows the same steps as described above However depending on the LOR hardware setup channel definitions in LOR and correspondingly in xLights Nutcracker need to align See discussion in the section Coming Over from LOR Importing an xLights Nutcracker Sequence This process can be used to Import effects from a xLights Nutcracker sequence from another user e Import effects from another of your e g older xLights Nutcracker sequence into an existing xLights Nutcracker sequence Step 1 If the xml sequence has been received from another user it is preferable to have both the shared sequence xml file and the xlights_rgbeffects xml file from the donor Create a new directory and copy the sequence file and the xlights_rgbeffects file to that directory Change the show and media directories to point to the new directory If you have the xlights_network xml file which contains the network setup details copy that to the new directory too otherwise setup a block of universes large enough to cover the sequence channels
111. lick on Add group and give the group a name Spirals Then select the group and click New Preset and give the Preset name Red and White Spirals and press OK Caution Do not use the default group that is already there Ensure that you create you own K group or groups before saving your effect preset against that group It is good practice to create mA groups that reflect the type of the effect To retrieve a preset that has been saved go to a location on the grid where you wish the preset to be placed right click on the sequencing grid select Effects Preset scroll to and locate the preset you want and double click on it to have it copied to your location or select Apply Effect If you change something within an effect that you have selected you can update it by clicking Update Effects You can move an effect preset from one group to another group delete or rename a preset You can also import an effect from someone else by clicking on Import selecting an xlights_rgbeffects xml file and importing the effect from there xLights Nutcracker page 59 Built In Effects LUNG POR OE N E eC N EO The following effects are ready made effects that can be used to generate an effect straight away Off Effect Effect Icon _ Sequencer representation H HH Description The off effect simply turns every pixel off on the model it is placed on Prerequisite information Colors Timing speed are ignored None Ti
112. ltiple timing tracks on the sequencer each with different frequencies of timing marks By default a timing track New Timing is created for each sequence if you have not created one when creating a new sequence Timing Tracks can be added via the Settings Sequence Settings Timing Tracks menu then select a new Timing Grid When you create a timing track it gets added to all views that you have defined Timing tracks are local to a sequence Note The timing marks create a grid but once the effects are dropped they have no relation to the original timing marks that were used to drop them You can switch to any other timing track and have a completely different grid If you have multiple timing tracks defined e Each timing track has a different color of timing marks e You can select the timing track radio button to the left of the timing track name to enable that track You can also select more than one timing track to be displayed at the same time however only one timing track will be active for effects to calculate the start and end position xLights Nutcracker page 36 9 Sequencer Tine 0 00 00 i a Singing Face Singing Face You can set up timing marks on any timing track manually by placing your cursor on the waveform above the grid and while playing the sequence press the t key where you wish the timing mark to appear You can add new timing tracks or delete an existing timing track at any tim
113. n Four options are available Help Sequence Settings E w Render On Save Tool Icon Size Grid Spacing d Medium ALT 2 Grid Icon Backgrounds d Large ALT 3 Grid Node Values Render Mode 4 Effect Assist Window Reset Toolbars Grid Spacing This function enables you to change the size i e width of each band of the sequencer grid Four options are available xLights Nutcracker page 152 gt eETIINGS Hep Sequence Settings A a jz Q amp Render On Save L ets EOLA fe Small CTRL 1 Medium CTRL 2 Large CTRL 3 Extra Large CTRL 4 Tool Icon Size Grid Spacing Grid Icon Backgrounds Grid Node Values Render Mode Effect Assist Window Reset Toolbars FF F Grid icon Backgrounds Sequence Settings Render On Save Tool Icon Size Grid Spacing Orid Icon Backgrounds Grid Node Values Render Mode Effect Assist Window Reset Toolbars 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 Sequence Settings i Ww
114. n Effect Changing an Effect Selecting Colors single Channel Colors Moving and Stretching effects Copy Paste Delete Effects Undo Effect Selecting Multiple Effects Create Random Effects Layers Layer Blending Morph Layer Blending Mix Slider Singing Faces Model definition Coro Faces Matrix Timing Tracks Importing Phrases Breakdown Phrases Breakdown Words Shortcuts Chapter Five Menus Eile New Sequence Musical Sequence Animation Sequence Open Sequence Save Sequence Save As Sequence Close Sequence Select Show Folder BackUp Quit Playlist Add Rename Delete Refresh Custom Script xLights Nutcracker page 4 View Zoom in Zoom out Perspectives Windows Model Preview House Preview Effect Settings Colors Sparkles Brightness Contrast Layer Blending Effect Dropper Effect Assist Perspectives Import Effects Settings Sequence settings Info Media Metadata Timings New Import Data Layers Import Render On Save Tool Icon Size Grid Spacing Grid Icon Backgrounds Grid Node Values Render Mode Effect Assist Window Reset Toolbars Chapter Six Advanced Features Configuring Matrix Panels as Models Coming over from LOR Running LOR Controller in DMX Mode LOR to DMX Channel conversion Running LOR in DMX mode Convert a LOR LMS file to play using non LOR hardware Converting a LOR sequence and importing into xLights Nutcracker Common Scenarios Online Support Groups xLights
115. n example of how LoR controllers can be connected in DMX mode Refer to the table above of Unit ids to DMX channel conversions LOR in DMX Topography This layout diagram shows an DMX i aed example of how LOR Controller Tai ame Ag 2h Screw controllers can be connected 2 2 l f mml ENS in a DMX network BN N Note The cable colours in this example are r based on the 565A standard N XLR Plug Data tad P oP PP a oa i an Change Over a a a Cable 2 N aj a 3 ron IN No Change Se Anaa A 26 Changiaie a Nall eh hange Over IE Over Cable 4 RJ45 568A ENATSH Cable E oo h h 3 1N 2l Ne eee 4 Data 4 ie 14 Data d a ay a R 3E ee i gt o gt E a a Data DD poy a paraa RL a e RJ45 568A RJ45 a DMX Controller s o se Sey LOR Gantrdlide LOR Controller a RI45 S684 RJ45 i Used with permission from FastEddy ACL xLights Nutcracker page 160 athe Weel bo Coniqer Cowon Ieri Pipgak iar Lina E TE perO a ight hoda 0 Dag igan fe nenia rra Ai BT 1E hear Used with permission from FastEddy ACL You must use the LOR hardware utility to set the DMX start address on a LOR controller if the controller doesn t have on board channel selection The next diagram shows an example of how LOR controller addresses are set in a DMX universe
116. ncel Appearance The first drop down box is used to select the type of face definition that is required The default value is None Select Single Node or Node Ranges for Coro faces or Matrix if you are going to use images for each face position Single Node Coro faces The following window is then displayed For each phoneme select the channels that will be turned on Multiple selections can be selected by holding down the CTRL key xLights Nutcracker page 111 Model Model Name Singing Face New Individual Start Chans Custom Model 3 4 ej H Face Definition a End AJB C DJE F al 1 Single Nodes 2 j a2 Nodes a3 l 1 Face Outline Outline a4 5 1 Mouth AI Top Lip Bottom Lip a3 6 1 Mouth E Top Lip Middle Lip a6 71 Mouth etc Oval Mouth a7 a la Mouth FW Top Lip aa 9 1 Mouth L Top Lip i i Mouth MEF Top Lip 11 1 Mouth 0 Mouth 1 1 Mouth rest Top Lip 13 1 5 5 j5 Mouth U O Mouth l4 1 B 7 Mouth W Middle Lip 15 1 8 7 Eyes pen Eyes Open 16 1 a 7 Eyes Closed Eyes Closed 17 il 3 18 1 8 oll 19 1 p 20 1 FV 4 Gi m Solor f Sparkles Brightness OK Cancel Contrast M a r are Matrix If a matrix is selected then the following window will be displayed DFP PP Face Definition Matrix IT Veg IF Why LEE gm mna DY POE LA Mouth Al Mouth E Mouth etc Mouth FV Mouth L Mouth MB
117. ncer tab and continue with o Adding models for this sequence to the sequencer view o Creating adding timing marks o Dropping effects on the sequencer grid o Playing the sequence Tip Ensure that you save the sequence prior to exiting to save the work that has been done so far Animation Sequence If creating an animation sequence click on Animation Sequence No media audio file is required or requested for The subsequent process is the same as in the Musical Sequence Open Sequence To open an existing sequence either use the Open Sequence icon select Open Sequence from the File menu or press Ctrl O You will be presented with the Choose Sequence file to open window with the directory defaulting to your show directory You can select an xLights Nutcracker xml sequence or an xLights Nutcracker fseq file to open Save Sequence To save an open sequence either use the Save Sequence icon select Save Sequence from the File menu or press Ctrl S If the sequence has not been saved previously you will be presented with the Save As dialogue window to enter the name for the sequence If the Render on Save setting under the Settings menu is set i e ticked then all the effects on all the models will be rendered first before the sequence is saved in the fseq file This is the default Progress status messages are displayed on the last line of the window When the sequence has completed saving a message will be displayed on
118. ned in an xLights Nutcracker configuration xml file in the show directory It can be reused for all subsequent sequences however it needs to be added to the sequence grid of each sequence as required in order for effects to then be sequenced against the model A model is made up of one or more strands and each strand is made up of one or more nodes To define a model after opening an existing sequence or creating a new one hi e Click on the Models icon on the top row of the canvas or e Click on the Models button on the Layout window e Right click when in the sequencer window select Edit Display Elements and then Add Models Clicking on the icon the model list window will display any existing models that have already been defined Liam a P I re PG Mode List REP feeders Arch Arch Arch4 ArchS Arch CandyCanel CandyCane F CandyCane3 Rename CandyCanet Garage Al Copy IciclesL lo IcichesMi IciclesR Lantemi i Lantern2 Export CSV ambarn Delete Mode Layout xLights Nutcracker page 38 New Model definition Click on New to define a new model The following screen will be displayed Model Xx Model Name Individual Start Chans Custom Model O 0 Hep B Display As Tree 360 M Start End Type of String RGBNods ah b Actual of Strings 1 of RGB Nodes per String 5
119. net Supported devices include those made by jlsys SanDevices Advatek Lights and Entec Also supports the Lynx EtherDongle and E1 31 projects on DIYC rents My xLights Sequences 201 5Sequences K ents My xLights Sequences 2015Sequences The universe numbers entered here should match the universe numbers defined on your 1 51 device Baud Rate or 1 31 Univ Num Chann xLights Vixen FPP Mapping Enabled Multicast 3 1 400 Channels 1 to 400 Yes C Unicast 2 60 Channels 401 to 460 Yes IP Address MULTICAST 71 291 Channels 461 to 751 Yes 5 453 Channels 752 to 1204 Yes Starting Uniwerse 1 T3 512 Channels 1205 to 1716 Yes 74 126 Channels 1717 to 1842 Yes of Universes l 11 366 Channels 1843 to 2208 Yes One Ouput E T5 512 C hannels 2209 to 2720 Yes T6 51 Channels 2721 to 3232 Yes Last Channel 512 72 512 Channels 3233 to 3744 Yes TT 51 Channels 3745 to 4256 Yes I ent li F 1 Select the Method Multicast or Unicast depending on which option you will use to drive your lighting networks If unsure leave as Multicast If Unicast is selected then the IP address of the controller that will support the universe s you are defining here must be entered Enter the Starting Universe of Universes and the Last channel for each universe Leave the One Output unticked Note If the One Output is ticked then visually the universes and number of channels will be grouped as follows E131 MULTICAST 92 94 SLAG C
120. ng Face Custom Medel pt o Heip Depry As Cuite Shark ind ALB Gla amp F Pa ay eld 11 1 Tippee a arg ROB Hedi i ri Made With 55 i 4 Medel Heaght 50 6 Aa F n B Tint Channel L From thepat 3 Sas Coren io il i ia Part of my deeply oF id Made Espirais z 15 er i iF Ce a Pip aa A Bere herm 18 iL xLights Nutcracker page 43 a A custom model grid will be displayed in which you enter numbers in the grid representing your model If your model is a candy cane with 12 nodes you could have a grid 4 columns wide and 10 rows high Place the numbers 1 9 up the right hand side 10 and 11 in the middle cells in the top row and 12 would go in column A row 2 as follows s ii Rical Mame Gandy Csa iari DH Comics bedel at O pip Crplay As Conner Stark Ena A B Cc D Type of Sey G Medes oP Pal Made Weith d Biede Phegihe i Sot Chewy B Lo fmm api O Seem amp be Wi ee ia a E Sharh Ciemi Pat of mep dpb Pca Blreghteeers Adeuntrrerd Di Darei APREN MeT Marmer If you enter a number and wish to erase it enter O in the cell It will be removed when the grid is saved and reopened You can use the and keys to make zoom in and out You can also enter the same data in Excel copy the cells from Excel and then use the paste icon to paste the data into the cell in row 1 column 1 Save the model Rename a Model A model name can be renamed by select
121. ng Layer Blending mode results Modes Normal Both layers will show with layer 2 showing only where there is blank space from layer 1 as in thin spirals for example Effect 1 Ignore effect 2 and only show effect 1 Good for being able to hide an effect if you re not sure you want to use it Effect 2 Ignore effect 1 and only show effect 2 1 is Mask Effect 2 will show wherever effect one is not showing If E1 Fire E2 Spirals then the spirals would show on top of the fire but the fire would appear to be black 2 is Mask Same as effect one just reversed Tip use Bars as the mask on layer 2 and you will have effect 1 reveal as if was coming from behind a curtain 1 is Unmask Make Fire E1 Butterfly E2 and set both for 1 is Unmask You ll see the awesome power of this blending mode 2 is Unmask Make Bars E1 Fire E2 and set both for 2 is Unmask You ll see the awesome power of this blending mode 1 Reveals 2 Effect one will show on top of effect 2 except for areas in effect 1 that are black Effect 2 will show on the black areas of Effect 1 2 Reveals 1 See 1 reveals 2 Same result just transposed Shadow 1 on 2 The the layer 2 effect will show in the shape of layer 1 Try E1 Circles E2 Buitterfly to see what this does Shadow 2 on 1 Effect 2 will overlay on effect 1 where there is no black in effect 2 Try Effect 1 as circles E2 Bars with one of the colors as black Average This what you would expect as layered If E1 and E2 had yellow an
122. ng on the Select Papagayo Input File button and locating the required file a If you have split the PGO voice file into more than one file for example by splitting the song into two sections then click on the icon on the same line select the second PGO file and then enter the of fames to offset by when prompted this corresponds to the number of frames after which the second section of the song starts 2 Select the xml sequence that contains the model to be imported against Accept the warning message that the xml sequence will be overwritten xLights Nutcracker page 32 3 Select the Output Type Auto faces Coro faces Image faces or Movie faces Coro faces option 4 Preset Name this defines the mapping between the phonemes and your custom Singing face mapping You can save one or multiple mappings for future re use When using this for the first time Select add new and enter a Preset name when prompted Convert Fapagayo tile into an xLights Sequence Download v1 3 5 3 from nutcracker123 com nutcracker releases papagayoMOD 1 3 5 3 win32 rar 1 Select Papagayo Input File 2 Select Sequencer Output File 3 Choose output type Coro faces v Assign Custom model channels to standard Coro face parts 4 In the grid below configure how phonemes and face parts are rendered Presets allow settings to be saved and reused again later Preset Name CoroPGOPreset v bel Delete Clear Grid
123. ng to the input Sequencer channel mapping for some inputs and is useful to identify missing or misaligned channel information 5 Select the options specific to LOR conversion xLights Nutcracker page 24 6 Specify the time resolution i e 25ms 50ms 100ms These correspond to 40 fps 20 fps and 10 fps respectively Select 50ms if not sure 7 Click on Start Conversion 8 Conversion messages are displayed If successfully converted a file of the same name but with a different extension i e as specified for the Output Format will be created in your show directory For LMS imports LOR networks should be first followed by DMX starting at universe 1 Sequence files to convert SEQ SCTBLUEXMAS Ims Output Format All channels off at end C LOR Import Options Map Empty LMS Channels E Map LMS Channels with no network Show Verbose Channel Map Time Resolution Conversion Messages Reading D Users Reading LOR sequence Track 1 length 12722 centiseconds LOR Network 0 30 channels Total channels 32 INFO xLights Channel 16 LOR Name CT2 WARNING CT2 Ahh is empty INFO xLights Channel 16 LOR Name CT3 INFO xLights Channel 17 LOR Name CT3 INFO xLights Channel 18 LOR Name CT3 INFO xLights Channel 19 LOR Name CT3 INFO xLights Channel 20 LOR Name CT3 INFO xLights Channel 21 LOR Name CT3 INFO xLights Channel 22 LOR Name CT3 INFO xLights Ch
124. nst the node row instead Tip The Convert tab has an option to convert a LOR sequence file with a Show verbose Channel map setting that will provide details of the LOR to xLights Nutcracker channel mappings You can simulate a conversion and review the mapping details first Instead of using the Import tab to import the data as an editable effect you can also import the data as a Data Layer The process is much more efficient however you cannot directly edit the data after your have imported it That option has also been described in this chapter xLights Nutcracker page 170 Common Scenarios Scenario 1 A user is still using LOR for 8 controllers this year How should he set them up Should he run it in DMX if the controller support DMX The general rule is that you can do 96 channels of LOR with xLights if the LOR controllers are in LOR mode In this case put the LOR controllers in DMX mode and then xLights can do it all The user can can import all the LOR sequences schedule them play them edit them etc scenario 2 A user has an E682 and an E6804 running pixels and 2 CMB16 and 1 CMB24 controllers How should they be configured and connected Is a cross over cable required Plug in the USB same com port that would be used if running it from LOR No crossover cable is required if running from a LOR network On the setup screen add LOR channels via USB device Put in at least 48 channels Set the com port as requir
125. nstalled without Audacity installed first download the plugin package from the following address http isophonics net QMVampPlugins To install copy the files qm vamp plugins dylib qm vamp plugins cat qm vamp plugins n3 to either of the following locations on your computer Library Audio Plug Ins Vamp for plugins to be available to all users HOME Library Audio Plug Ins Vamp for plugins to be available to you only xLights Nutcracker page 15 Chapter Four Tabs Setup Setup Test Convert Layout Schedule Papagayo Sequencer The Setup tab is used to define the locations of the Show and Media directories as well as to configure the details of your network for each Universe Directories te a Setup Test Convert Layout Schedul Directories Show Directory Change Users Media Directory Change Users show Directory The xLights Nutcracker Show Directory is where all the required xLights Nutcracker sequences pictures and user configuration files required to run the sequences are kept When a sequence xml is saved and a binary file fseq rendered both files are created in the show directory This is the same location where xLights Nutcracker configuration files can be found and the default location where the program will first prompt for or look for files pertaining to several functions of xLights Nutcracker Tip It is useful to have separate show directories for each major event i e one for Halloween one
126. olors can be used for the effect Wave Type Defines the type of waveform to be generated by the effect Sine Decaying Sine Square Triangle Fractal Ivy Fill Colors Defines the color of color selection to be used for the waveform If None is selected only the first color selected is used If Palette is selected then the colors selected from the color palette are used If Rainbow is selected then the colors selected from are from the rainbow palette Mirror Wave If this setting is selected a mirror image of the waveform is also generated Number of Waves Controls the formation of the speed at which the waves are formed Thickness of Wave Controls the thickness of the waveform If multiple colors have been selected as the thickness increases then the different colors form part of the waveform For a thin wave the first color selected is used Scale Height of Wave Defines the height of the waveform Speed Controls the speed at which the wave moves across in the specified direction xLights Nutcracker page 102 Defines whether the wave moves from Left to Right or Right to Left Adding an Effect Click on the effect from the effects toolbar and drag the effect to the grid and release it between two timing marks on the row of the model you wish the effect to play on You can then select and drag each end to stretch the duration of the effect or reduce the duration of the effect The effect that you are
127. on None s Defines the length or height of the flames Defines the color of the flame Growth Cycles Defines the total length that the flames should grow to Location Defines the initial location and therefore the direction of the flames eg a setti of Bottom would drive the flames from the bottom to the top xLights Nutcracker page 70 Fireworks Effect Icon Sequencer representation 8 Description The Fireworks effect creates a fireworks type of effect of exploding lights in a burst Used most effectively on models such as a mega tree or a matrix Prerequisite information One or multiple colors can be used for the effect If multiple colors are selected then the lights in the explosion will be made up of the selected colors Number of Explosions Defines the number of explosions to be created Particles in Explosion Controls the number of particles in the explosion Velocity of Particles Controls the speed of the particles exploding Particle Fade Defines the speed at which the particles should fade in the explosion after the init Tip Add multiple layers of fireworks with different colors on each layer to get more explosions with multiple colors at the same time Set different velocities and number of explosions on each layer xLights Nutcracker page 71 Galaxy Effect Icon Sequencer representation am Description The Galaxy effect creates a spiral like effect that expands aroun
128. on of the waveform will cause only that section to be played Pressing the spacebar will replay that section e The Replay button does not currently drive any functionality Clicking on an effect in the grid will not alter the waveform area that has been highlighted to be played The effect becomes the focus point if you zoom in and out but the play range does not change If you do want the start position to move to where your effect is or to be based on the edit position in the grid then double click in the grid and that will then remove any highlighted position area in the waveform and set the start position in line with where you have double clicked Views A view is used to be able to easily select a list of models and the sequence in which they are to be displayed on the sequencer Views work across sequences so once you have setup a view with the models that you require if you open any sequence that view is available to use in that sequence Tip If you define Model Groups in a view then when you use the view in the sequencer you will be presented with a list of the groups Double Clicking each group will open up the list of models within the group xLights Nutcracker page 5 a Sequence Elements ai l View bo View A Add Views gt Master View i time 0 00 00 y Second View Delete View Timings Models Timing Model Add D Imported Timing TCU Sh cr ae He s the Auss
129. ords or phonemes more clearly Drag the words to align them as required You also need to separately drag the phonemes to align them as required If you wish to regenerate a word or words highlight the words right click and select Breakdown Word or Breakdown Selected Words option Select and drag the Face effect to the sequence grid against the model your Singing face model Tip Ensure that the color selected on the color window is correct based on your model definition White is the most common setting Tip If the Timing track name Lyrics1 does not appear in the list of Timing Tracks click on another effect and then return to the Face effect to force the list to be refreshed xLights Nutcracker page 117 Using the Effects Setting window under Mouth Movements select the applicable Timing Track Lyrics The face definition value will default to the one defined for the model You can also select Show Outline which will activate the outline when the face effect is present and Turn On Off Eyes if you wish Setting the eyes to Auto will cause the eyes to blink every few seconds when the rest phenome is on Tee hoo 28 00 73 00 30 00 31 00 32 00 33 00 34 00 35 00 inne 000 00 _ _8 _ _8 il E 8 8 8 8 8 6 8 8 0 E i i 1 amp It__ il _212 d MH _ M_ _M __ o2 _ _ i ll 1 Lyrics m eme U H HHEH HEHEHEH HH
130. ors are selected than the ColorWash will use the selected colors repeating the colors depending on the count setting Number of times the colors selected will be repeated for the duration of the effect Vertical Fade Controls whether the wash effect should fade vertically Horizontal Fade Controls whether the wash effect should fade horizontally Entire Model By default this effect will cover the entire model When unchecked you can then s the X Y coordinates for a partial color wash for an area of the model shimmer Applies a shimmer effect to the ColorWash effect if selected Circular Palette When selected this smoothes the color transitions when the effect repeats per th count setting If not selected there will be a hard transition between the last colq selected and the first color selected X Y Coordinates Defines area of the model for the effect to be applied to when the Entire Mode checkbox is deselected xLights Nutcracker page 65 Curtain Effect Icon Sequencer representation eel Description The Curtain effect creates a color transition of one or more colors across the face of a model depicting a curtain opening or closing based on the options selected Used most effectively on models such as a mega tree a matrix whole house or grouped arches Can also be used on singular items such as each arch Option Setting Description s Curtain edge Denotes how the curtain edge will come together i e close o
131. ote If the Falcon Player on the Raspberry Pi or BeagleBone Black controller is to be used in Bridge Mode for testing via the sequencer prior to your show then the universes and corresponding channels must be defined i e a definition of NULL will not output any lights Change Delete or Delete All To change or delete an individual row highlight the row and select Change or Delete Click on Delete All to delete the entire set up Test setup Test Convert Layout Schedule Papagayo Sequencer The test tab enables you to test anything from a single channel all channels for a model or all channels by sending different test patterns to your physical lights Ensure that output is enabled by selecting the Output To Lights button At the end of testing click on the Lights Off button ry Select individual or multiple channels using the Control Shift keys as described or select all lights xLights Nutcracker page 21 Setup Tet Comset Layout Schedule Papageyo Sequencer Selecta Caram toad Save Use Shatt clleck Ctrl click or click amp drag to select multiple channels Oh I7 MTREE 1956 Oh ores MTREE ELIR Standard RGB RGB Cycle Chati MTREE 1966 Sect function Background Highlight Spiri Ch 9787 MTREE 21968 a of Intensity Intensity Ch 978d MTREE H197R Ch OMG MTREE 1976 Chase oS 5 10 Ch 97S MTREE 1978 Chae 1 3 Ch 9791 MTREE FLIR Ch 9792 MTREE 1986 eee Ch 9793 MTREE 1988 Chase 1 5 Ch 97M M
132. p You can use fade in out with off xLights Nutcracker page 60 On Effect Effect Icon Sequencer representation ast Description The ON effect turns every pixel on for a given model Prerequisite information Only one color may be used with the ON effect If multiple colors are chosen only the first color selected will be used Option Settings Description Start intensity Starting intensity value End Intensity Ending intensity value Tip A start intensity of 0 and ending of 100 will result in a ramp up opposed to an ON with hard edges Tip Click on the Shimmer to get a shimmer effect xLights Nutcracker page 61 OU Q 02 Effect Icon Sequencer representation l Description The Bars effect creates straight edged multiple color bars that move across a model The edges may be hard highlighted or 3D soft Prerequisite information Direction H Expand Bars start at the horizontal middle of the model and expand towards the left an right edges Direction H Compress Bars start at the left right edges of the model and move in towards the horizonta center of the model Direction Alternate Bars are not animated like the other direction options The colors for each bad change to the next color selected in the palette Highton A single row of white is set at the leading edge of each color sm The trailing edge of each color fades to black Tip Layering a On effect with a start intensity
133. peat off Leiler E entre ane tse 3 104 REM Frnt bem Once on Pio Tes a 104 REM Last ers Droe sei z 105 REM Sleigh Fade freq 110 LET LiseMaeneSe rras 2013 Playlist 1 Sleigh Ridere La 120 SET PLAVLEST Lothar Spinneriargles heg a 130 ONPLAYEACEEND 140 i3 PRINT ks BORA LE TS TET MES PENAS 137 PRINT Playing TTEMAMES 1 133 PLAVTTERA 1 LH WAIT 186 ONFLAVEACEEND m 180 LET Nestitem 2 200 REM 702 REM Pilay ther hitiem aE REMI You can also set Playback options for the Playlist as follows Playlist View Audio Import Settings Help Random Order I C Lights off after each song PLOTest fsea View The view menu enables you to zoom in or out on the sequencer view define and use Perspectives and nominate which windows you want to have open Zoom in Selecting this option while on the sequencer tab will zoom in details on the sequencer grid xLights Nutcracker page 133 Zoom out Selecting this option while on the sequencer tab will zoom out the details on the sequencer grid Perspectives Perspectives saves the location and size of the windows you use Particularly for dual monitor setups it lets you move and size the Preview and Color windows away giving you a bigger program area Going to View Perspectives Save Current will store your settings to the currently selected perspective You can have multiple perspective saved and easily recall them by selecting the perspective desir
134. quence Import The Import button enables you to import timing marks created externally for example using Audacity or where you have created a timing track manually or wish to import one from another sequencer in a Supported format You will be presented with a window to navigate to and select a file containing the timing marks to import to the timing grid This can be a text file txt a LOR Ims file or a LOR LAS file xLights Nutcracker page 147 A Choose Timing file s GOL Organize New folder ir H amp Marre z Date modified Type care E di 215Sequences 23 07 2015 4 23 PM File folder it All Want For Christmas Is You Inputs 1706 2015 2 17 AM File folder f di Amazing Grace Inputs 13 05 2015 11 53 File folder di Backup 11 05 2015 12 11 File folder jy Blue Christmas Inputs 25 05 2015 X12 AM File folder 4 T 7 File pame Tati Tet files it LOR Ims i OR f lasi Select the required file click OK to import the timing grid marks If you select a LOR LMS or LAS file and it has timing marks in it you will be prompted to select the timing grid from within a window BOBesee PUM 2 BARA p iparkles Dene inghtness You can repeat this process to import another timing grid from the same file or from another file Click Done when complete Data Layers When should you use the data layer to import effects Typically if you have sequences from other s
135. r xLights Nutcracker page 83 Tip If the image is not scaled to your model eg matrix the scaled movement value will autoscale the image However it is better to scale the image externally to suit your model so that another movement value can then be used Tip The playback rate is influenced by the length of the effect So if you change the time length of your effect and have an image that is non stationary the rate of movement will adjust according to the new time length Caution If you move the image that you have used for the picture effect to a different location or Pixel Editor Matrix Drawing Tool You can use the Matrix drawing tools to amend a picture or draw your own pictures or animations Click on the Picture effect within the sequence grid that contains your effect and then open the Effect Assist window if it is not already open You will be presented with a window similar to the following i e the picture of your effect is copied to a grid APS j Load Image Image Current Image 0 Users d228061 Documents h Image Size 40 x 48 Model Size 64 x 64 The Matrix Drawing Tool has 8 windows each with a color and a radio button under the color to show you which color is selected You can change the color assigned to each window change the saturation hue brightness change the RGB setting etc xLights Nutcracker page 84 a Select the pencil tool and after selecting a color use t
136. r deselect all the Timing Tracks to be able to drop an effect on the sequencer grid Define a model Each model type is described in the Models section however to get going click on the Models icon and from the Models list window click New and on the Model window that pops up enter the following information L Model name P10 Matrix example xLights Nutcracker page 9 il Display Horiz Matrix jii Type of String RGB Nodes IV Actual of Strings 50 V of RGB Nodes per String 50 vi of Strands per String 1 vii Start Channel 1 viii From Output 1 IX Starting Corner Top Left X Part of my Display Tick xi Model Brightness Adjustment 0 Model Name P10 Matrix Individual Start Chans Custom Model E a Display As Start End Type of String RGB Nodes l 11800 11991 2 11992 12183 Actual of Strings 64 12184 12375 12376 12567 of RGB Nodes per String 64 12568 12759 12760 12951 12952 13143 Start Channel 11800 From Output 1 a 13144 13335 13336 13527 Starting Corner Top Left Top Right 13528 13719 13720 13911 Bottom Left Bottom Right 13912 14103 14104 14295 7 14487 Model Brightness M 0 14679 Adjustment 14871 nce ppearance 15255 15447 15639 n 15831 22 15832 16023 1i of Strands per String 1 Part of my display V Click OK to save the model Add a model to the sequencer From th
137. r effects will be rendered last Refer to discussion under Move Up Move Down xLights Nutcracker page 150 Info Media Meta Data Timings Data Layers S Layers to Render A Nutcracker 3 Feliz Navidad_3 seq Source D Users d228081 Documents My Lights Sequences Feliz Navidad Inputs Feliz Navidac Data O Users d228081 Documents My xLights Sequences 20155equences Feliz Navidad_3 iseq Number of Channels 16384 Channel Offset 0 On the Main Menu click on the Render All button after which the sequence can be played Click on the Save or Save All buttons to save the sequence Tip You must click Render All or Save the file as after the Import function is complete the data is not automatically rendered Tip To view the details of the data that has been imported double click on the model s row title to reveal the strands and then the nodes The imported effects are at the node level Delete Use this function if you wish to delete a data layer that has been created via the import function Select on the layer and delete Move Up Move Down While the most common use of this function is to import effects from a previous sequencer once per sequence you can import multiple layers to be rendered at the same time An example of this is where you may have two purchased LOR or other sequences for a mega tree singing faces Or you may have xLights Nutcracker effects on a whole house model whi
138. r open depending on the Effe setting value Examples Center Two curtains will move from the outside to the inside center of the model or from the inside center to the outside of the model Bottom The curtain sweep will be from the top closing or opening out towards the bottom Denotes whether the curtain should open close open then close or close then open Used conjunction with the curtain edge direction Defines the curve of the curtain effect A value of zero will depict a straight curtain edge A val of 10 will depict a curved curtain edge with a sweeping drop Swag Speed Defines the speed at which the curtains will close or open Tip You can use the curtain effect layered with any other effect as a mask to reveal the other effect Q xLights Nutcracker page 66 Faces ses J Effect Icon The Faces effect is used by xLights Nutcracker to generate singing and talking face effects It is used and placed on the sequencer as part of the Papagayo import functionality if the target in xLights Nutcracker is a Coro face 5 Sequencer representation It is also used within xLights Nutcracker functionality to generate Singing Faces The use of this effect is described in the section describing Singing Faces xLights Nutcracker page 67 1 Q mD Effect Icon Sequencer representation LO C Description The Fan effect creates spiralling blade like objects that move around
139. s p Glediator Record File gled Leb LOR clipboard Icb HLS hlsnec xLights Sequence xseq xLights Nutcracker page 23 Setup Test Convert Layout Schedule Papagayo Sequencer Xmas 2015 Playlist 1 xLights File Converter Entries on the Setup tab will guide the conversion Make sure you have your lighting networks defined accurately before you start a conversion For LMS imports LOR networks should be first followed by DMX starting at universe 1 Sequence files to convert Conversion Messages Choose Files Output Format All channels off at end LOR Import Options Map Empty LMS Channels E Map LMS Channels with no network Show Verbose Channel Map F Time Resolution 50 ms Click on Choose Files and on the subsequent window change the file type to the type of file that you wish to convert and navigate to where your input file i e LSP MSQ file LOR LMS file etc is located Double click to select the file 2 Select the output Format to convert to Supported formats are Falcon Pi Player fseq xLights Sequence xseq Lynx Conductor seq Vix Vixen 2 1 wix sequence file Vir Vixen 2 1 wir routine file LOR Sequence las or lms Glediator Record File gled Leb LOR clipboard Icb HLS hlsnec Specify whether all channels should be turned off at the end of the sequence Tick if unsure Select the Show Verbose Channel Map This option will display messages pertaini
140. s found co far 1000 Track 1 length 14993 centiseconds 7 l c apnnelz r Lapi chani T loal channels i ARMING channel CORO4 P21 Red is unmapped I b 1 R HING channel CCRO4 P21 Green is unmapped i 21 Blue iz unmapped I If annel CCRO4 WARNING channel CCRO4 P22 Red is unmapped Nits channel COCRO4 Pe Green s unmapped MING channel CCROd P22 Blue is unmapped I Niy channel ff Phd PY4 Bed m snrmannesl The messages tell us that two networks are required One with zero channels this was a star where channels were deleted from one with 1800 channels Go to the Setup tab and define these setup tab Existing layout Nenenik Type ELJI 1020 1 11 7 lal a10 E131 lO 20 1 206 a i Baud Rate or ELJI Un Mum Charen cLights Vinen FPP Mapping a A J i WI hannes to IE Ed SS E eA I mi i F Lr Lava E i j b a l i Gi a m i Ln Lhi p mn m i i I ET i o i innmets sil te ij JE 1020 1 206 G 5 Chantel 2551 to 3080 ELF 10 20 1206 7 al Channels 2061 te 3570 Et 4 lo tle Charmnmeje l to JEW ELJ 10 20 1206 4 A Channel 3501 te 3 Add two entries Network type of LOR any baud rate however the last channel must map correctly Then move them to the top using the green UP arrows xLights Nutcracker page 163 E iyi rt Baud Fateor ELJI U i n FPP fla F winne Tt id j els te i i ele 1301 t 0 10 70 12 Z af amneis ZIEL to 2820 L
141. s to other commonly used software Macintosh The latest release of xLights Nutcracker for Macintosh can be found at the following link http www dankulp com xlights C M O D Linux Most Linux users pull and compile the latest code checkin The repository for the xLights Nutcracker code is at https github com smeighan xLights Installing If this is an upgrade to an existing xLights Nutcracker setup make sure that you backup your existing files before installing a new version The install process does not delete any of the files required for your sequences or setup as these files are kept in the show and media directories To backup your existing files follow the procedure described in Chapter 5 Menus or just press F10 Caution Before you install any new release of the software it is very good practice to backup AY your key xLights Nutcracker files using F10 Note that if you have any sequence currently open g then changes to the effects views models etc may not have been saved until you exit xLights me Windows 1 Download the required released executable file and save to any location on your Windows PC 2 Double click on the downloaded executable 3 The xLights Nutcracker setup Window will be displayed xLights Nutcracker page 13 Welcome to the xLights Nutcracker Setup Wizard Ta d raia agn Pro ede or 4 an eor 4 Click on Next 5 Select the destination location Leave as is to upgrade to a new release
142. s used to calculate the spirograph movement r Radius of inner circle This defines the radius of the inner or moving circle that is used to calculate the spirograph movement d Distance Defines the offset distance of the point of the spirograph that is used to calculate the spirograph movement d Animation Defines the level of animation or movement of the spiral away from the axis A higher value will cause the spiral to expand outwards Length Defines the length of the expansion of the animation Note r should be lt R xLights Nutcracker page 96 Strobe Effect Icon Sequencer representation RE Description The Strobe effect provides an effect where light particles turn off and on rapidly but at fixed intervals Prerequisite information One or multiple colors can be used for the effect Option Settings Description Number of Strobes Controls the number of particles that form part of the strobe effect Strobe Duration Controls the duration of the particles being on as a result affects how quickly or slowly the particles turn off and on Strobe Type Unused at this stage xLights Nutcracker page 97 Text Effect Icon pa Sequencer representation kH Description The Text effect enables upto 4 lines of text all individually controlled to be displayed The content of the text can be static but can also include countdown timers Prerequisite information One color can be selected for each line of t
143. se an absolute location reference i e you specify the exact location If you move the location of your images it won t pick up the new location E Similarly location won t change if you change your show directory You may wish to consider lui having all your images in a separate location outside your show directory Timing Tracks Next add a new Timing track Timing tracks can be added via the Setting Sequence Settings Timing menus Select a Timing Track of type Empty and click on OK to add it Double click on the name of the timing track and change it to something meaningful such as Lyrics If you have more than one Voice then repeat this process for the second Voice i e Add a new Timing track Select one of type Empty and click on OK to add it Double click on the name of the timing track and change it to something meaningful such as Lyrics 2 On the sequencer tab select Edit Display Elements and add the new timing track s Lyrics Lyrics2 or any other name of your choice to the view that you are working with If the Singing face model is not part of the view then add that to the view too Importing Phrases Phrases Lyrics for Voice 1 Select the Timing Track Lyrics and for clarity deselect any others There are two ways to add the phrases lyrics to the Timing Track Importing the entire set of Lyrics Obtain the lyrics from the internet or elsewhere copy them then Right cl
144. seconds 0 3600 7 oao Cancel Specify the number of seconds for the delay Click on Save Playlists to save the Playlist The playlist will be displayed as a tab next to the Sequencer tab Rename To rename a Playlist click on the Playlist tab that you wish to change then click on the Playlist tab then select Rename You will be prompted for a new name ipagayo Sequencer Xmas 2013 Playlist 1 Playlist Moi Mot Filename Delay s Delete To delete a Playlist click on the Playlist tab that you wish to delete then click on the Playlist tab jle Playlist View Audio Import Settings Help then select Delete You will be prompted to confirm the deletion Click OK to delete or Cancel to return xLights Nutcracker page 132 Refresh This option is used to refresh the screen with a list of Available files To be used if you have just added any new Audio Video or xLights Nutcracker sequence files to your show directory Select Playlist and then Refresh Custom Script If this option is elected for a playlist the BASIC language scripts used to run the playlist is displayed You can then edit add custom scripts to perform actions such as send out RDS data play a video etc Playlist Wie Mode di Set dely Piper Pay Al Remove Script Plenare Delay is 100 REMA l gt e 100 REMA Creed OFS LERA He s the Aussie Sentahieg 102 REM Raeetsere off E sChiimad Time Again tebadea ting E 103 REMI Re
145. series of zigzag branches against a colored background This effect is best used against a tree type of model such as a mega tree Prerequisite information The first color selected will be used as the background color for the model i e the mega tree Subsequent color s will be used for each branch Number Branches Defines how many individual branches are created for the effect Speed Controls the speed at which the lights of the branch move across the effect xLights Nutcracker page 100 Twinkle Effect Icon Sequencer representation Description The Twinkle effect provides an effect of individual particles turning off and on slowly or rapidly similar to the shimmer effect but with a different and more random implementation Prerequisite information One or multiple colors can be used for the effect Number Lights Defines and changes the number and pattern of the lights twinkling from a scattered pattern to lights closely aligned to an intense pattern Twinkle Steps Controls the speed and accordingly the smoothness with which the colors of the lights change Strobe If selected will generate a strobe like effect to the twinkle xLights Nutcracker page 101 Q lt 4 Effect Icon Sequencer representation wH Description The Wave effect generates a waveform effect across the model Different types of waveforms are possible as described below Prerequisite information One or multiple c
146. t Name Archl 6C Arch2 6C Arch3 6 Arch4 62 Arch5 6 Arch6 6 4 w Model Width 50 p Model Height 50 U 0 1 Click on the image button to browse and select an image of your house or other setting Use the set size button to adjust the size of your image to fit your display and use the fill background attribute to expand the image to fit your display 2 The brightness slider is used to control the brightness that the sequence displays on this layout and can be used to increase the brightness if individual models have been set to less than full brightness 3 You can also change the layout display brightness for individual models via the Modify Models function 4 Click on the Open Sequence to open a sequence if one is not already open or to open a different sequence Note While it is possible to have more than one xLights Nutcracker sequence open at the same time this is not recommended 5 The first time the layout is set up the position of each model has to be defined on the layout The positions of models can be changed at any time however they should reflect where your live models will be placed so that effects that work at a Model group level or whole of house level can present an accurate representation of how your display will look live In order to do this a Click on the model from the list in the Preview Models window xLights Nutcracker page 26 b In most cases the model image will display in th
147. the last line indicating the name of the fseq file and how long the save process took xLights Nutcracker page 128 Save As Sequence To save an open sequence with a different name either use the Save As Sequence icon or select Save As Sequence from the File menu You will be presented with the Save As dialogue window to enter the name for the sequence If the Render on Save setting under the Settings menu is set i e ticked then all the effects on all the models will be rendered first before the sequence is saved in the fseq file This is the default Progress status messages are displayed on the last line of the window When the sequence has completed saving a message will be displayed on the last line indicating the name of the fseq file and how long the save process took Close Sequence To close the currently open sequence select Close Sequence from the File menu If the sequence data has not been saved since the last change you will be presented with warning cx The sequence you are closing has unsaved changes Please choose whether you would like to Save or Discard the changes or hit Cancel to return to the sequence Save Changes Discard Changes Cancel Click on Save Changes if you want to save your changes If you click Cancel then you will be returned to the sequence If you select and click Discard Changes then the sequence will be closed without any sequence changes being saved Select Show Folder
148. to group and display effects To amend details similarly click on the Select Model Groups button and then click on Edit Groups highlight the group add or remove models make any other changes and then click Update Groups 10 To play the sequence and watch the effects click on the Play button to start the sequence Note You must use the layout controls which are different to the same controls used for the sequencer O J You can then pause and restart the sequence or stop the sequence You can also start at any point by moving the slider xLights Nutcracker page 27 a 004 579 4 5795 p Tip If you have a model groups displayed on the Layout screen then it will only display models that are part of the model groups Therefore it is useful to have a Model Group say All Models and include all the models for your show and include that model group on the layout tab Moving Objects around For a single object you can left click on the object it turns yellow and with the mouse button still held down drag it around To move more than one object around together Press the Control key first and then left click on each object that you want to move as a group holding down the control key all the time Then at the last object drag to move all the selected objects around together If you release the Control key at any time the objects will not move as a group Aligning objects Select a group of objects right c
149. unning as you want on different elements of your display If you create an fseq called background eseq and upload to the FP it will execute as soon as the FP has started i e no definition is required on the FP Right click to the left of the sequencer grid and select Export Model xLights Nutcracker page 49 Model Group All Singing Face New P10 Matrix Group P10 Matrix F ee Insert Layer Above Arches Group Insert Layer Below Archl Arch Play Model Arch Export Model Arch Toggle Strands Arch Promote Node Effects Arch Edit Display Elements HouseHorGroup You will then be presented with a window where you can select the target sequencer type and the filename to be created Press OK when done Status messages will be displayed on the last line of your sequencer as the model is exported The file will be created in your show directory a l m Export Sequence Boe 5 La Format Lcb LOR Clipboard lcb File name OK Cancel Tip You can use this functionality to export a models effects to the Falcon Player and then use the effect to run a continuous background sequence such as a Tune to sign independently of sequences running in via the fseq file xLights Nutcracker page 50 Import Model There is no functionality to directly import an xLights Nutcracker model that someone else has created However since models are defined using xml you can copy them into your xlights
150. user_dictionary file to the folder where you store your Sequences This user dictionary is a simple text file which can be edited by using a text editor such as windows notepad or any other text editor such as Notepad to open this file The only file that you should make any additions to because the other two files will be overwritten each time Nutcracker is installed When you first open the user_dictionary file it will contain the information shown below Fis Dis Pemma Wea Hi oe Tou tin W your oan mardi fo it er digt Grmi aa H Bm H ioi Proper remti ot hppa im the itinira dick torus LEF in ciara morc wil i kel not kgpiir z Each Wiry mui an Wine ia the Pile Firat ij t mord i oraal ly er ithe aa xt the h tha word fa Fat iga by eets wide th pronounce ik The ia ag J h t ani Pye phoneme nest Freiten Alir Be er ie The Fi eg ne ore oe cons ile ilis more iing u pi EHP 1 will alio alig Pa ugayo to map them to exher g iets im t Fa tute re Te tart with there ip fuit one paeple entry in this dictionary WETA mA W il OF Oe xLights Nutcracker page 120 Before continuing create a text file containing all the words that did not have an associated NutcrackerPapagayo phoneme breakdown created for usually name this file is missing words txt and put it in the same folder as my sequences There is no special formatting just a list of words one per line is required One thing to note here is that if you have any
151. xLights Nutcracker Model Groups are sequenced against an internal grid representation The Layout Mode and Grid Size provides options on how the internal grid is to be calculated when effects run across a model group xLights Nutcracker page 52 A list of all available defined models will be displayed in the left hand window Use the arrows to add models to the Group Click on Update Group when complete To modify the models that form part of a group click on the group name in the top right hand window File Playlist View Audio Import Settings Help ROBeSSe4irouaaenme Ame ARES LE lS Model Groups Model Groups Arches Group ag Candy Canes Group T Ti f Candy Canes Group HouseHorGroup HouseHorGroup HouseVert Group F HouseVert Group Remove Group Icicles Group Icicles Group LI ee i Lanterns Group Model Group All P10 Matrix Group Group Details Group Name Candy Canes Group Layout Mode Grid as per preview or ee a a CandyCanel Grid Sze 400 Tash CandyCane2 Add to Group Models in Group CandyCanes r CandyCane4 EUDE Ine Archl CandyCanel Garane ad amti Arch CandyCane A Archs CandyCanes vo aa EETA Arch a Achi 3 wp ane paa Garage Al Model Width 30 ls IciclesL g ae TciclesM Model Height 50 J Vi ov The models that are currently in the group will be displayed in the Models in Group window and the other models will be

User Manual - Nutcracker

Contents

Download Pdf Manuals

Related Search

Related Contents