📄 overview-summary.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:32 EET 2003 -->
<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<TITLE>
Overview (Mobile 3D Graphics API (M3G))
</TITLE>
<META NAME="keywords" CONTENT="Overview,Mobile 3D Graphics API">
<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
</HEAD>
<SCRIPT>
function asd()
{
parent.document.title="Overview (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="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Overview</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Package</FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Use</FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/microedition/m3g/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">
PREV
NEXT</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="index.html" TARGET="_top"><B>FRAMES</B></A>
<A HREF="overview-summary.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>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->
<HR>
<CENTER>
<H2>
Mobile 3D Graphics API</H2>
</CENTER>
This specification defines the Mobile 3D Graphics API (M3G) for J2ME.
<P>
<B>See:</B>
<BR>
<A HREF="#overview_description"><B>Description</B></A>
<P>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Packages</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="20%"><B><A HREF="javax/microedition/m3g/package-summary.html">javax.microedition.m3g</A></B></TD>
<TD>Defines an API for rendering three-dimensional (3D) graphics at interactive
frame rates, including a scene graph structure and a corresponding file format
for efficient management and deployment of 3D content.</TD>
</TR>
</TABLE>
<P>
<A NAME="overview_description"><!-- --></A>
<P>
<p>This specification defines the Mobile 3D Graphics API (M3G) for J2ME.</p>
<hr>
<h3><a name="Copyright">Copyright Notice and Disclaimers</h3>
<small>
<p><b>Mobile 3D Graphics API Specification ("Specification")</b><br>
<b>Version: 1.0</b><br>
<b>Status: FCS</b><br>
<b>Specification Lead: Nokia Corporation ("Specification Lead")</b><br>
<b>Release: 2003-11-19</b></p>
<p>Copyright 2003 Nokia Corporation.<br>
All rights reserved. </p>
<p><b>NOTICE; LIMITED LICENSE GRANTS</b></p>
<p>Specification Lead hereby grants You a fully-paid, non-exclusive,
non-transferable, worldwide, limited license (without the right to
sublicense), under the Specification Lead's applicable intellectual
property rights to view, download, use and reproduce the Specification
only for the purpose of internal evaluation, which shall be understood
to include developing applications intended to run on an
implementation of the Specification provided that such applications do
not themselves implement any portion(s) of the Specification. The
Specification contains proprietary information of the Specification
Lead and may only be used in accordance with the license terms set
forth herein.</p>
<p>Subject to the reciprocity requirement set forth below
Specification Lead also grants You a perpetual, non-exclusive,
worldwide, fully paid-up, royalty free, irrevocable limited license
(without the right to sublicense) under any applicable copyrights or
patent rights it may have in the Specification to create and/or
distribute an Independent Implementation of the Specification that:
(a) fully implements the Specification without modifying, subsetting
or extending the public class or interface declarations whose names
begin with "java" or "javax" or their equivalents
in any subsequent naming convention adopted by Specification Lead
through the Java Community Process, or any recognized successors or
replacements thereof; (b) implement all required interfaces and
functionality of the Specification; (c) only include as part of such
Independent Implementation the packages, classes or methods specified
by the Specification; (d) pass the technology compatibility kit
("TCK") for such Specification; and (e) are designed to operate on a
Java platform which is certified to pass the complete TCK for such
Java platform. For the purpose of this agreement the applicable
patent rights shall mean any claims for which there is no technically
feasible way of avoiding infringement in the course of implementing
the Specification. Other than this limited license, You acquire no
right, license, title or interest in or to the Specification or any
other intellectual property rights of the Specification Lead.</p>
<p>You need not include limitations (a)-(e) from the previous
paragraph or any other particular "pass through" requirements in any
license You grant concerning the use of Your Independent
Implementation or products derived from it. However, except with
respect to implementations of the Specification (and products derived
from them) by Your licensee that satisfy limitations (a)-(e) from the
previous paragraph, You may neither: (i) grant or otherwise pass
through to Your licensees any licenses under Specification Lead's
applicable intellectual property rights; nor (ii) authorize Your
licensees to make any claims concerning their implementation's
compliance with the Specification in question.</p>
<p>The license provisions concerning the grant of licenses hereunder
shall be subject to reciprocity requirement so that Specification
Lead's grant of licenses shall not be effective as to You if, with
respect to the Specification licensed hereunder, You (on behalf of
yourself and any party for which You are authorized to act with
respect to this Agreement) do not make available, in fact and
practice, to Specification Lead and to other licensees of
Specification on fair, reasonable and non-discriminatory terms a
perpetual, irrevocable, non-exclusive, non-transferable, worldwide
license under such Your (and such party's for which You are authorized
to act with respect to this Agreement) patent rights which are or
would be infringed by all technically feasible implementations of the
Specification to develop, distribute and use an Independent
Implementation of the Specification within the scope of the licenses
granted above by Specification Lead. However, You shall not be
required to grant a license:</p>
<ol>
<p><li>to a licensee not willing to grant a reciprocal license under
its patent rights to You and to any other party seeking such a license
with respect to the enforcement of such licensee's patent claims where
there is no technically feasible alternative that would avoid the
infringement of such claims;</li></p>
<p><li>with respect to any portion of any product and any combinations
thereof the sole purpose or function of which is not required in order
to be fully compliant with the Specification; or</li></p>
<p><li>with respect to technology that is not required for developing,
distributing and using an Independent Implementation.</li></p>
</ol
<p>Furthermore, You hereby grant a non-exclusive, worldwide,
royalty-free, perpetual and irrevocable covenant to Specification Lead
that You shall not bring a suit before any court or administrative
agency or otherwise assert a claim that the Specification Lead has, in
the course of performing its responsibilities as the Specification
Lead under JCP process rules, induced any other entity to infringe
Your patent rights.</p>
<p>For the purposes of this Agreement: "Independent Implementation"
shall mean an implementation of the Specification that neither derives
from the reference implementation to the Specification ("Reference
Implementation") source code or binary code materials nor, except with
an appropriate and separate license from licensor of the Reference
Implementation, includes any of Reference Implementation's source code
or binary code materials.</p>
<p>This Agreement will terminate immediately without notice from
Specification Lead if You fail to comply with any material provision
of or act outside the scope of the licenses granted above.</p>
<p><b>TRADEMARKS</b></p>
<p>Nokia is a registered trademark of Nokia Corporation. Nokia
Corporation's product names are either trademarks or registered
trademarks of Nokia Corporation. Your access to this Specification
should not be construed as granting, by implication, estoppel or
otherwise, any license or right to use any marks appearing in the
Specification without the prior written consent of Nokia Corporation
or Nokia's licensors.</p>
<p>No right, title, or interest in or to any trademarks, service
marks, or trade names of Sun or Sun's licensors, is granted hereunder.
Sun, Sun Microsystems, the Sun logo, Java, J2ME, and the Java Coffee
Cup logo are trademarks or registered trademarks of Sun Microsystems,
Inc. in the U.S. and other countries.</p>
<p><b>DISCLAIMER OF WARRANTIES</b></p>
<p>THE SPECIFICATION IS PROVIDED "AS IS". SPECIFICATION LEAD MAKES NO
REPRESENTATIONS OR WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING
BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, OR NON-INFRINGEMENT, THAT THE CONTENTS OF THE
SPECIFICATION ARE SUITABLE FOR ANY PURPOSE OR THAT ANY PRACTICE OR
IMPLEMENTATION OF SUCH CONTENTS WILL NOT INFRINGE ANY THIRD PARTY
PATENTS, COPYRIGHTS, TRADE SECRETS OR OTHER RIGHTS. This document
does not represent any commitment to release or implement any portion
of the Specification in any product.</p>
<p>THE SPECIFICATION COULD INCLUDE TECHNICAL INACCURACIES OR
TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE
INFORMATION THEREIN; THESE CHANGES WILL BE INCORPORATED INTO NEW
VERSIONS OF THE SPECIFICATION, IF ANY. SPECIFICATION LEAD MAY MAKE
IMPROVEMENTS AND/OR CHANGES TO THE PRODUCT(S) AND/OR THE PROGRAM(S)
DESCRIBED IN THE SPECIFICATION AT ANY TIME. Any use of such changes
in the Specification will be governed by the then-current license for
the applicable version of the Specification.</p>
<p><b>LIMITATION OF LIABILITY</b></p>
<p>TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL SPECIFICATION
LEAD OR ITS LICENSORS BE LIABLE FOR ANY DAMAGES, INCLUDING WITHOUT
LIMITATION, LOST REVENUE, PROFITS OR DATA, OR FOR SPECIAL, INDIRECT,
CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND
REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF OR RELATED TO
ANY FURNISHING, PRACTICING, MODIFYING OR ANY USE OF THE SPECIFICATION,
EVEN IF SPECIFICATION LEAD AND/OR ITS LICENSORS HAVE BEEN ADVISED OF
THE POSSIBILITY OF SUCH DAMAGES.</p>
<p>You will indemnify, hold harmless, and defend Specification Lead
and its licensors from any claims arising or resulting from: (i) Your
use of the Specification; (ii) the use or distribution of Your Java
application, applet and/or clean room implementation; and/or (iii) any
claims that later versions or releases of any Specification furnished
to You are incompatible with the Specification provided to You under
this license.</p>
<p><b>RESTRICTED RIGHTS LEGEND</b></p>
<p>U.S. Government: If this Specification is being acquired by or on
behalf of the U.S. Government or by a U.S. Government prime contractor
or subcontractor (at any tier), then the Government's rights in the
Software and accompanying documentation shall be only as set forth in
this license; this is in accordance with 48 C.F.R. 227.7201 through
227.7202-4 (for Department of Defense (DoD) acquisitions) and with 48
C.F.R. 2.101 and 12.212 (for non-DoD acquisitions).</p>
<p><b>REPORT</b></p>
<p>You may wish to report any ambiguities, inconsistencies or
inaccuracies You may find in connection with Your use of the
Specification ("Feedback"). To the extent that You provide
Specification Lead with any Feedback, You hereby: (i) agree that such
Feedback is provided on a non-proprietary and non-confidential basis,
and (ii) grant Specification Lead a perpetual, non-exclusive,
worldwide, fully paid-up, irrevocable license, with the right to
sublicense through multiple levels of sublicensees, to incorporate,
disclose, and use without limitation the Feedback for any purpose
related to the Specification and future versions, implementations, and
test suites thereof.</p>
</small>
<hr>
<h3>Preface</h3>
<p>This document contains the specification of the Mobile 3D Graphics
API (abbreviated "M3G") for the Java 2 Platform, Micro Edition ("J2ME").
The specification was defined within the Java Community Process ("JCP")
under Java Specification Request 184 ("JSR-184"). The specification is
subject to the terms of the JCP agreements (i.e. JSPA and/or IEPA).
<p>The Mobile 3D Graphics API is an <i>optional package</i>. An
optional package can be adopted to existing J2ME <i>profiles</i>.
A profile of J2ME defines device-type-specific sets of APIs for a
particular vertical market or industry. The main target platform of
this optional API is J2ME/CLDC, used with profiles such as MIDP 1.0 or
MIDP 2.0. However, the API can also be implemented on top of J2ME/CDC,
or any Java platform in general.
<p>Technical details of the API can be found in the <a
href="javax/microedition/m3d/package-summary.html">package
overview</a> and the individual class descriptions; see especially the
<a href="javax/microedition/m3d/Graphics3D.html">Graphics3D</a>
class. To see how the API is used in practice, refer to the <a
href="javax/microedition/m3d/package-summary.html#ExampleMidlets">example
MIDlets</a> at the end of the Package overview.
<p>This specification uses definitions based upon those specified in
RFC 2119 (available on the <a href="http://www.ietf.org">IETF web
site</a>).
<table BORDER CELLPADDING=3 class="Table" >
<tr>
<th>
<div class="TableHead">Term</div>
</th>
<th>
<div class="TableHead">Definition</div>
</th>
</tr>
<tr>
<td>
<div class="TableText">MUST</div>
</td>
<td>
<div class="TableText">The associated definition is an absolute requirement
of this specification.</div>
</td>
</tr>
<tr>
<td>
<div class="TableText">MUST NOT</div>
</td>
<td>
<div class="TableText">The definition is an absolute prohibition of this
specification.</div>
</td>
</tr>
<tr>
<td>
<div class="TableText">SHOULD</div>
</td>
<td>
<div class="TableText">Indicates a recommended practice. There may exist
valid reasons in particular circumstances to ignore this recommendation,
but the full implications must be understood and carefully weighed before
choosing a different course.</div>
</td>
</tr>
<tr>
<td>
<div class="TableText">SHOULD NOT</div>
</td>
<td>
<div class="TableText">Indicates a non-recommended practice. There may
exist valid reasons in particular circumstances when the particular behavior
is acceptable or even useful, but the full implications should be understood
and the case carefully weighed before implementing any behavior described
with this label.</div>
</td>
</tr>
<tr>
<td>
<div class="TableText">MAY</div>
</td>
<td>
<div class="TableText">Indicates that an item is truly optional.</div>
</td>
</tr>
</table>
<h3>Background</h3>
<p>The objective of the Mobile 3D Graphics API Expert Group was to
provide an efficient 3D Graphics API suitable for the J2ME platform,
in particular CLDC/MIDP. The API is targeted at CLDC class of devices
that typically have very little processing power and memory, and no
hardware support for 3D graphics or floating point math. The API has
been defined such that implementations on that kind of hardware are
feasible. However, the API also scales up to higher-end devices
featuring a color display, a DSP, a floating point unit, or even
specialized 3D graphics hardware.
<p>The M3G specification is based on the requirements, summarized below,
that were agreed on by the Expert Group. The rationale for each requirement
is presented in the paragraphs following the summary.</p>
<ul>
<li>
The API <b>must </b>support retained mode access (that is, a scene graph).</li>
<li>
The API <b>must </b>support immediate mode access, with features similar
to OpenGL.</li>
<li>
The API <b>must</b> support mixing and matching of immediate and retained
mode access.</li>
<li>
The API <b>must not</b> include optional parts (that is, all methods must
be implemented).</li>
<li>
The API <b>must</b> have importers for meshes, textures, entire scene graphs,
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -