3D Utilities

Updates Documentation

PDF documentation for the Unofficial Update v8 version of trueSpace. Authored with Scribus. Includes a new video file from the beta testing days that demos the copy skin weights button. The manual also includes some corrections and missing information for the original manual.

There is no installer for this manual. The trueSpace manual and Unofficial update must be installed first. Copy the files as indicated in the included text file.

WIP uu v9 preview pdf manual can be found here: https://united3dartists.com/ in the Software section

March 6, 2022

• update for March 5 2022 UU release
• removed many table of contents numbers - manual process
• authored shortcuts via script and LibreOffice Calc
• Note to self: see if Scribus is better in Linux

February 20, 2022

• update for Feb 13 2022 UU release

January 12, 2022

• update for December 28 2021 UU release

November 16, 2021

• updated for November 11 UU release
• add more clear history warnings and boolean layers note

October 30, 2021 and October 31, 2021

• update changes up to the Oct 15 UU release
• added missing shortcuts for material inspect and axis tool
• segregated the junk pages

July 10, 2021

• updated for June 10 release of UU
• add look at selection all windows
• remove shortcut esc = unselect
• physics cloth error original manual
• remove background shortcut - RB drag - Look At Selection All Windows
• light and camera panels Ctrl-RClick to open panel
• links from spot and projector to ies light tool

July 3, 2021

• updated to June 2 release of the UU

Fix Unofficial Update Restore

The Unofficial Updates has a flaw where it can easily uninstall toolbars and widgets that are not included with it.

Option #1: This replacement will change it so it only restores the intended objects. It also provides the option to not restore the objects. The script runs automatically on startup. If any of the objects are missing the panel will show with the missing objects in red.

Option #2: delete it, run Unlock UU9.RsObj to permanently delete the restore script.

Usage for Option #1:

When the panel shows, press the "Restore Red Selected Items" button to restore the items.

Uncheck the corresponding box and press the button to ignore the missing item.

To force the restore of an ignored item

• RMB the C3DC button to open the panel manually
• change the color of the item to pure red (255)
• push the button

Global Function Set

Comes pre-installed in the Unofficial Updates

Comes pre-installed in C3D Persistent Install v3

A Collection of functions to be reused anywhere. Includes functions for displaying message boxes with optional timeouts and opening frame panels.

drag into the link editor to install

The script requires the plugin, Clintons3dPlugin

February 28 2024

• added var for use with the new open floating panels script
• added Info popup dialog from the UU version

December 6, 2022

• bug fix: when closing any floating window that was open just before opening a tool panel the panel would become hidden

October 6, 2022

• bug fix/improvement for automatic panel alignment on open
• removed confusing comments
• renamed some functions and variables

September 24, 2022

minor adjustment to open panel code

September 3, 2022

• moved hierarchy functions out of the global function set(1100 lines down to about 500)
• more options for Question dialog, urgent to use exclamation icon instead of question icon and default button choice

July 30, 2022

• fixed open panel bug so works with non-UU version of tS
• Grouping and Parenting functions for toolbar and scene view 2

June 1, 2022

• add second argument to OpenPanel function, PanelWidth
• new OpenLogView function

JSON Function Set

Comes pre-installed in the Unofficial Updates v9

Comes pre-installed in C3D Persistent Install v3

JSON - JavaScript Object Notation functions used to translate JSON text to and from Javascript objects

drag into the link editor and press the install button

Open Floating Panel

Comes pre-installed in C3D Persistent Install v3

script for opening floating panels arranged from right to left

drag into the link editor and press the install button

persistent base install required

Global Function Set is required

The script requires the plugin, Clintons3dPlugin

To show the default panel of the selected node

• Activity.Run("/Scripts/CustomCommands/OpenFloatingPanel/Start")

To show the default panel of a defined node

• start = "/Scripts/CustomCommands/OpenFloatingPanel/Start"
• Node.Value(start, "TheNode") = full path to the node
• Activity.Run(start)

To show the default panel of a defined node at the mouse location

• start = "/Scripts/CustomCommands/OpenFloatingPanel/Start"
• Node.Value(start, "TheNode") = full path to the node
• Node.Value(start, "AtMouse") = true
• Activity.Run(start)

Options

