Creates a new font. To prevent the font from displaying incorrectly when using the outline setting, set antialias to false. This will ensure the text properly fills out the entire outline. Be sure to check the List of Default Fonts first! Those fonts can be used without using this function. See Also: Finding the Font Name. Due to the static nature of fonts, do NOT create the font more than once. You should only be creating them once, it is recommended to create them at the top of your script. Do not use this function within GM:HUDPaint or any other hook! Define fonts that you will actually use, as fonts are very taxing on performance and will cause crashes! Do not create fonts for every size.

We advise against using this. It may be changed or removed in a future update. Alias of DisableClipping so use that instead. Enables or disables the clipping used by the VGUI that limits the drawing operations to a panels bounds. Identical to DisableClipping. See also Panel:NoClipping.

Draws a hollow circle, made of lines. For a filled circle, see examples for surface. DrawPoly. This is a rendering function that requires a 2d rendering context. This means that it will only work in 2d Rendering Hooks.

Draws a line from one point to another. This is a rendering function that requires a 2d rendering context. This means that it will only work in 2d Rendering Hooks.

Draws a hollow box with a given border width. This is a rendering function that requires a 2d rendering context. This means that it will only work in 2d Rendering Hooks.

Draws a textured polygon (secretly a triangle fan) with a maximum of 4096 vertices. Only works properly with convex polygons. You may try to render concave polygons, but there is no guarantee that things wont get messed up. Unlike most surface library functions, non-integer coordinates are not rounded. You must reset the drawing color and texture before calling the function to ensure consistent results. See examples below. This is a rendering function that requires a 2d rendering context. This means that it will only work in 2d Rendering Hooks.

Draws a solid rectangle on the screen. This is a rendering function that requires a 2d rendering context. This means that it will only work in 2d Rendering Hooks.

Draw the specified text on the screen, using the previously set position, font and color. This function does not handle newlines. This function moves the text position by the length of the drawn text - this can be used to change text properties (such as font or color) without having to manually recalculate the text position. See example #2 for example use of this behavior. This is a rendering function that requires a 2d rendering context. This means that it will only work in 2d Rendering Hooks.

Draw a textured rectangle with the given position and dimensions on the screen, using the current active texture set with surface. SetMaterial. It is also affected by surface. SetDrawColor. See also render. SetMaterial and render. DrawScreenQuadEx. See also surface. DrawTexturedRectUV and surface. DrawTexturedRectRotated. This is a rendering function that requires a 2d rendering context. This means that it will only work in 2d Rendering Hooks.

Draw a textured rotated rectangle with the given position and dimensions and angle on the screen, using the current active texture. See also surface. DrawTexturedRectUV and surface. DrawTexturedRect. This is a rendering function that requires a 2d rendering context. This means that it will only work in 2d Rendering Hooks.

Draws a textured rectangle with a repeated or partial texture. u and v refer to texture coordinates. (u, v) = (0, 0) is the top left (u, v) = (1, 0) is the top right (u, v) = (1, 1) is the bottom right (u, v) = (0, 1) is the bottom left Using a start point of (1, 0) and an end point to (0, 1), you can draw an image flipped horizontally, same goes with other directions. Going above 1 will tile the texture. Negative values are allowed as well. Here's a helper image: See also surface. DrawTexturedRect and surface. DrawTexturedRectRotated. If you are using a . png image, you need supply the "noclamp" flag as second parameter for Material if you intend to use tiling. If you find that surface. DrawTexturedRectUV is getting your texture coordinates (u0, v0), (u1, v1) wrong and you're rendering with a material created with CreateMaterial, try adjusting them with the following code: local du = 0. 5 / 32 -- half pixel anticorrection local dv = 0. 5 / 32 -- half pixel anticorrection local u0, v0 = (u0 - du) / (1 - 2 * du), (v0 - dv) / (1 - 2 * dv) local u1, v1 = (u1 - du) / (1 - 2 * du), (v1 - dv) / (1 - 2 * dv) Explanation: surface. DrawTexturedRectUV tries to correct the texture coordinates by half a pixel (something to do with sampling) and computes the correction using IMaterial::GetMappingWidth()/GetMappingHeight(). If the material was created without a $basetexture, then GetMappingWidth()/GetMappingHeight() uses the width and height of the error material (which is 32x32). This is a rendering function that requires a 2d rendering context. This means that it will only work in 2d Rendering Hooks. The UV offsets might require (sub-)pixel correction for accurate tiling results. Issue Tracker: 3173

Returns the current alpha multiplier affecting drawing operations. This is set by surface. SetAlphaMultiplier or by the game engine in certain other cases.

Returns the current color affecting draw operations. The returned color will not have the color metatable. Issue Tracker: 2407

Returns the HUD icon TextureID of a texture with the specified name. You probably want to use Material and surface. SetMaterial.

Retrieves the position and ScissorRect information for the Panel that is currently being drawn. When using the surface library (and, by extension, the draw library) inside of the PANEL:Paint function, the origin (The on-screen position of (0,0)) is automatically shifted to the top-left corner of the panel to make it easier to draw the panel's contents. Additionally, render. SetScissorRect is used to clip (or "mask") all drawn content to within the boundaries of the panel. This function returns the information used by the surface library about the current panel's origin and ScissorRect.

Returns the current color affecting text draw operations. The returned color will not have the color metatable. Issue Tracker: 2407

Returns the X and Y co-ordinate that has been set with surface. SetTextPos or changed by surface. DrawText.

Returns the width and height (in pixels) of the given text with the font that has been set with surface. SetFont. Does not take into account new lines, the returned height is for the entire font (as specified by the font), not maximum of individual characters.

Returns the texture id of the material with the given name/path, for use with surface. SetTexture. Opposite version of this function is surface. GetTextureNameByID. This function will not work with . png or . jpg images. For that, see Material. You will probably want to use it regardless.

Returns name/path of texture by ID. Opposite version of this function is surface. GetTextureID.

Returns the size of the texture with the associated texture ID. For . png/. jpg textures loaded with Material you can use the $realheight and $realwidth material parameters (IMaterial:GetInt) to get the size of the image.

Play a sound file directly on the client (such as UI sounds, etc). Valid sample rates: 11025 Hz, 22050 Hz and 44100 Hz, otherwise you may see this kind of message: Unsupported 32-bit wave file your_sound. wav and Invalid sample rate (48000) for sound 'your_sound. wav'

We advise against using this. It may be changed or removed in a future update. You should use ScrH instead. Returns the height of the current client's screen.

We advise against using this. It may be changed or removed in a future update. You should use ScrW instead. Returns the width of the current client's screen.

Sets the alpha multiplier that will influence all upcoming drawing operations. See also render. SetBlend.

Set the color of any future shapes to be drawn, can be set by either using R, G, B, A as separate values or by a Color. The alpha value may not work properly if you're using a material without $vertexalpha. Due to post processing and gamma correction the color you set with this function may appear differently when rendered. This problem does not occur on materials drawn with surface. DrawTexturedRect.

Set the current font to be used for text operations later. The fonts must first be created with surface. CreateFont or be one of the Default Fonts.

Sets the material to be used in all upcoming draw operations using the surface library. Not to be confused with render. SetMaterial. If you need to unset the texture, use the draw. NoTexture convenience function. Material function calls are expensive to be done inside this function or inside rendering context, you should be caching the results of Material calls

Set the color of any future text to be drawn, can be set by either using R, G, B, A as separate numbers or by a Color.

Set the top-left position to draw any future text at.

Sets the texture to be used in all upcoming draw operations using the surface library. This is a legacy method, and should probably not be used, see surface. SetMaterial and IMaterial for a better alternative.