UO.GetTileName

Оглавление · Алфавитный указатель · World & Geometry

ClassicUO • Runtime API

Читает название graphic из записи tiledata.

Точный синтаксис

UO.GetTileName(group:Any, tileId:Any) -> String

Выберите одну из зарегистрированных форм. Параметры передаются позиционно. Any означает значение BASIC с преобразованием внутри команды; Unit — отсутствие возвращаемого значения.

Параметры

• group — 0 — таблица земли (land); 1 — таблица статических graphic. Реализация считает любое ненулевое group второй таблицей; используйте 0 или 1.
• tileId — Graphic/type записи в tiledata, обычно целое 0…65535. Это не serial предмета и не индекс статики внутри клетки.

Возвращает

String — название из игровых файлов tiledata. Пустая строка означает пустое имя или недопустимый tileId. Название берётся из ресурсов игры и не переводится автоматически на язык интерфейса IDE. Это не имя конкретного предмета от сервера.

Поведение

• Эта команда читает справочную запись graphic; координаты мира не нужны. group=0 и group=1 выбирают разные таблицы даже при одинаковом tileId.
• Свойство читается из данных graphic, а не из текущего состояния конкретного предмета.

Примеры

Пример 1. Прочитать свойство известного static graphic

# Прочитать свойство известного static graphic
#
# Читает название graphic из записи tiledata.
#
# String — название из игровых файлов tiledata. Пустая строка означает пустое имя или
# недопустимый tileId. Название берётся из ресурсов игры и не переводится автоматически на язык
# интерфейса IDE. Это не имя конкретного предмета от сервера.

SUB Main()
    # group=1 выбирает static tiledata; tileId=0x0CCA — graphic дерева.
    # value содержит результат, описанный в разделе «Возвращает»; его смысл не совпадает с serial.

    VAR value = UO.GetTileName(1, 0x0CCA)
    IF value <> '' THEN
        UO.Print(value)
    ELSE
        UO.Print('No tiledata name')
    END IF
END SUB

Разбор параметров и выполнения:

• group=1 выбирает static tiledata; tileId=0x0CCA — graphic дерева.
• value содержит результат, описанный в разделе «Возвращает»; его смысл не совпадает с serial.

Пример 2. Прочитать свойство graphic найденного предмета

# Прочитать свойство graphic найденного предмета
#
# Читает название graphic из записи tiledata.
#
# String — название из игровых файлов tiledata. Пустая строка означает пустое имя или
# недопустимый tileId. Название берётся из ресурсов игры и не переводится автоматически на язык
# интерфейса IDE. Это не имя конкретного предмета от сервера.

SUB Main()
    # FindType возвращает serial. GetType превращает его в числовой graphic.
    # group=1 используется для предметов; в tileId передаётся graphic, не item.

    VAR item = UO.FindType(0x0EED, -1, 'backpack')
    IF item <> '' THEN
        VAR graphic = UO.GetType(item)
        VAR value = UO.GetTileName(1, graphic)
        UO.Print(CStr(value))
    END IF
END SUB

Разбор параметров и выполнения:

• FindType возвращает serial. GetType превращает его в числовой graphic.
• group=1 используется для предметов; в tileId передаётся graphic, не item.

Пример 3. Прочитать свойство земли под персонажем

# Прочитать свойство земли под персонажем
#
# Читает название graphic из записи tiledata.
#
# String — название из игровых файлов tiledata. Пустая строка означает пустое имя или
# недопустимый tileId. Название берётся из ресурсов игры и не переводится автоматически на язык
# интерфейса IDE. Это не имя конкретного предмета от сервера.

SUB Main()
    # Первые два аргумента GetLandscapeTile — текущие мировые X/Y; третий — текущая карта.
    # land[0] содержит graphic земли. group=0 выбирает land tiledata. Для GetTileLayer/GetTileHeight
    # земля даёт 0.

    VAR land = UO.GetLandscapeTile(UO.GetX(), UO.GetY(), UO.WorldNum())
    IF GetArrayLength(land) >= 3 THEN
        VAR graphic = land[0]
        VAR value = UO.GetTileName(0, graphic)
        UO.Print(CStr(value))
    END IF
END SUB

Разбор параметров и выполнения:

• Первые два аргумента GetLandscapeTile — текущие мировые X/Y; третий — текущая карта.
• land[0] содержит graphic земли. group=0 выбирает land tiledata. Для GetTileLayer/GetTileHeight земля даёт 0.