This page is incomplete! Help wanted!

Please finish this page using the corresponding Old Wiki article.
Go to Contribution guidelines for more information.

---

This function applies a shader to one or more world textures.

Tip

The resource shader_tex_names can help in finding the names of world textures. When replacing the texture for a ped using the CJ skin, set textureName to "CJ" The shader inherits the render states of the original when it is drawn, so texture stage 0 will already be set to the original texture. When using with a 'ped', ensure you have set 'ped' or 'all' in the elementTypes when calling dxCreateShader CJ body parts textures can be replaced by using: "cj_ped_head", "cj_ped_hat", "cj_ped_torso", "cj_ped_legs", "cj_ped_feet", "cj_ped_glasses", "cj_ped_necklace", "cj_ped_watch" and "cj_ped_extra1". Latest version of shader_tex_names will show what is being used.

Syntax

 engineApplyShaderToWorldTexture ( )

Code Examples

Example 1 Example 2 Example 3 Example 4

client

This example will replace the texture of a group of common explosions (grenades, rockets, etc) with a custom explosion effect

theTechnique = dxCreateShader("shader.fx")
explosionTexture = dxCreateTexture( "tex/Explosion.png")

function replaceEffect()
  engineApplyShaderToWorldTexture(theTechnique, "fireball6")
  dxSetShaderValue (theTechnique, "gTexture", explosionTexture)
end
addEventHandler("onClientResourceStart", resourceRoot, replaceEffect)

client

This example will apply a shader to the "des_logwall" world texture (which is used by the house near the 'play' gamemode spawn point)

theTechnique = dxCreateShader("shader.fx")
engineApplyShaderToWorldTexture(theTechnique, "des_logwall")

client

This example will apply a shader to the current vehicle of the local player

theTechnique = dxCreateShader( "shader.fx" )

function applyShader(thePlayer, seat)
local theVehicle = source

  if seat == 0 and thePlayer == localPlayer then
    engineApplyShaderToWorldTexture(theTechnique, "vehiclegrunge256", theVehicle)
    engineApplyShaderToWorldTexture(theTechnique, "?emap*", theVehicle)
  end
end
addEventHandler("onClientVehicleEnter", root, applyShader)

function removeShader(thePlayer, seat)
local theVehicle = source

  if seat == 0 and thePlayer == localPlayer then
          engineRemoveShaderFromWorldTexture(theTechnique, "vehiclegrunge256", theVehicle)
          engineRemoveShaderFromWorldTexture(theTechnique, "?emap*", theVehicle)
  end
end
addEventHandler("onClientVehicleExit", root, removeShader)

client

Basic texture replacement shader example (compatible with all script examples on this page):

texture gTexture;

technique TexReplace
{
    pass P0
    {
        Texture[0] = gTexture;
    }
}

See Also

Engine Functions

• engineAddClothingModel
• engineAddClothingTXD
• engineAddImage
• engineApplyShaderToWorldTexture
• engineFreeModel
• engineFreeTXD
• engineGetModelFlags
• engineGetModelIDFromName
• engineGetModelLODDistance
• engineGetModelNameFromID
• engineGetModelPhysicalPropertiesGroup
• engineGetModelTextureNames
• engineGetModelTextures
• engineGetModelTXDID
• engineGetModelVisibleTime
• engineGetObjectGroupPhysicalProperty
• engineGetPoolCapacity
• engineGetPoolDefaultCapacity
• engineGetPoolUsedCapacity
• engineGetSurfaceProperties
• engineGetVisibleTextureNames
• engineImageGetFile
• engineImageGetFiles
• engineImageGetFilesCount
• engineImageLinkDFF
• engineImageLinkTXD
• engineImportTXD
• engineLoadCOL
• engineLoadDFF
• engineLoadIFP
• engineLoadIMG
• engineLoadTXD
• enginePreloadWorldArea
• engineRemoveImage
• engineRemoveShaderFromWorldTexture
• engineReplaceAnimation
• engineReplaceCOL
• engineReplaceModel
• engineRequestModel
• engineRequestTXD
• engineResetModelFlags
• engineResetModelLODDistance
• engineResetModelTXDID
• engineResetSurfaceProperties
• engineRestoreAnimation
• engineRestoreCOL
• engineRestoreDFFImage
• engineRestoreModel
• engineRestoreModelPhysicalPropertiesGroup
• engineRestoreObjectGroupPhysicalProperties
• engineRestoreTXDImage
• engineRestreamWorld
• engineSetAsynchronousLoading
• engineSetModelFlag
• engineSetModelFlags
• engineSetModelLODDistance
• engineSetModelPhysicalPropertiesGroup
• engineSetModelTXDID
• engineSetModelVisibleTime
• engineSetObjectGroupPhysicalProperty
• engineSetPoolCapacity
• engineSetSurfaceProperties
• engineStreamingFreeUpMemory
• engineStreamingGetBufferSize
• engineStreamingGetMemorySize
• engineStreamingGetModelLoadState
• engineStreamingGetUsedMemory
• engineStreamingReleaseModel
• engineStreamingRequestModel
• engineStreamingRestoreBufferSize
• engineStreamingRestoreMemorySize
• engineStreamingSetBufferSize
• engineStreamingSetMemorySize
• engineStreamingSetModelCacheLimits

Engine Elements

• col
• dff
• txd

Reference

• Scripting Functions