Image-图片操作

函数
HIMAGE WINAPI	XImage_LoadSrc (HIMAGE hImageSrc)
	@图片_加载从图片源 更多...
HIMAGE WINAPI	XImage_LoadFile (const wchar_t *pFileName)
	图片_加载从文件 加载图片从文件. 更多...
HIMAGE WINAPI	XImage_LoadFileAdaptive (const wchar_t *pFileName, int leftSize, int topSize, int rightSize, int bottomSize)
	图片_加载从文件自适应 加载图片从文件,自适应图片. 更多...
HIMAGE WINAPI	XImage_LoadFileRect (const wchar_t *pFileName, int x, int y, int cx, int cy)
	图片_加载从文件指定区域 加载图片,指定区位置及大小. 更多...
HIMAGE WINAPI	XImage_LoadResAdaptive (int id, const wchar_t *pType, int leftSize, int topSize, int rightSize, int bottomSize, HMODULE hModule)
	图片_加载从资源自适应 加载图片从资源,自适应图片. 更多...
HIMAGE WINAPI	XImage_LoadRes (int id, const wchar_t *pType, HMODULE hModule)
	图片_加载从资源 加载图片从资源. 更多...
HIMAGE WINAPI	XImage_LoadZip (const wchar_t *pZipFileName, const wchar_t *pFileName, const wchar_t *pPassword)
	图片_加载从ZIP 加载图片从ZIP压缩包. 更多...
HIMAGE WINAPI	XImage_LoadZipAdaptive (const wchar_t *pZipFileName, const wchar_t *pFileName, const wchar_t *pPassword, int x1, int x2, int y1, int y2)
	图片_加载从ZIP自适应 加载图片从ZIP压缩包,自适应图片. 更多...
HIMAGE WINAPI	XImage_LoadZipRect (const wchar_t *pZipFileName, const wchar_t *pFileName, const wchar_t *pPassword, int x, int y, int cx, int cy)
	图片_加载从ZIP指定区域 加载ZIP图片,指定区位置及大小. 更多...
HIMAGE WINAPI	XImage_LoadZipMem (void *data, int length, const wchar_t *pFileName, const wchar_t *pPassword)
	@图片_加载从内存ZIP 更多...
HIMAGE WINAPI	XImage_LoadZipRes (int id, const wchar_t *pFileName, const wchar_t *pPassword, HMODULE hModule)
	@图片_加载从资源ZIP 更多...
HIMAGE WINAPI	XImage_LoadMemory (void *pBuffer, int nSize)
	图片_加载从内存 加载流图片,指定区位置及大小. 更多...
HIMAGE WINAPI	XImage_LoadMemoryRect (void *pBuffer, int nSize, int x, int y, int cx, int cy)
	图片_加载从内存指定区域 加载流图片,指定区位置及大小. 更多...
HIMAGE WINAPI	XImage_LoadMemoryAdaptive (void *pBuffer, int nSize, int leftSize, int topSize, int rightSize, int bottomSize)
	图片_加载从内存自适应 加载流图片压缩包,自适应图片(九宫格). 更多...
HIMAGE WINAPI	XImage_LoadFromImage (void *pImage)
	图片_加载从Image 加载图片从GDI+的Image对象. 更多...
HIMAGE WINAPI	XImage_LoadFromExtractIcon (const wchar_t *pFileName)
	图片_加载文件图标 加载文件图标,从一个EXE文件或DLL文件或图标文件;例如:*.exe文件的图标. 更多...
HIMAGE WINAPI	XImage_LoadFromHICON (HICON hIcon)
	图片_加载从HICON 创建一个炫彩图片句柄,从一个现有的图标句柄HICON. 更多...
HIMAGE WINAPI	XImage_LoadFromHBITMAP (HBITMAP hBitmap)
	图片_加载从HBITMAP 创建一个炫彩图片句柄,从一个现有的位图句柄HBITMAP. 更多...
BOOL WINAPI	XImage_IsStretch (HIMAGE hImage)
	图片_是否缩放 是否为拉伸图片句柄 更多...