• start = "/Scripts/CustomCommands/OpenFloatingPanel/Start"
• the node: Node.Value(start, "TheNode") =, default is blank(the selected object)
• show aspects: Node.Value(start, "ShowAspects") =, default is true to show the panel aspect choices, false will hide the aspect choices
• aspect: Node.Value(start, "Aspect") =, default is 3 which seems to be the default aspect for panels
• atmouse: Node.Value(start, "AtMouse") =, default is false
• mouse offset x: Node.Value(start, "MouseOffsetX") =, default is 0, offset the mouse location in the x direction(AtMouse=true)
• mouse offset y: Node.Value(start, "MouseOffsetY") =, default is 0, offset the mouse location in the y direction(AtMouse=true)
• allow duplicate panels: Node.Value(start, "AllowCopies") =, default is false

Aspects note:

• 0=icon
• 1=minimized
• 2=Exp
• 3=Default
• any extra aspects do not necessarily start at 4 and any undefined aspect numbers will open the default aspect

Notes

• Limited to 8 open panels that will automatically close when the source node is deleted
• after the limit is reached will give option to stop, if continue then the last panel will not auto close when the source is deleted
• can be easily expanded by copy fresh panels in to the encaps and rename to match the pattern
• AtMouse - mouse position will be relative to the active window

July 5, 2024

• new Allow Copies option
• new will change the aspect of an open panel instead of just exiting

July 1, 2024 - rereleased later the same day

• fix so can open panel if object is open in a le window view
• bad code got through qc - fixed

April 17, 2024

• open floating panel at mouse location option

March 11 2024

• trueBlue idea: fixed bug where panel would not close when the source node is deleted
• trueBlue: account for invalid selection

February 29 2024

• fix Aspect value not reset to default after run

Status Message (Old Version)

Comes pre-installed in the Unofficial Updates

Comes pre-installed (new version) in C3D Persistent Install v3

This script enables advanced control of the status line without generating undos and with optional timeouts for the message.

installation

1. reset the default context must have been run sometime in the past
2. drag into the link editor and press the install button

See techniques page for command details - techniques - status line

The script requires the plugin, Clintons3dPlugin, version v.1638429.

April 17, 2024

• increase pause timer period so log does not fill up with timer messages
  maybe not needed but makes me feel better

March 20, 2024

• fix bug where long pause will prevent scene item panels in the stack from updating - looking frozen

December 27, 2023

• update to match UU version - loads into kernel root instead of CustomCommands
• reset.js file is altered if status message script is not set for preobjects loading

April 19, 2022

• update to latest UU version of the script that has better performance, can spam the status line without losing it

Widget Scripts

Collection of scripts that were removed from the widgets for update and consolidation.

drag into the link editor and press the install button

The script requires the plugin, Clintons3dPlugin, version v.1638429.

Scripts

• ZoomToSelection
• ZoomToAll
• SetCameraView
• PEPivotSnap
• PEPivotSnapRotationToCenter
• PEPivotSnapRotationToSelection
• Widget Function Set - UU stuff = CycleViews, OpenAnimationBar, Show3DViewWidget, OpenLE OpenAE
  more UU10 stuff - Unselect, OpenPanelForSelected, BackgroundColors, PostprocessGlow
• CameraFromView

If UU is installed only the Widget Function Set will be installed

July 3, 2024

• fix zoom to for hair objects with high vrtex counts
• added missing updates from 2023 for the zoom scripts that were only in the UU

June 9, 2024

• update for new batch file and load on demand compatible - not load on demand, just compatible

June 8, 2024

• added uu10 Unselect, OpenPanelForSelected, BackgroundColors, PostprocessGlow

July 15, 2023

• fixed bug in zoomtoselection pe mode, restores the selection
• note: uu may have the bug in it's installation

July 4, 2023

• fix install bug where ZoomToAll loses point edit restoration
• found that all scripts were virtually identical to UU9 (uu9 addition of status message only difference), so only install the Widget Function Set for UU
• correction: Does not require Status Message script

February 26, 2023

• add Widget Function Set
• new installer

September 11, 2021

• more undo friendly code
• improved orthographic view zoom
• zoom all centered on all items instead of the selection

September 7, 2021

• add error message when try to pivot rotate without a face selection
• improved installer

Persistent installs

Basis for script installations that can be recovered from a context reset or a layout change.

