Game Development Community

Create .torsion file for existing project w/o one?

by Wenceslao Villanueva Jr. · in Torsion · 04/07/2008 (3:06 pm) · 4 replies

I recently bought the platform starter kit for the Torque Game Builder and the demo project it comes with doesn't have a .torsion file. Is there anyway to generate a .torsion file for existing projects so that I can get up and running with Torsion?

#1
04/07/2008 (3:18 pm)
It should be as simple as:

File->New->Project

Fill out the Name and BaseDirectory fields. Other stuff should be fine with the defaults.
#2
04/07/2008 (3:21 pm)
Also, you want to goto the configuration tab and add one for release and debug ( if you have both ). The configuration specifies where your game exe is, and is used to build exports ( which is what allows autocomplete and the information you see in the codebrowser tab to work ).
#3
04/07/2008 (3:32 pm)
Ok, I didn't realize that Torsion will scan the directories for all script files automatically. I had to build an executable, put it into the directory of the project and point Torsion to that. I'm up and debugging now, I just didn't think it would be that simple.

Also, is there documentation that describes all the settings? Right now I'm not sure what the difference would be between a debug and release build in Torsion. I try opening the help file but it seems to have issues, If I open the torsion.chm file I get the error: Cannot open the file: mk: @MSITStore:C:\Program Files\Torsion\torsion.chm.
#4
04/07/2008 (10:41 pm)
Glad to hear it.

Generally release vs debug doesn't make any difference at all to Torsion. You can name your project configurations Foo and Widgit if you want.

The only difference is the executable that it runs ( thats usually the only difference -- unless you make other changes in the configurations settings window -- but you don't HAVE to make any ).

Hm, for me help does bring up a window. Well, I'll just paste what mine says...
Ignore anything you don't recognize in your version.

Configuration Settings:
Quote:
General

Name
The unique configuration name for this config.
Executable
The game executable for this configuration.
Arguments
The optional arguments to pass to the executable on launch.

Debugging

Enable Precompile
This toggles execution of the precompile step before launching the executable.
Enable setModPaths
This will slow down the precompile step, but it is needed for some versions of Torque when TORQUE_SHIPPING is defined.
OneClick Debugging
Enables automatic injection of the debugger startup code in to the main entry script.

ScriptSense

Build Exports
This enables generation of engine exports from the executable associated with this config.

Project Settings:
Quote:

Project Tab

General

Name
The default internal project name default project file name.
Base Directory
This is typically the folder where the Torque executable and entry script are located.
Entry Script
This is the first script loaded by the Torque executable when the game is launched. Normally this is main.cs. If an entry script is not specified then OneClick Debugging must be disabled for each configuration.
Script Scanner Extensions
A semicolon separated list of script file extensions the code completion scanner should process when generating the ScriptSense database.
Mods
An optional semicolon separated list of mods to include in the project tree and scan for inclusion in the ScriptSense database.

Debugging

Address
The IP address or DNS name of the debug target machine. You normally use 127.0.0.1 for debugging on the local machine.
Password
The password to use when connecting to the debug target.
Port
The port on the debug target machine to use. 6060 is the Torque default.
Reload Modified Scripts
When enabled and supported by the engine you will be automatically prompted to reload changed scripts after continuing from a breakpoint.

NOTE: As of this time this feature is only supported by the TorqueScript Edit and Continue resource.
Hook Code
The debugger startup hook code that will be injected into the entry script. The strings #port# and #password# will be replaced with the correct values from the connection dialog.
Elixir
NOTE: At this time the Elixir documentation system is not availible.
Search URL
The url to the Elixir search script.
Product
The Elixir product string. This is typically TGE, TGEA, or TGB.
Version
The product version. Use HEAD for the latest product documentation.



Configuration Tab

Edit...
Opens the Configuration Settings dialog for editing the currently selected config.
New...
Opens the Configuration Settings dialog for creating a new config.
Delete
Deletes the selected config from the list.
Copy
Creates a copy of the selected config and opens the Configuration Settings dialog for editing.