--- title: Обзор редактора Defold brief: Данное руководство представляет собой обзор внешнего вида и принципов работы редактора Defold, а также навигации в нем. --- # Обзор редактора Defold Назначение редактора --- просмотр и эффективное управление файлами игрового проекта. При открытии файла на редактирование, запускается соответствующий редактор, при этом вся необходимая информация о файле отображается в отдельных представлениях. ## Запуск редактора При запуске редактора Defold, появляется экран выбора и создания проекта. Кликните мышью, в соответствии с желаемым действием: Home : Отображает недавно открывавшиеся проекты, предоставляя к ним быстрый доступ. Это представление открывается по умолчанию. New Project : Позволяет создать новый проект Defold. Здесь вам необходимо выбрать, хотите ли вы использовать базовый шаблон (из вкладки *From Template*), следовать учебнику (вкладка *From Tutorial*) или попробовать один из проектов-примеров (вкладка *From Sample*). ![new project](images/editor/new_project.png){srcset="images/editor/new_project@2x.png 2x"} При создании новый проект сохраняется на локальном диске, и все сделанные изменения сохраняются локально. Подробнее о различных опциях можно узнать в [руководстве по настройке проекта](https://www.defold.com/manuals/project-setup/). ## Панели редактора Редактор Defold разделен на несколько панелей, или представлений, которые отображают определенную информацию. ![Editor 2](images/editor/editor2_overview.png) Панель *Assets* : Содержит список всех файлов, являющихся частью проекта. Навигация по списку осуществляется посредством прокрутки мыши. В этом представлении могут быть выполнены любые файловые операции: - Выполните двойной клик по файлу, чтобы открыть его в редакторе, соответствующем этому типу файлов. - Перетащите и бросьте, чтобы добавить в проект файлы из других расположений на диске или переместить файлы и папки в новые расположения в пределах проекта. - Выполните клик ПКМ, чтобы открыть _контекстное меню_, с помощью которого можно создавать новые файлы или папки, переименовывать, удалять, отслеживать файловые зависимости и многое другое. Панель *Editor* : Представление по центру отображает текущий открытый файл в редакторе соответствующего типа. Все визуальные редакторы позволяют управлять видом камеры: - Панорамирование: Alt + ЛКМ. - Зумирование: Alt + ПКМ (трехкнопочная мышь) или Ctrl + Mouse button (однокнопочная мышь). Если мышь оснащена колесом прокрутки, его можно использовать для зумирования. - Вращение в 3D: Ctrl + ЛКМ. В правом верхнем углу представления сцены расположен тулбар, на котором можно найти инструменты манипулирования объектами: *Move*, *Rotate* и *Scale*. ![toolbar](images/editor/toolbar.png){srcset="images/editor/toolbar@2x.png 2x"} Панель *Outline* : Это представление отображает содержимое редактируемого в данный момент файла в виде иерархической древовидной структуры. Outline отражает представление редактора, позволяя выполнять операции с элементами: - Кликните по элементу, чтобы выделить его. Удерживайте Shift или Option, чтобы расширить выделение. - Перетащите и бросьте элемент для перемещения. Бросьте какой-либо игровой объект на другой игровой объект в коллекции, чтобы сделать его дочерним. - Кликните ПКМ чтобы открыть _контекстное меню_, с помощью которого можно добавлять, удалять выделенные элементы и т.д. Панель *Properties* : Это представление отображает свойства (такие как Position, Rotation, Animation и т.д.), ассоциированные с текущим выбранным элементом. Панель *Tools* : В этом представлении есть несколько вкладок. Вкладка *Console* отображает вывод какой-либо ошибки или целенаправленный вывод, осуществляемый вами во время выполнения игры. Рядом с консолью находятся вкладки *Build Errors*, *Search Results*, а также *Curve Editor*, используемый при редактировании кривых в редакторе частиц. Панель Tools также используется для взаимодействия со встроенным отладчиком. Панель *Changed Files* : Если проект использует распределенную систему контроля версий Git, это представление отображает список файлов проекта, которые были изменены, добавлены или удалены. Регулярно выполняя синхронизацию проекта, вы можете синхронизировать свою локальную копию с тем, что хранится в Git-репозитории проекта, что позволяет сотрудничать с командой без риска потери своей работы в случае сбоя. Подробнее о Git можно узнать в нашем [руководстве по контролю версий](/manuals/version-control/). В этом представлении можно выполнять некоторые файловые операции: - Выполните двойной клик по файлу чтобы открыть представление отличий. Defold открывает файл в подходящем редакторе, так же, как и в представлении ассетов. - Выполните клик ПКМ по файлу, чтобы открыть всплывающее меню, с помощью которого можно открыть представление отличий, отменить все изменения, сделанные в файле, найти файл в файловой системе и многое другое. ## Двухпанельное редактирование Когда открыто несколько файлов, для каждого из них в верхней части окна редактора отображается отдельная вкладка. Рядом друг с другом можно открыть 2 представления редактора. Выполните клик ПКМ по вкладке редактора, который хотите переместить, и выберите Move to Other Tab Pane. ![2 panes](images/editor/2-panes.png){srcset="images/editor/2-panes@2x.png 2x"} С помощью меню вкладок можно также поменять местами две панели или объединить их в одну. ## Редактор сцен Двойной клик по файлу коллекции или игрового объекта приводит к открытию *редактора сцены*: ![Select object](images/editor/select.png) Выделение объектов : Клик по объектам в главном окне выделяет их. Прямоугольник, окружающий объект в представлении редактора, будет подсвечен зеленым цветом, указывая на то, какой элемент выделен. Выделенный объект также подсвечивается в представлении *Outline*. Объекты можно выделять и другим способом: - Кликните и перетащите, чтобы выделить все объекты, попавшие внутрь области выделения. - Кликните по объекту в представлении Outline. Для добавления к выделению зажмите и удерживайте Shift или (Mac) / Ctrl (Win/Linux) при клике по объектам. Инструмент перемещения : ![Move tool](images/editor/icon_move.png){.left} Для перемещения объектов используется инструмент *Move*. Активировать его можно на тулбаре в правом верхнем углу редактора сцены, или нажав клавишу W. ![Move object](images/editor/move.png) На выделенном объекте отображается набор манипуляторов (квадратики и стрелки). Перетаскивание центрального маркера, в виде зеленого квадратика, приводит к свободному перемещению объекта в пространстве экрана, перетаскивание стрелок позволяет перемещать объект по осям X, Y и Z. Здесь же имеются маркеры-квадратики для перемещения объекта в плоскости X-Y, а также (видно при повороте камеры в 3D) в плоскостях X-Z и Y-Z. Инструмент вращения : ![Rotate tool](images/editor/icon_rotate.png){.left} Для вращения объектов используется инструмент *Rotate*, который можно активировать на тулбаре и нажатием клавиши E. ![Move object](images/editor/rotate.png) Данный инструмент состоит из четырех круговых манипуляторов: один оранжевый, вращающий объект в пространстве экрана, и по одному для вращения вокруг каждой из осей X, Y и Z. Поскольку вид является параллельным по отношению к осям X и Y, круги отображаются только как две прямые, пересекающие объект. Инструмент масштабирования : ![Scale tool](images/editor/icon_scale.png){.left} Для масштабирования объектов используется инструмент *Scale*, который можно активировать на тулбаре и нажатием клавиши R. ![Scale object](images/editor/scale.png) Этот инструмент состоит из набора квадратных маркеров. Из них центральный равномерно масштабирует объект по всем осям (включая Z). Также имеется по одному маркеру для масштабирования вдоль каждой из осей X, Y и Z и по одному --- для масштабирования в плоскостях X-Y, X-Z и Y-Z. ## Создание новых файлов проекта Создавать новые файлы ресурсов можно двумя способами: выполнив File ▸ New... и выбрав тип файла из меню, либо используя контекстное меню: Выполните клик ПКМ в целевом расположении в браузере *ассетов*, затем выберите New... ▸ [тип файла]: ![create file](images/editor/create_file.png){srcset="images/editor/create_file@2x.png 2x"} Введите подходящее имя для нового файла. Полное имя файла, включая суффикс типа файла, отображается в диалоге в строке *Path*: ![create file name](images/editor/create_file_name.png){srcset="images/editor/create_file_name@2x.png 2x"} ## Импортирование файлов в проект Добавление в проект файлов ассетов (изображений, звуков, моделей и т.д.) осуществляется простым перетаскиванием их в нужную позицию в браузер *ассетов*. При этом создаются _копии_ файлов в выбранном расположении файловой структуры проекта. За подробностями обращайтесь к [нашему руководству по импортированию ассетов](/manuals/importing-assets/). ![Import files](images/editor/import.png){srcset="images/editor/import@2x.png 2x"} ## Обновление редактора Редактор будет автоматически проверять наличие обновлений. При обнаружении обновление будет отображаться в правом нижнем углу окна редактора и на экране выбора проекта. При клике по ссылке Update Available будет произведена загрузка и обновление редактора. ![Update from project selection](images/editor/update-project-selection.png){srcset="images/editor/update-project-selection@2x.png 2x"} ![Update from editor](images/editor/update-main.png){srcset="images/editor/update-main@2x.png 2x"} ## Клавиатурные сокращения ### Сокращения по умолчанию | Команда | Windows | macOS | Linux | |---------|---------|-------|-------| | Add | A | A | A | | Add secondary | Shift+A | Shift+A | Shift+A | | Backwards tab trigger | Shift+Tab | Shift+Tab | Shift+Tab | | Beginning of file | Ctrl+Home | Cmd+Up | Ctrl+Home | | Beginning of line | | Ctrl+A | | | Beginning of line text | Home | Home | Home | | Build | Ctrl+B | Cmd+B | Ctrl+B | | Close | Ctrl+W | Cmd+W | Ctrl+W | | Close all | Shift+Ctrl+W | Shift+Cmd+W | Shift+Ctrl+W | | Continue | F5 | F5 | F5 | | Copy | Ctrl+C | Cmd+C | Ctrl+C | | Cut | Ctrl+X | Cmd+X | Ctrl+X | | Delete | Delete | Delete | Delete | | Delete backward | Backspace | Backspace | Backspace | | Delete line | | Ctrl+D | | | Delete next word | Ctrl+Delete | Alt+Delete | Ctrl+Delete | | Delete prev word | Ctrl+Backspace | Alt+Backspace | Ctrl+Backspace | | Delete to end of line | Shift+Ctrl+Delete | Cmd+Delete | Shift+Ctrl+Delete | | Documentation | F1 | F1 | F1 | | Down | Down | Down | Down | | End of file | Ctrl+End | Cmd+Down | Ctrl+End | | End of line | End | Ctrl+E | End | | Enter | Enter | Enter | Enter | | Erase tool | Shift+E | Shift+E | Shift+E | | Escape | Esc | Esc | Esc | | Find next | Ctrl+G | Cmd+G | Ctrl+G | | Find prev | Shift+Ctrl+G | Shift+Cmd+G | Shift+Ctrl+G | | Find text | Ctrl+F | Cmd+F | Ctrl+F | | Frame selection | F | F | F | | Goto line | Ctrl+L | Cmd+L | Ctrl+L | | Hide selected | Ctrl+E | Cmd+E | Ctrl+E | | Hot reload | Ctrl+R | Cmd+R | Ctrl+R | | Left | Left | Left | Left | | Move down | Alt+Down | Alt+Down | Alt+Down | | Move tool | W | W | W | | Move up | Alt+Up | Alt+Up | Alt+Up | | New file | Ctrl+N | Cmd+N | Ctrl+N | | Next word | Ctrl+Right | Alt+Right | Ctrl+Right | | Open | Ctrl+O | Cmd+O | Ctrl+O | | Open asset | Shift+Ctrl+R | Cmd+P | Shift+Ctrl+R | | Page down | Page Down | Page Down | Page Down | | Page up | Page Up | Page Up | Page Up | | Paste | Ctrl+V | Cmd+V | Ctrl+V | | Preferences | Ctrl+Comma | Cmd+Comma | Ctrl+Comma | | Prev word | Ctrl+Left | Alt+Left | Ctrl+Left | | Proposals | Ctrl+Space | Ctrl+Space | Ctrl+Space | | Quit | Ctrl+Q | Cmd+Q | Ctrl+Q | | Realign camera | Period | Period | Period | | Rebuild | Shift+Ctrl+B | Shift+Cmd+B | Shift+Ctrl+B | | Rebundle | Ctrl+U | Cmd+U | Ctrl+U | | Redo | Shift+Ctrl+Z | Shift+Cmd+Z | Shift+Ctrl+Z | | Reindent | Ctrl+I | Ctrl+I | Ctrl+I | | Reload stylesheet | | Ctrl+R | | | Rename | F2 | F2 | F2 | | Replace next | Shift+Ctrl+H | Alt+Cmd+G | Shift+Ctrl+H | | Replace text | | Alt+Cmd+F | | | Right | Right | Right | Right | | Rotate tool | E | E | E | | Save all | Ctrl+S | Cmd+S | Ctrl+S | | Scale tool | R | R | R | | Scene stop | Ctrl+T | Cmd+T | Ctrl+T | | Search in files | Shift+Ctrl+F | Shift+Cmd+F | Shift+Ctrl+F | | Select all | Ctrl+A | Cmd+A | Ctrl+A | | Select beginning of file | Shift+Ctrl+Home | Shift+Cmd+Up | Shift+Ctrl+Home | | Select beginning of line | | Shift+Ctrl+A | | | Select beginning of line text | Shift+Home | Shift+Home | Shift+Home | | Select down | Shift+Down | Shift+Down | Shift+Down | | Select end of file | Shift+Ctrl+End | Shift+Cmd+Down | Shift+Ctrl+End | | Select end of line | Shift+End | Shift+Alt+Down | Shift+End | | Select left | Shift+Left | Shift+Left | Shift+Left | | Select next occurrence | Ctrl+D | Cmd+D | Ctrl+D | | Select next word | Shift+Ctrl+Right | Shift+Alt+Right | Shift+Ctrl+Right | | Select page down | Shift+Page Down | Shift+Page Down | Shift+Page Down | | Select page up | Shift+Page Up | Shift+Page Up | Shift+Page Up | | Select prev word | Shift+Ctrl+Left | Shift+Ctrl+Left | Shift+Ctrl+Left | | Select right | Shift+Right | Shift+Right | Shift+Right | | Show last hidden | Shift+Ctrl+E | Shift+Cmd+E | Shift+Ctrl+E | | Show palette | Space | Space | Space | | Split selection into lines | Shift+Ctrl+L | Shift+Cmd+L | Shift+Ctrl+L | | Step into | F11 | F11 | F11 | | Step out | Shift+F11 | Shift+F11 | Shift+F11 | | Step over | F10 | F10 | F10 | | Stop debugger | Shift+F5 | | Shift+F5 | | Tab | Tab | Tab | Tab | | Toggle breakpoint | F9 | F9 | F9 | | Toggle comment | Ctrl+Slash | Cmd+Slash | Ctrl+Slash | | Toggle component guides | Ctrl+H | Ctrl+Cmd+H | Ctrl+H | | Toggle pane bottom | F7 | F7 | F7 | | Toggle pane left | F6 | F6 | F6 | | Toggle pane right | F8 | F8 | F8 | | Toggle visibility filters | Shift+Ctrl+I | Shift+Cmd+I | Shift+Ctrl+I | | Undo | Ctrl+Z | Cmd+Z | Ctrl+Z | | Up | Up | Up | Up | | Up major | Shift+Up | Shift+Up | Shift+Up | | Zoom in | Ctrl+'+' | Cmd+'+' | Ctrl+'+' | | Zoom out | Ctrl+'-' | Cmd+'-' | Ctrl+'-' | ### Кастомизация сокращений Клавиатурные сокращения можно настроить, если создать конфигурационный файл (например, `keymap.edn` в домашней директории). Затем необходимо выполнить File ▸ Preferences и в строку Path to custom keymap прописать путь к созданному файлу. Необходимо перезапустить Defold после изменения этой настройки, а также каждый раз при редактировании файла keymap. Просмотреть и скачать файлы конфигурации клавиш можно здесь: [Windows](examples/keymap_win.edn), [MacOS](examples/keymap_macos.edn), [Linux](examples/keymap_linux.edn) ## Журнал событий редактора При возникновении проблем с редактором и при необходимости [сообщить о проблеме](/manuals/getting-help/#getting-help), лучше всего предоставить лог-файлы из самого редактора. Лог-файлы редактора можно найти в следующих расположениях: * Windows: `C:\Users\ **Your Username** \AppData\Local\Defold` * macOS: `/Users/ **Your Username** /Library/Application Support/` или `~/Library/Application Support/Defold` * Linux: `~/.Defold` Получить доступ к журналу редактора можно также во время его работы, если он запущен из терминала/командной строки. Для запуска редактора из терминала на macOS: ``` $ > ./path/to/Defold.app/Contents/MacOS/Defold ``` ## FAQ :[Editor FAQ](../shared/editor-faq.md)