лекции / Shchupak_Yu._Win32_API_Razrabotka_prilozheniy_dlya_Windows

Параметр iStretchMode может принимать одно из значений, указанных в табл. 3.7.

Таблица 3.7. Режимы масштабирования растра

Продолжим рассмотрение параметров функции StretchDIBits.

Параметр lpBits задает адрес массива пикселов. Обратите внимание на то, что он определен как адрес одномерного массива.

Параметру lpBitsInfo передается адрес заголовка информационного блока. Здесь он имеет тип указателя на структуру BITMAPINFO, которая определена в Win32 GDI следующим образом:

typedef struct tagBITMAPINFO { BITMAPINFOHEADER bmiHeader; RGBQUAD bmiColors[1];

} BITMAPINFO;

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

Параметр iUsage определяет интерпретацию цветовой таблицы и обычно прини мает значение DIB_RGB_COLORS, когда таблица содержит RGB составляющие цветов, либо DIB_PAL_COLORS, когда в таблице хранятся индексы логической палитры.

Последний параметр, dwRop, содержит код тернарной растровой операции. Эти операции будут рассматриваться позже, а пока мы будем использовать простей шую растровую операцию SRCCOPY, которая просто копирует пикселы источника в приемник.

Есть и еще одна функция для вывода аппаратно независимых растров — SetDIBitsToDevice. Она обеспечивает вывод DIB растра полностью или частично, с сохранением исходной ориентации и масштаба. Можно было бы сказать, что возможности рассмотренной выше функции StretchDIBits полностью перекрыва ют возможности SetDIBitsToDevice. Однако интерфейс последней функции позво ляет копировать исходный растр частями, строка за строкой, что позволяет зна чительно экономить оперативную память, если это необходимо. Правила использования этой функции приведены в MSDN.

Примеры работы с растром DIB

В этом разделе приводятся два приложения, демонстрирующие технику работы с аппаратно независимыми растрами. В первом приложении растр формируется программно, после чего сохраняется в BMP файле. Во втором приложении растр загружается из BMP файла, а затем воспроизводится в окне программы.

Подробности работы с DIB инкапсулированы в класс C++, который мы назвали KDib. Этот класс предназначен для работы только с несжатыми растрами.

В него включен тот минимум средств, которого хватает для решения рассматрива емых двух задач. Конечно, при желании можно легко расширить класс KDib, доба вив поля и методы, необходимые для решения других подзадач.

ГенераторBMP-растрадляANSI-символа

Программа, приведенная в листинге 3.5, осуществляет генерацию битового образа ANSI символа, заданного десятичным кодом, после чего сохраняет сгенерирован ный образ символа в BMP файле. Битовый образ ANSI символа формируется в формате True Color с кодировкой 24 бит/пиксел. Цветовая таблица в растре отсут ствует.

В программе используется шрифт, содержащийся в контексте устройства по умолчанию, то есть SYSTEM_FONT. Конечно, в будущем вы можете усложнить код программы, чтобы обеспечить выбор любого шрифта и любого размера сим волов, а также формировать не отдельный символ, а полный набор из 256 симво лов1.

Код класса KDib, как обычно, размещается в двух файлах. Интерфейс содержит ся в файле KDib.h, а его реализация — в файле KDib.cpp.

Листинг 3.5. Проект CreateCharBmp

//////////////////////////////////////////////////////////////////////

// KDib.h

#include <windows.h> #include <fstream> #include <string> using namespace std;

class KDib { public:

KDib();

~KDib();

BOOL CreateDib24(int w, int h, const char* fileName); void StoreDib24();

BOOL LoadFromFile(const char* fileName); void SetPixel(int x, int y, COLORREF color);

int Draw(HDC hdc, int xDst, int yDst, int wDst, int hDst, int xSrc, int ySrc, int wSrc, int hSrc, DWORD rop);

int GetWidth() { return width; } int GetHeight() { return height; }

const char* GetError() { return error.c_str(); }

1Для создания более продвинутой программы желательно сначала ознакомиться с главами, посвя щенными работе с меню и диалоговыми окнами.

int imageSize; string error;

ifstream inpFile; ofstream outFile;

};

//////////////////////////////////////////////////////////////////////

// KDib.cpp #include "KDib.h"

KDib::KDib() {

fileHeadSize = sizeof(BITMAPFILEHEADER); fileHead.bfType = 0x4d42;

aBitmapBits = NULL;

}

//==================================================================== KDib::~KDib() {