Popups Toolbar

Popup toolbars for trueSpace 7.61.

Snapping Toolbar

Script and plugin combination for doing snap transformations inside trueSpace 7.61. It will move an object/element selection to the center location of another object/element selection.

Workspace Dimensions

Script and plugin combination for creating dimension objects inside trueSpace 7.61.

Unofficial Updates for Clinton

Changes to the unofficial updates to match my preferences and buttons for most of the widget shortcuts.

Prerequisite installer

Pre-install several required scripts that are needed by other scripts. Not for the Unofficial Updates

Batch installs

Install many scripts in one go. Replaces old Mass installer script

Align and Distribute

Recreate some of the alignment and distribution functions of Inkscape to organize the locations and rotations of objects in a scene.

Align View to Face Selection

Align the 3D perspective view to the selected face or triangle.

After alignment the Screen coordinate system can be used to keep transformations within the plane of the selection.

requires Clintons3dplugin v1638443

OD_CopyPaste

This script will copy and paste mesh data from an external file. Supports UV and morph options. Does not support Weightmaps, SubD and Lightwave style UV's
"Easily copying and pasting of geometry and common attributes across 3D Applications, perfect for quick iterations between them, without concerns about file management."

Copy UV Channel

This script will copy the UV values from one mesh to another. Useful for UV mapping in an external application like Blender.

Library Place

Library place script for organizing projects and for incremental object and scene backups. A library place is a collection of trueSpace libraries.

Copy Node Attributes

Comes pre-installed in the Unofficial Updates

This script will copy the attributes from the source node to the destination node.  It works by getting a list of input connectors on the source and if a connector with the same name exists on the destination node the value will be copied.

One use would be to convert a light to a different kind of light.  Add the desired type of light to the scene and set it as the destination.  Set the source light and when the script is run it's color and location will be copied to the new light.

Verify will ask before copying each connector value.

The script requires the plugin, Clintons3dPlugin, version v.1638404.

Web browser based
Color Picker, Layers UI and Scene View for trueSpace7.61

Web based color picker. Colors update in real time and it has 8 slots for color swatches. Web based scene view provides a tree based view into the scene. The layers system is an updated version of workspace layers 3 tools.

display mesh information in the viewport

This script will display mesh information in the 3D view. It will show vertex, triangle and triangle neighbor indices and vertex indices. Information might be useful for scripters/developers. The triangle neighbors data display requires the plugin below.

Push delete markers to clear the display.

The script requires the plugin, Clintons3dPlugin, version v.1638403.

January 2021

• use wldmatrix to position
• limit to 128 to prevent crashing

February 2015 - add matrial index display

April 6 2014 - add uv coord display for uv set 1

Selection Visibility

will hide the item from the 3D view selection system. This script will alter the structure of a 3d object, camera or light to make it invisible to the selection widget. It only works with renderable items.

The script requires the plugin, Clintons3dPlugin

The script requires the Global Function Set

Select a 3D object and press the button to lock it or unlock it. After locking a text object is created which has a button for unlocking the 3D object. The text will match the name of the locked item.

Will work with 3d members of groups but behavior a little odd.

Dev note

Same technique used directly on a 2D group would crash tS, so is setup to only work with group members not groups.

Group behavior is the reason this is not a replacement for the widget based locking scripts.

November 14, 2024

• fixed crash when undo is used - replaced Node.Create with Node.Copy of pre-existing nodes

Origin Widget

Comes pre-installed in the Unofficial Updates

Adds a visual indicator of the meshes origin for object navigation and point edit widgets and adds a center sphere for the point edit widgets.

To scale the object about the origin instead of it's center use Ctrl + LMB or Ctrl + RMB on the scale handles.

Ctrl + Left Click the sphere of the point edit widget and the origin will move to the center of the selection.
Widget based snapping requires that the Mesh Origin script is installed.

Mesh Origin

Mesh origin tool for changing the location of the center of a mesh or group.

Mirror Matrix

Comes pre-installed in the Unofficial Updates

Mirror tool that effects the object matrix values. Similar to the built in modeling mirror tool but mirrors the matrix values as well as the vertices. This tool is also compatible with cameras and lights.

persistent base install required

Select a scene item then choose an axis and press the Mirror button.

Mirror Copy - make a copy and mirror it