BOOL WINAPI	XImage_IsAdaptive (HIMAGE hImage)
	图片_是否自适应 是否为自适应图片句柄 更多...
BOOL WINAPI	XImage_IsTile (HIMAGE hImage)
	图片_是否平铺 是否为平铺图片 更多...
HIMAGE WINAPI	XImage_LoadSvg (HSVG hSvg)
	@图片_加载从SVG 更多...
HIMAGE WINAPI	XImage_LoadSvgFile (const wchar_t *pFileName)
	@图片_加载从SVG文件 UTF8文件 更多...
HIMAGE WINAPI	XImage_LoadSvgString (const char *pString)
	@图片_加载从SVG字符串 多字节字符串ANSI 更多...
HIMAGE WINAPI	XImage_LoadSvgStringW (const wchar_t *pString)
	@图片_加载从SVG字符串W UNICODE字符串 更多...
HIMAGE WINAPI	XImage_LoadSvgStringUtf8 (const char *pString)
	@图片_加载从SVG字符串UTF8 UTF8字符串 更多...
HSVG WINAPI	XImage_GetSvg (HIMAGE hImage)
	@图片_取SVG 更多...
BOOL WINAPI	XImage_SetDrawType (HIMAGE hImage, image_draw_type_ nType)
	图片_置绘制类型 设置图片绘制类型 更多...
BOOL WINAPI	XImage_SetDrawTypeAdaptive (HIMAGE hImage, int leftSize, int topSize, int rightSize, int bottomSize)
	图片_置绘制类型自适应 设置图片自适应(九宫格) 更多...
void WINAPI	XImage_SetTranColor (HIMAGE hImage, COLORREF color)
	图片_置透明色 指定图片透明颜色. 仅支持GDI+模式 更多...
void WINAPI	XImage_SetTranColorEx (HIMAGE hImage, COLORREF color, BYTE tranColor)
	图片_置透明色扩展 指定图片透明颜色及透明度.仅支持GDI+模式 更多...
float WINAPI	XImage_SetRotateAngle (HIMAGE hImage, float fAngle)
	图片_置旋转角度 设置旋转角度. 更多...
void WINAPI	XImage_SetSplitEqual (HIMAGE hImage, int nCount, int iIndex)
	@图片_置等分 更多...
void WINAPI	XImage_SetScaleSize (HIMAGE hImage, int width, int height)
	@图片_置缩放大小 启用缩放属性后有效,值大于0有效, XImage_SetDrawType() 例如: 拉伸, 九宫格 更多...
void WINAPI	XImage_EnableTranColor (HIMAGE hImage, BOOL bEnable)
	图片_启用透明色 启用或关闭图片透明色.仅支持GDI+模式 更多...
void WINAPI	XImage_EnableAutoDestroy (HIMAGE hImage, BOOL bEnable)
	图片_启用自动销毁 启用或关闭自动销毁,当与UI元素关联时有效 更多...
void WINAPI	XImage_EnableCenter (HIMAGE hImage, BOOL bCenter)
	图片_启用居中 启用或关闭图片居中显示，默认属性图片有效。 更多...
BOOL WINAPI	XImage_IsCenter (HIMAGE hImage)
	图片_是否居中 判断图片是否居中显示 更多...
image_draw_type_ WINAPI	XImage_GetDrawType (HIMAGE hImage)
	图片_取绘制类型 获取图片绘制类型 更多...
int WINAPI	XImage_GetWidth (HIMAGE hImage)
	图片_取宽度 获取图片宽度. 更多...
int WINAPI	XImage_GetHeight (HIMAGE hImage)
	图片_取高度 获取图片高度. 更多...
HIMAGE WINAPI	XImage_GetImageSrc (HIMAGE hImage)
	@anchor 图片_取图片源 更多...
void WINAPI	XImage_AddRef (HIMAGE hImage)
	图片_增加引用计数 增加引用计数. 更多...
