File: cs_281.html

package info (click to toggle)
crystalspace 0.94-20020412-3
links: PTS
area: main
in suites: woody
size: 62,276 kB
ctags: 52,843
sloc: cpp: 274,783; ansic: 6,608; perl: 6,276; objc: 3,952; asm: 2,942; python: 2,354; php: 542; pascal: 530; sh: 430; makefile: 370; awk: 193
file content (259 lines) | stat: -rw-r--r-- 7,704 bytes
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- Created by texi2html 1.64 -->
<!-- 
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
            Karl Berry  <karl@freefriends.org>
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
            and many others.
Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
 
-->
<HTML>
<HEAD>
<TITLE>Crystal Space: API Modifications 92</TITLE>

<META NAME="description" CONTENT="Crystal Space: API Modifications 92">
<META NAME="keywords" CONTENT="Crystal Space: API Modifications 92">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="texi2html 1.64">

</HEAD>

<BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">

<A NAME="SEC657"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_280.html#SEC651"> &lt; </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_282.html#SEC668"> &gt; </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_279.html#SEC650"> &lt;&lt; </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_279.html#SEC650"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_285.html#SEC711"> &gt;&gt; </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="index.html#SEC_Top">Top</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_toc.html#SEC_Contents">Contents</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_285.html#SEC711">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<HR SIZE=1>
<H2> C.2 API Changes from 0.90 to 0.92 </H2>
<!--docid::SEC657::-->
<P>

This section documents the major changes between versions 0.90 and 0.92 of of
Crystal Space.
</P><P>

<A NAME="SEC658"></A>
<H3> csInitializer changes </H3>
<!--docid::SEC658::-->
<P>

<CODE>csInitializer::CreateEnvironment()</CODE> now accepts two additional
parameters: <CODE>argc</CODE> and <CODE>argv</CODE>.
Consequently <CODE>csInitializer::SetupKeyboardHandler()</CODE> has been removed.
</P><P>

<A NAME="SEC659"></A>
<H3> iCollideSystem changes </H3>
<!--docid::SEC659::-->
<P>

The <CODE>iCollideSystem::Collide()</CODE> function now accepts
<CODE>csReversibleTransform</CODE> transforms instead of just <CODE>csTransform</CODE>.
</P><P>

<A NAME="SEC660"></A>
<H3> Texture Manager Changes </H3>
<!--docid::SEC660::-->
<P>

The following deregistration functions have been removed.  Instead, use the
normal <CODE>DecRef()</CODE> mechanism.
</P><P>

<UL>
<LI>
<CODE>iTextureManager::UnregisterTexture()</CODE>
<LI>
<CODE>iTextureManager::UnregisterMaterial()</CODE>
</UL>
<P>

<A NAME="SEC661"></A>
<H3> iRegion </H3>
<!--docid::SEC661::-->
<P>

The functions <CODE>iRegion::Find<small>...</small>()</CODE> will no longer increase
the reference count of the returned objects.
</P><P>

<A NAME="SEC662"></A>
<H3> GetThingState </H3>
<!--docid::SEC662::-->
<P>

<CODE>iEngine::GetThingState()</CODE> has not been removed but this function
is now deprecated. It is recommended that you get the <CODE>iMeshObjectType</CODE>
for the thing mesh objects the usual way (i.e. by loading the plugin).
</P><P>

<A NAME="SEC663"></A>
<H3> iThingState </H3>
<!--docid::SEC663::-->
<P>

The following functions were made <CODE>const</CODE> in <CODE>iThingState</CODE>:
<UL>
<LI>
<CODE>CurveTexel()</CODE>
<LI>
<CODE>CurveVertex()</CODE>
<LI>
<CODE>GetCurveVertices()</CODE>
<LI>
<CODE>GetCurveVertexCount()</CODE>
<LI>
<CODE>GetCurveCount()</CODE>
<LI>
<CODE>GetCurvesScale()</CODE>
<LI>
<CODE>GetMovingOption()</CODE>
<LI>
<CODE>GetPortalCount()</CODE>
<LI>
<CODE>GetPortal()</CODE>
<LI>
<CODE>GetPortalPolygon()</CODE>
<LI>
<CODE>GetVertexCount()</CODE>
</UL>
<P>

