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

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

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

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)

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

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

Comes pre-installed in the Unofficial Updates

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
• CameraFromView

If UU9 is installed only the Widget Function Set and the ZoomToSelection will be installed

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

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

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

Note: XYZ lock buttons color is not fixed for the Expanded and Workspace layouts, all other layouts are ok

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

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