BOOL KDib::CreateDib24(int w, int h, const char* fileName) { width = w;

height = h;

bytesPerLine = ((width * 24 + 31) / 32) * 4; imageSize = bytesPerLine * height;

infoHeadSize = sizeof(BITMAPINFOHEADER);

fileHead.bfSize = fileHeadSize + infoHeadSize + bytesPerLine * height; fileHead.bfOffBits = fileHeadSize + infoHeadSize;

infoHead.biSize = infoHeadSize; infoHead.biWidth = width; infoHead.biHeight = height; infoHead.biPlanes = 1; infoHead.biBitCount = 24; infoHead.biCompression = BI_RGB; infoHead.biSizeImage = imageSize;

aBitmapBits = new BYTE[imageSize]; memset(aBitmapBits, 0, imageSize);

outFile.open(fileName, ios::out | ios::binary | ios::trunc); if (!outFile) return FALSE;

else return TRUE;

}

//==================================================================== BOOL KDib::LoadFromFile(const char* fileName) {

inpFile.open(fileName, ios::in | ios::binary); if (!inpFile) {

error = "Неверное имя файла или каталога."; return FALSE;

}

inpFile.read((char*)&fileHead, fileHeadSize); if (fileHead.bfType != 0x4d42) {

error = "Ýòî íå BMP-ôàéë";

продолжение

Листинг 3.5 (продолжение)

return FALSE;

}

infoHeadSize = fileHead.bfOffBits - fileHeadSize; int fileSize = fileHead.bfSize;

imageSize = fileSize - (fileHeadSize + infoHeadSize);

pInfoHead = (BITMAPINFOHEADER*)(new BYTE [infoHeadSize]); inpFile.read((char*)pInfoHead, infoHeadSize);

width = pInfoHead->biWidth; height = pInfoHead->biHeight;

aBitmapBits = new BYTE[imageSize]; inpFile.read((char*)aBitmapBits, imageSize); return true;

}

//==================================================================== int KDib::Draw(HDC hdc, int xDst, int yDst, int wDst, int hDst,

int xSrc, int ySrc, int wSrc, int hSrc, DWORD rop) {

return StretchDIBits(hdc, xDst, yDst, wDst, hDst, xSrc, ySrc, wSrc, hSrc, aBitmapBits, (CONST BITMAPINFO*)pInfoHead, DIB_RGB_COLORS, rop);

}

//==================================================================== void KDib::SetPixel(int x, int y, COLORREF color) {

}

//==================================================================== void KDib::StoreDib24() {

//Запись заголовка BMP-файла outFile.write((char*)&fileHead, fileHeadSize); outFile.write((char*)&infoHead, infoHeadSize);

//Запись массива пикселов outFile.write((char*)aBitmapBits, imageSize);

}

//////////////////////////////////////////////////////////////////////

// CreateCharBmp.cpp #include <windows.h> #include "KWnd.h"

#include "KDib.h"

#define ANSI_CODE 65

#define FILE_NAME "symbol.bmp"

KDib bmp;

LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM); //==================================================================== int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,

LPSTR lpCmdLine, int nCmdShow)

{

MSG msg;

while (GetMessage(&msg, NULL, 0, 0)) { TranslateMessage(&msg); DispatchMessage(&msg);

}

return msg.wParam;

}

//==================================================================== LRESULT CALLBACK WndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)

{

HDC hDC; PAINTSTRUCT ps; TEXTMETRIC tm; SIZE sz;

static int width, height; COLORREF color;

int x, y;

BOOL isFileCreated; static char line[2];

switch (uMsg)

{

case WM_CREATE:

hDC = GetDC(hWnd); GetTextMetrics(hDC, &tm); line[0] = ANSI_CODE; line[1] = 0;

GetTextExtentPoint32(hDC, line, 1, &sz); width = sz.cx;

height = tm.tmHeight;

isFileCreated = bmp.CreateDib24(width, height, FILE_NAME); if (!isFileCreated)

MessageBox(hWnd, "Файл " FILE_NAME " не создан.", "Error", MB_OK);

ReleaseDC(hWnd, hDC); break;

case WM_PAINT:

hDC = BeginPaint(hWnd, &ps); SetBkColor(hDC, RGB(0,0,0)); SetTextColor(hDC, RGB(255,255,255)); TextOut(hDC, 0, 0, line, 1);

//Сканирование изображения символа (от последней строки к первой)

//Запись в массив пикселов DIB

for (y = 0; y < height; ++y) { for (x = 0; x < width; ++x) {

color = GetPixel(hDC, x, height-1-y); bmp.SetPixel(x, y, color);

}

}

bmp.StoreDib24();

EndPaint(hWnd, &ps);

продолжение

Листинг 3.5 (продолжение)

break;

case WM_DESTROY: PostQuitMessage(0); break;

default:

return DefWindowProc(hWnd, uMsg, wParam, lParam);

}

return 0;

}

