Сканкод · дистрибьютор в РФ и СНГМетод .bmp
| Назначение: | Выводит на экран часть изображения или всё изображение из BMP-файла. |
| Синтаксис: | lcd.bmp(offset as dword, x as word, y as word, x_offset as word, y_offset as word, maxwidth as word, maxheight as word) as ok_ng |
| Возвращает: | 0 - OK: обработано успешно. 1 - NG: неподдерживаемый или неверный формат файла. |
| См. также: | Вывод изображений |
| Параметр | Описание |
| offset | Смещение в скомпилированном двоичном файле приложения, по которому хранится BMP-файл. |
| x | Координата X левой верхней точки положения изображения на экране. Диапазон значений: от 0 до lcd.width - 1. |
| y | Координата Y левой верхней точки положения изображения на экране. Диапазон значений: от 0 до lcd.height - 1. |
| x_offset | Горизонтальное смещение в BMP-файле, задающее левый верхний угол выводимой части изображения. |
| y_offset | Вертикальное смещение в BMP-файле, задающее левый верхний угол выводимой части изображения. |
| maxwidth | Максимальная ширина выводимой части изображения. Фактическая ширина вывода определяется полной шириной изображения и заданным x_offset. |
| maxheight | Максимальная высота выводимой части изображения. Фактическая высота вывода определяется полной высотой изображения и заданным y_offset. |
Подробности
Чтобы получить offset, откройте BMP-файл методом romfile.open, затем прочитайте смещение этого файла из свойства romfile.offset (только чтение). Разумеется, BMP-файл для этого должен быть в вашем проекте (см. как добавить файл).
Обратите внимание: сейчас поддерживаются только 2-, 16- и 256-цветные режимы, и при попытке вывести BMP-файл любого другого типа lcd.bmp вернёт 1 - NG. Сжатые BMP-файлы тоже отвергаются.
Метод учитывает тип выбранного контроллера и панели (выбор делается в диалоге Customize Project, который открывается из диалога Project Settings). Он проверяет значения lcd.paneltype, lcd.bitsperpixel, lcd.redbits, lcd.greenbits и lcd.bluebits и выдаёт наилучшее возможное изображение для выбранного дисплея.
Аргументы x_offset, y_offset, maxwidth и maxheight позволяют вывести только часть BMP-изображения. Так можно прокручивать большое изображение, не помещающееся на экран. Другое применение - объединить несколько отдельных изображений в один файл и выводить нужные фрагменты. Это эффективнее, потому что romfile.open нужно выполнить всего один раз.