Mirror Mesh Vertices - a mesh requires that the vertices are updated for a full mirror effect. Can be disabled to only mirror the matrix values. This option is ignored for cameras and lights.

December 8, 2020

• fix mesh inside out

December 7, 2020

• fixed regression from Dec 6 which removed the Nov 25 changes
• better rotation for lights and cameras
• original selection does not get mirrored when using the copy option
• works with groups and groups that have NURBS members
• copied nodes will arrange themselves in the link editor window
• works with individual members of groups

December 6, 2020

• bug fix - scaled object was double scaled when mirrored
• added support for upcoming NURBS tools

November 25, 2020

• bug fix: missing return statement
• bug fix: string replace required regex to replace all ; for error display

November 24, 2020

• multiple selection mirror
• NURBS objects
• updated installer

March 25, 2020

• fixed bug with pivot - truespace pivot needs to be flattened into the mesh vertices

Poly Combine

Uses a boolean process to convert a 3D group or a selection of individual 3d mesh objects into a single polygon mesh object. By default the result is flattened and no geometry changes occur.

persistent base install v3 required

Mesh Origin script required

Clintons3dPlugin.rsx v1638457 is required.

Usage:

LMB - open floating panel, RMB open panel in the stack view

Understand that undos will be lost and uncheck Show Undo Warning

Select several simple 3D objects and press the button to merge them into a single polygon mesh object.

Select a 3D group object made up of 3D objects and sub-groups of 3D objects and press the button to merge the group hierarchy into a single polygon mesh.

The tS "Construction history will be lost" dialog may show if Flatten Final Result is on. When the dialog shows check the checkbox and press the Yes button. This prevents the question from being asked for the duration of the tool run. After the run the dialog is restored to it's previous state.
An error dialog will show if the tS dialog is not set properly and no processing will occur until it is.

Notes:

If one item in the selection is a child of a parent node then all the items must share the same parent.

Parent objects, complex 3D structures and non-mesh objects cannot be combined into a single mesh.

All undo history will be erased when running this tool.

Flatten Final Result will restore the flatten Dialog settings show/don't value after a succesful run

Show Warnings Dialog - uncheck to turn off the warnings for no undos / all undos will be lost.

Flatten Final Result - default true, atypical set to false and keep boolean construction history

Quad Mode - any new faces generated will have 4 edges, option is for Merge and Union boolean operations
Default value is Off.

Boolean Operation - Add(Boolean merge geometry), Merge and Union options. Off by default

• Add (default) - combine the unaltered meshes together
• Merge - combine the meshes while also adding intersection lines to the geometry
• Union - combine the meshes removing any internal geometry

Run - execute the poly combine process

Show / Hide - set the visible state of the Construction history/Flatten dialog after a successful Poly Combine run or first use of the Construction history/Flatten dialog by any tool

Dev Notes:

The script uses a Csg operation node as the basis for combining the mesh date.

A lot of "waste" code was left in for reference purposes on ideas that didn't pan out and random ideas to try and fight the crashes. It has a version of the multiple selection portion of the tool that uses ScripObjectBuffer to reduce the number of undos generated removing the need to clear undo history. This buffer form of the script is difficult to maintain and troubleshoot. Throughout the developement there were issues of undo not working, crashes and crashing while using undo.

Much of the code was written with the assumption of a final 1 or few undos version based on script buffers so values are returned from some functions via the function set node.

The script buffer run code has simple sample code for writing out the resulting code to a file to verifiy it's structure and syntax.

Discovered that the Dialog settings node only loads the first time a tool needs it and the behavior cannot be controlled by script unless at some time in the past a question is ansered "Yes" and the "Do not show again" checkbox is activated.

The Node.Create may be less stable than using Node.Copy

Node.ExportConnector used on a Csg operation node was one crash source. The solution was to change the final argument from 1 to 0. This sets value immediately flag to not true. It also seemed that the boolean operation speed increased dramatically after making this change.
update: not so sure about the speed increase, maybe only increased the first boolean speed? transferred the change to the t3d import and saw no speed increase

Original tS6 PolyCombine plugin

October 17, 2024

• fixed typo in the installer code

September 12, 2024 - release 2

• StartMulti - test for renderable was too late, Invalid procedure call or argument Error
• fixed Start Group IsNotPure3D function to check ORA node
• clear undo history on errors

