|
@@ -11,28 +11,39 @@ The editor allows you to browse and manipulate all files and folders in your gam
|
|
|
|
|
|
|
|
When you run the Defold Editor, you are presented with a project selection and creation screen. Click to select what you want to do:
|
|
When you run the Defold Editor, you are presented with a project selection and creation screen. Click to select what you want to do:
|
|
|
|
|
|
|
|
-#### MY PROJECTS
|
|
|
|
|
-Click to show your recently opened projects so you can quickly access them. This is the default view.
|
|
|
|
|
|
|
+MY PROJECTS
|
|
|
|
|
+: Here are your recently opened projects so you can quickly access them. This is the default view of the starting screen.
|
|
|
|
|
|
|
|
-If you didn't open any projects earlier, it will show a view like on the left - you can click `Open From Disk…` to open one using system file browser or click `Create New Project` button and it will switch to a tab `TEMPLATES`, otherwise it will show a list of your projects, like on the right on the below picture:
|
|
|
|
|
|
|
+ If you didn't open any projects earlier (or removed all), it will show two buttons - you can click `Open From Disk…` to find and open one using system file browser or click `Create New Project` button and it will switch to a tab `TEMPLATES`.
|
|
|
|
|
|
|
|
- 
|
|
|
|
|
|
|
+ 
|
|
|
|
|
|
|
|
-#### TEMPLATES
|
|
|
|
|
-Contains empty or almost empty basic projects made for quick start of a new Defold project for certain platforms or using certain extensions.
|
|
|
|
|
|
|
|
|
|
-#### TUTORIALS
|
|
|
|
|
-Contains projects with guided tutorials to learn, play and modify, if you would like to follow a tutorial.
|
|
|
|
|
|
|
+ If you have earlier opened projects, it will show a list of your projects, like on the picture below:
|
|
|
|
|
|
|
|
-#### SAMPLES
|
|
|
|
|
-Contains projects prepared to showcase certain use cases.
|
|
|
|
|
|
|
+ 
|
|
|
|
|
|
|
|
- 
|
|
|
|
|
|
|
+TEMPLATES
|
|
|
|
|
+: Contains empty or almost empty basic projects made for quick start of a new Defold project for certain platforms or using certain extensions.
|
|
|
|
|
+
|
|
|
|
|
+TUTORIALS
|
|
|
|
|
+: Contains projects with guided tutorials to learn, play and modify, if you would like to follow a tutorial.
|
|
|
|
|
+
|
|
|
|
|
+SAMPLES
|
|
|
|
|
+: Contains projects prepared to showcase certain use cases.
|
|
|
|
|
+
|
|
|
|
|
+ 
|
|
|
|
|
|
|
|
When you create a new project it is stored on your local drive and any edits you do are saved locally.
|
|
When you create a new project it is stored on your local drive and any edits you do are saved locally.
|
|
|
|
|
|
|
|
You can learn more about the different options in the [Project Setup manual](https://www.defold.com/manuals/project-setup/).
|
|
You can learn more about the different options in the [Project Setup manual](https://www.defold.com/manuals/project-setup/).
|
|
|
|
|
|
|
|
|
|
+## Editor Language
|
|
|
|
|
+
|
|
|
|
|
+In the bottom left corner of the starting screen you can see a Language selection - select from the available currently localizations (since Defold 1.11.2). This is also available in the Editor in `File ▸ Preferences ▸ General ▸ Editor Language`.
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
## The Editor panes
|
|
## The Editor panes
|
|
|
|
|
|
|
|
The Defold Editor is separated into a set of panes, or views, that display specific information.
|
|
The Defold Editor is separated into a set of panes, or views, that display specific information.
|
|
@@ -135,9 +146,9 @@ If you have multiple files open, a separate tab for each file is shown at the to
|
|
|
- Click `Close` (<<kbd>Ctrl</kbd>/<kbd>⌘ Cmd</kbd> + <kbd>W</kbd>) a single tab,
|
|
- Click `Close` (<<kbd>Ctrl</kbd>/<kbd>⌘ Cmd</kbd> + <kbd>W</kbd>) a single tab,
|
|
|
- Click `Close Others` to close all tabs except the selected one,
|
|
- Click `Close Others` to close all tabs except the selected one,
|
|
|
- Click `Close All` (<kbd>Ctrl</kbd>/<kbd>⌘ Cmd</kbd> + <kbd>Shift</kbd>+<kbd>W</kbd>) to close all tabs in the active pane,
|
|
- Click `Close All` (<kbd>Ctrl</kbd>/<kbd>⌘ Cmd</kbd> + <kbd>Shift</kbd>+<kbd>W</kbd>) to close all tabs in the active pane,
|
|
|
-- Select `➝| Open As` - to use other than default editor or associated external tool set in `Preferences ▸ Code ▸ Custom Editor`. Check more in [Preferences manual](/manuals/editor-preferences).
|
|
|
|
|
|
|
+- Select `➝| Open As` - to use other than default editor or associated external tool set in `File ▸ Preferences ▸ Code ▸ Custom Editor`. Check more in [Preferences manual](/manuals/editor-preferences).
|
|
|
|
|
|
|
|
-{.inline} {.inline}
|
|
|
|
|
|
|
+
|
|
|
|
|
|
|
|
## Side-by-side editing
|
|
## Side-by-side editing
|
|
|
|
|
|
|
@@ -159,7 +170,7 @@ If you are working with a 3D project it is worth to check the Toolbar and adjust
|
|
|
|
|
|
|
|

|
|

|
|
|
|
|
|
|
|
-### Selecting objects
|
|
|
|
|
|
|
+### Manipulating objects
|
|
|
|
|
|
|
|
<kbd>Left Mouse Click</kbd> on objects in the main window to select them. The rectangle (or cuboid) surrounding the object in the editor view will highlight with cyan to indicate what item is selected. The selected object is also highlighted in the `Outline` view as in the picture above.
|
|
<kbd>Left Mouse Click</kbd> on objects in the main window to select them. The rectangle (or cuboid) surrounding the object in the editor view will highlight with cyan to indicate what item is selected. The selected object is also highlighted in the `Outline` view as in the picture above.
|
|
|
|
|
|
|
@@ -168,9 +179,10 @@ If you are working with a 3D project it is worth to check the Toolbar and adjust
|
|
|
- <kbd>Left Mouse Click</kbd> and <kbd>Drag</kbd> to select all objects inside the selection region.
|
|
- <kbd>Left Mouse Click</kbd> and <kbd>Drag</kbd> to select all objects inside the selection region.
|
|
|
- <kbd>Left Mouse Click</kbd> objects in the `Outline`, and while holding <kbd>⇧ Shift</kbd> you can expand selection or while holding <kbd>Ctrl</kbd>/<kbd>⌘ Cmd</kbd> you can (un)select clicked.
|
|
- <kbd>Left Mouse Click</kbd> objects in the `Outline`, and while holding <kbd>⇧ Shift</kbd> you can expand selection or while holding <kbd>Ctrl</kbd>/<kbd>⌘ Cmd</kbd> you can (un)select clicked.
|
|
|
|
|
|
|
|
-### Move tool <kbd>W</kbd>
|
|
|
|
|
|
|
+#### Move tool
|
|
|
|
|
|
|
|
{.left}
|
|
{.left}
|
|
|
|
|
+
|
|
|
To move objects, use the *Move Tool*. You can find it in the Toolbar in the top right corner of the scene editor, or by pressing the <kbd>W</kbd> key.
|
|
To move objects, use the *Move Tool*. You can find it in the Toolbar in the top right corner of the scene editor, or by pressing the <kbd>W</kbd> key.
|
|
|
|
|
|
|
|
{.inline}{.inline}
|
|
{.inline}{.inline}
|
|
@@ -181,9 +193,10 @@ The gizmo changes and shows a set of manipulators - squares and arrows (selected
|
|
|
- 3 red, green and blue arrows along each axis to move the object only along the given X, Y or Z axis.
|
|
- 3 red, green and blue arrows along each axis to move the object only along the given X, Y or Z axis.
|
|
|
- 3 red, green and blue square handles to move the object only on the given plane, e.g. X-Y (blue) and (visible if rotating the camera in 3D) X-Z (green) and Y-Z (red) planes.
|
|
- 3 red, green and blue square handles to move the object only on the given plane, e.g. X-Y (blue) and (visible if rotating the camera in 3D) X-Z (green) and Y-Z (red) planes.
|
|
|
|
|
|
|
|
-### Rotate tool <kbd>E</kbd>
|
|
|
|
|
|
|
+#### Rotate tool
|
|
|
|
|
+
|
|
|
|
|
+{.left}
|
|
|
|
|
|
|
|
- :
|
|
|
|
|
To rotate objects, use the *Rotate Tool* by selecting it in the Toolbar, or by pressing the <kbd>E</kbd> key.
|
|
To rotate objects, use the *Rotate Tool* by selecting it in the Toolbar, or by pressing the <kbd>E</kbd> key.
|
|
|
|
|
|
|
|
{.inline}{.inline}
|
|
{.inline}{.inline}
|
|
@@ -194,9 +207,10 @@ This tool consists of four circular manipulators (selected manipulator will turn
|
|
|
- 3 smaller red, green and blue circle manipulators allowing rotation around each of the X, Y and Z axes separately. For 2D orthographic view, the 2 of them are perpendicular to the X- and Y-axis, so the circles only appear as two lines crossing the object.
|
|
- 3 smaller red, green and blue circle manipulators allowing rotation around each of the X, Y and Z axes separately. For 2D orthographic view, the 2 of them are perpendicular to the X- and Y-axis, so the circles only appear as two lines crossing the object.
|
|
|
|
|
|
|
|
|
|
|
|
|
-### Scale tool <kbd>R</kbd>
|
|
|
|
|
|
|
+#### Scale tool
|
|
|
|
|
|
|
|
{.left}
|
|
{.left}
|
|
|
|
|
+
|
|
|
To scale objects, use the *Scale Tool* by selecting it in the toolbar, or by pressing the <kbd>R</kbd> key.
|
|
To scale objects, use the *Scale Tool* by selecting it in the toolbar, or by pressing the <kbd>R</kbd> key.
|
|
|
|
|
|
|
|
{.inline}{.inline}
|
|
{.inline}{.inline}
|
|
@@ -217,9 +231,9 @@ Click on the Visibility Eye Icon (`👁`) in the Toolbar to toggle visibility of
|
|
|
|
|
|
|
|
## Creating new project files
|
|
## Creating new project files
|
|
|
|
|
|
|
|
-To create new resource files, either select `File ▸ New...` and then choose the file type from the menu, or use the context menu:
|
|
|
|
|
|
|
+To create new resource files, either select `File ▸ New…` and then choose the file type from the menu, or use the context menu:
|
|
|
|
|
|
|
|
-<kbd>Right Mouse Click</kbd> the target location in the `Assets` browser, then select `New... ▸ [file type]`:
|
|
|
|
|
|
|
+<kbd>Right Mouse Click</kbd> the target location in the `Assets` browser, then select `New… ▸ [file type]`:
|
|
|
|
|
|
|
|

|
|

|
|
|
|
|
|
|
@@ -247,7 +261,8 @@ To add asset files (images, sounds, models etc) to your project, simply drag and
|
|
|
|
|
|
|
|
The Editor will automatically check for updates when connected to internet. When an update is detected a blue clickable link `Update Available` will be shown in the lower left corner of the project selection screen or in the lower right corner of the Editor window.
|
|
The Editor will automatically check for updates when connected to internet. When an update is detected a blue clickable link `Update Available` will be shown in the lower left corner of the project selection screen or in the lower right corner of the Editor window.
|
|
|
|
|
|
|
|
-
|
|
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
|
|
|
Press the `Update Available` clickable link to download and update. A confirmation window with information will pop up - click `Download Update` to proceed.
|
|
Press the `Update Available` clickable link to download and update. A confirmation window with information will pop up - click `Download Update` to proceed.
|
|
|
|
|
|
|
@@ -263,13 +278,13 @@ After update is downloaded the blue link will change to `Restart to Update`. Cli
|
|
|
|
|
|
|
|
## Preferences
|
|
## Preferences
|
|
|
|
|
|
|
|
-You can modify the settings of the Editor in the `Preferences` window. To open it click `File ▸ Preferences...` or shortcut <kbd>Ctrl</kbd>/<kbd>⌘ Cmd</kbd> + <kbd>,</kbd>
|
|
|
|
|
|
|
+You can modify the settings of the Editor in the `Preferences` window. To open it click `File ▸ Preferences…` or shortcut <kbd>Ctrl</kbd>/<kbd>⌘ Cmd</kbd> + <kbd>,</kbd>
|
|
|
|
|
|
|
|
Read more details in the [Preferences manual](/manuals/editor-preferences)
|
|
Read more details in the [Preferences manual](/manuals/editor-preferences)
|
|
|
|
|
|
|
|

|
|

|
|
|
|
|
|
|
|
-## Editor logs
|
|
|
|
|
|
|
+## Editor Logs
|
|
|
If you run into a problem with the Editor and need to report issue (`Help ▸ Report Issue`) it is a good idea to provide log files from the editor itself. To open location of the logs in your system browser click on `Help ▸ Show Logs`.
|
|
If you run into a problem with the Editor and need to report issue (`Help ▸ Report Issue`) it is a good idea to provide log files from the editor itself. To open location of the logs in your system browser click on `Help ▸ Show Logs`.
|
|
|
|
|
|
|
|
Read more in [Getting Help manual](/manuals/getting-help/#getting-help).
|
|
Read more in [Getting Help manual](/manuals/getting-help/#getting-help).
|