Release Notes/099/2019.30000 Experimental
Download Here for the latest build in this branch.
Build 2019.33020 - Oct 18, 2019
- Kinect Azure TOP / Kinect Azure Select TOP / Kinect Azure CHOP - The new Microsoft Kinect Azure is now supported in TouchDesigner via these 3 new operators. Please note that Microsoft is updating this new SDK at a fast pace. We will support future changes and additions as the SDK matures and improves. (Windows 10 only, see requirements)
- Kinect Azure TOP - This is the main operator used to configure all the settings for the Kinect Azure, as well as get data from one of its cameras (Depth, Color, IR, Player Index, or Point Cloud). Only one Kinect Azure TOP can be connected to each Kinect Azure device.
- Kinect Azure Select TOP - This TOP references a Kinect Azure device through the Kinect Azure TOP (above) and retrieves additional images from the other camera streams.
- Kinect Azure CHOP - This CHOP references a Kinect Azure device through the Kinect Azure TOP (above) and retrieves body tracking information, including bone positions and rotations, and IMU sensor data.
- RealSense TOP - Updated to SDK 2.29.0 and the following additions
- Added support for T265 cameras. NOTE: The driver is not stable yet when changing parameters, work in progress.
- Added support for setting arbitrary options for the devices via a CHOP.
- Complete list of RealSense Options
- Names will be all lowercase, and omit the RS2_OPTION_ from the start. E.g RS2_OPTION_ENABLE_AUTO_EXPOSURE can be set with a channel named 'enable_auto_exposure'.
- Pangolin CHOP - New CHOP interfaces with Pangolin's Beyond laser show control software.
- When Beyond is running, the Pangolin CHOP will send laser image frames to it.
- Image frames are created from either a SOP input or CHOP input.
- TouchDesigner Non-commercial will only work with the demo version of Beyond. TouchDesigner Commercial or Pro is required to interface with licensed versions of Beyond.
- Ouster TOP - New operator for real-time point cloud capture from Ouster lidar sensors.
- Direct support for the OS1 Ouster product line.
- Additional sensor data like IMU, packet counts, matrices via Info CHOP and Info DAT.
- Visual Panoramic and Scan Order capture formats selectable in 'Image Layout' parameter.
- Flexible X, Y, Z, Range, Intensity and Noise plane mapping to RGBA GPU Image Channels
- Time Sync Mode for supporting multiple devices in the same area (Internal OSC, Sync Pulse In, PTP 1588)
- Auto startup features
- Window Rejection mode
- Positions and transforms are now given in TouchDesigner space (Y is up) rather than sensor space (Z is up).
- Ouster Select TOP - New TOP to select additional fields from the Ouster scanner.
- Point File In TOP - Added support for converting shapes into point clouds when loading .obj files.
- Point File Select TOP - New TOP to select additional channels from a Point File In TOP
- Movie File In TOP - Added support for NotchLC codec.
- Movie File In TOP / Point File In TOP - Added support to store and display header data in an attached Info DAT (currently supported in FITS and PLY files).
- Movie File Out TOP - Major improvements for hardware encoding, audio channel support, and custom header data.
- Added parameters for saving more than 4 channels per frame (currently only supports EXR images), allowing you to save out point cloud files with an arbitrary number of channels.
- Added support for Lossless H264 and H265 hardware encoding on Nvidia GPUs.
- Can now record more than 8 audio channels on supported codecs.
- Custom header data can now be written to files by attaching a Table DAT (currently only supports EXR sequences).
- Video Device In TOP - Added support for GPU Demosaicing for Ximea cameras.
- Video Device Out TOP - AJA devices can now sync to SDI inputs for their reference inputs.
- NDI In TOP / NDI Out TOP - Upgrade to NDI 4.0 and added support for transmitting 16-bit data.
- Custom Operators - Added support for 16-bit fixed and 16-bit float data to and from TOPs.
- TOPs - Now support saving .tiff files with 16-bit image depth using RMB "Save Image" and python TOP.save() method if the 'Pixel Format' is set to 16-bit float.
- GLSL MAT - Added TD AttenuateLight(int index, float lightDist); function.
- Audio File Out CHOP - A new CHOP for recording and saving multi-channel audio files.
- Timer CHOP - Added optional third input for 'Input Index' to drive current position of the timer.
- LTC In CHOP - Added total_seconds channel and toggle parameters for frames, seconds, min channels.
- Particle SOP - Added 'Birth' pulse parameter to birth particles accurately. Works in conjunction with a new 'Birth Count' parameter which determines how many particles are created each time 'Spawn' is pulsed.
- Geometry COMP - Improvements
- Now can calculate bounds when instancing from TOPs.
- New 'Active' parameter available for instancing to control on a per instance basis if each instance should be shown in the render.
- Geometry COMP / GLSL MAT - Added support for custom instancing attributes. For Geometry COMP this is found on the Instance 3 page.
- SocketIO DAT - Fixed issues with connecting to non-secure servers (ie. http).
- Web Server DAT - Additions and improvements.
- Change Stop/Start pulse to instead be an 'Active' toggle and 'Restart' pulse, making it easier to have a Web Server DAT start on launching of a .toe file.
- Added error handling on server start failure and accompanying Info CHOP channels.
- Added support for HTTPS
- Added onWebSocketClose callback.
- Added 'PointClouds' folder and pointGenerator, pointRender, pointTransform, and pointWeight components.
- Widgets updated to tdui.0.30.10.twwk.1.0.2
- Added new font auto-scaling based on a ratio parameter instead of a locked font size.
- Font controls now have a 'Font Side Mode' and 'Font Ratio' parameter. To see it work activate it and scale up the size of the widget.
- TDJSON - All functions now work with built-in parameters.
- TOP Class - New
cudaMemory()method which allows the TOP's memory to be copied to CUDA memory on the GPU, for use with CUDA libraries in Python.
- OP.pars(pattern) now supports legacy parameter names.
- Point Class.normP returns the normalized point within SOP bounding box. This is equivalent to $BBX $BBY $BBZ in tscript. Previously this was limited to a few specific SOP parameters.
- SOP Class maximized .min .max .size members
- Custom Operators - OP_NodeInfo class now has a 'pluginPath' member.
- Par.enableExpr to get or set an expression that controls the enable state for this parameter.
Bug Fixes and Improvements
- NDI - Upgrade to NDI 4.0.
- Notch TOP - Upgrade to SDK v0.9.22
- RealSense - Upgrade to RealSense SDK 2.29.0
- ZED - Upgrade to SDK 2.8.3
- CUDA - Moved back to CUDA 10.0 to match support with Kinect Azure and ZED requirements.
- Point File In TOP - Improvements
- Added column headers to the Info DAT and unavailable channels no longer appear in the assignment column.
- Moved the channel selection parameters to the first page and the playback parameters to the second page.
- Changed the channel selection parameters to drop-down menus and added options to fill a channel with ones or zeros.
- Changed references of "fields" to "channels".
- Resolution parameter boxes are disabled unless 'Custom Resolution' is selected.
- Movie File In TOP - Now correctly handles orientation metadata for .jpeg and .tiff images and .mov movies.
- Movie File Out TOP - 'Add Frame' pulse now works for 'Image' output types.
- Video Device In TOP - Fixed slow performance when trying to connect to a camera.
- Video Device In TOP - Fixed DirectShow device selection being off by one.
- ZED TOP - Renabled in this release branch after upgrading to 2.8.3 SDK.
- Notch TOP - Fixed bug with GPU memory usage in the pop-up info. It was not including the GPU memory usage of the block itself.
- GLSL MAT - Added more Matrix parameters that take single matrix input.
- Line MAT - Now has more accurate picking values when render picking.
- Engine COMP - Now runs TouchEngine from the in-use version of TouchDesigner. This fixes the previous situation in which the last-installed version was always used. Users can still override this behaviour by placing a link to a particular installation named "TouchEngine" next to the .tox they are loading.
- Window COMP - Will now sync the resolution and view mode (image or points) when connected to a TOP.
- Fixed issue with TOP viewers opening at 400x300 all the time.
- Geometry COMP - Fixed crash when assigning a TOP to the Translate OP parameter.
- Geometry COMP - Relax restriction on different Instance OPs having the same length when using 'Instance Count Mode = Manual'. Now the OPs just need to have at least enough entries for all instances, but they can have more as well.
- FBX COMP - Added File Version to info pop-up and fbx_file_version Info CHOP channels.
- Bullet Solver COMP - Rename onFrameStart, onFrameEnd, and onInit callback methods to whileRunningPreSimulate, whileRunningPostSimulate, and onInitialize respectively
- Geometry Viewer -Improvements
- Geometry Viewer homes properly when first opened.
- Re-worked the scroll acceleration so it's based on the distance to pivot rather than the last home values, this fixes issues when the scroll speed would get very slow.
- Geometry viewer now saves the last home bounds to preserve the view when saving.
- Text SOP - Fixed a bug with uninitialized vertex positions.
- Object CHOP / Transform CHOP - Some cleanup for better behavior of new features and loading old files.
- TOP to CHOP - Fixed case where the CHOP would sometimes be empty on first cook.
- Timer CHOP - Now include timer_pulse even if segment is at least 1 frame long.
- CPlusPlus DAT - Fixed input op node string getting the copy of the cplusplus node string.
- Execute DAT - onCreate callback now called earlier in the load process.
- OSC In DAT - Blank lines no longer logged when non-scoped bundles are received. See below BACKWARDS COMPATIBILITY
- Web Client DAT - Improvements
- Web Server DAT - Improvements
- Fixed returning binary value in 'data' in the onHTTPResponse callback (eg. for returning images).
- Fixed webSocketSendBinary so that it properly handles bytes and bytearray input.
- Error DAT - Improvements
- Components now show errors from themselves as well as their their children.
- "source" is now the first column of the table.
- Removed the "Log" page and moved the parameters to the "Error" page.
- Geometry Instancing with TOPs - Fixed a crash that could occur when using TOPs for instancing.
- Better file type support - dragging PTS, XYZ and PLY files into TouchDesigner will automatically create a Point File In TOP and FITS has been added to the dragdrop list of extensions for the Movie File In TOP.
- Added total number of pixels to TOP popup info dialog.
- Fixed hanging when using Panel.width or Panel.height in some cases.
- Panel alignment using 'Max per Line' now works with fill and stretch weights.
- Fixed inside panel value not activating when overlapped by a sibling.
- Custom header parameters now display parameter label, not parameter value.
- Cloned components now preserve custom header parameter settings.
- Fixed crash when pulsing clone on component with custom parameters.
- Fixed startup errors and crash on .projects using external .tox references which triggered recompiling of extensions.
- Binding now using optimized expressions when possible.
- Removed shortcut for toggling all 'Viewers Always Active'. You can still access the setting in the Network Editors RMB-menu.
- Reverted Buffer Select TOP back to Render Select TOP. Hey, it's experimental right?
BACKWARDS COMPATIBILITY - Renamed vram_usage in Notch TOP's Info CHOP to block_gpu_memory_used.
BACKWARD COMPATIBILITY - ParMode, PaneType, and JustifyType are now Python style enums. They will work as usual except when accessing str(enumObject). To get the old result of str(enumObject), use enumObject.name.
BACKWARD COMPATIBILITY - OSC In DAT - Blank lines no longer logged when non-scoped bundles are received.
Build 2019.30790 - Aug 27, 2019
- Python 3.7.2 is now the built-in version of python. Backward Compatibility warning, see below.
- Engine COMP - This component will run a .tox file in a separate process using TouchEngine. *Work in progress*
- Instancing with TOPs - Keep data on the GPU.
- On the Geometry COMP you can provide it with a TOP and it will render an instance for every pixel in the TOP. For example, floating point red, green, blue channels can be assigned to the instances' X Y and Z positions.
- In addition, you are no longer limited to one OP for specifying instancing data. The Instancing pages have been expanded so you can specify TOPs, CHOPs, SOPs, or DATs for every instance attribute interchangably. For example, position from a TOP and color from a CHOP.
- Point Clouds and general data with TOPs - Working with more data types on the GPU.
- Point File In TOP - .
plyfiles (Windows only). It will create a square multi-RGBA buffer with pixel format 32-bit floats. Generally it can be set up as one pixel for each point, and the pixels that are unused contain NAN (a special value called Not-A-Number).
- The operator's pop-up info shows the number of points and channels.
- An Info DAT attached shows the channel names in the file. The first 4 channels are put into RGBA (buffer 1), the next 4 channels are in buffer 2, etc
- Buffer Select TOP - Formally known as the Render Select TOP, this TOP is now more general-purpose and can also select buffers from a Point File In TOP if multiple buffers exist.
- TOP Viewer modes have been extended.
- 'Normalized Split' displays each channel separately as a normalized grayscale image with min and max values overlaid.
- 'View as Points' will visualize the data in a 3D Viewer like in SOPs, assuming the RGB channels contain XYZ point data.
- Point File In TOP - .
- Math TOP - Ranges can now be changed on individual color channels.
- Bind CHOP - Use CHOP channels for binding with parameters.
- Allows for multiple inputs (like old Override CHOP) or the bound parameter to update a channel's value.
- Includes a 'Callbacks DAT' for querying where the change was initiated and then taking further actions via python script.
- 'Channel Pickup' parameter doesn't change the value of that parameter until the input value crosses the current value.
- Binding - Binding to DAT text or table cells is now supported.
- Function TOP - New TOP allowing mathematical functions to be done on pixels, similar to the Function CHOP.
- CHOP to TOP - A new option to wrap long channel data into multiple rows of pixels when the channel's length exceeds the GPU's maximum texture width.
- Movie File Out TOP - TIFF image formats can now be saved out at higher 16-bit pixel format.
- Video Device In TOP / Video Device Out TOP - Upgraded to Blackmagic SDK version 11.
- Video Device In TOP - Added support for bandwidth and camera bit depth controls for Ximea cameras.
- Video Device In TOP - Added support for using the HDMI input from AJA io4K devices.
- Video Device Out TOP - Added support for Fill + Key pairs for AJA devices.
- Audio Movie CHOP - Added an option for switching audio tracks when movie files contain multiple tracks.
- Keyboard In CHOP - Keys are now defined in a space or comma separated list rather than as neighbouring keys on the keyboard. Old files are automatically updated to the new system when they load (only works for constant parameters).
- Added shift key support to the 'Modifier Key' parameter menu.
- Added 'Panels' parameter so events are only triggered when the given panel has focus.
- Mouse In CHOP - Added 'Panels' parameter so events are only triggered when the given panel has focus.
- Object CHOP - Improvements
- Reorganization of parameters and pages.
- Added '4x4 Matrix', '3x3 Matrix', and 'Quaternion + Transform' to the 'Compute' menu.
- Added "xord" and "rord" channels to Transform output.
- Added "Swap Target/Reference" toggle parameter.
- Transform CHOP - Overhauled and improved.
- Now accepts two inputs. Added 'Invert Input 0' and 'Invert Input 1' parameters. Also added some warnings when two inputs are not compatible or invalid inputs.
- Added '4x4 Matrix', '3x3 Matrix', and 'Quaternion + Transform' output.
- Now supports Vector sets and performs Matrix-Vector multiplication.
- Added Vector/Position options for Input 1.
- Added toggle parameters to control output.
- Added Operation and Coefficient parameters for final output values.
- Added 'Unmatched Channels' parameter.
- Now accepts xord and rord channels as part of TRS channels.
- Swapped the Input and Transform pages.
- Renamed 'Invert' to 'Post Invert' on the output page.
- Changed the 4 Invert toggles to a menu of Unary Operations.
- LTC In CHOP / LTC Out CHOP - Improved to support higher frame rates and more.
- LTC CHOPs now work for higher frame rates.
- LTC In will now adjust the frame value based on the value in the User 1 channel.
field1is now automatically used for frame rates over 30.
- Added an option for LTC In to display the number of 'Total Frames'.
- Timeline CHOP - Added options for 'Second', 'Absolute Frame', and 'Absolute Second'.
- Hold CHOP - Added 'Hold per Sample' parameter.
- Pattern CHOP - Added 'Random Non-Repeating Integers' to the 'Type' menu which will randomly change values whenever the 'Randomize' pulse parameter is pressed.
- Web Server DAT - New DAT which runs a web server in TouchDesigner, currently supports handling of HTTP requests and webSocket connections. How client requests are handled is left up to the user via a 'Callbacks DAT'.
- Web Client DAT - New DAT that acts as a web client. This replaces the deprecated Web DAT. Includes
- SocketIO DAT - New DAT for extended socket.io functionality, separate from the older functionality of the WebSocket DAT.
- Raster SOP - New SOP that takes a TOP and converts it into a single-line SOP that can be used with the Laser CHOP.
- Aligning SOPs to their X, Y, and Z axes: Rectangle SOP / Box SOP / Circle SOP / Grid SOP / Sphere SOP / Superquad SOP / Torus SOP / Tube SOP - Added 'Anchor' parameters to main SOP generators. The position stays stationary regardless of rotate and scale settings.
- Text SOP - Added 'Vertical Align' parameter with options: First Line, Top, Center, Bottom. The chosen field will be aligned to the x-axis.
- Text SOP - Added 'Scale Font to BBox Height' parameter to scale the font's vertical size so it's based on the vertical bounding box of the font, rather than the typical way a font is sized.
- Select SOP - Now allows multiple input ops to be specified in the 'SOP' parameter, acting like a Merge SOP.
- Merge SOP - Added 'SOPs' parameter to accept multiple SOPs by reference.
- Join CHOP - Added 'CHOPs' parameter to accept multiple CHOPs by reference.
- DATs - Execute DATs will now accept multiple OPs to monitor.
- Replicator COMP - Added a new onRemoveReplicant() callback to destroy replicators.
- Header parameter type added which acts as a label and section divider. It is like parameter sections but you can give it a text string label.
- Page Class - methods and members will now also work for built-in pages.
- Page.appendHeader(name) - Appends a custom parameter that displays only the value, left justified, with no editing ability. Can be used in combination with Par.startSection and Par.enable.
- Par Class.page member can now return a built-in page.
- Par Class.subLabel member added.
- Par Class - Added collapser/collapsable boolean members, these are for collapsable parameters like those found on MATs for texture map's Texture Sampling Parameters.
- Par Class.bindRange member added, when true then min, max, clampMin, clampMax, normMin, normMax, normVal values will be based on master bind parameter. (Custom Parameters only)
- OP Class.pages() method returns a list of the operator's built-in pages.
- Added createFolders flag for .save() the functions in COMP, TOP, CHOP, SOP, and DAT classes.
- textTOP_Class / textSOP_Class - Added
lines()method to inspect the text after it has been formatted by things such as word wrap.
- textSOP_Class / textTOP_Class - Python objects returned from
lines()method now have
- textTOP_Class / textSOP_Class - Added members to access more font metrics such as ascender, descender, capHeight, lineGap and xHeight.
Bug Fixes and Improvements
- Critical Bug Fix from 2019.30550 - Files loaded and then saved in 2019.30550 with Unicode strings (including Icons for Widgets) were corrupting those Unicode strings. This build fixes the issue, as well as attempts to recover the corrupted strings. Please check any unicode data you have in your file to ensure it loaded up properly, and re-save your file using this build.
- Upgraded to CUDA 10.1
- Geometry COMP - Geometry components and applicable object components now display bounding box information in their info popups. This also works with geometry instancing.
- Notch TOP - Added group names as section headers when generating the custom parameters of a Notch block.
- Analyze TOP - Added options to calculate RGBA independently for Minimum and Maximum operations.
- Text TOP - Position Units can now be changed when using a Table DAT to describbe text positions.
- Text SOP / Text TOP - Kerning renamed to 'Tracking' as that is the more correct term for that feature.
- Select CHOP - Optimized performance when using wildcards.
- Object CHOP - Use default values when no Targent and Reference Op are provided.
- DMX In CHOP / DMX Out CHOP - Increased the baud rate for reading and writing through generic serial interfaces.
- OSC In CHOP - Fixed stripping name segments.
- OSC In CHOP - Renamed 'Strip Prefix Segments' to 'Strip Name Prefixes'.
- OSC In CHOP - Added 'Reset Values' parameter to reset channel values to 0 without removing the channels.
- OSC Out CHOP - Enable Send Events Every Cook parameter for Time Slice mode, allowing OSC data to only be sent only when values change.
- Serial DAT / Serial CHOP - Windows version now includes list of all valid ports in menu, not simply COM1-COM8.
- OSC Out DAT - Removed optional input table which didn't make sense in an Output operator context.
- OP Find DAT - Fixed overcooking issue as well as optimizations in calling the default DAT callbacks.
- WebSocket DAT - Added 'Reset' pulse parameter.
- Web DAT is deprecated.
- Custom menu names now allow spaces, Font menus no longer introduce underscores.
BACKWARD COMPATIBILITY - Python 3.7.2 has 2 additional reserved keywords, 'async' and 'await'. Any scripts using these terms will need to be modified.
BACKWARD COMPATIBILITY - Transform CHOP was previously using rotate order as the output order even if the 'Custom Output Orders' was On.
BACKWARD COMPATIBILITY - Transform CHOP had Output Channels parameter removed, replaced by output toggles to customize the output channels.
BACKWARD COMPATIBILITY - Function CHOP fixed an issue where tanh(x) was being calculated as tan(x).
Each SOP has a list of Points. Each point has an XYZ 3D position value plus other optional attributes. Each polygon Primitive is defined by a vertex list, which is list of point numbers.
An Operator Family that creates, composites and modifies images, and reads/writes images and movies to/from files and the network. TOPs run on the graphics card's GPU.
An Operator Family that reads, creates and modifies 3D polygons, curves, NURBS surfaces, spheres, meatballs and other 3D surface data.
(1) The TouchDesigner window is made of a menu bar at the top, a Timeline at the bottom, plus one of a choice of Layouts in the middle. A Layout is made on one or more Panes, each Pane can contain a Network Editor, Viewer, Panel, etc. See Pane and Bookmark. (2) Nodes in a network are arranged using Layout commands in the RMB menu.
The Graphics Processing Unit. This is the high-speed, many-core processor of the graphics card/chip that takes geometry, images and data from the CPU and creates images and processed data.
To pulse a parameter is to send it a signal from a CHOP or python or a mouse click that causes a new action to occur immediately. A pulse via python is via the
.pulse() function on a pulse-type parameter, such as Reset in a Speed CHOP. A pulse from a CHOP is typically a 0 to 1 to 0 signal in a channel.
(1) A Geometry Component can render its SOP geometry many times using CHOP samples, DAT rows, TOP pixels or SOP points, (2) An instance is an OP that doesn't actually have its own data, but rather just refers to an OP (or has an input) whose data it uses. This includes Null OPs, Select OPs and Switch OPs.
TOuch Environment file, the file type used by TouchDesigner to save your project.
A built-in panel in TouchDesigner that contains a library of components and media that can be dragged-dropped into a TouchDesigner network.
Any of the procedural data operators. OPs do all the work in TouchDesigner. They "cook" and output data to other OPs, which ultimately result in new images, data and audio being generated. See Node.
The term "Frame" is used (1) in the Timeline, (2) as a time-unit in CHOPs, (3) as a time-unit in TOPs, and (4) with movies images which are read and created with TOPs.
Binding is a Parameter Mode that ties two or more parameters together, where changing the value of any one of the bound parameters changes value of all the bound parameters. The actual value is stored in one of bound parameters, called the bind master parameter.
To re-compute the output data of the Operators. An operator cooks when (1) its inputs change, (2) its Parameters change, (3) when the timeline moves forward in some cases, or (4) Scripting commands are run on the node. When the operator is a Gadget, it also cooks when a user interacts with it. When an operator cooks, it usually causes operators connected to its output to re-cook. When TouchDesigner draws the screen, it re-cooks all the necessary operators in all Networks, contributing to a frame's total "cook time".
A Time Slice is the time from the last cook frame to the current cook frame. In CHOPs it is the set of short channels that only contain the CHOP channels' samples between the last and the current cook frame.