📄 vertexbuffer.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc on Thu Nov 27 13:54:36 EET 2003 -->
<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<TITLE>
VertexBuffer (Mobile 3D Graphics API (M3G))
</TITLE>
<META NAME="keywords" CONTENT="javax.microedition.m3g.VertexBuffer,VertexBuffer class">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
</HEAD>
<SCRIPT>
function asd()
{
parent.document.title="VertexBuffer (Mobile 3D Graphics API (M3G))";
}
</SCRIPT>
<BODY BGCOLOR="white" onload="asd();">
<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_top"><!-- --></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A><TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/VertexBuffer.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<EM><B>Nov 19, 2003</B></EM></EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/microedition/m3g/VertexArray.html"><B>PREV CLASS</B></A>
<A HREF="../../../javax/microedition/m3g/World.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
<A HREF="VertexBuffer.html" TARGET="_top"><B>NO FRAMES</B></A>
<SCRIPT> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>'); } //--></SCRIPT><NOSCRIPT><A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A></NOSCRIPT></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
javax.microedition.m3g</FONT>
<BR>
Class VertexBuffer</H2>
<PRE>
java.lang.Object
|
+--<A HREF="../../../javax/microedition/m3g/Object3D.html">javax.microedition.m3g.Object3D</A>
|
+--<B>javax.microedition.m3g.VertexBuffer</B>
</PRE>
<HR>
<DL>
<DT>public class <B>VertexBuffer</B><DT>extends <A HREF="../../../javax/microedition/m3g/Object3D.html">Object3D</A></DL>
<P>
<p>VertexBuffer holds references to VertexArrays that contain the positions,colors, normals, and texture coordinates for a set of vertices. The elementsof these arrays are called <i>vertex attributes</i> in the rest of thisdocumentation. The structure of a VertexBuffer object is shown in the figurebelow.</p><center><img src="./doc-files/VertexBuffer-components.png"/></center><p>There can be at most one position array, one color array, and one normalarray in a VertexBuffer. The number of texture coordinate arrays, however, canbe anything between zero and the number of texturing units supported by theimplementation, which can be queried with <A HREF="../../../javax/microedition/m3g/Graphics3D.html#getProperties()"><CODE>getProperties</CODE></A>.</p><p>All vertex attribute arrays must be the same length; this is enforced bythe <code>set</code> methods. The first array that is added to a previouslyempty VertexBuffer can have any number of elements. This is also the case ifthe sole previously set array is replaced with another. Any subsequentlyadded arrays must have the same length as the first.</p><p>Vertex positions, texture coordinates, and normals are interpreted ashomogeneous (4D) coordinates, where the fourth component is implicitly 1for positions and texcoords, and 0 for normals. In other words, positionsand texcoords are interpreted as 3D points, whereas normals are treated as3D vectors. In the case of 2D texcoords, the third component is implicitlyzero.</p><p>3D texture coordinates are supported, even though 3D texture maps are not.This allows some clever rendering tricks, such as cheap environment mappingby using normal vectors as texture coordinates.</p><h3>Deferred exceptions</h3><p>All vertex attribute arrays are initialized to null. The application canalso set them to null at any time. This is a completely legal state, as longas the VertexBuffer is not rendered or tested for intersection with a pickray. When rendering, null vertex attributes are treated as follows:</p><ul><li>If the position array is null, an exception is thrown.</li><li>If the normal array is null, and lighting is enabled, an exception is thrown.</li><li>If a texcoord array is null, and the corresponding texturing unit is enabled, an exception is thrown.</li><li>If the color array is null, the <A HREF="../../../javax/microedition/m3g/VertexBuffer.html#setDefaultColor(int)">default</A> color is used instead.</li></ul><p>Lighting can be disabled for a submesh by setting a null Material inAppearance. Similarly, a particular texturing unit can be turned off bysetting its Texture2D to null.</p><p>When picking, null vertex attributes are treated as follows:</p><ul><li>If the position array is null, an exception is thrown.</li><li>If the normal array is null, the returned normal is undefined.</li><li>If a texcoord array is null, the returned texcoords are undefined.</li></ul><p>The color array and the default color are ignored when picking.</p>
<P>
<P>
<DL>
<DT><B>See Also:</B><DD><a href="../../../file-format.html#VertexBuffer">Binary format</a></DL>
<HR>
<P>
<!-- ======== NESTED CLASS SUMMARY ======== -->
<!-- =========== FIELD SUMMARY =========== -->
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<A NAME="constructor_summary"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Constructor Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../javax/microedition/m3g/VertexBuffer.html#VertexBuffer()">VertexBuffer</A></B>()</CODE>
<BR>
Constructs an empty vertex buffer, with all vertex attributes set to null. </TD>
</TR>
</TABLE>
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Method Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/microedition/m3g/VertexArray.html">VertexArray</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/m3g/VertexBuffer.html#getColors()">getColors</A></B>()</CODE>
<BR>
Gets the current color array, or null if per-vertex colors are not set.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/m3g/VertexBuffer.html#getDefaultColor()">getDefaultColor</A></B>()</CODE>
<BR>
Retrieves the default color of this VertexBuffer.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/microedition/m3g/VertexArray.html">VertexArray</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/m3g/VertexBuffer.html#getNormals()">getNormals</A></B>()</CODE>
<BR>
Gets the current normal vector array, or null if normals are not set.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/microedition/m3g/VertexArray.html">VertexArray</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/m3g/VertexBuffer.html#getPositions(float[])">getPositions</A></B>(float[] scaleBias)</CODE>
<BR>
Returns the current vertex position array, or null if positions are not set. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../javax/microedition/m3g/VertexArray.html">VertexArray</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/m3g/VertexBuffer.html#getTexCoords(int, float[])">getTexCoords</A></B>(int index, float[] scaleBias)</CODE>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -