DxSetTexturePixels: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 12: | Line 12: | ||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
bool dxSetTexturePixels( element texture, string pixels [, int x = 0, int y = 0, int width, int height ] ) | bool dxSetTexturePixels( [ int surfaceIndex, ] element texture, string pixels [, int x = 0, int y = 0, int width, int height ] ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 20: | Line 20: | ||
===Optional Arguments=== | ===Optional Arguments=== | ||
{{New feature/item|4.0130|1.3|4021| | |||
*'''surfaceIndex:''' Desired slice to set if the texture is a volume texture, or desired face to set if the texture is a cube map. <nowiki>(Cube map faces: 0=+X 1=-X 2=+Y 3=-Y 4=+Z 5=-Z)</nowiki> | |||
}} | |||
By default the pixels are set starting at the top left corner of the texture. To set a different region, define a rectangular area using all four of these optional arguments: | By default the pixels are set starting at the top left corner of the texture. To set a different region, define a rectangular area using all four of these optional arguments: | ||
*'''x:''' Rectangle left position | *'''x:''' Rectangle left position | ||
| Line 36: | Line 39: | ||
==Requirements== | ==Requirements== | ||
{{Requirements|n/a|1.3|}} | {{Requirements|n/a|1.3|}} | ||
==Changelog== | |||
{{ChangelogHeader}} | |||
{{ChangelogItem|1.3.0-9.04021|Added surfaceIndex argument}} | |||
==See Also== | ==See Also== | ||
{{Drawing_functions}} | {{Drawing_functions}} | ||
Revision as of 02:57, 22 April 2012
This function sets the pixels of a texture element. It can be used with a standard texture, render target or screen source. Only 'plain' format pixels please.
Performance note:
- This function is slow and not something you want to be doing once a frame.
- It is very slow when setting pixels to a render target or screen source.
- And is very slow indeed if the texture format is not 'argb'
Syntax
bool dxSetTexturePixels( [ int surfaceIndex, ] element texture, string pixels [, int x = 0, int y = 0, int width, int height ] )
Required Arguments
- texture : The texture element to set the pixels of
- pixels : The 'plain' format pixels to use
Optional Arguments
By default the pixels are set starting at the top left corner of the texture. To set a different region, define a rectangular area using all four of these optional arguments:
- x: Rectangle left position
- y: Rectangle top position
- width: Rectangle width
- height : Rectangle height
Returns
Returns a string if successful, false if invalid arguments were passed to the function.
Example
TODO
Requirements
This template will be deleted.
Changelog
| Version | Description |
|---|
| 1.3.0-9.04021 | Added surfaceIndex argument |
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