Renamed two functions in <CODE>iThingState</CODE>:
</P><P>

<UL>
<LI>
<CODE>CurveVertex()</CODE> to <CODE>GetCurveVertex()</CODE>
<LI>
<CODE>CurveTexel()</CODE> to <CODE>GetCuveTexel()</CODE>
</UL>
<P>

Added several functions to <CODE>iThingState</CODE>:
</P><P>

<UL>
<LI>
<CODE>FindPolygonIndex()</CODE>
<LI>
<CODE>RemovePolygon()</CODE>
<LI>
<CODE>RemovePolygons()</CODE>
<LI>
<CODE>SetVertex()</CODE>
<LI>
<CODE>DeleteVertex()</CODE>
<LI>
<CODE>DeleteVertices()</CODE>
<LI>
<CODE>SetCurveVertex()</CODE>
<LI>
<CODE>SetCurveTexel()</CODE>
<LI>
<CODE>ClearCurveVertices()</CODE>
<LI>
<CODE>FindCurveIndex()</CODE>
<LI>
<CODE>RemoveCurve()</CODE>
<LI>
<CODE>RemoveCurves()</CODE>
</UL>
<P>

<A NAME="SEC664"></A>
<H3> Isometric Engine </H3>
<!--docid::SEC664::-->
<P>

Added <CODE>iIsoEngine::GetMaterialList()</CODE> and removed all other
material functions from <CODE>iIsoEngine</CODE> except the one to create a material
from a VFS path.
</P><P>

Added <CODE>iIsoEngine::GetMeshFactories()</CODE> and removed the following
functions.
</P><P>

<UL>
<LI>
<CODE>AddMeshFactory()</CODE>
<LI>
<CODE>FindMeshFactory()</CODE>
<LI>
<CODE>RemoveMeshFactory()</CODE>
</UL>
<P>

<A NAME="SEC665"></A>
<H3> Terrain Mesh Object </H3>
<!--docid::SEC665::-->
<P>

Changed <CODE>iTerrFuncState::LoadMaterialGroup()</CODE> so that the first
parameter is now a material list (<CODE>iMaterialList</CODE>) instead of
<CODE>iEngine</CODE>.
</P><P>

<A NAME="SEC666"></A>
<H3> Loader and Saver Plugins </H3>
<!--docid::SEC666::-->
<P>

Changed <CODE>iLoaderPlugin::Parse()</CODE> to accept a material list and mesh
factory list (<CODE>iMaterialList</CODE> and <CODE>iMeshFactoryList</CODE>) instead of an
<CODE>iEngine</CODE> instance.
</P><P>

Changed <CODE>iSaverPlugin::WriteDown()</CODE> so that it no longer has
the <CODE>iEngine</CODE> parameter.
</P><P>

<A NAME="SEC667"></A>
<H3> iMeshObject and iMeshObjectFactory Changes </H3>
<!--docid::SEC667::-->
<P>

Added <CODE>SetLogicalParent()</CODE> and <CODE>GetLogicalParent()</CODE> to
both <CODE>iMeshObject</CODE> and <CODE>iMeshObjectFactory</CODE>. This should
be no issue for applications simply using mesh objects but it is an
issue if you made your own mesh object implementation. Also beware
that there have been some changes in the way the parser interact
with the plugin loaders. The plugin loaders are no longer responsible
for setting the factory pointer. The parser will now do that.
</P><P>

<A NAME="API Modifications 90"></A>
<HR SIZE=1>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_280.html#SEC651"> &lt; </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_282.html#SEC668"> &gt; </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_279.html#SEC650"> &lt;&lt; </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_279.html#SEC650"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_285.html#SEC711"> &gt;&gt; </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="index.html#SEC_Top">Top</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_toc.html#SEC_Contents">Contents</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_285.html#SEC711">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<BR>  
<FONT SIZE="-1">
This document was generated

using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>

</BODY>
</HTML>