DxSetBlendMode: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
| Line 13: | Line 13: | ||
**'''add:''' The source textures are added to the screen/render target. | **'''add:''' The source textures are added to the screen/render target. | ||
**'''modulate_add:''' The source textures are multiplied by the alpha and then added to the screen/render target. | **'''modulate_add:''' The source textures are multiplied by the alpha and then added to the screen/render target. | ||
{{New feature/item|4.0140|1.3.0|4425| | |||
**'''overwrite :''' The source textures are overwritten. This can be useful for clearing render targets. | |||
}} | |||
==Returns== | ==Returns== | ||
| Line 24: | Line 27: | ||
==Requirements== | ==Requirements== | ||
{{Requirements|n/a|1.3.0-9.03782|}} | {{Requirements|n/a|1.3.0-9.03782|}} | ||
==Changelog== | |||
{{ChangelogHeader}} | |||
{{ChangelogItem|1.3.0-9.04425|Added overwrite }} | |||
==See Also== | ==See Also== | ||
Revision as of 07:28, 27 July 2012
This function sets the current blend mode for the dxDraw functions. Changing the blend mode can increase the quality when drawing text or certain other images to a render target. As a general guide use modulate_add when drawing text to a render target, and add when drawing the render target to the screen. Don't forget to restore the default blend at the end.
Syntax
bool dxSetBlendMode( string blendMode )
Required Arguments
- blendMode : The blend mode to use which can be one of:
- blend: The source textures are alpha blended to the screen/render target. The is the default mode for drawing and gives the results we all know and love.
- add: The source textures are added to the screen/render target.
- modulate_add: The source textures are multiplied by the alpha and then added to the screen/render target.
Returns
Returns true if successful, or false if invalid arguments were passed to the function.
Example
--TODO
Requirements
| Minimum server version | n/a |
|---|---|
| Minimum client version | 1.3.0-9.03782 |
Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="1.3.0-9.03782" />
Changelog
| Version | Description |
|---|
| 1.3.0-9.04425 | Added overwrite |
See Also
- dxConvertPixels
- dxCreateFont
- dxCreateRenderTarget
- dxCreateScreenSource
- dxCreateShader
- dxCreateTexture
- dxDrawCircle
- dxDrawImage
- dxDrawImageSection
- dxDrawLine
- dxDrawLine3D
- dxDrawMaterialLine3D
- dxDrawMaterialPrimitive
- dxDrawMaterialPrimitive3D
- dxDrawMaterialSectionLine3D
- dxDrawPrimitive
- dxDrawPrimitive3D
- dxDrawRectangle
- dxDrawText
- dxDrawWiredSphere
- dxGetBlendMode
- dxGetFontHeight
- dxGetMaterialSize
- dxGetPixelColor
- dxGetPixelsSize
- dxGetPixelsFormat
- dxGetStatus
- dxGetTextSize
- dxGetTextWidth
- dxGetTexturePixels
- dxIsAspectRatioAdjustmentEnabled
- dxSetAspectRatioAdjustmentEnabled
- dxSetBlendMode
- dxSetPixelColor
- dxSetRenderTarget
- dxSetShaderValue
- dxSetShaderTessellation
- dxSetShaderTransform
- dxSetTestMode
- dxSetTextureEdge
- dxSetTexturePixels
- dxUpdateScreenSource