You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/en/manuals/editor.md
+38-23Lines changed: 38 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,28 +11,39 @@ The editor allows you to browse and manipulate all files and folders in your gam
11
11
12
12
When you run the Defold Editor, you are presented with a project selection and creation screen. Click to select what you want to do:
13
13
14
-
#### MY PROJECTS
15
-
Click to show your recently opened projects so you can quickly access them. This is the default view.
14
+
MY PROJECTS
15
+
: Here are your recently opened projects so you can quickly access them. This is the default view of the starting screen.
16
16
17
-
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:
17
+
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`.
: Contains empty or almost empty basic projects made for quick start of a new Defold project for certain platforms or using certain extensions.
28
+
29
+
TUTORIALS
30
+
: Contains projects with guided tutorials to learn, play and modify, if you would like to follow a tutorial.
31
+
32
+
SAMPLES
33
+
: Contains projects prepared to showcase certain use cases.
34
+
35
+

31
36
32
37
When you create a new project it is stored on your local drive and any edits you do are saved locally.
33
38
34
39
You can learn more about the different options in the [Project Setup manual](https://www.defold.com/manuals/project-setup/).
35
40
41
+
## Editor Language
42
+
43
+
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`.
44
+
45
+

46
+
36
47
## The Editor panes
37
48
38
49
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
135
146
- Click `Close` (<<kbd>Ctrl</kbd>/<kbd>⌘ Cmd</kbd> + <kbd>W</kbd>) a single tab,
136
147
- Click `Close Others` to close all tabs except the selected one,
137
148
- Click `Close All` (<kbd>Ctrl</kbd>/<kbd>⌘ Cmd</kbd> + <kbd>Shift</kbd>+<kbd>W</kbd>) to close all tabs in the active pane,
138
-
- 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).
149
+
- 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).
@@ -159,7 +170,7 @@ If you are working with a 3D project it is worth to check the Toolbar and adjust
159
170
160
171

161
172
162
-
### Selecting objects
173
+
### Manipulating objects
163
174
164
175
<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.
165
176
@@ -168,9 +179,10 @@ If you are working with a 3D project it is worth to check the Toolbar and adjust
168
179
- <kbd>Left Mouse Click</kbd> and <kbd>Drag</kbd> to select all objects inside the selection region.
169
180
- <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.
170
181
171
-
### Move tool <kbd>W</kbd>
182
+
####Move tool
172
183
173
184
{.left}
185
+
174
186
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.
@@ -181,9 +193,10 @@ The gizmo changes and shows a set of manipulators - squares and arrows (selected
181
193
- 3 red, green and blue arrows along each axis to move the object only along the given X, Y or Z axis.
182
194
- 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.
@@ -194,9 +207,10 @@ This tool consists of four circular manipulators (selected manipulator will turn
194
207
- 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.
@@ -217,9 +231,9 @@ Click on the Visibility Eye Icon (`👁`) in the Toolbar to toggle visibility of
217
231
218
232
## Creating new project files
219
233
220
-
To create new resource files, either select `File ▸ New...` and then choose the file type from the menu, or use the context menu:
234
+
To create new resource files, either select `File ▸ New…` and then choose the file type from the menu, or use the context menu:
221
235
222
-
<kbd>Right Mouse Click</kbd> the target location in the `Assets` browser, then select `New... ▸ [file type]`:
236
+
<kbd>Right Mouse Click</kbd> the target location in the `Assets` browser, then select `New… ▸ [file type]`:
223
237
224
238

225
239
@@ -247,7 +261,8 @@ To add asset files (images, sounds, models etc) to your project, simply drag and
247
261
248
262
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.
249
263
250
-

264
+

265
+

251
266
252
267
Press the `Update Available` clickable link to download and update. A confirmation window with information will pop up - click `Download Update` to proceed.
253
268
@@ -263,13 +278,13 @@ After update is downloaded the blue link will change to `Restart to Update`. Cli
263
278
264
279
## Preferences
265
280
266
-
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>
281
+
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>
267
282
268
283
Read more details in the [Preferences manual](/manuals/editor-preferences)
269
284
270
285

271
286
272
-
## Editor logs
287
+
## Editor Logs
273
288
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`.
274
289
275
290
Read more in [Getting Help manual](/manuals/getting-help/#getting-help).
0 commit comments