Differences

This shows you the differences between two versions of the page.

--- en:games:star_trek_armada_1:modding:tools:storm3d_tool [2025-03-22-18-33] – 7saturn
+++ en:games:star_trek_armada_1:modding:tools:storm3d_tool [2025-03-22-21-32] (current) – [Mesh Mode] 7saturn
@@ Line 1: / Line 1: @@
 ====== Storm3D Tool ======
+The //Storm3D Tool// or also sometimes called //Storm3D utility// is a piece of software used to manipulate SOD models, as they are used by [[..:..:..:star_trek_-_armada_1|Star Trek: Armada]]. It directly uses the [[en:game_tech:Storm3D Engine]] to display the models loaded.
+===== Setting Storm3D Tool Up =====
+You can get the //Storm3D Tool// from here: [[http://armadafiles.com/files/armada/utilities/modeling-tools/armada-storm3d-sod-utilities/details|Armada Files]]. It was meant to be used with versions 1.1 and 1.2 of //Star Trek: Armada//. (See also [[..:..:..:star_trek_-_armada_1#Hashes of the Different Versions]].) But in reality only version 1.2 has any relevance today. The //Storm3D Tool.exe// is placed in the root folder of the //Star Trek: Armada// installation folder and started from there.
+It works well with the original CD Version of //Star Trek: Armada//, but not so much with an (unaltered) GOG version of the game. Reason for that are the modifications GOG made to the game in form of some DLLs. They make //Storm3D Tool// crash upon loading. You can in principle get the //Storm3D Tool// to work with the GOG version by removing all unneeded files from the GOG folder (make backups of it, before you do so!). If put that to the extreme, you can create a stand-alone variation of it, by only keeping the following files/folders:
+  * //SOD//,
+  * //Sprites//,
+  * //Textures// and
+  * //Storm3D Tool.exe//.
+Placing mod files into those directories is necessary to modify SODs with //Storm3D Tool//. But the rest of the //Star Trek: Armada// installation is not required for //Storm3D Tool// to work then.
+If created in this fashion, it will also start on a modern system.
+===== Usage =====
+==== Keys ====
+There are a number of things you can do with the //Storm3D Tool// directly. The following keys may be useful:
+^  Key  ^  Effect  ^
+| <key>F1</key> | Displays the different keys and their effects. The descriptions are, however a bit spartan. |
+| <key>F2</key> | Switches between advanced mode and preview mode. The latter is the default mode. |
+| <key>F5</key> | Increases selection brush size when in mesh mode. |
+| <key>F6</key> | Decreases selection brush when in mesh mode. |
+| <key>F7</key> | Allows to mark the mesh of a LOD node, implicitly switching from node mode to mesh mode. |
+| <key>F8</key> | Opens a loading dialog to select an SOD file for use with //Storm3D Tool//. This does not yet place the model anywhere. |
+| <key>F9</key> | Opens up a save dialog to save the currently selected object to an SOD file. |
+| <key>PG Down </key> | Selects the next element. Depending on the mode that can be an entire model (when in object mode), a node (when in node mode) or a mesh LOD (when in mesh mode). |
+| <key>PG Up</key> | Selects the previous element. Depending on the mode that can be an entire model (when in object mode), a node (when in node mode) or a mesh LOD (when in mesh mode). |
+| <key>a</key> | Zooms out from model (when in object mode) or node (when in node mode) or mesh (when in mesh mode). |
+| <key>z</key> | Zooms in from model (when in object mode) or node (when in node mode) or mesh (when in mesh mode). |
+| <key>b</key> | Plays the build/construction animation, that is also used when a ship is built in a yard, or a station by a [[en:games:star_trek_armada_1:Constructor]]. |
+| <key>d</key> | Displays the indicators for low crew (damage patches), borg assimilation and [[en:games:star_trek_armada_1:modding:emitter_names|emitters]] (life support or engines down). |
+| <key>o</key> | Switches ob object mode, when in advanced mode. |
+| <key>n</key> | Switches to node mode, when in advanced mode. |
+| <key>m</key> | Switches to mesh mode, when in advanced mode. |
+| <key>SPACE</key> | Place a loaded SOD model near the mouse pointer. Note: This also considers the mouse pointer location if the mouse pointer is not inside the window of //Storm3D Tool//. Meaning, your newly placed model might not be visible initially. |
+| <key>DEL</key> | Removes the currently selected object (regardless whether you are in node or mesh mode, it will always remove the entire selected **model**!).  |
+| <key>w</key> | Switch display to displaying the mesh (no textures). |
+| <key>Left Mouse Button</key> | Turn the selected element (in object mode, it will be the entire model, in node mode it will be the node). |
+| <key>Right Mouse Button</key> | Moves the object in-plain (in object mode, it will be the entire model, in node mode it will be the node). |
+| <key>Middle Mouse Button</key> | Moves the object perpendicular to the viewing plain (in object mode, it will be the entire model, in node mode it will be the node). |
+| <key>l</key> | Places a light source. Without a light source, the non-glowing elements of the models will be black, as they cannot reflect any light that it not there. By default there is always one light source placed, but that can be deleted, like any other element. |
+| <key>c</key> | By default the color of placed light sources and units is chosen randomly. This allows to set the color of a model's glowing parts or of a light source. |
+| <key>s</key> | Spin an object: When holding <key>s</key> while spinning an object with the <key>Left Mouse Button</key>, you can make an object continue spinning. Pressing <key>s</key> makes the turning animation stop or continue. |
+| <key>h</key> | Continuously hides and shows the object currently selected. Pressing <key>h</key> again stops the animation. This is similar to the effect used to indicate a unit becoming cloaked or decloaked. |
+| <key>p</key> | If a unit has an animation, it will be restarted. |
+| <key>-</key> | Switches to a different LOD. |
+| <key>+</key> | Switches to a different LOD. |
+| <key>t</key> | When having selected a mesh in mesh mode, this allows for selecting a different texture for that particular mesh. As no UV alignment can be done with //Storm3D Tool//, this is probably of limited use. |
+==== Modes ====
+Modes can be switched by pressing <key>F2</key>, to activate advanced mode (or preview mode), or keys <key>o</key>, <key>n</key> and <key>m</key> for object, node or mesh mode.
+=== Preview Mode ===
+Basically the same as the below described [[#object_mode|Object Mode]] just without the possibility to switch to [[#node_mode|Node Mode]] or [[#mesh_mode|Mesh Mode]] and with less information displayed.
+=== Advanced Mode ===
+When this mode is active, the other (following) modes can be used. If you switch from advanced to preview mode with <key>F2</key>, then these modes will be turned off as well and you revert to something similar as [[#object_mode|Object Mode]].
+=== Object Mode ===
+This is basically the same as preview mode, but displays some more information. If advanced mode is not active, //Storm3D Tool// will behave exactly the same, except, that in advanced mode you can also switch to the node or mesh mode. In object mode you can place a loaded SOD model with <key>SPACE</key>, select other models with keys <key>PG Up</key> and <key>PG Down</key>, remove selected models with <key>DEL</key>, as well as move and turn a selected object. A selected object is surrounded by a blue box. View toggles such as showing animations, construction animations, wireframes or emitters can influence how the model is displayed.
+In object mode the following information is displayed:
+{{ :en:games:star_trek_armada_1:modding:tools:storm3d_tool_object_mode.png?nolink&600 |}}
+  * Top left you will find the file name of the currently selected object.
+  * Next to the file name you will find the objects radius (parenthesis).
+  * Next to that the number of currently loaded objects is displayed. Light sources do count as well.
+  * Below the file name you find the LOD mode. Initially this is //AUTO//, as it is selected derived from viewer distance and size of the object. But when altering the selected LOD with keys <key>+</key> and <key>-</key>, this will turn into //LOD 1// to //LOD **n**//.
+  * Top right you will find the frame rate.
+  * Bottom left you find the current mode: //OBJECT//.
+=== Node Mode ===
+{{ :en:games:star_trek_armada_1:modding:tools:storm_3d_node_direction_indicator.png?nolink|}}Node mode allows for manipulating the nodes of the [[en:games:star_trek_armada_1:modding:model_hierarchy|hierarchy]]. So, not the entire model is selected with <key>PG Up</key> or <key>PG Down</key>, but only the nodes of the model. You can activate it by pressing <key>F2</key> and then <key>n</key>. **Important**: Even when in node mode, <key>DEL</key> key will remove the entire model, not just the node. So avoid using it, unless you intend on removing the currently worked on model.
+Selected nodes can be moved just as if they were entire models, including their directions. A node is represented by a triad of the three colors red, green and yellow. Their intersection (root) is the location of a node, while the yellow line indicates the direction the node faces. Some tools like [[.:tools:Milkshape 3D]] cannot be used to properly set nodes **and** have them face the correct direction. If you use one of these modelling tools, you may need to adjust the node directions eventually, e.g. with //Storm3D Tool//.
+When having selected a node that ties to a mesh group, pressing <key>F7</key> switches to mesh mode, selecting the mesh that is tied to that node.
+In node mode the following information is displayed:
+{{ :en:games:star_trek_armada_1:modding:tools:storm3d_tool_node_mode.png?nolink&600 |}}
+  * Top left you will find the file name of the currently selected object.
+  * Next to the file name you will find the objects radius (parenthesis).
+  * Next to that the number of currently loaded objects is displayed. Light sources do count as well.
+  * Below the file name you find the LOD mode. Initially this is //AUTO//, as it is selected derived from viewer distance and size of the object. But when altering the selected LOD with keys <key>+</key> and <key>-</key>, this will turn into //LOD 1// to //LOD **n**//.
+  * Top right you will find the frame rate.
+  * Below the LOD info you will see the //NODE INFO//. It consists of:
+    * The node which is closest to the mouse pointer right now.
+    * The currently selected node.
+    * The hierarchy below but not including including the currently selected node.
+  * Bottom left you find the current mode: //NODE//.
+=== Mesh Mode ===
+Mesh mode is used to manipulate model vertices and thereby also faces made up by them. In this mode the <key>PG Up</key> and <key>PG Down</key> keys do not select an object or nodes but the different groups of the model, also making up the LODs of it. Mesh mode is activated by pressing <key>F2</key> and then <key>m</key>. When working with it, it is recommended that you work on LOD 2 first, and later align the other LODs to fit the LOD2.
+{{ :en:games:star_trek_armada_1:modding:tools:storm3d_tool_vertex_selector.png?nolink|}}Once active, the mouse pointer will be surrounded by a cyan circle-like indicator. This indicator represents how big the selector is. Keys <key>F5</key> and <key>F6</key> change the size of the mouse pointer circle. When hovering it over vertices of the currently selected group, they get high lighted by smaller cyan circle-like indicators. When shift-clicking on the vertices, they turn purple. This indicates, that the vertex is selected for manipulation. When shift-right-clicking on selected vertices they get de-selected. Manipulation can then be achieved by either right-clicking and dragging the mouse pointer (translate the selected vertices in-plain) or middle-clicking and dragging the mouse pointer to translate the selected vertices perpendicular to the viewing plain.
+As vertices have no direction, the left-clicking and dragging of the mouse pointer is free for other uses. It turns the model.
+In node mode the following information is displayed:
+{{ :en:games:star_trek_armada_1:modding:tools:storm3d_tool_mesh_mode.png?nolink&600 |}}
+  * Top left you will find the file name of the currently selected object.
+  * Next to the file name you will find the objects radius (parenthesis).
+  * Next to that the number of currently loaded objects is displayed. Light sources do count as well.
+  * Below the file name you find the LOD mode. Initially this is //AUTO//, as it is selected derived from viewer distance and size of the object. But when altering the selected LOD with keys <key>+</key> and <key>-</key>, this will turn into //LOD 1// to //LOD **n**//.
+  * Top right you will find the frame rate.
+  * Below the LOD info you will see the //MESH INFO//. It consists of:
+    * The name of the currently selected mesh. An object consists of at least one, but usually multiple meshes.
+    * The hierarchy below but not including including the currently selected mesh's node.
+    * The number of vertices of the currently selected mesh.
+    * The number of faces made up by those vertices.
+  * Bottom left you find the current mode: //MESH/VERTEX//.
+===== Tricks =====
+==== Removing the Starting Logo ====
+When starting //Storm3D Tool//, you will be greeted by the //Star Trek: Armada// logo:
+{{ :en:games:star_trek_armada_1:modding:tools:armada_logo.jpg?nolink&600 |}}
+As the blue box surrounding it already indicates, this is a model currently being selected. To get rid of it, simply press <key>DEL</key> and it will be removed.
+==== Getting a Black Background ====
+In certain situations it is preferable to not have the starfield background be present, but a black background. However, you cannot select this starfield background, as you can with the initially displayed //Star Trek: Armada// logo. So you cannot remove it. It is essentially fixed placed in //Storm3D Tool//. But you **can** place a black background, as there is one provided by //Star Trek: Armada// itself. Simply load file //SOD\MbgBlack.SOD// and place it with <key>SPACE</key>. This is particularly useful when creating [[en:games:star_trek_armada_1:modding:Wire Frames]] or [[en:games:star_trek_armada_1:modding:buttons#creating_a_button_image|button images]].
+===== Known Problems =====
+==== Window Too Big =====
+As the tool is rather old, it has certain problems on modern systems. Specifically screen resolutions with more than 3071 pixels can lead to problems when going to full screen mode (<key>ALT</key> + <key>ENTER</key>) or when enlarging the window beyond that pixel number. (It does not matter if that is in x- or y-direction, both are affected.) Reason for that is a bug in the used Direct3D 7 framework, which crashes upon exceeding 3071 pixels in any direction. You can enlarge the window for more convenience. (Specifically the fonts are enlarged and will therefore be readable a lot better.) But when doing so, make sure you don't create a window that is too big.
+On very old systems you may also have a problem with running out of video RAM. Below 8 MB of video RAM the tool may give you a hard time starting in any higher resolution than 640x480 or 800x600 pixels with 16 bit color depth. Recommendation is to not work on such an antiquated machine.
+==== Desktop Color Depth Wrong ====
+Depending on the situation, having set a color depth of 24 or 32 bits can prevent the tool from starting. Try 16 or 32 bit color depth settings instead, when using 24 bits. If working with a Voodoo3 based graphics card, set it to 16 bits.
 ----