September 12, 2024

• changed order of flatten error construction history setup message steps
• bug, error states resetting dialog settings - fixed
• added show and hide buttons
• on success if flatten warning was active before the run say "press [Hide]..."

September 11, 2024

• fixed press No on Construction history dialog giving actual error or bogus error
• new flatten final result option
• new pre-process to setup the Dialog settings for flattening and the no flattening option
• typical use text hints from trueblue
• remove memory leak warning - no leak after all
• lose your undos warning only shows once, so if errors will not show again until after a succesful run

September 10, 2024

• fixed strange inconsistent quad mode by adding an option and setting it explicitly
• group 3d combined arrange in the LE
• open panel instead of direct run
• restore flatten question state instead of setting to On

September 9, 2024

• fixed minor bug in the installer - remove old from CustomScripts
• bug fix - flatten dialog choice always cleared, only clear after passes validity tests
• add new boolean operations options
• new warning dialog - memory leak

Copy Transform

Script for transferring the matrix from one object to another. It moves the location, rotation and scale of one object to another. Original idea by MikomDude and icon supplied by Draise. United3DArtists thread here .

persistent base install required

Select 2 or more objects and press the button. They will move, rotate and scale to the last selected object. Right click for options. The Use Local Space option can be used for grouped objects to move the members relative to each other.

March 24, 2020

• persistent install
• unique button id

CTRL button simulator

Updated version comes pre-installed in the Unofficial trueSpace Updates as a Link Editor toolbar button.

CTRL add/subtract to selection does not work in the link editor.

This script simulates ctrl style picking for LE nodes.

persistent base install required

Usage:

1. press the button
2. select objects to add/subtract to the selection - rectangle select is much more reliable than click select
3. press the button again to exit the ctrl simulator
4. if erratic behavior right click the button to open a link editor window exposing the selection change event

September 22, 2019

• slightly more reliable selection overall
• status message by trueBlue
• right click open le to stabilize - not effective, rectangle select is the solution

February 24, 2018

• persistent install v2 compatible
• compatible with new batch installer

January 13, 2018 - persistent install

April 6, 2017

• more reliable
• button highlight when active
• dev note: changed to a button that includes the TagAlias connector and set it's value as "/Scripts/CustomCommands/ctrlSelectionGroup/Selection Change Event/Active;-1" and set AgentID to {163F13B6-0BDC-43E9-8C90-CFA6B14221FA} ,just a value that works, random guid does not work

Nov 2012: unique button id

GUID Generator

Generates a guid that can be used as an id for buttons.

Bridge Synchronize(OLD)

Place this object in a scene so that truespace 7.61 model side can render a workspace animation.

When truespace 7.61 was released a bug was introduced that prevented workspace animations from rendering in the modelside renders. The object animations did not transfer through the bridge. The bug also shows when scrubbing the workspace timeline and no motion will show in modelside.

Shortcut Runner

A runnable list of all defined shortcuts including widget shortcuts in the Unofficial Updates.

Toolbar Manager v2

Use to select toolbar nodes, save them to an internal store or a file library. Load from the store or library. Temporarily hide the toolbars to get them out of the way when switching to modelside. Easily save toolbars and transfer them to another layout.

Standard Colors

Load this script and it will automatically change the colors of the axis lock buttons and the widgets to match standard color schemes for 3D applications (r,g,b) <=> (x,y,z).

persistent base install required

Reset the toolbar or load/reload layout to see the toolbar changes

August 1, 2024

• fix to work with uu4clinton main classic toolbar
• works with all layout toolbars

June 9, 2024

• cube widget is load on demand - adjust for it
• adjust for load on demand(load widgets fresh, change widgets, save widgets)

July 24, 2020

• latest unofficial colored triangles
• installer clears recent files list

September 2, 2019

work with latest Unofficial Updates cube widget

March 17, 2019

reestablished the widget color fixes and added cube widget

October 15, 2018

works with Unofficial Upate 4

February 24, 2018

• persistent install v2 compatible
• compatible with new batch installer
• don't fix widget color

November 2012: delete itself

Sep 18 2011 fixed XYZ button update.

Point Clone for truespace 7.61

