📄 sdlsetcolorkey.html
字号:
<HTML><HEAD><TITLE>SDL_SetColorKey</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+"><LINKREL="HOME"TITLE="SDL Library Documentation"HREF="index.html"><LINKREL="UP"TITLE="Video"HREF="video.html"><LINKREL="PREVIOUS"TITLE="SDL_SaveBMP"HREF="sdlsavebmp.html"><LINKREL="NEXT"TITLE="SDL_SetAlpha"HREF="sdlsetalpha.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFF8DC"TEXT="#000000"LINK="#0000ee"VLINK="#551a8b"ALINK="#ff0000"><DIVCLASS="NAVHEADER"><TABLESUMMARY="Header navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><THCOLSPAN="3"ALIGN="center">SDL Library Documentation</TH></TR><TR><TDWIDTH="10%"ALIGN="left"VALIGN="bottom"><AHREF="sdlsavebmp.html"ACCESSKEY="P">Prev</A></TD><TDWIDTH="80%"ALIGN="center"VALIGN="bottom"></TD><TDWIDTH="10%"ALIGN="right"VALIGN="bottom"><AHREF="sdlsetalpha.html"ACCESSKEY="N">Next</A></TD></TR></TABLE><HRALIGN="LEFT"WIDTH="100%"></DIV><H1><ANAME="SDLSETCOLORKEY"></A>SDL_SetColorKey</H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN2045"></A><H2>Name</H2>SDL_SetColorKey -- Sets the color key (transparent pixel) in a blittable surface andRLE acceleration.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN2048"></A><H2>Synopsis</H2><DIVCLASS="FUNCSYNOPSIS"><ANAME="AEN2049"></A><P></P><PRECLASS="FUNCSYNOPSISINFO">#include "SDL.h"</PRE><P><CODE><CODECLASS="FUNCDEF">int <BCLASS="FSFUNC">SDL_SetColorKey</B></CODE>(SDL_Surface *surface, Uint32 flag, Uint32 key);</CODE></P><P></P></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN2055"></A><H2>Description</H2><P> Sets the color key (transparent pixel) in a blittable surface and enables or disables RLE blit acceleration.</P><P>RLE acceleration can substantially speed up blitting of images with largehorizontal runs of transparent pixels (i.e., pixels that match the<TTCLASS="PARAMETER"><I>key</I></TT> value). The <TTCLASS="PARAMETER"><I>key</I></TT> must be of the same pixel format as the <TTCLASS="PARAMETER"><I>surface</I></TT>, <AHREF="sdlmaprgb.html"><TTCLASS="FUNCTION">SDL_MapRGB</TT></A> is often useful for obtaining an acceptable value.</P><P>If <TTCLASS="PARAMETER"><I>flag</I></TT> is <TTCLASS="LITERAL">SDL_SRCCOLORKEY</TT> then<TTCLASS="PARAMETER"><I>key</I></TT> is the transparent pixel value in the source image of ablit.</P><P>If <TTCLASS="PARAMETER"><I>flag</I></TT> is OR'd with<TTCLASS="LITERAL">SDL_RLEACCEL</TT> then the surface will be draw using RLEacceleration when drawn with<AHREF="sdlblitsurface.html">SDL_BlitSurface</A>. The surface willactually be encoded for RLE acceleration the first time<AHREF="sdlblitsurface.html">SDL_BlitSurface</A> or<AHREF="sdldisplayformat.html">SDL_DisplayFormat</A> is called on thesurface.</P><P>If <TTCLASS="PARAMETER"><I>flag</I></TT> is 0, this function clearsany current color key.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN2076"></A><H2>Return Value</H2><P>This function returns <SPANCLASS="RETURNVALUE">0</SPAN>, or<SPANCLASS="RETURNVALUE">-1</SPAN> if there was an error.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN2081"></A><H2>See Also</H2><P><AHREF="sdlblitsurface.html"><TTCLASS="FUNCTION">SDL_BlitSurface</TT></A>,<AHREF="sdldisplayformat.html"><TTCLASS="FUNCTION">SDL_DisplayFormat</TT></A>,<AHREF="sdlmaprgb.html"><TTCLASS="FUNCTION">SDL_MapRGB</TT></A>,<AHREF="sdlsetalpha.html"><TTCLASS="FUNCTION">SDL_SetAlpha</TT></A></P></DIV><DIVCLASS="NAVFOOTER"><HRALIGN="LEFT"WIDTH="100%"><TABLESUMMARY="Footer navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top"><AHREF="sdlsavebmp.html"ACCESSKEY="P">Prev</A></TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="index.html"ACCESSKEY="H">Home</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top"><AHREF="sdlsetalpha.html"ACCESSKEY="N">Next</A></TD></TR><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top">SDL_SaveBMP</TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="video.html"ACCESSKEY="U">Up</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top">SDL_SetAlpha</TD></TR></TABLE></DIV></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -