Палитры рисования и аннотаций

Вопрос Изображение с оформлением рисования и аннотаций позволяет пользователям рисовать скетч в пустом окне или подписывать изображение либо снимок карты. Приложение для полевых работ ArcGIS Survey123 содержит палитру инструментов рисования по умолчанию, состоящую из восьми инструментов, включая стрелки, основные символы-маркеры и текстовые надписи. Для получения дополнительной информации о палитре по умолчанию см. раздел Режим рисования.

Помимо инструментов рисования по умолчанию вы можете создавать пользовательские палитры для настройки инструментов рисования и надписывания. Например, у коммунальных служб могут быть специальные символы и стили линий, относящиеся к электро- или газоснабжению.

Примечание:

Пользовательские палитры не поддерживаются веб-приложением ArcGIS Survey123.

Чтобы создать пользовательские проекты, выполните следующие действия:

  • Настройте среду Python в ArcGIS Survey123 Connect, чтобы можно было запускать инструменты Новый шаблон XLSPalette и Конвертировать XLSPalette.
  • Подготовьте пользовательскую палитру с помощью спецификации XLSPalette.
  • Убедитесь, что шаблон XLSPalette и все связанные с ним файлы находятся в папке медиафайлов опроса.
  • Конвертируйте XLSPalette в файл .palette, запустив инструмент Конвертировать XLSPalette на вкладке Медиа в Survey123 Connect.
  • В форме XLSForm опроса задайте в столбце body::esri:style для вопроса Изображения с рисунком или надписями используйте пользовательскую палитру вместо палитры по умолчанию, указав palette=<palette_name>.

Пользовательская палитра сначала настраивается в шаблоне XLSPalette. Шаблон XLSPalette должен быть конвертирован в файл .palette, чтобы его можно было добавить в опрос. Шаблоны XLSPalette конвертируются инструментом на вкладке Медиа в Survey123 Connect.

Подготовка пользовательской палитры

Пользовательская палитра настраивается в XLPalette, файле .xlsx, содержащем рабочие листы, которые будут преобразованы в файл .palette, который можно использовать в опросе.

Чтобы начать работу с пользовательским дизайном палитры, загрузите шаблон XLSPalette . Survey123 Connect содержит инструмент Новый шаблон XLSPalette, предназначенный для создания пустого шаблона. Чтобы запустить инструмент, настройте среду Python в Survey123 Connect. Дополнительные сведения смотрите в разделе Настройка Python.

Откройте опрос в Survey123 Connect. Чтобы создать шаблон XLSPalette, щелкните Инструменты, а затем выберите Новый шаблон XLSPalette. Файл шаблона myXLSPalette1.xlsx создан в папке для медиафайлов Либо можно загрузить копию шаблона Survey123 с ArcGIS Online.

Каждый лист в шаблоне XLSPalette - это группа инструментов: группа инструментов в пользовательской палитре. Строки каждого листа группы инструментов задают инструменты аннотаций в группе инструментов. В следующем примере показана конфигурация XLSPalette для трех инструментов аннотации проверок газопровода, содержащая два инструмента линий и инструмент маркеров:

типlabelинструментсимволtextSymbol

line

Линия газопровода (новая)

line

color=Blue&size=5&style=dash

color=MediumBlue&size=14&anchor=bottom&italic

line

Линия газопровода (существующая)

line

color=Yellow&size=5&outline.color=Black&outline.size=1

color=#FFFFE0&size=14&anchor=bottom

marker

Счетчик (новый)

meter.svg

Дополнительные сведения о синтаксисе и параметрах, которые можно использовать для разработки пользовательской палитры, см. в спецификации XLSPalette. Полный синтаксис также описывается в листе Ссылка шаблона XLSPalette.

Скопируйте шаблон XLSPalette и любые файлы изображений, которые использует палитра, например символы-маркеры SVG и значки группы инструментов, в папку медиафайлов опроса. Шаблон XLSPalette теперь должен быть конвертирован в файл .palette, чтобы его можно было добавить в опрос.

Конвертировать палитру

Чтобы запустить инструмент Конвертировать XLSPalette, настройте среду Python в Survey123 Connect. Дополнительные сведения смотрите в разделе Настройка Python.

Открыть опрос в Survey123 Connect и выберите вкладку Медиа. Во вкладке Медиа содержится содержание папки с медиафайлами опроса. Кнопка конвертации находится рядом с файлами .xlsx. Нажмите кнопку преобразования, чтобы запустить инструмент Конвертировать XLSPalette, чтобы преобразовать шаблон XLSPalette в файл .palette, который можно использовать в опросе.

Конвертация файла XLSPalette на вкладке Медиа

Когда преобразование завершится, файл .palette будет сохранен в папке медиафайлов и появится на вкладке Медиа.

Подсказка:

Имя файла .palette совпадает с именем исходного файла .xlsx. Поскольку это имя будет использоваться в качестве параметра XLSForm, убедитесь, что в нем нет пробелов.

Добавление палитры в опрос

После создания и конвертации пользовательской палитры можно добавить ее в XLSForm. Вы можете добавить в опрос столько пользовательских палитр, сколько вам необходимо. Но для каждого вопроса с рисованием и аннотацией можно применять только одну палитру.

Для вопроса Изображение с рисунком или аннотацией введите в столбец body::esri:style palette=<имя_палитры>, где <имя_палитры> — это имя файла палитры без расширения .palette, например: palette=Electrical

Пользовательская палитра теперь будет использоваться для вопроса Изображение вместо палитры по умолчанию.

Чтобы обновить пользовательскую палитру, внесите необходимые изменения в файл .xlsx и еще раз запустите инструмент Конвертировать XLSPalette на вкладке Медиа. Это заменит файл .palette в папке медиаресурсов и изменения становятся видимыми в Survey123 Connect при обновлении просмотра формы. Снова опубликуйте опрос, чтобы изучить изменения в полевом приложении Survey123.

Спецификация XLSPalette

Спецификация XLSPalette разработана специально для создания инструментов аннотаций в Survey123. Пользовательские палитры настроены в файле .xlsx с помощью синтаксиса XLSPalette. Шаблон XLSPalette состоит из следующего:

  • Один или несколько листов группы инструментов, содержащих столбцы type, tool, symbol и textSymbol. Группа инструментов - эта группа инструментов в палитре. Палитра может содержать столько групп инструментов, сколько необходимо. Имя каждого листа группы инструментов будет отображаться в полевом приложении Survey123 как имя каждой вкладки группы инструментов в пользовательской палитре.
  • Лист Ссылка, содержащий руководство по синтаксису и параметрам, которые можно использовать для разработки палитры.
  • Лист Версия, содержащий информацию о том, когда последний раз обновлялся шаблон XLSPalette.
  • Лист Списки, содержащий таблицы подстановки для проверки данных в листах групп инструментов. Не меняйте содержимое этого листа.

При необходимости вы можете добавлять и удалять рабочие листы группы инструментов. Чтобы добавить новый лист группы инструментов, создайте копию текущего листа группы инструментов, чтобы убедиться в том, что сохранены форматирование и проверка данных. Рабочие листы группы инструментов, которые не содержат никаких строк, кроме строки заголовка, игнорируются при преобразовании XLSPalette в файл .palette.

При работе со свойствами инструмента учитывайте следующее:

  • Большая часть свойств символов задаются в виде пар name=value, разделенных амперсандом.
  • Цвета могут быть заданы стандартными названиями цветов HTML или шестнадцатеричными цветовыми кодами. Для задания непрозрачности можете использовать восьмизначный шестнадцатеричный код цвета.
  • Единицами измерения ширины и размера являются пикселы.
  • Линейные символы поддерживают пользовательские штриховки.
  • Если тип инструмента - текст, необходима запись в столбце textSymbol. Для остальных типов значение textSymbol не является обязательным.

Типы и инструменты

Палитра может содержать любые комбинации типов инструментов. Поддерживаются типы линия, площадь, маркер и текст, и они должны быть введены в столбец type в каждом листе группы инструментов.

Линии, области и текст поддерживают различные инструменты, определяющие стиль прорисовки для соответствующего типа объектов. В столбце tool каждого листа группы инструментов можно задать инструмент. Вам не следует задавать инструмент для типов "маркер" и "текст".

Для получения полного списка поддерживаемых инструментов см. лист Ссылка шаблона XLSPalette.

Символы

Каждый из инструментов поддерживает ряд свойств символа, которые можно задать в столбце symbol каждого листа группы инструментов.

Для линий можно задать пользовательский шаблон штриховки, используя одну или несколько пар "пробел-черточка" в формате [n,n...], где n — относительная длина сегмента, например, [4,3,2,3].

Для символов-маркеров первым значением может быть название Простого символа-маркера Esri либо имя файла изображения с расширением. Поддерживаемые форматы изображений - SVG, PNG и JPG. Простые символы-маркеры - это круг, крест, ромб, квадрат, треугольник и x.

Для получения полного списка поддерживаемых символов и свойств см. лист Ссылка в шаблоне XLSPalette.

Текст

К каждому инструменту может быть прикреплена текстовая подпись. Вы можете также задать подпись с помощью текстового типа. Форматирование текста задано в столбце textSymbol в каждом листе группы инструмента.

Для свойства alignment можно задать несколько значений выравнивания, разделенных запятой, например, alignment=left,middle.

Свойство anchor применяется только к линейному, площадному типам и типу маркеров и определяет место позиционирования текстовой подписи относительно графического элемента.

Для получения полного списка поддерживаемых стилей и свойств см. лист Ссылка в шаблоне XLSPalette.

Значок Группа инструментов

Значки Группы инструментов отображаются в палитре с именами группы инструментов. По умолчанию если все инструменты группы используют один и тот же инструмент, автоматически задается значок, соответствующий инструменту. Чтобы задать для группы инструментов значок, добавьте к имени листа &icon= и либо имя значка из библиотеки значки Esri Calcite UI, либо файл изображения, сохраненный в папке медиафайлов. Поддерживаемые форматы изображений - SVG, PNG и JPG.

Подсказка:

Для получения наилучших результатов воспользуйтесь одним цветом с прозрачным фоном для значков группы инструментов. Значки группы инструментов отображаются в серой шкале палитры.

Длины имен листов ограничены 31 символом и могут содержать пробелы, например, New Works&icon=electric.svg.