DrawShape

From ZDoom Wiki
Jump to navigation Jump to search
Note: This feature is for ZScript only.


Screen

native static vararg void DrawShape(TextureID tex, bool animate, Shape2D s, ...)

Usage

Similar to DrawTexture but instead of a position a predefined Shape can be passed. Using a custom shape allows for masking textures without having to put it in the texture itself. For instance, a square texture can be fitted into a circular shape to make it draw in a circle instead. This can be useful for things like shaping camera textures instead of having to use textures to mask the edges. The downside is that all scaling and texture coordinate mapping has to be done manually.

Note: ARGB colors are best specified by a hex value. For instance, if a color of pure red with full opaqueness is desired, the value 0xFFFF0000 should be used. The first FF specifies the alpha, the second FF specifies the level of red, and the next two 00 specify the level of green and blue respectively. If a tag says only "RGB" then the first FF specifying the alpha can be completely left out.

Warning: This can only be called from within functions that are specifically designed to draw HUD elements (e.g. BaseStatusBar's Draw or EventHandler's RenderOverlay).

Parameters

  • tex - The id of the texture to draw. The id of a texture can be found by calling TexMan's CheckForTexture function
  • animate - Whether or not to animate the image if it has a definition in ANIMDEFS
  • s - The predefined shape to pass to the function. See Shape for creating custom shapes
  • tags - Tags allow for any number of optional arguments to be specified in any order. Tags are set with the following syntax:
Screen.DrawShape(myTex, false, myShape, DTA_FillColor, 0xFF0000, DTA_AlphaChannel, true); // etc

with the tag first followed by its value. Valid tags:

  • (double) DTA_Alpha - Sets the alpha of the texture. A value of 1 is fully opaque while 0 is fully transparent. If less than 1 and DTA_LegacyRenderStyle is not specified then the render style is set to Translucent
  • (int) DTA_Color - An ARGB color that the texture's final colors (after all other color operations) are blended with
  • (int) DTA_FillColor - An RGB color to stencil on top of the texture. If DTA_LegacyRenderStyle is not specified then the render style is set to TranslucentStencil if DTA_Alpha is less than one, otherwise setting it to Stencil
  • (bool) DTA_AlphaChannel - If DTA_LegacyRenderStyle is not specified then the render style is set to Shaded if a color was specified in DTA_FillColor
  • (int) DTA_ColorOverlay - Applies an ARGB color overlay on top of the texture
  • (int) DTA_Desaturate - If DTA_FillColor is set then completely desaturates the texture with a value greater than 0. Otherwise scales the desaturation. A value of 255 is fully desaturated while a value of 0 is fully saturated
  • (int) DTA_TranslationIndex - Id for the translation to translate the color of the texture
  • (int) DTA_LegacyRenderStyle - Sets the render style via the STYLE_* constants. See: render styles
  • (bool) DTA_NoOffset - The shape ignores the global offsets for the screen when drawing it
  • (int) DTA_ClipTop - Clip anything above this position on the screen
  • (int) DTA_ClipBottom - Clip anything below this position on the screen
  • (int) DTA_ClipLeft - Clip anything to the left of this position on the screen
  • (int) DTA_ClipRight - Clip anything to the right of this position on the screen
  • Note: Clipping rectangles take precedence over the DTA_Clip* tags
  • (bool) DTA_Masked - If false, don't use the texture's mask

Examples

Nuvolachalk.png Note: This article lists no examples. If you make use of this feature in your own project(s) or know of any basic examples that could be shared, please add them. This will make it easier to understand for future authors seeking assistance. Your contributions are greatly appreciated.