//////////////////////////////////////////////////////////////////////

Конечно, требуется сделать несколько пояснений по интерфейсу и реализа ции класса KDib. Мы надеемся, что большая часть кода понятна благодаря тому, что вы внимательно прочли теоретический материал по DIB.

Такие поля класса, как width, height, bytesPerLine, fileHead, infoHeadи aBitmapBits, не требуют особых комментариев. Но для чего нужен указатель на BITMAPINFOHEADER, который хранится в поле pInfoHead? Чуть позже, рассматривая метод LoadFromFile, мы увидим, что это поле используется для хранения адреса блока памяти, выделя емого из кучи при помощи оператора new. Выделенный блок памяти предназначен для заголовка информационного блока и всего того, что может следовать за ним, напри мер цветовых масок и/или цветовой таблицы. Дело в том, что формат загружаемого файла может быть любым, и поэтому заранее неизвестно, сколько памяти потребует ся для указанных компонентов.

Кроме традиционных для класса методов, таких как конструктор и деструк тор, класс KDib содержит методы, перечисленные в следующем списке:

Метод CreateDib24 создает в памяти 24 разрядный растр с заданными шириной

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

Метод SetPixel осуществляет прямой доступ к пикселам в 24 разрядном растре. Цветовая информация для синей, зеленой и красной составляющих цвета пик села записывается в соответствующие элементы массива aBitmapBits. Адреса эле ментов вычисляются через номер строки развертки y и номер пиксела в строке x.

Метод StoreDib24 сохраняет созданный растр, записывая его на диск в формате BMP.

Метод LoadFromFile загружает BMP файл с заданным именем, считывая его с диска в оперативную память. В процессе загрузки сначала читается заголовок растрового файла, затем вычисляются размер заголовка информационного бло ка в совокупности с цветовой таблицей, который указывается в поле infoHeadSize. Помимо этого в поле imageSize указывается вычисленный размер изображения в байтах. Полученные величины используются для указания размеров динами чески выделяемой памяти под заголовок информационного блока pInfoHead

ипод массив пикселов aBitmapBits. После выделения указанной памяти соответ ствующие компоненты растра читаются из файла.

Метод Draw выводит растр на поверхность графического устройства, используя функцию StretchDIBits.

ПросмотрщикBMP-файла

Программа, приведенная в листинге 3.6, является примитивным просмотрщиком BMP файлов. Спектр ее возможностей действительно не слишком велик. Она может воспроизводить только несжатые файлы. Это раз. У ее окна нет полос про крутки, и поэтому приложение может показывать только те файлы, которые по мещаются на экране дисплея. Это два. И наконец, имя файла задается при помо щи макроса в тексте программы, что говорит о сугубо учебном характере этого проекта.

Впрограмме используется тот же класс KDib, с которым вы познакомились

впредыдущем приложении. Естественно, код этого класса не будет приводиться повторно. Для сборки приложения вам просто нужно взять файлы KDib.h и KDib.cpp из предыдущего проекта и подключить их к данному проекту.

Листинг 3.6. Проект BmpFileViewer

//////////////////////////////////////////////////////////////////////

// BmpFileViewer.cpp #include <windows.h> #include "KWnd.h"

#include "KDib.h"

#define FILE_NAME "YoungHacker.bmp"

KDib bmp;

LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM); //==================================================================== int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,

LPSTR lpCmdLine, int nCmdShow)

{

MSG msg;

KWnd mainWnd("BmpFileViewer", hInstance, nCmdShow, WndProc);

while (GetMessage(&msg, NULL, 0, 0)) { TranslateMessage(&msg); DispatchMessage(&msg);

}

return msg.wParam;

}

//==================================================================== LRESULT CALLBACK WndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)

{

HDC hDC; PAINTSTRUCT ps; RECT rect;

int dX, dY;

int ws, hs, wd, hd; static BOOL isFileLoaded;

switch (uMsg)

{

case WM_CREATE:

hDC = GetDC(hWnd);

isFileLoaded = bmp.LoadFromFile(FILE_NAME);