void WINAPI	XImage_Release (HIMAGE hImage)
	图片_释放引用计数 释放引用计数,当引用计数为0时,自动销毁. 更多...
int WINAPI	XImage_GetRefCount (HIMAGE hImage)
	图片_取引用计数 获取引用计数. 更多...
void WINAPI	XImage_Destroy (HIMAGE hImage)
	图片_销毁 强制销毁图片, 谨慎使用, 建议使用 XImage_Release() 释放. 更多...

详细描述

图片操作接口,提供了图片的加载,销毁及配合UI元素的贴图显示,当图片接口关联到一个UI元素后,它会自动销毁图片接口,否则需要你手动销毁.
主要支持:加载图片文件格式,bmp,jpg,png,gif,ico.从文件加载,从程序资源加载,从压缩包中加载,自适应图片,平铺,透明色支持.

函数说明

XImage_AddRef()

void WINAPI XImage_AddRef

(

HIMAGE

hImage

)

图片_增加引用计数 增加引用计数.

参数

hImage

图片句柄.

XImage_Destroy()

void WINAPI XImage_Destroy

(

HIMAGE

hImage

)

图片_销毁 强制销毁图片, 谨慎使用, 建议使用 XImage_Release() 释放.

参数

hImage

图片句柄.

XImage_EnableAutoDestroy()

void WINAPI XImage_EnableAutoDestroy	(	HIMAGE	hImage,
		BOOL	bEnable
	)

图片_启用自动销毁 启用或关闭自动销毁,当与UI元素关联时有效

参数

hImage	图片句柄.
bEnable	启用自动销毁TRUE,关闭自动销毁FALSE.

XImage_EnableCenter()

void WINAPI XImage_EnableCenter	(	HIMAGE	hImage,
		BOOL	bCenter
	)

图片_启用居中 启用或关闭图片居中显示，默认属性图片有效。

参数

hImage	图片句柄.
bCenter	是否居中显示.

XImage_EnableTranColor()

void WINAPI XImage_EnableTranColor	(	HIMAGE	hImage,
		BOOL	bEnable
	)

图片_启用透明色 启用或关闭图片透明色.仅支持GDI+模式

参数

hImage	图片句柄.
bEnable	启用TRUE,关闭FALSE.

XImage_GetDrawType()

image_draw_type_ WINAPI XImage_GetDrawType

(

HIMAGE

hImage

)

图片_取绘制类型 获取图片绘制类型

参数

hImage

图片句柄.

返回

图片绘制类型.

XImage_GetHeight()

int WINAPI XImage_GetHeight

(

HIMAGE

hImage

)

图片_取高度 获取图片高度.

参数

hImage

图片句柄.

返回

图片高度.

XImage_GetImageSrc()

HIMAGE WINAPI XImage_GetImageSrc

(

HIMAGE

hImage

)

@anchor 图片_取图片源

参数

hImage

图片句柄

返回

返回图片源句柄

XImage_GetRefCount()

int WINAPI XImage_GetRefCount

(

HIMAGE

hImage

)

图片_取引用计数 获取引用计数.

参数

hImage

图片句柄.

返回

返回引用计数.

XImage_GetSvg()

HSVG WINAPI XImage_GetSvg

(

HIMAGE

hImage

)

@图片_取SVG

参数

hImage

图片句柄

返回

SVG句柄

XImage_GetWidth()

int WINAPI XImage_GetWidth

(

HIMAGE

hImage

)

图片_取宽度 获取图片宽度.

参数

hImage

图片句柄.

返回

图片宽度.

XImage_IsAdaptive()

BOOL WINAPI XImage_IsAdaptive

(

HIMAGE

hImage

)

图片_是否自适应 是否为自适应图片句柄

参数

hImage

图片句柄.

返回

是否自适应

XImage_IsCenter()

BOOL WINAPI XImage_IsCenter

(

HIMAGE

hImage

)

图片_是否居中 判断图片是否居中显示

参数

hImage

图片句柄.

返回

如果居中显示返回TRUE，否则相反.

XImage_IsStretch()

BOOL WINAPI XImage_IsStretch

(

HIMAGE

hImage

)

图片_是否缩放 是否为拉伸图片句柄

参数

hImage

图片句柄.

返回

是否缩放.

XImage_IsTile()

BOOL WINAPI XImage_IsTile

(

HIMAGE

hImage

)

图片_是否平铺 是否为平铺图片

参数

hImage

图片句柄.

返回

是否平铺

XImage_LoadFile()

HIMAGE WINAPI XImage_LoadFile

(

const wchar_t *

pFileName

)

图片_加载从文件 加载图片从文件.

参数

pFileName

图片文件.

返回

图片句柄.

XImage_LoadFileAdaptive()

HIMAGE WINAPI XImage_LoadFileAdaptive	(	const wchar_t *	pFileName,
		int	leftSize,
		int	topSize,
		int	rightSize,
		int	bottomSize
	)

图片_加载从文件自适应 加载图片从文件,自适应图片.

参数

pFileName	图片文件.
leftSize	坐标.
topSize	坐标.
rightSize	坐标.
bottomSize	坐标.

返回

图片句柄.

XImage_LoadFileRect()

HIMAGE WINAPI XImage_LoadFileRect	(	const wchar_t *	pFileName,
		int	x,
		int	y,
		int	cx,
		int	cy
	)

图片_加载从文件指定区域 加载图片,指定区位置及大小.

参数

pFileName	图片文件.
x	坐标.
y	坐标.
cx	宽度.
cy	高度.

返回

图片句柄.

XImage_LoadFromExtractIcon()

HIMAGE WINAPI XImage_LoadFromExtractIcon

(

const wchar_t *

pFileName

)

图片_加载文件图标 加载文件图标,从一个EXE文件或DLL文件或图标文件;例如:*.exe文件的图标.

参数

pFileName

文件名.

返回

图片句柄

XImage_LoadFromHBITMAP()

HIMAGE WINAPI XImage_LoadFromHBITMAP

(

HBITMAP

hBitmap

)

图片_加载从HBITMAP 创建一个炫彩图片句柄,从一个现有的位图句柄HBITMAP.

参数

hBitmap

位图句柄,如果你不使用可以释放 DeleteObject().

返回

图片句柄

XImage_LoadFromHICON()

HIMAGE WINAPI XImage_LoadFromHICON

(

HICON

hIcon

)

图片_加载从HICON 创建一个炫彩图片句柄,从一个现有的图标句柄HICON.

参数

hIcon

图标句柄,如果你不使用可以释放 DestroyIcon().

返回

图片句柄

XImage_LoadFromImage()

HIMAGE WINAPI XImage_LoadFromImage

(

void *

pImage

)

图片_加载从Image 加载图片从GDI+的Image对象.

参数

pImage

GDI图片对象指针 Image*.

返回

图片句柄

XImage_LoadMemory()

HIMAGE WINAPI XImage_LoadMemory	(	void *	pBuffer,
		int	nSize
	)

图片_加载从内存 加载流图片,指定区位置及大小.

参数

pBuffer	图片缓冲区
nSize	图片缓冲区大小

返回

图片句柄.

XImage_LoadMemoryAdaptive()

HIMAGE WINAPI XImage_LoadMemoryAdaptive	(	void *	pBuffer,
		int	nSize,
		int	leftSize,
		int	topSize,
		int	rightSize,
		int	bottomSize
	)

图片_加载从内存自适应 加载流图片压缩包,自适应图片(九宫格).

参数

pBuffer	图片缓冲区
nSize	图片缓冲区大小
leftSize	坐标.
topSize	坐标.
rightSize	坐标.
bottomSize	坐标.

返回

图片句柄

XImage_LoadMemoryRect()

HIMAGE WINAPI XImage_LoadMemoryRect	(	void *	pBuffer,
		int	nSize,
		int	x,
		int	y,
		int	cx,
		int	cy
	)

图片_加载从内存指定区域 加载流图片,指定区位置及大小.

参数

pBuffer	图片缓冲区
nSize	图片缓冲区大小
x	坐标.
y	坐标.
cx	宽度.
cy	高度.

返回

图片句柄.

XImage_LoadRes()

HIMAGE WINAPI XImage_LoadRes	(	int	id,
		const wchar_t *	pType,
		HMODULE	hModule
	)

图片_加载从资源 加载图片从资源.

参数

id	资源ID.
pType	资源类型. 在rc资源文件中,资源的类型, 例如:xcgui.rc, 用记事本打开可以看见资源类型; 例如:BITMAP, PNG; 参见MSDN
hModule	从指定模块加载, 例如:DLL, EXE; 如果为空, 从当前EXE加载

返回

图片句柄.

XImage_LoadResAdaptive()

HIMAGE WINAPI XImage_LoadResAdaptive	(	int	id,
		const wchar_t *	pType,
		int	leftSize,
		int	topSize,
		int	rightSize,
		int	bottomSize,
		HMODULE	hModule
	)

图片_加载从资源自适应 加载图片从资源,自适应图片.

参数

id	资源ID.
pType	资源类型. 在rc资源文件中,资源的类型, 例如:xcgui.rc, 用记事本打开可以看见资源类型; 例如:BITMAP, PNG; 参见MSDN
leftSize	坐标.
topSize	坐标.
rightSize	坐标.
bottomSize	坐标.
hModule	从指定模块加载, 例如:DLL, EXE; 如果为空, 从当前EXE加载

返回

图片句柄.

XImage_LoadSrc()

HIMAGE WINAPI XImage_LoadSrc

(

HIMAGE

hImageSrc

)

@图片_加载从图片源

参数

hImageSrc

图片源句柄

返回

返回图片句柄

XImage_LoadSvg()

HIMAGE WINAPI XImage_LoadSvg

(

HSVG

hSvg

)

@图片_加载从SVG

参数

hSvg

SVG句柄

返回

图片句柄

XImage_LoadSvgFile()

HIMAGE WINAPI XImage_LoadSvgFile

(

const wchar_t *

pFileName

)

@图片_加载从SVG文件 UTF8文件

参数

pFileName

文件名

返回

图片句柄

XImage_LoadSvgString()

HIMAGE WINAPI XImage_LoadSvgString

(

const char *

pString

)

@图片_加载从SVG字符串 多字节字符串ANSI

参数

pString

字符串指针

返回

图片句柄

XImage_LoadSvgStringUtf8()

HIMAGE WINAPI XImage_LoadSvgStringUtf8

(

const char *

pString

)

@图片_加载从SVG字符串UTF8 UTF8字符串

参数

pString

字符串指针

返回

图片句柄

XImage_LoadSvgStringW()

HIMAGE WINAPI XImage_LoadSvgStringW

(

const wchar_t *

pString

)

@图片_加载从SVG字符串W UNICODE字符串

参数

pString

字符串指针

返回

图片句柄

XImage_LoadZip()

HIMAGE WINAPI XImage_LoadZip	(	const wchar_t *	pZipFileName,
		const wchar_t *	pFileName,
		const wchar_t *	pPassword
	)

图片_加载从ZIP 加载图片从ZIP压缩包.

参数

pZipFileName	ZIP压缩包文件名.
pFileName	图片文件名.
pPassword	ZIP压缩包密码.

返回

图片句柄.

XImage_LoadZipAdaptive()

HIMAGE WINAPI XImage_LoadZipAdaptive	(	const wchar_t *	pZipFileName,
		const wchar_t *	pFileName,
		const wchar_t *	pPassword,
		int	x1,
		int	x2,
		int	y1,
		int	y2
	)

图片_加载从ZIP自适应 加载图片从ZIP压缩包,自适应图片.

参数

pZipFileName	ZIP压缩包文件名.
pFileName	图片文件名.
pPassword	ZIP压缩包密码,如果没有填NULL.
x1	坐标.
x2	坐标.
y1	坐标.
y2	坐标.

返回

图片句柄.

XImage_LoadZipMem()

HIMAGE WINAPI XImage_LoadZipMem	(	void *	data,
		int	length,
		const wchar_t *	pFileName,
		const wchar_t *	pPassword
	)

@图片_加载从内存ZIP

参数

data	内存块指针
length	内存块大小,字节为单位
pFileName	图片名称
pPassword	zip压缩包密码

返回

图片句柄

XImage_LoadZipRect()

HIMAGE WINAPI XImage_LoadZipRect	(	const wchar_t *	pZipFileName,
		const wchar_t *	pFileName,
		const wchar_t *	pPassword,
		int	x,
		int	y,
		int	cx,
		int	cy
	)

图片_加载从ZIP指定区域 加载ZIP图片,指定区位置及大小.

参数

pZipFileName	ZIP文件.
pFileName	图片名称
pPassword	密码
x	坐标.
y	坐标.
cx	宽度.
cy	高度.

返回

图片句柄.

XImage_LoadZipRes()

HIMAGE WINAPI XImage_LoadZipRes	(	int	id,
		const wchar_t *	pFileName,
		const wchar_t *	pPassword,
		HMODULE	hModule
	)

@图片_加载从资源ZIP

参数

id	RC资源ID
pFileName	图片名称
pPassword	zip压缩包密码
hModule	模块句柄

返回

图片句柄

XImage_Release()

void WINAPI XImage_Release

(

HIMAGE

hImage

)

图片_释放引用计数 释放引用计数,当引用计数为0时,自动销毁.

参数

hImage

图片句柄.

XImage_SetDrawType()

BOOL WINAPI XImage_SetDrawType	(	HIMAGE	hImage,
		image_draw_type_	nType
	)

图片_置绘制类型 设置图片绘制类型

参数

hImage	图片句柄.
nType	图片绘制类型.

返回

如果成功返回TRUE,否则相反.

XImage_SetDrawTypeAdaptive()

BOOL WINAPI XImage_SetDrawTypeAdaptive	(	HIMAGE	hImage,
		int	leftSize,
		int	topSize,
		int	rightSize,
		int	bottomSize
	)

图片_置绘制类型自适应 设置图片自适应(九宫格)

参数

hImage	图片句柄.
leftSize	坐标.
topSize	坐标.
rightSize	坐标.
bottomSize	坐标.

返回

如果成功返回TRUE,否则相反.

XImage_SetRotateAngle()

float WINAPI XImage_SetRotateAngle	(	HIMAGE	hImage,
		float	fAngle
	)

图片_置旋转角度 设置旋转角度.

参数

hImage	图片句柄.
fAngle	选择角度.

返回

返回先前角度.

XImage_SetScaleSize()

void WINAPI XImage_SetScaleSize	(	HIMAGE	hImage,
		int	width,
		int	height
	)

@图片_置缩放大小 启用缩放属性后有效,值大于0有效, XImage_SetDrawType() 例如: 拉伸, 九宫格

参数

hImage	图片句柄
width	宽度
height	高度

XImage_SetSplitEqual()

void WINAPI XImage_SetSplitEqual	(	HIMAGE	hImage,
		int	nCount,
		int	iIndex
	)

@图片_置等分

参数

hImage	图片句柄
nCount	等分数量
iIndex	索引

XImage_SetTranColor()

void WINAPI XImage_SetTranColor	(	HIMAGE	hImage,
		COLORREF	color
	)

图片_置透明色 指定图片透明颜色. 仅支持GDI+模式

参数

hImage	图片句柄.
color	颜色值, 请使用宏: RGBA()

XImage_SetTranColorEx()

void WINAPI XImage_SetTranColorEx	(	HIMAGE	hImage,
		COLORREF	color,
		BYTE	tranColor
	)

图片_置透明色扩展 指定图片透明颜色及透明度.仅支持GDI+模式

参数

hImage	图片句柄.
color	颜色值, 请使用宏: RGBA()
tranColor	透明色的透明度.