User Tools

Site Tools


voxel_editor

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
voxel_editor [2017/07/14 08:21]
justin
voxel_editor [2019/09/03 08:58] (current)
Line 7: Line 7:
 =====Main Toolbar===== =====Main Toolbar=====
 ^Icon^Function^Description^Shortcut Key^ ^Icon^Function^Description^Shortcut Key^
-|{{:wiki:new_resource.png?​nolink|}}|New Resource|Opens the [[New Resource dialog]] (with "​Tile"​ selected for the resource type).|+|{{:wiki:page_add.png?​nolink|}}|New Resource|Opens the [[New Resource dialog]] (with "​Tile"​ selected for the resource type).|
 |{{:​wiki:​disk.png?​nolink|}}|Save|Saves changes to the model.| |{{:​wiki:​disk.png?​nolink|}}|Save|Saves changes to the model.|
 |{{:​wiki:​disk_multiple.png?​nolink|}}|Save As|Saves a copy of the model to a new file.| |{{:​wiki:​disk_multiple.png?​nolink|}}|Save As|Saves a copy of the model to a new file.|
-|{{:wiki:arrow_undo.png?​nolink|}}|Undo|Reverts the most recent modification made to the model.|Ctrl + Z| +|{{:wiki:folder_voxel.png?​nolink|}}|Import from External Format|Opens the Import dialog, allowing you to import data from MagicaVoxel .vox files or Qubicle .qb files.| 
-|{{:wiki:arrow_redo.png?​nolink|}}|Redo|Reapplies the last modification that was undone.|Ctrl + Y| +|{{:​wiki:​import_export.png?​nolink|}}|Export to External Format|Opens the Export dialog, allowing you to export the model to MagicaVoxel .vox format, OBJ format, or a PNG image.| 
-|{{:wiki:clear.png?​nolink|}}|Clear|Removes all voxels from the model'​s current frame.| +|{{:​wiki:​undo.png?​nolink|}}|Undo|Reverts the most recent modification made to the model.|Ctrl + Z| 
-|{{:wiki:brick_add.png?​nolink|}}|Import from VOX/PNG File|Opens the Import dialog, allowing you to import data from MagicaVoxel VOX files or PNG images.| +|{{:wiki:redo.png?​nolink|}}|Redo|Reapplies the last modification that was undone.|Ctrl + Y| 
-|{{:wiki:lorry_go.png?​nolink|}}|Export to External Format|Opens the Export dialog, allowing you to export ​the model to either ​the MagicaVoxel VOX format or to the OBJ format.| +|{{:wiki:grid.png?​nolink|}}|Display Grid|Enables/​disables display of the boundary grid lines.| 
-|{{:wiki:voxel_outlines.png?​nolink|}}|Toggle Voxel Outlines|Enables/​disables ​the outlines drawn around ​the edges of voxels.| +|{{:wiki:voxel_outlines.png?​nolink|}}|Display Voxel Outlines|Enables/disables display of outlines drawn along voxel edges.| 
-|{{:wiki:grid.png?​nolink|}}|Toggle Grid|Enables/​disables ​the boundary grid lines.|+|{{:​wiki:​surface_edges.png?​nolink|}}|Display Surface Edges|Enables/​disables display of outlines drawn along the perimeter of each flat surface.| 
 +|{{:wiki:ground.png?​nolink|}}|Display Ground|Enables/​disables ​the ground surface displayed underneath ​the model.| 
 +|{{:​wiki:​mesh_preview.png?​nolink|}}|Preview Game Mesh|Displays ​the generated mesh as it will appear in-game.| 
 +|{{:​wiki:​image.png?​nolink|}}|Capture Thumbnail|Captures an image to use for the model'​s preview thumbnail.| 
 +|{{:wiki:gear.png?​nolink|}}|Editor Settings|Opens the Voxel Editor section of the Editor Settings dialog.| 
 +|{{:wiki:fullscreen.png?​nolink|}}|Fullscreen Mode|Toggles ​the editor'​s fullscreen mode.|F11|
  
-=====Camera/​Other ​Controls=====+=====Camera Controls=====
 ^Control/​Key^Description^ ^Control/​Key^Description^
 |Right Mouse Button + Drag|Rotate camera| |Right Mouse Button + Drag|Rotate camera|
