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 creates a shader element that can be used in the dxDraw functions. Successful shader creation is not guaranteed unless the Effect File contains a fallback technique which will work on every existing PC.

Note

It is highly recommended that dxSetTestMode is used when writing and testing scripts using dxCreateShader.

Syntax

 dxCreateShader ( )

Code Examples

Example 1 Example 2 Example 3

client

addEventHandler( "onClientRender", root,
    function()
        if myShader then
            dxDrawImage( 100, 350, 300, 350, myShader )
        end
    end
)

-- Use 'toggle' command to switch shader on and off
addCommandHandler( "toggle",
    function()
        if not myShader then
            myShader = dxCreateShader( "fancything.fx" )  -- Create shader
        else
            destroyElement( myShader )                    -- Destroy shader
            myShader = nil
        end
    end
)

client

This example creates basic shader from raw data (without i/o) on resource start:

local myShader_raw_data = [[
  texture tex;
  technique replace {
    pass P0 {
      Texture[0] = tex;
    }
  }
]]

addEventHandler("onClientResourceStart", resourceRoot, function()
  local myShader = dxCreateShader(myShader_raw_data) -- create shader from raw data
  if isElement(myShader) then
    local myTexture = dxCreateTexture("some_image.png") -- create texture from image file
    if isElement(myTexture) then
      -- apply image to world texture via shader
      dxSetShaderValue(myShader, "tex", myTexture)
      engineApplyShaderToWorldTexture(myShader, "shad_ped")
    else
      outputDebugString("Unable to load texture", 1)
    end
  else
    outputDebugString("Unable to create shader", 1)
  end
end)

client

This example creates a basic shader using macros to change shader's behaviour:

local shaderRawStr = [[
    texture MACRO_TEX_NAME;

    technique simple
    {
        pass P0
        {
            //-- Set up texture stage 0
            Texture[0] = MACRO_TEX_NAME;
      ColorOp[0] = SelectArg1;
  #ifdef MACRO_FIRST_ARG
      ColorArg1[0] = Texture;
  #else
      ColorArg1[0] = Diffuse;
  #endif
      AlphaOp[0] = SelectArg1;
      AlphaArg1[0] = Texture;

            //-- Disable texture stage 1
            ColorOp[1] = Disable;
            AlphaOp[1] = Disable;
        }
    }
]]

addEventHandler( "onClientResourceStart", resourceRoot,
    function ( )
        local shader, tech = dxCreateShader( shaderRawStr,  { MACRO_TEX_NAME = "Tex0",  MACRO_FIRST_ARG = true } )
        if not shader or tech ~= "simple" then
            outputDebugString( "An error was occured" )
      return
        end

        local texture = dxCreateTexture( "test.png" )
        if not texture then
      outputDebugString( "An error was occured" )
      return
  end

  dxSetShaderValue( shader, "Tex0", texture )

  addEventHandler( "onClientRender", root,
      function()
          dxDrawImage( 0, 0, 500, 500, shader )
      end
  , false )
    end
, false )

See Also

Drawing Functions

• dxConvertPixels
• dxCreateFont
• dxCreateRenderTarget
• dxCreateScreenSource
• dxCreateShader
• dxCreateTexture
• dxDrawCircle
• dxDrawImage
• dxDrawImageSection
• dxDrawLine
• dxDrawLine3D
• dxDrawMaterialLine3D
• dxDrawMaterialPrimitive
• dxDrawMaterialPrimitive3D
• dxDrawMaterialSectionLine3D
• dxDrawModel3D
• dxDrawPrimitive
• dxDrawPrimitive3D
• dxDrawRectangle
• dxDrawText
• dxDrawWiredSphere
• dxGetBlendMode
• dxGetFontHeight
• dxGetMaterialSize
• dxGetPixelColor
• dxGetPixelsFormat
• dxGetPixelsSize
• dxGetStatus
• dxGetTextSize
• dxGetTexturePixels
• dxGetTextWidth
• dxIsAspectRatioAdjustmentEnabled
• dxSetAspectRatioAdjustmentEnabled
• dxSetBlendMode
• dxSetPixelColor
• dxSetRenderTarget
• dxSetShaderTessellation
• dxSetShaderTransform
• dxSetShaderValue
• dxSetTestMode
• dxSetTextureEdge
• dxSetTexturePixels
• dxUpdateScreenSource

Drawing Elements

• dx-font
• shader
• texture

Reference

• Scripting Functions