<HTML> <HEAD> <TITLE>cgD3D9SetUniform</TITLE> <STYLE TYPE="text/css" MEDIA=screen> <!-- BODY { font-family: Arial,Helvetica; } BLOCKQUOTE { margin: 10pt; } H1,A { color: #336699; } /*** Top menu style ****/ .mmenuon { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #ff6600; font-size: 10pt; } .mmenuoff { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #ffffff; font-size: 10pt; } .cpyright { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #ffffff; font-size: xx-small; } .cpyrightText { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #ffffff; font-size: xx-small; } .sections { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #336699; font-size: 11pt; } .dsections { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #336699; font-size: 12pt; } .slink { font-family: Arial,Helvetica; font-weight: normal; text-decoration: none; color: #336699; font-size: 9pt; } .slink2 { font-family: Arial,Helvetica; text-decoration: none; color: #336699; } .maintitle { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #336699; font-size: 18pt; } .dblArrow { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #336699; font-size: small; } .menuSec { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #336699; font-size: small; } .newstext { font-family: Arial,Helvetica; font-size: small; } .linkmenu { font-family: Arial,Helvetica; color: #000000; font-weight: bold; text-decoration: none; } P { font-family: Arial,Helvetica; } PRE { font-family: monospace; white-space: pre; font-color: #333333; font-weight: 100; background-color: #eeeeee; padding: 5px; width: 90%; border-style: solid; border-width: 2px; border-color: #bebebe; } .quote { font-family: Times; text-decoration: none; color: #000000; font-size: 9pt; font-style: italic; } .smstd { font-family: Arial,Helvetica; color: #000000; font-size: x-small; } .std { font-family: Arial,Helvetica; color: #000000; } .meerkatTitle { font-family: sans-serif; font-size: x-small; color: black; } .meerkatDescription { font-family: sans-serif; font-size: 10pt; color: black } .meerkatCategory { font-family: sans-serif; font-size: 9pt; font-weight: bold; font-style: italic; color: brown; } .meerkatChannel { font-family: sans-serif; font-size: 9pt; font-style: italic; color: brown; } .meerkatDate { font-family: sans-serif; font-size: xx-small; color: #336699; } .tocTitle { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #333333; font-size: 10pt; } .toc-item { font-family: Arial,Helvetica; font-weight: bold; color: #336699; font-size: 10pt; text-decoration: underline; } .perlVersion { font-family: Arial,Helvetica; font-weight: bold; color: #336699; font-size: 10pt; text-decoration: none; } .docTitle { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #000000; font-size: 10pt; } .dotDot { font-family: Arial,Helvetica; font-weight: bold; color: #000000; font-size: 9pt; } .docSec { font-family: Arial,Helvetica; font-weight: normal; color: #333333; font-size: 9pt; } .docVersion { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #336699; font-size: 10pt; } .docSecs-on { font-family: Arial,Helvetica; font-weight: normal; text-decoration: none; color: #ff0000; font-size: 10pt; } .docSecs-off { font-family: Arial,Helvetica; font-weight: normal; text-decoration: none; color: #333333; font-size: 10pt; } h3 { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #336699; font-size: small; } h2 { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #336699; font-size: medium; } h1 { font-family: Verdana,Arial,Helvetica; font-weight: bold; text-decoration: none; color: #336699; font-size: large; } DL { font-family: Arial,Helvetica; font-weight: normal; text-decoration: none; color: #333333; font-size: 10pt; } UL > LI > A { font-family: Arial,Helvetica; font-weight: bold; color: #336699; font-size: 10pt; } .moduleInfo { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #333333; font-size: 11pt; } .moduleInfoSec { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #336699; font-size: 10pt; } .moduleInfoVal { font-family: Arial,Helvetica; font-weight: normal; text-decoration: underline; color: #000000; font-size: 10pt; } .cpanNavTitle { font-family: Arial,Helvetica; font-weight: bold; color: #ffffff; font-size: 10pt; } .cpanNavLetter { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #333333; font-size: 9pt; } .cpanCat { font-family: Arial,Helvetica; font-weight: bold; text-decoration: none; color: #336699; font-size: 9pt; } --> </STYLE> </HEAD> <BODY> <object type="application/x-oleobject" classid="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e"> </object> <BLOCKQUOTE> <H1><A NAME="NAME"><A NAME="1">NAME </A></A></H1> <P> <B>cgD3D9SetUniform</B> - set the value of a uniform parameter </P> <H1><A NAME="SYNOPSIS"><A NAME="2">SYNOPSIS </A></A></H1> <PRE> #include <Cg/cgD3D9.h> HRESULT cgD3D9SetUniform( CGparameter param, const void * values ); </PRE> <H1><A NAME="PARAMETERS"><A NAME="3">PARAMETERS </A></A></H1> <DL> <DT><STRONG>param </STRONG></DT> <DD> <P> The parameter whose values are to be set. <B>param</B> must be a uniform parameter that is not a sampler. </P> <DT><STRONG>values </STRONG></DT> <DD> <P> The values to which to set <B>param</B>. The amount of data required depends on the type of parameter, but is always specified as an array of one or more floating point values. The type is <B>void*</B> so a compatible user-defined structure can be passed in without type-casting. Use <A HREF="cgD3D9TypeToSize.html">cgD3D9TypeToSize</A> to determine how many values are required for a particular type. </P> </DD></DL> <H1><A NAME="RETURN_VALUES"><A NAME="4">RETURN VALUES </A></A></H1> <P> Returns <B>D3D_OK</B> if the function succeeds. </P> <P> Returns the D3D failure code if the function fails due to a D3D call. </P> <H1><A NAME="DESCRIPTION"><A NAME="5">DESCRIPTION </A></A></H1> <P> <B>cgD3D9SetUniform</B> sets the value for a uniform parameter. All values should be of type float. There is assumed to be enough values to set all elements of the parameter. </P> <H1><A NAME="EXAMPLES"><A NAME="6">EXAMPLES </A></A></H1> <PRE> // param is a CGparameter handle of type float3 // matrixParam is a CGparameter handle of type float2x3 // arrayParam is a CGparameter handle of type float2x2[3] ... // intialize the data for each parameter D3DXVECTOR3 paramData(1,2,3); float matrixData[2][3] = { 0,1,2, 3,4,5 }; float arrayData[3][2][2] = { 0,1, 2,3, 4,5, 6,7, 8,9, 0,1 }; ... // set the parameters cgD3D9SetUniform(param, paramData); cgD3D9SetUniform(matrixParam, matrixData); // you can use arrays, but you must set the entire array cgD3D9SetUniform(arrayParam, arrayData); </PRE> <H1><A NAME="ERRORS"><A NAME="7">ERRORS </A></A></H1> <P> <B>cgD3D9Failed</B> is generated if a D3D function returns an error. </P> <P> <B>CGD3D9ERR_NODEVICE</B> is returned if a required D3D device is <B>NULL</B>. This usually occurs when an expanded interface routine is called but a D3D device has not been set with <A HREF="cgD3D9SetDevice.html">cgD3D9SetDevice</A>. </P> <P> <B>CGD3D9ERR_NOTLOADED</B> is returned if <B>program</B> was not loaded with the <A HREF="cgD3D9LoadProgram.html">cgD3D9LoadProgram</A>. </P> <P> <B>CGD3D9ERR_NOTUNIFORM</B> is returned if <B>param</B> is not a uniform parameter. </P> <P> <B>CGD3D9ERR_INVALIDPARAM</B> is returned if the parameter fails to set for any other reason. </P> <H1><A NAME="HISTORY"><A NAME="8">HISTORY </A></A></H1> <P> <B>cgD3D9SetUniform</B> was introduced in Cg 1.1. </P> <H1><A NAME="SEE_ALSO"><A NAME="9">SEE ALSO </A></A></H1> <P> <A HREF="cgD3D9SetUniformArray.html">cgD3D9SetUniformArray</A>, <A HREF="cgD3D9SetUniformMatrix.html">cgD3D9SetUniformMatrix</A>, <A HREF="cgD3D9SetUniformMatrixArray.html">cgD3D9SetUniformMatrixArray</A>, <A HREF="cgD3D9TypeToSize.html">cgD3D9TypeToSize</A> </P> </BLOCKQUOTE> </BODY>