-|Shift + Right Mouse Button + Drag|Move camera ​up/down|+|Middle ​Button + Drag|Move camera|
 |Scroll Wheel Up|Zoom camera in| |Scroll Wheel Up|Zoom camera in|
 |Scroll Wheel Down|Zoom camera out| |Scroll Wheel Down|Zoom camera out|
-|Alt + Left Mouse Button|Pick color| 
  
 =====Editor Tools===== =====Editor Tools=====
 ^Icon^Function^Description^Shortcut Key^ ^Icon^Function^Description^Shortcut Key^
-|{{:wiki:pencil_add.png?​nolink|}}|Attach/​Place Voxels|Mode for adding voxels to the model. New voxels can be attached to existing ones or onto the bottom ​grid by left-clicking.|F1| +|{{:wiki:voxel_add.png?​nolink|}}|Attach/​Place Voxels|Mode for adding voxels to the model. New voxels can be attached to existing ones or onto the grid boundaries ​by left-clicking. In "​Box"​ mode, you can click and drag to place a box area of voxels across three dimensions. In "​Face"​ mode, clicking a voxel will "​extrude"​ the face (all adjoining voxels of the same color) outward by one.|F1| 
-|{{:wiki:paintbrush.png?​nolink|}}|Paint Voxels|Mode for painting voxels. Left-click an existing voxel to change its color to the currently selected color.|F2| +|{{:wiki:voxel_paint.png?​nolink|}}|Paint Voxels|Mode for painting voxels. Left-click an existing voxel to change its color to the currently selected color. In "​Box"​ mode, you can click and drag to paint a three dimensional area. In "​Face"​ mode, clicking a voxel'​s face will paint all voxels of the same color that adjoin that face.|F2| 
-|{{:​wiki:​delete.png?​nolink|}}|Erase Voxels|Mode for removing voxels from the model. Left-click to remove the voxel currently highlighted ​with red outline.|F3| +|{{:​wiki:​delete.png?​nolink|}}|Erase Voxels|Mode for removing voxels from the model. Left-click to remove the voxel currently highlighted ​by the voxel cursor. In "​Box"​ mode, you can click and drag to remove ​box area of voxels across three dimensions. In "​Face"​ mode, clicking a voxel'​s face will remove all voxels of the same color that adjoin that face.|F3| 
-|{{:wiki:paintcan.png?​nolink|}}|Replace Color|Mode for replacing the colors of multiple voxels at once. Left-clicking a voxel will replace the color of that voxel and any others of the same color with the currently selected color. With "All Frames"​ checked, the color replacement will occur across all frames of the model.|F4| +|{{:wiki:paint_can.png?​nolink|}}|Replace Color|Mode for replacing the colors of multiple voxels at once. Left-clicking a voxel will replace the color of that voxel and any others of the same color with the currently selected color. With "All Frames"​ checked, the color replacement will occur across all frames of the model. With "​Contiguous"​ checked, only adjoining voxels will be replaced.|F4| 
-|{{:wiki:arrow_up.png?​nolink|}}|Shift Model Up|Shifts the entire model up by one voxel (current frame only)| +|{{:wiki:arrow_out.png?​nolink|}}|Move Voxels|Mode for moving voxels along one axisThe voxels will be moved in the direction of the mouse drag and based on the orientation of the voxel cursor. If any voxels are selected, ​only the selection will be moved, otherwise ​the entire model will be moved.|F5
-|{{:​wiki:​arrow_down.png?​nolink|}}|Shift Model Down|Shifts ​the entire model down by one voxel (current frame only)| +|{{:wiki:group.png?​nolink|}}|Select Voxels|Mode for selecting one or more voxels that can then be moved or deleted independently from the rest of the model.|F6
-|{{:​wiki:​arrow_left.png?​nolink|}}|Shift Model Left|Shifts ​the entire model left by one voxel (current frame only)+|{{:wiki:eyedropper.png?​nolink|}}|Pick Color|Mode for sampling ​the color of a voxel. Left-clicking a voxel will set its color as the palette'​s selected color.|F7
-|{{:wiki:arrow_right.png?​nolink|}}|Shift Model Right|Shifts ​the entire ​model right by one voxel (current frame only)+|{{:wiki:arrow_rotate_clockwise.png?​nolink|}}|Rotate ​Model Clockwise|Rotates ​the entire model clockwise ​by 90 degrees ​(current frame only).
-|{{:wiki:blue_arrow_down.png?​nolink|}}|Shift Model Forward|Shifts ​the entire model forward by one voxel (current frame only)+|{{:wiki:flip_horizontal.png?​nolink|}}|Flip Model Horizontally|Flips the entire model horizontally,​ relative to the camera view (current frame only).
-|{{:wiki:blue_arrow_up.png?​nolink|}}|Shift Model Backward|Shifts ​the entire model backward ​by one voxel (current frame only)| +|{{:wiki:palette.png?​nolink|}}|Apply Palette|Attempts to match all voxel colors in the model to those of the currently selected palette. A dialog will open allowing you to adjust the results before the colors are applied.|
-|{{:wiki:shape_flip_horizontal.png?​nolink|}}|Flip Model Horizontally|Flips the entire model horizontally,​ relative to the camera view (current frame only)| +
-|{{:wiki:arrow_rotate_clockwise.png?​nolink|}}|Rotate Model Horizontally|Rotates ​the entire ​model clockwise by 90 degrees (current frame only)|+
  
