Merge "docs: rs link fixes" into ics-mr0

      <ol>

        <li>

          <a href="#developing">Developing a RenderScript application</a>

          <a href="#creating-graphics-rs">Creating a Graphics Renderscript</a>

          <ol>

            <li><a href="#creating-native">Creating the native Renderscript file</a></li>

            <li><a href="#creating-entry">Creating the Renderscript entry point class</a></li>

            <li><a href="#creating-view">Creating the surface view</a></li>

            <li><a href="#creating-activity">Creating the activity</a></li>

          </ol>

        </li>

        <li>

          <a href="#drawing">Drawing</a>

          <ol>

            <li><a href="#hello-graphics">The Hello Graphics application</a></li>

            <li><a href="#drawing-rsg">Drawing using the rsgDraw functions</a></li>

            <li><a href="#drawing-mesh">Drawing with a mesh</a></li>

          </ol>

        </li>

        <li>

          <a href="#shaders">Shaders</a>

          <ol>

            <li><a href="#shader-bindings">Shader bindings</a></li>

            <li><a href="#shader-sampler">Defining a sampler</a></li>

          </ol>

        </li>

      </ol>

  will need to be familiar with APIs to appropriately render 3D graphics on an Android-powered

  device.</p>

  <h2>Creating a Graphics RenderScript</h2>

  <h2 id="creating-graphics-rs">Creating a Graphics RenderScript</h2>

  <p>Because of the various layers of code when writing a RenderScript application, it is useful to

  create the following files for a scene that you want to render:</p>

  RenderScript sample that is provided in the SDK as a guide (some code has been modified from its

  original form for simplicity).</p>

  <h3>Creating the native RenderScript file</h3>

  <h3 id="creating-native">Creating the native RenderScript file</h3>

  <p>Your native RenderScript code resides in a <code>.rs</code> file in the

  <code>&lt;project_root&gt;/src/</code> directory. You can also define <code>.rsh</code> header

      enough or more resources to do so, and renders as fast as it can if it does not.</p>

      <p>For more

      information on using the RenderScript graphics functions, see <a href=

      "using-graphics-api">Using the Graphics APIs</a>.</p>

      information on using the RenderScript graphics functions, see the <a href=

      "#drawing">Drawing</a> section.</p>

    </li>

    <li>An <code>init()</code> function. This allows you to do any initialization of your

}

</pre>

  <h3>Creating the RenderScript entry point class</h3>

  <h3 id="creating-entry">Creating the RenderScript entry point class</h3>

  <p>When you create a RenderScript (<code>.rs</code>) file, it is helpful to create a

  corresponding Android framework class that is an entry point into the <code>.rs</code> file. In

</pre>

  <h3>Creating the surface view</h3>

  <h3 id="creating-view">Creating the surface view</h3>

  <p>To create a surface view to render graphics on, create a class that extends {@link

  android.renderscript.RSSurfaceView}. This class also creates a RenderScript context object

</pre>

  <h3>Creating the Activity</h3>

  <h3 id="creating-activity">Creating the Activity</h3>

  <p>Applications that use RenderScript still adhere to activity lifecyle, and are part of the same

  view hierarchy as traditional Android applications, which is handled by the Android VM. This

}

</pre>

  <h2>Drawing</h2>

  <h3>Drawing using the rsgDraw functions</h3>

  <h2 id="drawing">Drawing</h2>

  <p>The following sections describe how to use the graphics functions to draw with Renderscript.</p>

  <h3 id="drawing-rsg">Drawing using the rsgDraw functions</h3>

  <p>The native RenderScript APIs provide a few convenient functions to easily draw a polygon to

  the screen. You call these in your <code>root()</code> function to have them render to the

    the screen.</li>

  </ul>

  <h3>Drawing with a mesh</h3>

  <h3 id="drawing-mesh">Drawing with a mesh</h3>

  <p>When you want to draw complex shapes and textures to the screen, instantiate a {@link

  android.renderscript.Mesh} and draw it to the screen with <code>rsgDrawMesh()</code>. A {@link

  "{@docRoot}resources/samples/RenderScript/MiscSamples/src/com/example/android/rs/miscsamples/RsRenderStatesRS.html">

  RsRenderStatesRS</a> sample has many examples on how to create a shader without writing GLSL.</p>

  <h3>Shader bindings</h3>

  <h3 id="shader-bindings">Shader bindings</h3>

  <p>You can also set four pragmas that control the shaders' default bindings to the {@link

  android.renderscript.RenderScriptGL} context when the script is executing:</p>

#pragma stateStore(parent)

</pre>

  <h3>Defining a sampler</h3>

  <h3 id="shader-sampler">Defining a sampler</h3>

  <p>A {@link android.renderscript.Sampler} object defines how data is extracted from textures.

  Samplers are bound to Program objects (currently only a Fragment Program) alongside the texture