Русский

Справочник MQL4 Общие функции ResourceReadImage

ResourceReadImage

Читает данные графического ресурса, созданного функцией ResourceCreate() или сохраненного в EX4-файле при компиляции.

bool  ResourceReadImage(
   const string      resource_name,       // имя графического ресурса для чтения
   uint&             data[],              // массив для получения данных из ресурса
   uint&             width,               // для получения ширины картинки в ресурсе
   uint&             height               // для получения высоты картинки в ресурсе
   );

Параметры

resource_name

[in]  Имя графического ресурса, содержащего изображение. Для доступа к собственным ресурсам указывается в коротком виде "::resourcename". Если же необходимо загрузить ресурс из скомпилированного EX4-файла, то необходимо имя в полном виде с указанием пути относительно папки MQL4, имени файла и имени ресурса – "path\\filename.ex4::resourcename".

data[][]

[in]  Одномерный или двумерный массив для получения данных из графического ресурса.

img_width

[out]  Ширина картинки графического ресурса в пикселях.

img_height

[out]  Высота картинки графического ресурса в пикселях.

Возвращаемое значение

true – в случае успеха, иначе false. Чтобы получить информацию об ошибке, необходимо вызвать функцию GetLastError().

Примечание

Если на основании массива data[] в дальнейшем необходимо создать графический ресурс, то следует использовать формат цвета COLOR_FORMAT_ARGB_NORMALIZE или COLOR_FORMAT_XRGB_NOALPHA.

Если массив data[] является двумерным и его вторая размерность меньше размера X(width) графического ресурса, то функция ResourceReadImage() вернет false и чтение не будет произведено. Но при этом, если ресурс существует, то в параметры width и height возвращаются актуальные размеры картинки. Это позволит сделать еще одну попытку получения данных из ресурса.

Смотри также

Ресурсы, ObjectCreate(), ObjectSetString(), OBJPROP_BMPFILE