Difference between revisions of "Soldat PolyWorks Manual"

From Soldat Community Wiki
Jump to: navigation, search
(Work in progress)
 
m
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
[[File:PW.png|right|thumb|Soldat PolyWorks Icon]] This is the latest help file for '''[[Soldat PolyWorks]]''' taken from [https://github.com/Soldat/polyworks Soldat PolyWorks GitHub]
 +
 +
 
=Controls=
 
=Controls=
* '''Scroll''' - Click and drag with the middle mouse button or hold space + left click.
+
* '''Scroll''' - Click and drag with the '''[Middle Mouse Button]'''  or hold '''[Space] + [Left Mouse Button]'''.
* '''Zoom''' - [Mouse wheel down/up] or [Ctrl+Plus]/[Ctrl+Minus] or [NUM+] and [NUM-] keys for zooming in and out.  
+
* '''Zoom''' - '''[Mouse Wheel Down/Up]''' or '''[Ctrl+Plus]''' / '''[Ctrl+Minus]''' or '''[NUM+]''' / '''[NUM-]''' keys for zooming in and out.  
* '''Zoom Reset''' - Press the [NUM*] key to return to 100%. Press [Ctrl+0] to center the view and return to 100% zoom.
+
* '''Zoom Reset''' - Press the '''[NUM*]''' key to return to 100%. Press '''[Ctrl+0]''' to center the view and return to 100% zoom.
  
  
 
=Tools=
 
=Tools=
* '''Transform''' - Click and drag to move current selection, or if nothing is selected, click and drag near a vertex to move it. Hold [Shift] for vertical/horizontal movement. Hold [Ctrl] to scale, [Ctrl+Shift] to scale proportionately. Hold [Alt] to rotate, [Alt+Shift] to rotate in 15° increments.
+
[[File:Pw tool move.gif]] '''Transform''' - Click and drag to move current selection, or if nothing is selected, click and drag near a vertex to move it. Hold '''[Shift]''' for vertical/horizontal movement. Hold '''[Ctrl]''' to scale, [Ctrl+Shift] to scale proportionately. Hold '''[Alt]''' to rotate, [Alt+Shift] to rotate in 15° increments.
  
* '''Create''' - Click to create polys using the current color. [Right click] to select the type of the poly to be created and to turn quad mode on or off. Hold [Shift] to constrain the angle to 15° increments relative to the last vertex placed. Hold [alt] for vertex selection. Hold [Ctrl] to move the current selection.
 
  
* '''Vertex Selection''' - Click and drag to select vertices, or click on a poly near the vertex to select that vertex. Hold [Shift] to select additional vertices and [Alt] to deselect vertices. Hold [Ctrl] to move the current selection.
+
[[File:Pw tool create.gif]] '''Create''' - Click to create polys using the current color. '''[Right Click]''' to select the type of the poly to be created and to turn quad mode on or off. Hold '''[Shift]''' to constrain the angle to 15° increments relative to the last vertex placed. Hold '''[Alt]''' for vertex selection. Hold '''[Ctrl]''' to move the current selection.
  
* '''Poly Selection''' - Click in a poly or scenery to select it. Hold [Shift] to select additional polys or scenery and alt to deselect them. Hold [Ctrl] to move the current selection.
+
 
 +
[[File:Pw tool vselect.gif]] '''Vertex Selection''' - Click and drag to select vertices, or click on a poly near the vertex to select that vertex. Hold '''[Shift]''' to select additional vertices and '''[Alt]''' to deselect vertices. Hold '''[Ctrl]''' to move the current selection.
 +
 
 +
[[File:Pw tool pselect.gif]] '''Poly Selection''' - Click in a poly or scenery to select it. Hold '''[Shift]''' to select additional polys or scenery and '''[Alt]''' to deselect them. Hold '''[Ctrl]''' to move the current selection.
 
   
 
   
* '''Vertex Color''' - Click and drag to color vertices. If there are vertices selected only those will be affected. Hold alt to get a color from a vertex or scenery. Hold [Ctrl] to move the current selection.
 
  
* '''Poly Color''' - Click in a poly or scenery to color it. If there are vertices selected all of them will be affected. Hold alt to get a color from a vertex or scenery. Hold [Ctrl] to move the current selection.
+
[[File:Pw tool vcolour.gif]] '''Vertex Color''' - Click and drag to color vertices. If there are vertices selected only those will be affected. Hold '''[Alt]''' to get a color from a vertex or scenery. Hold '''[Ctrl]''' to move the current selection.
  
* '''Texture''' - Click and drag to change the texture coordinates of vertices. If there are vertices selected only those will be affected. Hold alt for vertex selection. Hold [Ctrl] to move the current selection.
 
  
* '''Scenery''' - Click to place scenery. Hold shift to constrain the angle to 15° increments or scale proportionately. Right click to show the scenery lists. Hold alt for vertex selection. Hold [Ctrl] to move the current selection.
+
[[File:Pw tool pcolour.gif]] '''Poly Color''' - Click in a poly or scenery to color it. If there are vertices selected all of them will be affected. Hold '''[Alt]''' to get a color from a vertex or scenery. Hold '''[Ctrl]''' to move the current selection.
  
* '''WayPoints''' - Click to place WayPoints. Hold shift and click to connect WayPoints. Right click to select the movement type of the WayPoints to be placed. Hold alt for vertex selection. Hold [Ctrl] to move the current selection.
 
  
* '''Objects''' - Click to place spawn points or colliders. Right click to select the type of object to be placed. Hold alt for vertex selection. Hold [Ctrl] to move the current selection.
+
[[File:Pw tool texture.gif]] '''Texture''' - Click and drag to change the texture coordinates of vertices. If there are vertices selected only those will be affected. Hold '''[Alt]''' for vertex selection. Hold '''[Ctrl]''' to move the current selection.
  
* '''Color Picker''' - Click to get a color from a vertex or scenery. Hold shift to get a color directly from the screen. Hold alt to get a lit vertex color. Hold [Ctrl] to move the current selection.
 
  
* '''Sketch''' - Click and drag to sketch. Hold shift to place lines. Hold alt to erase the sketch lines. Hold [Ctrl] to move the sketch lines.
+
[[File:Pw tool scenery.gif]] '''Scenery''' - Click to place scenery. Hold '''[Shift]''' to constrain the angle to 15° increments or scale proportionately. '''[Right Click]''' to show the scenery lists. Hold '''[Alt]''' for vertex selection. Hold '''[Ctrl]''' to move the current selection.
  
* '''Lights''' - Click to place a light source. Hold alt for vertex selection. Hold [Ctrl] to move the current selection.
 
  
* '''Depth Map''' - Click and drag to edit the depth map (Z-coordinates). If there are vertices selected only those will be affected. Hold alt to get a depth color from a vertex. Hold [Ctrl] to move the current selection.
+
[[File:Pw tool waypoint.gif]] '''WayPoints''' - Click to place WayPoints. Hold '''[Shift]''' and click to connect WayPoints. '''[Right Click]''' to select the movement type of the WayPoints to be placed. Hold '''[Alt]''' for vertex selection. Hold '''[Ctrl]''' to move the current selection.
  
  
=FILE MENU=
+
[[File:Pw tool objects.gif]] '''Objects''' - Click to place spawn points or colliders. '''[Right Click]''' to select the type of object to be placed. Hold '''[Alt]''' for vertex selection. Hold '''[Ctrl]''' to move the current selection.
* '''New [Ctrl+N]''' - Creates a new map.
 
  
* '''Open [Ctrl+O]''' - Opens a saved map.
 
  
* '''Open Compiled [Ctrl+shift+o]''' - Opens a compiled map.
+
[[File:Pw tool clrpicker.gif]] '''Color Picker''' - Click to get a color from a vertex or scenery. Hold '''[Shift]''' to get a color directly from the screen. Hold '''[Alt]''' to get a lit vertex color. Hold '''[Ctrl]''' to move the current selection.
  
* '''Open Recent''' - Opens a recent file.
 
  
* '''Save [Ctrl+S] ''' - Saves the map to the saved maps directory.
+
[[File:Pw tool sketch.gif]] '''Sketch''' - Click and drag to sketch. Hold '''[Shift]''' to place lines. Hold '''[Alt]''' to erase the sketch lines. Hold '''[Ctrl]''' to move the sketch lines.
  
* '''SAVE AS [Ctrl+shift+s] ''' - Saves the map to the saved maps directory using a new file name.
 
  
* '''COMPILE TO PMS''' - Compiles and saves the map to the Soldat maps directory.
+
[[File:Pw tool lights.gif]] '''Lights''' - Click to place a light source. Hold '''[Alt]''' for vertex selection. Hold '''[Ctrl]''' to move the current selection.
  
* '''COMPILE TO PMS AS [F9]''' - Compiles and saves the map to the Soldat maps directory using a new file name.
 
  
* '''EXPORT ''' - Saves the selected part of the map to a prefab file.
+
[[File:Pw tool depthmap.gif]] '''Depth Map''' - Click and drag to edit the depth map (Z-coordinates). If there are vertices selected only those will be affected. Hold '''[Alt]''' to get a depth color from a vertex. Hold '''[Ctrl]''' to move the current selection.
  
* '''IMPORT'''  - Loads a prefab file into the map.
 
  
* '''RUN SOLDAT [F8] '''Starts Soldat with the last compiled map.
+
=File Menu=
 +
* '''New [Ctrl+N]''' - Creates a new map.
  
* '''EXIT [alt+F4] '''Exits the program.
+
* '''Open [Ctrl+O]''' - Opens a saved map.
  
 +
* '''Open Compiled [Ctrl+Shift+O]''' - Opens a compiled map.
  
=EDIT MENU=
+
* '''Open Recent''' - Opens a recent file.
  
* '''UNDO [Ctrl+z]''' Undoes the last operation performed.
+
* '''Save [Ctrl+S]''' - Saves the map to the saved maps directory.
  
* '''REDO [Ctrl+y]''' Redoes the last undone operation.
+
* '''Save as [Ctrl+Shift+S]''' - Saves the map to the saved maps directory using a new file name.
  
* '''DUPLICATE [Ctrl+d]''' Duplicates the current selection and offsets by 32 pixels.
+
* '''Compile to PMS''' - Compiles and saves the map to the Soldat maps directory.
  
* '''COPY [Ctrl+c]'''Copies the current selection.
+
* '''Compile to PMS as [F9]''' - Compiles and saves the map to the Soldat maps directory using a new file name.
  
* '''PASTE [Ctrl+v]'''Pastes the most recently copied selection.
+
* '''Export''' - Saves the selected part of the map to a prefab file.
  
* '''CLEAR [delete]''' - Deletes everything in the current selection.
+
* '''Import''' - Loads a prefab file into the map.
  
* '''SELECT ALL [Ctrl+a] ''' - Selects all polys, scenery, spawn points, colliders, WayPoints, and lights.
+
* '''Run Soldat [F8]''' - Starts Soldat with the last compiled map.
  
* '''INVERT SELECTION [Ctrl+i]''' - Selects everything currently not selected.
+
* '''Exit [Alt+F4]''' - Exits the program.
  
* '''DESELECT [escape]''' - Deselects current selection.
 
  
* '''SELECT BY Color [Ctrl+b] ''' - Selects all vertices of the current color.
+
=Edit Menu=
 +
* '''Undo [Ctrl+Z]''' - Undoes the last operation performed.
  
* '''ARRANGE'''
+
* '''Redo [Ctrl+Y]''' - Redoes the last undone operation.
** '''BRING TO FRONT [home]''' - Brings selected polys and scenery in front of the rest.
 
** '''BRING FORWARD [page up]''' - Brings selected polys and scenery forward.
 
** '''SEND BACKWARD [page down]''' - Sends selected polys and scenery backward.
 
** '''SEND TO BACK [end]''' - Sends selected polys and scenery behind the rest.
 
  
* '''SPLIT AT VERTEX [Ctrl+l]''' - Splits polys in half from the selected vertex to the midpoint of the opposite edge.
+
* '''Duplicate [Ctrl+D]''' - Duplicates the current selection and offsets by 32 pixels.
  
* '''JOIN VERTICES [Ctrl+J]''' - Brings all selected vertices to the coordinates of the first vertex selected.
+
* '''Copy [Ctrl+C]''' - Copies the current selection.
  
* '''CREATE WITH SELECTED [Ctrl+E]''' - Creates a new poly using the 3 vertices selected.
+
* '''Paste [Ctrl+V]''' - Pastes the most recently copied selection.
  
*'''TRANSFORM'''
+
* '''Clear [Delete]''' - Deletes everything in the current selection.
** '''ROTATE 180°''' - Rotates all selected vertices and scenery by a half-turn.
 
** '''ROTATE 90° CW''' - Rotates all selected vertices and scenery clockwise by a half-turn.
 
** '''ROTATE 90° CCW''' - Rotates all selected vertices and scenery counterclockwise by a half turn.
 
** '''FLIP HORIZONTAL''' - Flips all selected vertices and scenery horizontally, along the vertical axis.
 
** '''FLIP VERTICAL''' - Flips all selected vertices and scenery vertically, along the horizontal axis.
 
  
* '''SEVER CONNECTIONS [Backspace]''' - Severs connections between selected WayPoints.
+
* '''Select All [Ctrl+A] ''' - Selects all polys, scenery, spawn points, colliders, WayPoints, and lights.
  
* '''CLEAR SKETCH''' - Removes all lines made by the sketch tool.
+
* '''Invert Selection [Ctrl+I]''' - Selects everything currently not selected.
  
* '''MAP SETTINGS [Ctrl+M]''' - Shows the Map Settings window.
+
* '''Deselect [ESC]''' - Deselects current selection.
  
* '''PREFERENCES [Ctrl+P]''' - Shows the Preferences window.
+
* '''Select by Color [Ctrl+B] ''' - Selects all vertices of the current color.
  
 +
* '''Arrange'''
 +
** '''Bring to Front [Home]''' - Brings selected polys and scenery in front of the rest.
 +
** '''Bring Forward [Page Up]''' - Brings selected polys and scenery forward.
 +
** '''Send Backward [Page Down]''' - Sends selected polys and scenery backward.
 +
** '''Send to Back [End]''' - Sends selected polys and scenery behind the rest.
  
=TEXTURE MENU=
+
* '''Split at Vertex [Ctrl+L]''' - Splits polys in half from the selected vertex to the midpoint of the opposite edge.
  
FIX TEXTURE [Ctrl+f]
+
* '''Join Vertices [Ctrl+J]''' - Brings all selected vertices to the coordinates of the first vertex selected.
Sets the texture coordinates of all selected vertices depending on the position of each vertex.
 
  
UNTEXTURE [Ctrl+u]
+
* '''Create with Selected [Ctrl+E]''' - Creates a new poly using the 3 vertices selected.
Sets the texture coordinates of all selected vertices to the same value.
 
  
*'''TRANSFORM TEXTURE'''
+
* '''Transform'''
** '''ROTATE 180°''' - Rotates the selected vertices' texture by a half-turn.
+
** '''Rotate 180°''' - Rotates all selected vertices and scenery by a half-turn.
** '''ROTATE 90° CW''' - Rotates the selected vertices' texture clockwise by a half-turn.
+
** '''Rotate 90° CW''' - Rotates all selected vertices and scenery clockwise by a half-turn.
** '''ROTATE 90° CCW''' - Rotates the selected vertices' texture counterclockwise by a half turn.
+
** '''Rotate 90° CCW''' - Rotates all selected vertices and scenery counterclockwise by a half turn.
** '''FLIP HORIZONTAL''' - Flips the selected vertices' texture horizontally, along the vertical axis.
+
** '''Flip Horizontal''' - Flips all selected vertices and scenery horizontally, along the vertical axis.
** '''FLIP VERTICAL''' - Flips the selected vertices' texture vertically, along the horizontal axis.
+
** '''Flip Vertical''' - Flips all selected vertices and scenery vertically, along the horizontal axis.
  
AVERAGE VERTEX COLORS [Ctrl+g] - Averages the colors of vertices that have the same position.
+
* '''Sever Connections [Backspace]''' - Severs connections between selected WayPoints.
  
APPLY LIGHT TO VERTICES - Applies lights to vertex colors and hides the light sources.
+
* '''Clear Sketch''' - Removes all lines made by the sketch tool.
  
FIXED TEXTURE  - Turns fixed texture on and off. When fixed texture is on vertices do not keep their texture coordinates when moved.
+
* '''Map Settings [Ctrl+M]''' - Shows the Map Settings window.
  
USER DEFINED X  - For use with quad function. Quads are created/manipulated with the horizontal texture coordinates specified in the Texture panel in the Properties window.
+
* '''Preferences [Ctrl+P]''' - Shows the Preferences window.
  
USER DEFINED Y  - For use with quad function. Quads are created/manipulated with the vertical texture coordinates specified in the Texture panel in the Properties window.
 
  
 +
=Texture Menu=
 +
* '''Fix Texture [Ctrl+F]''' - Sets the texture coordinates of all selected vertices depending on the position of each vertex.
  
=VIEW MENU=
+
* '''Untexture [Ctrl+U]''' - Sets the texture coordinates of all selected vertices to the same value.
  
* ZOOM IN [Ctrl+plus, num+] - Zooms in to twice the current zoom level.
+
* '''Transform Texture'''
 +
** '''Rotate 180°''' - Rotates the selected vertices' texture by a half-turn.
 +
** '''Rotate 90° CW''' - Rotates the selected vertices' texture clockwise by a half-turn.
 +
** '''Rotate 90° CCW''' - Rotates the selected vertices' texture counterclockwise by a half turn.
 +
** '''Flip Horizontal''' - Flips the selected vertices' texture horizontally, along the vertical axis.
 +
** '''Flip Vertical''' - Flips the selected vertices' texture vertically, along the horizontal axis.
  
* ZOOM OUT [Ctrl+minus, num-] - Zooms out to half the current zoom level.
+
* '''Average Vertex Colors [Ctrl+G]''' - Averages the colors of vertices that have the same position.
  
* FIT ON SCREEN  - Changes the zoom level and offset so that the entire map is visible in the PolyWorks window.
+
* '''Apply Light to Vertices''' - Applies lights to vertex colors and hides the light sources.
  
* ACTUAL SIZE - Changes the zoom level to show the same screen area that would be visible in Soldat, depending on the width of the PolyWorks window.
+
* '''Fixed Texture''' - Turns fixed texture on and off. When fixed texture is on vertices do not keep their texture coordinates when moved.
  
* RESET VIEW - Resets the zoom level and screen coordinates to the starting point.
+
* '''User Defined X''' - For use with quad function. Quads are created/manipulated with the horizontal texture coordinates specified in the Texture panel in the Properties window.
  
* SHOW GRID [Ctrl+'] - Turns the grid on and off.
+
* '''User Defined Y''' - For use with quad function. Quads are created/manipulated with the vertical texture coordinates specified in the Texture panel in the Properties window.
  
* SNAP TO GRID - Turns snapping to grid on and off. When snap to grid is on, vertices and scenery snap to the grid when created or moved.
 
  
* SNAP TO VERTICES - Turns snapping to vertices on and off. When snap to vertices is on vertices snap to nearby vertices when created or moved.
+
=View Menu=
  
* BLEND WIREFRAME - Turns wireframe blending on and off.
+
* '''Zoom In '''[Ctrl]'''+[NUM+]/[+]''' - Zooms in to twice the current zoom level.
  
* BLEND POLYS - Turns poly blending on and off.
+
* '''Zoom Out '''[Ctrl]'''+[NUM-]/[-]''' - Zooms out to half the current zoom level.
  
* SHOW SCENERY LAYERS
+
* '''Fit on Screen''' - Changes the zoom level and offset so that the entire map is visible in the PolyWorks window.
** BACK - Show sceneries in the back layer.
 
** MIDDLE - Show sceneries in the middle layer.
 
** FRONT - Show sceneries in the front layer..
 
  
REFRESH [F5] - Resizes the background to fit the map.
+
* '''Actual Size''' - Changes the zoom level to show the same screen area that would be visible in Soldat, depending on the width of the PolyWorks window.
  
 +
* '''Reset View''' - Resets the zoom level and screen coordinates to the starting point.
  
=PALETTE WINDOW=
+
* '''Show Grid''' [Ctrl+'] - Turns the grid on and off.
  
* CURRENT COLOR - Click the color box to show the Color Picker window, or input the RGB components.
+
* '''Snap to Grid''' - Turns snapping to grid on and off. When snap to grid is on, vertices and scenery snap to the grid when created or moved.
  
* VERTEX COLOR MODE
+
* '''Snap to Vertices''' - Turns snapping to vertices on and off. When snap to vertices is on vertices snap to nearby vertices when created or moved.
** PRECISION - Only color once vertex at a time.
 
** NORMAL - Click and drag to color vertices.
 
** DYNAMIC - The effect is applied as the mouse moves.
 
  
* RADIUS - Controls the radius of the vertex color tool and collider size.
+
* '''Blend Wireframe''' - Turns wireframe blending on and off.
  
* OPACITY - Controls the opacity of the vertex color tool and scenery alpha.
+
* '''Blend Polys''' - Turns poly blending on and off.
  
* BLEND MODE
+
* '''Show Scenery Layers'''
NORMAL - The current colour is applied.
+
** '''Back''' - Show sceneries in the back layer.
MULTIPLY - Multiplies the vertex colour with the current colour. The darker the colour is, the more effect it has. Blending with white produces no change.
+
** '''Middle''' - Show sceneries in the middle layer.
SCREEN - The opposite of Multiply. The lighter the colour is, the more effect is has. Blending with black produces no change.
+
** '''Front''' - Show sceneries in the front layer..
DARKEN - Affects vertices that are lighter than the current colour, and darkens them.
 
LIGHTEN - Affects vertices that are darker than the current colour, and lightens them.
 
DIFFERENCE - Takes the difference between the vertex colour and the current colour. Blending with white inverts the base color values, blending with black produces no change.
 
  
* PALETTE - Contains 72 colors. Right click to add a color to the palette.
+
* '''Refresh [F5]''' - Resizes the background to fit the map.
  
* PALETTE MENU
 
** LOAD PALETTE - Loads palette colors from a file.
 
** SAVE PALETTE - Saves the current palette colors in a file.
 
** CLEAR - Sets all palette colors to black.
 
  
 +
=Palette Window=
 +
* '''Current Color''' - Click the color box to show the Color Picker window, or input the RGB components.
  
=SCENERY WINDOW=
+
* '''Vertex Color Mode'''
 +
** '''Precision''' - Only color once vertex at a time.
 +
** '''Normal''' - Click and drag to color vertices.
 +
** '''Dynamic''' - The effect is applied as the mouse moves.
  
*LEVEL
+
* '''Radius''' - Controls the radius of the vertex color tool and collider size.
** BACK - Sceneries are placed behind everything.
 
** MIDDLE - Sceneries are placed behind polys, in front of the player.
 
** FRONT - Sceneries are placed in front of everything.
 
  
* ROTATE - Rotate scenery when creating.
+
* '''Opacity''' - Controls the opacity of the vertex color tool and scenery alpha.
  
*SCALE - Scale scenery when creating.
+
* '''Blend Mode'''
 +
** '''Normal''' - The current colour is applied.
 +
** '''Multiply''' - Multiplies the vertex colour with the current colour. The darker the colour is, the more effect it has. Blending with white produces no change.
 +
** '''Screen''' - The opposite of Multiply. The lighter the colour is, the more effect is has. Blending with black produces no change.
 +
** '''Darken''' - Affects vertices that are lighter than the current colour, and darkens them.
 +
** '''Lighten''' - Affects vertices that are darker than the current colour, and lightens them.
 +
** '''Difference''' - Takes the difference between the vertex colour and the current colour. Blending with white inverts the base color values, blending with black produces no change.
  
* SCENERY MENU
+
* '''Palette''' - Contains 72 colors. Right click to add a color to the palette.
** CLEAR UNUSED - Deletes unused scenery textures and removes them from the current scenery list.
 
** RELOAD SCENERY LIST - Reloads the Master List.
 
** REFRESH SCENERY - Reloads the texture for the scenery in the scenery list.
 
  
 +
* '''Palette Menu'''
 +
** '''Load Palette''' - Loads palette colors from a file.
 +
** '''Save Palette''' - Saves the current palette colors in a file.
 +
** '''Clear''' - Sets all palette colors to black.
  
=PROPERTIES WINDOW=
 
  
* POLYGON PROPERTIES - Sets the poly type or texture coordinates of all selected vertices.
+
=Scenery Window=
 +
* '''Level'''
 +
** '''Back''' - Sceneries are placed behind everything.
 +
** '''Middle''' - Sceneries are placed behind polys, in front of the player.
 +
** '''Front''' - Sceneries are placed in front of everything.
  
* SCENERY PROPERTIES - Sets the scaling, level, opacity or rotation of all selected scenery.
+
* '''Rotate''' - Rotate scenery when creating.
  
* TRANSFORM - Scales or rotates the current selection by the value input.
+
* '''Scale''' - Scale scenery when creating.
  
* TEXTURE SETTINGS - Sets texture dimensions used when fixed texture is applied. Define the horizontal and vertical coordinates used by the quad function.
+
* '''Scenery Menu'''
 +
** '''Clear Unused''' - Deletes unused scenery textures and removes them from the current scenery list.
 +
** '''Reload Scenery List''' - Reloads the Master List.
 +
** '''Refresh Scenery''' - Reloads the texture for the scenery in the scenery list.
  
* LIGHT PROPERTIES - Sets the colour and z-coordinate of all selected lights.
 
  
* MAP INFO - Shows the current number of polys, scenery, spawn points, colliders, WayPoints, and WayPoint connections.
+
=Properties Window=
 +
* '''Polygon Properties''' - Sets the poly type or texture coordinates of all selected vertices.
  
 +
* '''Scenery Properties''' - Sets the scaling, level, opacity or rotation of all selected scenery.
  
=WAYPOINTS WINDOW=
+
* '''Transform''' - Scales or rotates the current selection by the value input.
  
* LEFT/RIGHT/UP/DOWN/FLY - Sets the type of movement that the bot has to do to get to this WayPoint, for all selected WayPoints.
+
* '''Texture Settings''' - Sets texture dimensions used when fixed texture is applied. Define the horizontal and vertical coordinates used by the quad function.
  
* SPECIAL - Sets a special WayPoint function used in places where bots must stop and defend the base, for all selected WayPoints.
+
* '''Light Properties''' - Sets the colour and z-coordinate of all selected lights.
  
* PATH 1/PATH 2 - Sets the path number of all selected WayPoints.
+
* '''Map Info''' - Shows the current number of polys, scenery, spawn points, colliders, WayPoints, and WayPoint connections.
  
* SHOW - Shows WayPoints and connections for both paths or a single path.
 
  
 +
=WayPoints Window=
 +
* '''Left/Right/Up/Down/Fly''' - Sets the type of movement that the bot has to do to get to this WayPoint, for all selected WayPoints.
  
 +
* '''Special''' - Sets a special WayPoint function used in places where bots must stop and defend the base, for all selected WayPoints.
  
 +
* '''Path1 / Path2''' - Sets the path number of all selected WayPoints.
  
'''SOLDAT POLYWORKS © 2005 Anna Zajaczkowski'''
+
* '''Show''' - Shows WayPoints and connections for both paths or a single path.

Latest revision as of 06:02, 23 April 2018

Soldat PolyWorks Icon
This is the latest help file for Soldat PolyWorks taken from Soldat PolyWorks GitHub


Controls

  • Scroll - Click and drag with the [Middle Mouse Button] or hold [Space] + [Left Mouse Button].
  • Zoom - [Mouse Wheel Down/Up] or [Ctrl+Plus] / [Ctrl+Minus] or [NUM+] / [NUM-] keys for zooming in and out.
  • Zoom Reset - Press the [NUM*] key to return to 100%. Press [Ctrl+0] to center the view and return to 100% zoom.


Tools

Pw tool move.gif Transform - Click and drag to move current selection, or if nothing is selected, click and drag near a vertex to move it. Hold [Shift] for vertical/horizontal movement. Hold [Ctrl] to scale, [Ctrl+Shift] to scale proportionately. Hold [Alt] to rotate, [Alt+Shift] to rotate in 15° increments.


Pw tool create.gif Create - Click to create polys using the current color. [Right Click] to select the type of the poly to be created and to turn quad mode on or off. Hold [Shift] to constrain the angle to 15° increments relative to the last vertex placed. Hold [Alt] for vertex selection. Hold [Ctrl] to move the current selection.


Pw tool vselect.gif Vertex Selection - Click and drag to select vertices, or click on a poly near the vertex to select that vertex. Hold [Shift] to select additional vertices and [Alt] to deselect vertices. Hold [Ctrl] to move the current selection.

Pw tool pselect.gif Poly Selection - Click in a poly or scenery to select it. Hold [Shift] to select additional polys or scenery and [Alt] to deselect them. Hold [Ctrl] to move the current selection.


Pw tool vcolour.gif Vertex Color - Click and drag to color vertices. If there are vertices selected only those will be affected. Hold [Alt] to get a color from a vertex or scenery. Hold [Ctrl] to move the current selection.


Pw tool pcolour.gif Poly Color - Click in a poly or scenery to color it. If there are vertices selected all of them will be affected. Hold [Alt] to get a color from a vertex or scenery. Hold [Ctrl] to move the current selection.


Pw tool texture.gif Texture - Click and drag to change the texture coordinates of vertices. If there are vertices selected only those will be affected. Hold [Alt] for vertex selection. Hold [Ctrl] to move the current selection.


Pw tool scenery.gif Scenery - Click to place scenery. Hold [Shift] to constrain the angle to 15° increments or scale proportionately. [Right Click] to show the scenery lists. Hold [Alt] for vertex selection. Hold [Ctrl] to move the current selection.


Pw tool waypoint.gif WayPoints - Click to place WayPoints. Hold [Shift] and click to connect WayPoints. [Right Click] to select the movement type of the WayPoints to be placed. Hold [Alt] for vertex selection. Hold [Ctrl] to move the current selection.


Pw tool objects.gif Objects - Click to place spawn points or colliders. [Right Click] to select the type of object to be placed. Hold [Alt] for vertex selection. Hold [Ctrl] to move the current selection.


Pw tool clrpicker.gif Color Picker - Click to get a color from a vertex or scenery. Hold [Shift] to get a color directly from the screen. Hold [Alt] to get a lit vertex color. Hold [Ctrl] to move the current selection.


Pw tool sketch.gif Sketch - Click and drag to sketch. Hold [Shift] to place lines. Hold [Alt] to erase the sketch lines. Hold [Ctrl] to move the sketch lines.


Pw tool lights.gif Lights - Click to place a light source. Hold [Alt] for vertex selection. Hold [Ctrl] to move the current selection.


Pw tool depthmap.gif Depth Map - Click and drag to edit the depth map (Z-coordinates). If there are vertices selected only those will be affected. Hold [Alt] to get a depth color from a vertex. Hold [Ctrl] to move the current selection.


File Menu

  • New [Ctrl+N] - Creates a new map.
  • Open [Ctrl+O] - Opens a saved map.
  • Open Compiled [Ctrl+Shift+O] - Opens a compiled map.
  • Open Recent - Opens a recent file.
  • Save [Ctrl+S] - Saves the map to the saved maps directory.
  • Save as [Ctrl+Shift+S] - Saves the map to the saved maps directory using a new file name.
  • Compile to PMS - Compiles and saves the map to the Soldat maps directory.
  • Compile to PMS as [F9] - Compiles and saves the map to the Soldat maps directory using a new file name.
  • Export - Saves the selected part of the map to a prefab file.
  • Import - Loads a prefab file into the map.
  • Run Soldat [F8] - Starts Soldat with the last compiled map.
  • Exit [Alt+F4] - Exits the program.


Edit Menu

  • Undo [Ctrl+Z] - Undoes the last operation performed.
  • Redo [Ctrl+Y] - Redoes the last undone operation.
  • Duplicate [Ctrl+D] - Duplicates the current selection and offsets by 32 pixels.
  • Copy [Ctrl+C] - Copies the current selection.
  • Paste [Ctrl+V] - Pastes the most recently copied selection.
  • Clear [Delete] - Deletes everything in the current selection.
  • Select All [Ctrl+A] - Selects all polys, scenery, spawn points, colliders, WayPoints, and lights.
  • Invert Selection [Ctrl+I] - Selects everything currently not selected.
  • Deselect [ESC] - Deselects current selection.
  • Select by Color [Ctrl+B] - Selects all vertices of the current color.
  • Arrange
    • Bring to Front [Home] - Brings selected polys and scenery in front of the rest.
    • Bring Forward [Page Up] - Brings selected polys and scenery forward.
    • Send Backward [Page Down] - Sends selected polys and scenery backward.
    • Send to Back [End] - Sends selected polys and scenery behind the rest.
  • Split at Vertex [Ctrl+L] - Splits polys in half from the selected vertex to the midpoint of the opposite edge.
  • Join Vertices [Ctrl+J] - Brings all selected vertices to the coordinates of the first vertex selected.
  • Create with Selected [Ctrl+E] - Creates a new poly using the 3 vertices selected.
  • Transform
    • Rotate 180° - Rotates all selected vertices and scenery by a half-turn.
    • Rotate 90° CW - Rotates all selected vertices and scenery clockwise by a half-turn.
    • Rotate 90° CCW - Rotates all selected vertices and scenery counterclockwise by a half turn.
    • Flip Horizontal - Flips all selected vertices and scenery horizontally, along the vertical axis.
    • Flip Vertical - Flips all selected vertices and scenery vertically, along the horizontal axis.
  • Sever Connections [Backspace] - Severs connections between selected WayPoints.
  • Clear Sketch - Removes all lines made by the sketch tool.
  • Map Settings [Ctrl+M] - Shows the Map Settings window.
  • Preferences [Ctrl+P] - Shows the Preferences window.


Texture Menu

  • Fix Texture [Ctrl+F] - Sets the texture coordinates of all selected vertices depending on the position of each vertex.
  • Untexture [Ctrl+U] - Sets the texture coordinates of all selected vertices to the same value.
  • Transform Texture
    • Rotate 180° - Rotates the selected vertices' texture by a half-turn.
    • Rotate 90° CW - Rotates the selected vertices' texture clockwise by a half-turn.
    • Rotate 90° CCW - Rotates the selected vertices' texture counterclockwise by a half turn.
    • Flip Horizontal - Flips the selected vertices' texture horizontally, along the vertical axis.
    • Flip Vertical - Flips the selected vertices' texture vertically, along the horizontal axis.
  • Average Vertex Colors [Ctrl+G] - Averages the colors of vertices that have the same position.
  • Apply Light to Vertices - Applies lights to vertex colors and hides the light sources.
  • Fixed Texture - Turns fixed texture on and off. When fixed texture is on vertices do not keep their texture coordinates when moved.
  • User Defined X - For use with quad function. Quads are created/manipulated with the horizontal texture coordinates specified in the Texture panel in the Properties window.
  • User Defined Y - For use with quad function. Quads are created/manipulated with the vertical texture coordinates specified in the Texture panel in the Properties window.


View Menu

  • Zoom In [Ctrl]+[NUM+]/[+] - Zooms in to twice the current zoom level.
  • Zoom Out [Ctrl]+[NUM-]/[-] - Zooms out to half the current zoom level.
  • Fit on Screen - Changes the zoom level and offset so that the entire map is visible in the PolyWorks window.
  • Actual Size - Changes the zoom level to show the same screen area that would be visible in Soldat, depending on the width of the PolyWorks window.
  • Reset View - Resets the zoom level and screen coordinates to the starting point.
  • Show Grid [Ctrl+'] - Turns the grid on and off.
  • Snap to Grid - Turns snapping to grid on and off. When snap to grid is on, vertices and scenery snap to the grid when created or moved.
  • Snap to Vertices - Turns snapping to vertices on and off. When snap to vertices is on vertices snap to nearby vertices when created or moved.
  • Blend Wireframe - Turns wireframe blending on and off.
  • Blend Polys - Turns poly blending on and off.
  • Show Scenery Layers
    • Back - Show sceneries in the back layer.
    • Middle - Show sceneries in the middle layer.
    • Front - Show sceneries in the front layer..
  • Refresh [F5] - Resizes the background to fit the map.


Palette Window

  • Current Color - Click the color box to show the Color Picker window, or input the RGB components.
  • Vertex Color Mode
    • Precision - Only color once vertex at a time.
    • Normal - Click and drag to color vertices.
    • Dynamic - The effect is applied as the mouse moves.
  • Radius - Controls the radius of the vertex color tool and collider size.
  • Opacity - Controls the opacity of the vertex color tool and scenery alpha.
  • Blend Mode
    • Normal - The current colour is applied.
    • Multiply - Multiplies the vertex colour with the current colour. The darker the colour is, the more effect it has. Blending with white produces no change.
    • Screen - The opposite of Multiply. The lighter the colour is, the more effect is has. Blending with black produces no change.
    • Darken - Affects vertices that are lighter than the current colour, and darkens them.
    • Lighten - Affects vertices that are darker than the current colour, and lightens them.
    • Difference - Takes the difference between the vertex colour and the current colour. Blending with white inverts the base color values, blending with black produces no change.
  • Palette - Contains 72 colors. Right click to add a color to the palette.
  • Palette Menu
    • Load Palette - Loads palette colors from a file.
    • Save Palette - Saves the current palette colors in a file.
    • Clear - Sets all palette colors to black.


Scenery Window

  • Level
    • Back - Sceneries are placed behind everything.
    • Middle - Sceneries are placed behind polys, in front of the player.
    • Front - Sceneries are placed in front of everything.
  • Rotate - Rotate scenery when creating.
  • Scale - Scale scenery when creating.
  • Scenery Menu
    • Clear Unused - Deletes unused scenery textures and removes them from the current scenery list.
    • Reload Scenery List - Reloads the Master List.
    • Refresh Scenery - Reloads the texture for the scenery in the scenery list.


Properties Window

  • Polygon Properties - Sets the poly type or texture coordinates of all selected vertices.
  • Scenery Properties - Sets the scaling, level, opacity or rotation of all selected scenery.
  • Transform - Scales or rotates the current selection by the value input.
  • Texture Settings - Sets texture dimensions used when fixed texture is applied. Define the horizontal and vertical coordinates used by the quad function.
  • Light Properties - Sets the colour and z-coordinate of all selected lights.
  • Map Info - Shows the current number of polys, scenery, spawn points, colliders, WayPoints, and WayPoint connections.


WayPoints Window

  • Left/Right/Up/Down/Fly - Sets the type of movement that the bot has to do to get to this WayPoint, for all selected WayPoints.
  • Special - Sets a special WayPoint function used in places where bots must stop and defend the base, for all selected WayPoints.
  • Path1 / Path2 - Sets the path number of all selected WayPoints.
  • Show - Shows WayPoints and connections for both paths or a single path.