{"id":16897,"date":"2012-12-21T10:50:09","date_gmt":"2012-12-21T15:50:09","guid":{"rendered":"http:\/\/www.premiumbeat.com\/blog\/?p=16897"},"modified":"2012-12-21T13:25:50","modified_gmt":"2012-12-21T18:25:50","slug":"autodesk-smoke-matchbox-node","status":"publish","type":"post","link":"https:\/\/www.premiumbeat.com\/blog\/autodesk-smoke-matchbox-node\/","title":{"rendered":"SmokeConnectFX: The Matchbox Node"},"content":{"rendered":"

Learn how to program your own effects using GLSL Shaders and create your own nodes with the Matchbox node inside Autodesk Smoke 2013’s ConnectFX.<\/h2>\n

\"Smoke<\/a><\/p>\n

With Smoke 2013’s ConnectFX Nodes<\/strong> there is almost nothing you can’t do. \u00a0So you may be wondering if there is a way to script your own effects. Well, Smoke has a node to help with that too. The Matchbox Node<\/strong> is a scriptable node built around the OpenGL Shader Language<\/a> (GLSL)<\/strong> to allow you to create your own shader effects. \u00a0I am not a coder or programmer, so for me scripting my own effect isn’t really in my wheelhouse. But for those comfortable crafting code, the Smoke Matchbox Node can be quite powerful.<\/p>\n

\"\"<\/a><\/p>\n

The Matchbox Node does come with a few interesting presets that can be useful. \u00a0When you enter the Matchbox Node you are taken to the Matchbox effects located in \/usr\/discreet\/<Smoke Version>\/matchbox. <\/em>The presets include Add, Color Noise, Color Replace, Cross Hatching, Dots, Fabric, Gradient Map, Matte to ZDepth, Median Filter, MipsMaps, Nan Replace, Noise, Posterize, Ripples, Sharpen, Switcher, Twirl, Vignetting, Warp, ZComp, ZFog, ZGlow, ZMatte, ZRays<\/strong>. \u00a0You must choose an effect first. Then you will be sent to the Matchbox UI.<\/p>\n

[Click on images for larger view]
\n\"\"<\/a><\/p>\n

Now a lot of these effects can be accomplished in other CFX Nodes, and can be done better there and with more controls. But these presets are more examples of what can be done. \u00a0They are also there so that you can examine the code to see how the GLSL syntax works.<\/p>\n

\"\"<\/a><\/p>\n

Some of the more useful presets are Dots & Fabrics<\/strong> that create some interesting visual effects not possible in other nodes. The ‘Z’ effects are also interesting, as they allow you some quick manipulations using a Z Depth output from Action.<\/p>\n

\"\"<\/a><\/p>\n

One very useful effect to use in your ConnectFX schematic is the Switcher<\/strong>. The Switcher allows you to pipe up to 6 different sources into the Matchbox Node and \u00a0keyframe which input ultimately sent to the output of the node. This allows you to switch from inout to input, much like a router or video switcher. \u00a0You can even dissolve between the sources, as well as cut. \u00a0This Matchbox effect makes it very useful for doing some simple cuts or mixes in one path of your CFX pipeline.<\/p>\n

\"\"<\/a><\/p>\n

How to create your own Matchbox effects:<\/h3>\n

The basic steps for creating your own effects are:
\n1. Write or Copy\/Paste GLSL code in a text file and save with .glsl extension
\nNote: I had issues with the text editor \u00a0app in OSX as it saves with a lot of hidden characters. \u00a0I would suggest a programming text editor like <\/em><\/strong>
\nText Wrangler.<\/a>\u00a0<\/em><\/strong><\/p>\n

2. Test the code by running it through the test_shader<\/em> script located in \/usr\/discreet\/<Smoke Version>\/bin\/
\n<\/strong><\/em>Open up a Terminal in OSX, [Utilities\u00a0>Terminal.app]
\nType cd \/usr\/discreet\/<Smoke Version>\/bin<\/em><\/strong> \u00a0 [Enter] <Smoke Version><\/strong> would be the folder name of your current version of Smoke. You can \u00a0 \u00a0Shift+CMD+G in Finder and go to \/usr\/discreet\/ to see what your current version of Smoke is. The Smoke 2013 retail release will be smoke_2013.2
\n<\/em><\/strong>Type .\/test_shader \/<location where you saved your .glsl file><\/em><\/strong><\/p>\n

3. Fix any errors reported by the test_shader output and test again.<\/p>\n

4. Package the GLSL code and the XML code together and place them in a folder for use later. You can use\u00a0\/usr\/discreet\/<Smoke Version>\/matchbox<\/strong><\/em>, which will keep your effect with the presets or organize them wherever you like. You will just need to\u00a0navigate\u00a0to the folder when you want to load your effect.<\/p>\n

\"\"<\/a><\/p>\n

When error free the test_shader output will give you \u00a0XML information \u00a0to help you set up the UI of the effect.\u00a0Simply copy the XML shader node description section of the test output into a new file and save it using the same name, but with an\u00a0.xml\u00a0extension. Remember to save it with the .glsl file.<\/p>\n

Autodesk’s Joe Billington has created a great video tutorial and takes you through the process of building a Matchbox effect. His demonstration is on Flame 2012 and Linux, but the same operations apply.
\n