Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Here are a few simple examples that you can demonstrate on your licensed copy of SpinFire Ulitmate.

Acquire full scripting help from within SpinFire Ultimate using the Documentation menu item from the script menu.
Image RemovedImage Added

The following shows simple examples of some scripting primitives



List physical properties for model
Expand
titleGet the Physical Properties of Items

The following demonstrates getting the physical properties of the assembly and printing to the console through scriptnig.

Usage

GetPhysicalProperties()

Parameters

none

Code Block
languagepy
firstline1
title
Code Block
linenumberslanguagetruepy
# First open a 3D model to execute this script 
# Open the python.NET console panel 
import spinfirescript as sfs

sfs.SelectItem([])
propertiesData = sfs.GetPhysicalProperties()
print(propertiesData)
print(propertiesData.Message)


Multimedia
name2021-12-23 10-45-03.mp4
Expand
titleGet the Assembly Item Properties
test




List physical properties for model
Expand
titleRotate the Entire Assembly

The following demonstrates selecting and rotating an assembly through scriptnigscripting.

Usage

RotaeSelectedAssemblyItems(axis, degrees)

Parameters

axis: selectd the x, y, or z axis

degrees: amount to rotate in degrees

Code Block
languagepy
firstline1
title
Code Block
linenumberslanguagetruepy
# First open a 3D model to execute this script  
import spinfirescript as sfs

for i in range(0,10):
	sfs.SelectItem([])
	sfs.RotateSelectedAssemblyItems(sfs.Axis.X, 30)
	sfs.RotateSelectedAssemblyItems(sfs.Axis.Y, 20)
	sfs.RotateSelectedAssemblyItems(sfs.Axis.Z, 45)
	sfs.ClearSelectedItems()
Multimedia
namerotatingScript.mp4
Expand
titleChange Various Assembly Item Properties
test




2D Line Example code
Expand
titleInsert a 2D Line

The following demonstrates creating 2D lines through scriptnigscripting.

Usage

InsertLine(x-coord, y-coord, color, thickness)

Parameters

x-coord: starting x-coordinate.

y-coord: starting y-coordinate.

color: color as a string in the form "#AARRGGBB"

where AA is the alpha channel

RR is the red channel

GG is the green channel

BB is the blue channel

thickness: line thickness number > 0 

code

languagepy
title
linenumbers
Code Block
languagetruepy
# First open a 2D workspace to execute this script
import spinfirescript as sfs
import random

for i in range(1,10):
	newColor = "#FF"+''.join([random.choice('0123456789ABCDEF') for j in range(6)])
	sfs.InsertLine([0, (i+(i*4))*-1], [50, (i+(i*4))*-1], "#FF000000", i)
	sfs.InsertLine([100, (i+(i*4))*-1], [150, (i+(i*4))*-1], newColor, i)
Multimedia
name2021-11-15 08-51-26.mp4



Expand
titleInsert a 2D 3D Polyline

The following demonstrates creating 2D lines through scriptniga 3D polyline through scripting.

Usage:

InsertLine(

InsertPolyline([x-coord 1, y-coord 1, z-coord 1], [x-coord 2, y-coord 2, z-coord 2], [x-coord n, y-coord n, z-coord n], color, thickness)

Parameters

x-coord: Starting x-coordinate.

y-coord: Starting y-coordinate.

z-coord: Starting z-coordinate.

color: color as a string in the form "#AARRGGBB",

thickness: lne thickness number > 0 


3D Polyline Example code
Code Block
languagepy
title2D Line Example code
linenumberstrue
# First open a 2D3D workspace to execute this script
import spinfirescript as sfs
import random

for i in range(1,10):
	newColor = "#FF"+''.join([random.choice('0123456789ABCDEF') for j in range(6)])
	sfs.InsertLine([0, (i+(i*4))*-1], [50, (i+(i*4))*-1], "#FF000000", i)
	sfs.InsertLine([100, (i+(i*4))*-1], [150, (i+(i*4))*-1], newColor, i)

Multimedia
name2021-11-15 08-51-26.mp4

Expand
titleImport a Model

test

Expand
titleSave to an ACT3D File
test

print(sfs.InsertPolyline([[00, 00, 00], [50, 50.5, -70], [100, 75, 83.7]], "#FFAA0000", 2))




Expand
titleImport a Model

The following demonstrates saving the workspace to an ACT3D file through scripting.

Usage:

ImportFile(filename path)

Parameters

filename path: filename path of the file to import.


Import a File Example code
Code Block
languagepy
# First open a 2D or 3D workspace to execute this script
import spinfirescript as sfs  

print(sfs.ImportFile("C:/temp/TestCube.CATPart"))



Expand
titleSave to an ACT3D File

The following demonstrates saving the workspace to an ACT3D file through scripting.

Usage:

SaveFile(filename path)

Parameters

filename path: filename path of the ACT3D file.


Save ACT3D File Example code
Code Block
languagepy
# First open a 2D or 3D workspace to execute this script
import spinfirescript as sfs

print(sfs.SaveFile("c:/temp/new.ACT3D"))



Related Topics