-The Voxel Editor'​s palette allows you to select which color to use when attaching or painting voxels. The table below describes the actions that can be performed by clicking on a color slot within the palette grid.+=====Viewport Panels===== 
 +These panels are located at the corners of the main viewport where the model itself is displayed. 
 +^Panel^Description^ 
 +|Grid Dimensions|Sets the grid dimensions (width, depth, and height in voxels) for the model. For tiles, this should match the tile size (16x16, 24x24, etc.) of any maps in which the tile will be placed.| 
 +|Movement/​Rotation Buttons|Located in the upper right corner, these buttons move and rotate either the entire model or the selection if any voxels are currently selected. Movements and rotations are relative to the camera view.| 
 +|Current View|Displays which side of the model is currently being viewed. The "​Center Current View" button ({{:​wiki:​arrow_in.png?​nolink|}}) will reset the camera to be centered on the current view. Selecting an option from the dropdown will rotate the camera to that side.| 
 +|Surface Level (Tiles Only)|Determines the vertical positioning of the tile when placed into a map. This can be used to ensure that all tiles of a set (e.g. water, shore, and any variations) will automatically have their vertical placement align correctly without needing to adjust the grid height.| 
 + 
 +=====Other Controls===== 
 +^Control/​Key^Description^ 
 +|Alt + Left Mouse Button|Pick color with eyedropper tool| 
 +|Ctrl + Left Mouse Button + Drag|Move the model (or selection if any voxels are selected) while any tool mode is active| 
 +|Hold Backtick Key (`)|Hide extras (grid, voxel outlines, surface edges, and ground)| 
 +|B|Switch to "​Box"​ mode for Attach, Paint, and Erase tools| 
 +|V|Switch to "​Voxel"​ mode for Attach, Paint, and Erase tools| 
 +|F|Switch to "​Face"​ mode for Attach, Paint, and Erase tools| 
 + 
 +The Voxel Editor'​s ​[[palette]] allows you to select which color to use when attaching or painting voxels. The table below describes the actions that can be performed by clicking on a color slot within the [[palette]] grid.
 ^Action^Description^ ^Action^Description^
-|Left Mouse Button|Selects the color to use for attaching/painting.|+|Left Mouse Button|Selects the color to use for attaching ​and painting ​voxels.|
 |Right Mouse Button|Opens the color picker to modify the color.| |Right Mouse Button|Opens the color picker to modify the color.|
 |Middle Mouse Button|Replaces the color slot with the currently selected color.| |Middle Mouse Button|Replaces the color slot with the currently selected color.|
Line 49: Line 68:
 =====Animation Toolbar===== =====Animation Toolbar=====
 ^Icon^Function^Description^Shortcut Key^ ^Icon^Function^Description^Shortcut Key^
-|{{:wiki:film.png?​nolink|}}|Frame Number|Displays the current frame number and total number of frames.| +|{{:wiki:anim_frame.png?​nolink|}}|Frame Number|Displays the current frame number and total number of frames. Clicking on the frame numbers will display a slider that can be used to quickly navigate through multiple ​frames.| 
-|{{:wiki:resultset_first.png?​nolink|}}|First Frame|Jumps to the first frame.|Ctrl + Up Arrow| +|{{:wiki:arrow_blue_first.png?​nolink|}}|First Frame|Jumps to the first frame.|Ctrl + Up Arrow| 
-|{{:wiki:blue_arrow_left.png?​nolink|}}|View Previous Frame|Moves to the previous frame.|Ctrl + Left Arrow| +|{{:wiki:arrow_blue_left.png?​nolink|}}|Previous Frame|Moves to the previous frame.|Ctrl + Left Arrow| 
-|{{:wiki:blue_arrow_right.png?​nolink|}}|View Next Frame|Moves to the next frame.|Ctrl + Right Arrow| +|{{:wiki:arrow_blue_right.png?​nolink|}}|Next Frame|Moves to the next frame.|Ctrl + Right Arrow| 
-|{{:wiki:resultset_last.png?​nolink|}}|View Last Frame|Jumps to the last frame.|Ctrl + Down Arrow| +|{{:wiki:arrow_blue_last.png?​nolink|}}|Last Frame|Jumps to the last frame.|Ctrl + Down Arrow| 
-|{{:wiki:new_resource.png?​nolink|}}|Add Blank Frame|Add a new blank frame after the current frame.|Ctrl + N| +|{{:wiki:hourglass.png?​nolink|}}|Frame Length Multipler|Defines how long the current frame will be shown when part of an animation (in number of frames).| 
-|{{:wiki:film_duplicate.png?​nolink|}}|Duplicate Frame|Creates a copy of the current frame.|Ctrl + D| +|{{:​wiki:​anim_frame_add.png?​nolink|}}|Insert New Frame|Add a new blank frame after the current frame.|Ctrl + N| 
-|{{:wiki:film_delete.png?​nolink|}}|Delete Frame|Deletes the current frame.| +|{{:wiki:anim_frame_duplicate.png?​nolink|}}|Duplicate ​Current ​Frame|Creates a copy of the current frame.|Ctrl + D| 
-|{{:wiki:film_move_left.png?​nolink|}}|Move Frame Left|Reorders the frames by moving the current animation frame to the left.|Shift + Left Arrow| +|{{:wiki:anim_frame_delete.png?​nolink|}}|Delete ​Current ​Frame|Deletes the current frame.| 
-|{{:wiki:film_move_right.png?​nolink|}}|Move Frame Right|Reorders the frames by moving the current animation frame to the right.|Shift + Right Arrow| +|{{:wiki:anim_frame_move_left.png?​nolink|}}|Move ​Current ​Frame Left|Reorders the frames by moving the current animation frame to the left.|Shift + Left Arrow| 
-|{{:wiki:control_play_blue.png?​nolink|}}|Play Animation|Plays the selected animation.|+|{{:wiki:anim_frame_move_right.png?​nolink|}}|Move ​Current ​Frame Right|Reorders the frames by moving the current animation frame to the right.|Shift + Right Arrow| 
 +|{{:wiki:play.png?​nolink|}}|Play Animation|Plays the selected animation.|
 |{{:​wiki:​add.png?​nolink|}}|Add Animation|Displays a dialog that will allow you to define a new animation for this model. These values can be adjusted afterward from the [[Model Properties]] panel.| |{{:​wiki:​add.png?​nolink|}}|Add Animation|Displays a dialog that will allow you to define a new animation for this model. These values can be adjusted afterward from the [[Model Properties]] panel.|
 |{{:​wiki:​clear.png?​nolink|}}|Remove Animation|Removes the selected animation.| |{{:​wiki:​clear.png?​nolink|}}|Remove Animation|Removes the selected animation.|
  
 ~~NOTOC~~ ~~NOTOC~~
voxel_editor.txt · Last modified: 2019/09/03 08:58 (external edit)