Класс CImage

Статья
02/20/2013

CImage обеспечивает поддержку растрового изображения, включая возможность загрузки и сохранения изображений в BMP, JPEG, GIF и PNG (PNG форматах).

Важно
Этот класс и его члены нельзя использовать в приложениях, выполняемых в этой среде выполнения Windows.

class CImage

Члены

Открытые конструкторы

Имя	Описание
CImage::CImage	Конструктор.

Открытые методы

Имя	Описание
CImage::AlphaBlend	Указывает растровые изображения, имеющих прозрачные и полупрозрачных точки.
CImage::Attach	Вложение HBITMAP к объекту CImage.Может использоваться с растровыми изображениями растровых изображений раздела non-DIB или раздела DIB.
CImage::BitBlt	Копирует растровое изображение из контекста устройства источника к этому текущий контекст устройства.
CImage::Create	Создает растровое изображение раздела DIB и вложение его на ранее созданный объект CImage.
CImage::CreateEx	Создает растровое изображение раздела DIB (с дополнительными параметрами) и привязывает его на ранее созданный объект CImage.
CImage::Destroy	Наконец удаляет растровое изображение из объекта CImage и уничтожает растровое изображение.
CImage::Detach	Наконец удаляет растровое изображение из объекта CImage.
CImage::Draw	Копирует растровое изображение из прямоугольника источника в прямоугольник назначения.Ничья растянет или сжимает растровое изображение для приспособления измерений прямоугольника назначения, если необходимый и обрабатывает альфа-смешения и прозрачного цвета.
CImage::GetBits	Извлекает указатель на фактические значения пикселей растрового изображения.
CImage::GetBPP	Извлекает бит на точку.
CImage::GetColorTable	Извлекает красного, зеленого и синего (RGB) из диапазона записей таблицы цветов.
CImage::GetDC	Получает контекст устройства, в котором текущее растровое изображение выделен.
CImage::GetExporterFilterString	Находит доступные форматы изображения и их описания.
CImage::GetHeight	Получает высоту текущего изображения в пикселях.
CImage::GetImporterFilterString	Находит доступные форматы изображения и их описания.
CImage::GetMaxColorTableEntries	Получает максимальное количество записей в таблице цвета.
CImage::GetPitch	Получает шаг шрифта текущего изображения в байтах.
CImage::GetPixel	Получает цвет пикселя заданного x и Y.
CImage::GetPixelAddress	Получает адрес заданного в пикселях.
CImage::GetTransparentColor	Получает положение прозрачного цветов в таблице цвета.
CImage::GetWidth	Получает ширину текущего изображения в пикселях.
CImage::IsDIBSection	Определяет, является ли вложенное растровое изображение раздел DIB.
CImage::IsIndexed	Указывает, что цвета растрового изображения в индексированной сопоставлены палитры.
CImage::IsNull	Указывает, является ли растровое изображение источника в данный момент загружен.
CImage::IsTransparencySupported	Указывает, поддерживает ли приложение прозрачные растровые изображения и компилировать для Windows 2000 или более поздней версии.
CImage::Load	Загружает образ из указанного файла.
CImage::LoadFromResource	Загружает образ из заданного ресурса.
CImage::MaskBlt	Объединяет данные о цвете для растровых изображений источника и назначения, используя указанную операцию и маски растровый.
CImage::PlgBlt	Выполняет передачу бит- блока из прямоугольника в контексте устройства источника в параллелограмм в контексте устройства назначения.
CImage::ReleaseDC	Освобождает контекст устройства, который был получить с CImage::GetDC.
CImage::ReleaseGDIPlus	Освобождает ресурсы, используемые GDI+.Быть вызываются для освобождения ресурсов, созданные глобальным объектом CImage.
CImage::Save	Сохраняет изображение как значение указанного типа.Сохранить не может определить параметры образа.
CImage::SetColorTable	Устанавливает красного, зеленого и синего цвета RGB) в диапазоне записей в таблице цветов раздела DIB.
CImage::SetPixel	Устанавливает точку на указанные координаты в указанный цвет.
CImage::SetPixelIndexed	Устанавливает точку на указанные координаты к цвету палитры по указанному индексу.
CImage::SetPixelRGB	Устанавливает точку на указанные координаты к определенному красный, зеленого, голубому значение (RGB).
CImage::SetTransparentColor	Устанавливает индекс цвета, который должен рассматриваться как прозрачный.Только один цвет в палитре может быть прозрачным.
CImage::StretchBlt	Копирует растровое изображение из прямоугольника источника в прямоугольник назначения, растянуть или сжать растровое изображение для приспособления измерений прямоугольника назначения, если требуемый.
CImage::TransparentBlt	Копирует растровое изображение с прозрачный цвет из контекста устройства источника к этому текущий контекст устройства.

Открытые операторы

Имя	Описание
CImage::operator HBITMAP	Возвращает вложенный маркер Windows на объект CImage.

Заметки

CImage принимает растровые изображения или разделы файла DIB (DIB) или нет. однако можно использовать Создание или CImage::Load только с разделами DIB.Можно вложить растровое изображение раздела non-DIB к объекту CImage с помощью Вложение, но с другой стороны, нельзя использовать следующие методы CImage, которые поддерживают только растровые изображения DIB раздела:

Для определения, является ли вложенное растровое изображение раздел, DIB, вызовите IsDibSection.

Примечание
Примечание В Visual Studio .NET 2003, этот класс содержит количество объектов CImage созданный., Если счетчик становится равным 0, функция GdiplusShutdown автоматически называется для освобождения ресурсов, используемых GDI+.Это гарантирует, что все объекты, созданные CImage прямо или косвенно библиотеки DLL всегда уничтожены указано правильно и что GdiplusShutdown не вызываются из DllMain.

Примечание В Visual Studio .NET 2003, этот класс содержит количество объектов CImage созданный., Если счетчик становится равным 0, функция GdiplusShutdown автоматически называется для освобождения ресурсов, используемых GDI+.Это гарантирует, что все объекты, созданные CImage прямо или косвенно библиотеки DLL всегда уничтожены указано правильно и что GdiplusShutdown не вызываются из DllMain.

Примечание
С помощью глобальной CImage не рекомендуется использовать объекты из библиотеки DLL.Если необходимо использовать глобальный объект CImage в dll-библиотеке, вызовите CImage::ReleaseGDIPlus, чтобы явно освобождение ресурсов, используемых GDI+.

С помощью глобальной CImage не рекомендуется использовать объекты из библиотеки DLL.Если необходимо использовать глобальный объект CImage в dll-библиотеке, вызовите CImage::ReleaseGDIPlus, чтобы явно освобождение ресурсов, используемых GDI+.

CImage не могут быть выбраны в новое CDC.CImage создать собственное HDC для образа.Поскольку HBITMAP можно выбрать только один раз в HDCHBITMAP, связанное с CImage не могут быть выбраны в другое HDC.Если необходимо CDC, то восстановление HDC из CImage и присвойте ему значение CDC::FromHandle.

Пример

// Get a CDC for the image
CDC* pDC = CDC::FromHandle(m_myImage.GetDC());

// Use pDC here
pDC->Rectangle(0, 40, 100, 50);

m_myImage.ReleaseDC();

При использовании CImage в проекте MFC, обратите внимание, функции-члены в проекте ожидающие указатель на объект CBitmap.Если нужно использовать CImage с такой функции, как CMenu::AppendMenu, используйте CBitmap::FromHandle, передав ему в CImageHBITMAP и использовать возвращаемое CBitmap*.

void CMyDlg::OnRButtonDown(UINT nFlags, CPoint point)
{
   UNREFERENCED_PARAMETER(nFlags);

   CBitmap* pBitmap = CBitmap::FromHandle(m_myImage);
   m_pmenuPop->AppendMenu(0, ID_BMPCOMMAND, pBitmap);
   ClientToScreen(&point);
   m_pmenuPop->TrackPopupMenu(TPM_RIGHTBUTTON | TPM_LEFTALIGN, point.x, 
      point.y, this);
}

С помощью CImage, имеется доступ к реальным битам раздела DIB.Можно использовать объект CImage везде, где ранее использовать раздел Win32 HBITMAP или DIB.

Примечание
Следующие методы CImage имеют ограничения на их использование.

Метод	Ограничение
PlgBlt	Рабочие только с Windows NT 4.0 или более поздней версии.В приложениях не работать под управлением Windows 95, /98 или более поздней версии.
MaskBlt	Рабочие только с Windows NT 4.0 или более поздней версии.В приложениях не работать под управлением Windows 95, /98 или более поздней версии.
AlphaBlend	Рабочие только с Windows 2000, Windows 98 и более последним системами.
TransparentBlt	Рабочие только с Windows 2000, Windows 98 и более последним системами.
Рисование	Поддерживает прозрачность только с Windows 2000, Windows 98 и более последним системами.

См. раздел Ограничения CImage с более ранними операционными системами дополнительные сведения об ограничениях на этих методах.

Можно использовать CImage из MFC и библиотеки ATL.

Примечание
При создании проекта с помощью CImage необходимо указать CString прежде чем включать atlimage.h.Если в проекте используется библиотека ATL без MFC, включите atlstr.h прежде чем включать atlimage.h.Если в проекте используется MFC (или если проект библиотеки ATL с поддержкой MFC), включайте afxstr.h прежде чем включать atlimage.h. Кроме того, необходимо включить atlimage.h прежде чем включать atlimpl.cpp.Для выполнения этого легко включить atlimage.h в stdafx.h.

При создании проекта с помощью CImage необходимо указать CString прежде чем включать atlimage.h.Если в проекте используется библиотека ATL без MFC, включите atlstr.h прежде чем включать atlimage.h.Если в проекте используется MFC (или если проект библиотеки ATL с поддержкой MFC), включайте afxstr.h прежде чем включать atlimage.h.

Кроме того, необходимо включить atlimage.h прежде чем включать atlimpl.cpp.Для выполнения этого легко включить atlimage.h в stdafx.h.

Требования

Header: atlimage.h

См. также

Поделиться через

Класс CImage

Члены

Открытые конструкторы

Открытые методы

Открытые операторы

Заметки

Пример

Требования

См. также

Ссылки

Основные понятия

Другие ресурсы

Дополнительные ресурсы