<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Warnings and Gotchas of using ClanLib - ClanLib Game SDK</title>
<link rel="stylesheet" type="text/css" href="../../default.css">
</head>
<body style="background-color: #a4daea; color: black; margin: 1em 3em 1em 3em;">
<div style="border-style: solid; border-width:thin; border-color: black;">
<div style="background-color: white; color: black; padding: .3em 1em .3em 1em; border-bottom-style: dotted; border-bottom-width: 2px;">
<table cellspacing="0" cellpadding="0" border="0" width="100%">
<tr>
<td align="center">
<h1>
<a href="http://www.clanlib.org"><img style="border-style: none; padding-right: 130px;" src="../../gfx/clanlib.png" alt="ClanLib"></a>
</h1>
</td>
</tr>
</table>
<!--<div class="menu">
<a href="index.html">News</a>
<a href="intro.html">About</a>
<a href="download.html">Download</a>
<a href="cvs.html">CVS</a>
<a class="active" href="docs.html">Docs</a>
<a href="games.html">Games</a>
<a href="contact.html">Contact</a>
<a href="links.html">Links</a>
</div>-->
</div>
<div style="background-color: white; padding: 1em 3em 1em 3em;">
<!-- clanlib header end -->
<div style="border-bottom-style: dotted; border-bottom-width: 1px; margin-bottom: 1em;"><h2>Warnings and Gotchas of using ClanLib</h2></div>
<h1>OUTDATED</h1>
<div style="border-bottom-style: dotted; border-bottom-width: 1px;"><h2>Abstract:</h2></div>
<p>This document covers all issues about ClanLib safely and correctly</p>
<div style="border-bottom-style: dotted; border-bottom-width: 1px;"><h3>Creating destroying objects</h3></div>
<p>All objects must both created AND destroyed inside their respective ::init() and ::deinit() groups. This means that letting an object fall out of scope might not work, especially in CL_Application::main().<p>
<ul><pre><font face="Arial,Courier New,Courier">...
Do_Bar()
{
CL_SetupSound::init();
CL_SoundBuffer *soundbuffer = CL_Sample::create("beep.wav",NULL);
CL_SoundBuffer_Session ses = soundbuffer->play();
...
delete soundbuffer; // Good
CL_SetupSound::deinit(); //All user objects must be destroyed before now
} //ses destroyed here, very bad
</font></pre></ul>
<p> In this code ses is destroyed when it goes out of scope, which is after it should be destroyed. A better solution to this problem would be either wrap Do_Bar in some other function. eg<p>
<ul><pre><font face="Arial,Courier New,Courier">
init_sound() {
CL_SetupSound::init();
Do_Bar();
CL_SetupSound::deinit();
}
Do_Bar() {
CL_SoundBuffer *soundbuffer = CL_Sample::create("beep.wav",NULL);
CL_SoundBuffer_Session ses = soundbuffer->play(); //Ok here
...
delete soundbuffer; // Good
}
</font></pre></ul>
<p> The code above is perfectly safe as ses is destroy when Do_Bar goes out of scope which is before deinit(). Another way is to use pointers.</p>
<!-- clanlib footer begin -->
<div style="margin-top: 0em; text-align: center; color: #a0a0a0; border-top-style: dotted; border-top-width: 1px;">
Questions or comments, write to the <a href="http://clanlib.org/contact.html">ClanLib mailing list</a>.
</div>
</div>
</div>
</body>
</html>
distrib
>
Mageia
>
7
>
i586
>
media
>
core-release
>
by-pkgid
>
a2116f36018873d572acbcadddb8e994
>
files
>
45
