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 revisionPrevious revision
Next revision
Previous revision
voxel_editor [2017/06/21 14:58] justinvoxel_editor [2024/01/04 22:09] (current) justin
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:ambient_occlusion_voxel.png?nolink|}}|Display Ambient Occlusion|Enables/disables display of ambient occlusion in the editor.| 
 +|{{: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 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|
  
 =====Editor Tools===== =====Editor Tools=====
 +^Icon^Function^Description^Shortcut Key^
 +|{{: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: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 by the voxel cursor. In "Box" mode, you can click and drag to remove a 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: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_out.png?nolink|}}|Move Voxels|Mode for moving voxels along one axis. The 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: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. Holding Shift while selecting will add voxels to the current selection. Holding Shift + Alt while selecting will remove voxels from the current selection. Holding Alt while selecting will add all voxels of the selected color to the current selection.|F6|
 +|{{: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:link.png?nolink|}}|Create Attach Point|Mode for adding attach points to the model. Left-clicking a voxel will create an attach point at that voxel's coordinate. See [[Attach Points]] for more information.|F8|
 +|{{:wiki:arrow_rotate_clockwise.png?nolink|}}|Rotate Model Clockwise|Rotates the entire model clockwise by 90 degrees (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: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.|
 +
 +=====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. See [[Surface Level]] for more information.|
 +
 +=====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|
 +|G|Add selected voxels to a group|
 +
 +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^
 +|Left Mouse Button|Selects the color to use for attaching and painting voxels.|
 +|Right Mouse Button|Opens the color picker to modify the color.|
 +|Middle Mouse Button|Replaces the color slot with the currently selected color.|
  
 =====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.1498082299.txt.gz · Last modified: 2017/06/21 14:58 by justin