The Point Clone script copies one or more objects to the vertex locations of a target object. The scale, rotation and location can all be randomized within a range specified by the user.

Grid Array for truespace 7.61

Distribute copies of an object into a 2 or 3-dimensional block.

Radial Array 2 for truespace 7.61

Distribute copies of an object on a circular arc or spiral. Alternate to the original radial array script below.

Radial Array for truespace 7.61

Distribute copies of an object on a circular arc or spiral. Older version. Obsolete?

Unselectable Script

Lock scene items from basic selection.

Physics Constraint Helper for trueSpace7.61

Script to allow precision placement of physics center of gravity(COG) and constraint fixation points.

Scene View 2 and Node List View Window(Graph Node View)

Scene View 2 description here.

Plugin and script that provides a window similar to the Scene view, but with more options and automatic alphabetization. It displays a list of all the items in the scene. If the Object Information script is installed it will update automatically from the rsx plugin.

(OBSOLETE)Node List View Window(Graph Node View)

Plugin and script that provides a window similar to the Scene view, but with more options and automatic alphabetization. It displays a list of all the items in the scene. If the Object Information script is installed it will update automatically from the rsx plugin.

Object Statistics

Script for gathering statistics. Left click for mesh statistics. The objectStats gives vertex, edge, face and triangle counts. Object stats will continuously update via the web ui or the node list view

Mesh geometry to Widget code for trueSpace6(modelside)

Python script used to convert a mesh to widget code format for use in the trueSpace 6 sdk code. Right click to download the script.

June 13, 2015

• write to text file - fixes problem with too much information for the python display console
• fix for a missing line of generated code

Scene View Reorder Script for tS7.61

Script for alphabetizing the scene or a selected node in the Scene View. The script works by deleting and undoing the delete for each node in order.

Rectangle/Lasso Select Tool

Installs 2 buttons, one for rectangle style object selection and one for lasso style object selection.

Widget based Rectangle Select Tool

rectangle style object selection via ray tracing or axis oriented bounding box frustum culling.

Link editor tools

Link editor toolbar

View3D Layout Tool

3D view layout controls.

Freeze Transformations for trueSpace7.61

Freeze transformations script. Set rotation to (0,0,0), set translation to (0,0,0) and set scale to (1,1,1) and set shear to (0,0,0) without changing the appearance of the object.

layers3 for trueSpace7.61

A layers system for trueSpace workspace.

ies profile and generic falloff for trueSpace7.61 spotlights

This script will alter spot and projector lights in workspace to give the appearance of a light defined by an IES file. It can also set general falloff so the hotspot angle will have an effect in the 3D viewport.

Hierarchy Tools

Tools for parenting and grouping

Blender Link

Scripts to use Blender tools remotely from truespace to generate some meshes, curves and uv maps.

Null Objects

Scripts to convert meshes into null objects.

Change Light Type

Convert selected lights to different types of lights. Maintains group and parenting relationships.

1. press Get Light Types to populate the list
2. choose the new light type from the list
3. Select the lights to change
4. Press the Convert button

Protect Workspace

The Protect Workspace script saves and restores workspace attributes to protect them against modelspace changes. It protects materials, names, matrix transforms, camera fov and spot angle.

custom button and toolbar for trueSpace7.61

This script will create a button and toolbar. The button can refer to a script node or directly to script embedded in the button itself.

toolbar button icon generator for trueSpace7.61

This script and scene file will create a 32bit tga image file, size 26x26 with an alpha channel for use with a toolbar button. It uses the D3D renderer to generate oversized color and alpha images. These images are combined and shrunk down to size to provide a 32bit antialiased tga file.

usage notes:

• requires the custom post process RsD3DBloomFilter to generate the alpha channel
• requires clintons3dplugin rsx file
• optdetector is required to display the result inside trueSpace for review
• a mesh with an alpha material is required for the background alpha channel

1. set the filename with bmp format, the final icon will be a tga file
2. select the 3d camera view window
3. press run to generate the images

UU version deletes the intermediate files so not getting a button image for documentation purposes.

UU version found in the post process library

July 22, 2023

• updated with bmp color file option because jpg had artifacts
• if uu9 installed dont test for the opt detectors - it is system loaded in uu

November 8, 2020

• updated IconMaker script - more reliable, inputs for icon size

return to trueSpace Plugins and Scripts