git_clone/thorvg
1
0
Fork 0
mirror of https://github.com/thorvg/thorvg.git synced 2025-06-08 05:33:36 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 5
thorvg/docs/html/group__ThorVGCapi__Scene.html
Hermet Park 45fd5ffeed doc: updated to v0.8.0
2022-03-08 19:02:56 +09:00

277 lines
16 KiB
HTML
Raw Blame History

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.17"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>ThorVG: Scene</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="doxygen-awesome.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectlogo"><img alt="Logo" src="small_logo.svg"/></td>
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">ThorVG
&#160;<span id="projectnumber">v0.8</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.17 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */</script>
<div id="main-nav"></div>
</div><!-- top -->
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="summary">
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Scene<div class="ingroups"><a class="el" href="group__ThorVG__CAPI.html">ThorVG_CAPI</a></div></div> </div>
</div><!--header-->
<div class="contents">
<p>A module managing the multiple paints as one group paint.
<a href="#details">More...</a></p>
<div class="dynheader">
Collaboration diagram for Scene:</div>
<div class="dyncontent">
<div class="center"><img src="group__ThorVGCapi__Scene.png" border="0" usemap="#group____ThorVGCapi____Scene" alt=""/></div>
<map name="group____ThorVGCapi____Scene" id="group____ThorVGCapi____Scene">
<area shape="rect" href="group__ThorVG__CAPI.html" title="ThorVG C language binding APIs." alt="" coords="5,5,112,31"/>
<area shape="rect" title="A module managing the multiple paints as one group paint." alt="" coords="160,5,221,31"/>
</map>
</div>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:ga7572898d23143d37faa85cc89ad1625e"><td class="memItemLeft" align="right" valign="top">TVG_EXPORT <a class="el" href="group__ThorVG__CAPI.html#ga98af7c3fe18afa8ad65ea6a6e097a292">Tvg_Paint</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__ThorVGCapi__Scene.html#ga7572898d23143d37faa85cc89ad1625e">tvg_scene_new</a> ()</td></tr>
<tr class="memdesc:ga7572898d23143d37faa85cc89ad1625e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates a new scene object. <a href="group__ThorVGCapi__Scene.html#ga7572898d23143d37faa85cc89ad1625e">More...</a><br /></td></tr>
<tr class="separator:ga7572898d23143d37faa85cc89ad1625e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga8b712509a62cf5a3200ecbca53e773d3"><td class="memItemLeft" align="right" valign="top">TVG_EXPORT <a class="el" href="group__ThorVG__CAPI.html#gad980f552658dcbbe42a0168f35c27781">Tvg_Result</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__ThorVGCapi__Scene.html#ga8b712509a62cf5a3200ecbca53e773d3">tvg_scene_reserve</a> (<a class="el" href="group__ThorVG__CAPI.html#ga98af7c3fe18afa8ad65ea6a6e097a292">Tvg_Paint</a> *scene, uint32_t size)</td></tr>
<tr class="memdesc:ga8b712509a62cf5a3200ecbca53e773d3"><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets the size of the container, where all the paints pushed into the scene are stored. <a href="group__ThorVGCapi__Scene.html#ga8b712509a62cf5a3200ecbca53e773d3">More...</a><br /></td></tr>
<tr class="separator:ga8b712509a62cf5a3200ecbca53e773d3"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga16cbf3d1bdd02ebfc5a93c5d03f2d6cf"><td class="memItemLeft" align="right" valign="top">TVG_EXPORT <a class="el" href="group__ThorVG__CAPI.html#gad980f552658dcbbe42a0168f35c27781">Tvg_Result</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__ThorVGCapi__Scene.html#ga16cbf3d1bdd02ebfc5a93c5d03f2d6cf">tvg_scene_push</a> (<a class="el" href="group__ThorVG__CAPI.html#ga98af7c3fe18afa8ad65ea6a6e097a292">Tvg_Paint</a> *scene, <a class="el" href="group__ThorVG__CAPI.html#ga98af7c3fe18afa8ad65ea6a6e097a292">Tvg_Paint</a> *paint)</td></tr>
<tr class="memdesc:ga16cbf3d1bdd02ebfc5a93c5d03f2d6cf"><td class="mdescLeft">&#160;</td><td class="mdescRight">Passes drawing elements to the scene using Tvg_Paint objects. <a href="group__ThorVGCapi__Scene.html#ga16cbf3d1bdd02ebfc5a93c5d03f2d6cf">More...</a><br /></td></tr>
<tr class="separator:ga16cbf3d1bdd02ebfc5a93c5d03f2d6cf"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gaf1c3c73f367274a10b6c1584b2ff55ec"><td class="memItemLeft" align="right" valign="top">TVG_EXPORT <a class="el" href="group__ThorVG__CAPI.html#gad980f552658dcbbe42a0168f35c27781">Tvg_Result</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__ThorVGCapi__Scene.html#gaf1c3c73f367274a10b6c1584b2ff55ec">tvg_scene_clear</a> (<a class="el" href="group__ThorVG__CAPI.html#ga98af7c3fe18afa8ad65ea6a6e097a292">Tvg_Paint</a> *scene, bool free)</td></tr>
<tr class="memdesc:gaf1c3c73f367274a10b6c1584b2ff55ec"><td class="mdescLeft">&#160;</td><td class="mdescRight">Clears a Tvg_Scene objects from pushed paints. <a href="group__ThorVGCapi__Scene.html#gaf1c3c73f367274a10b6c1584b2ff55ec">More...</a><br /></td></tr>
<tr class="separator:gaf1c3c73f367274a10b6c1584b2ff55ec"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>A module managing the multiple paints as one group paint. </p>
<p>As a group, scene can be transformed, translucent, composited with other target paints, its children will be affected by the scene world. </p>
<h2 class="groupheader">Function Documentation</h2>
<a id="gaf1c3c73f367274a10b6c1584b2ff55ec"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf1c3c73f367274a10b6c1584b2ff55ec">&#9670;&nbsp;</a></span>tvg_scene_clear()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TVG_EXPORT <a class="el" href="group__ThorVG__CAPI.html#gad980f552658dcbbe42a0168f35c27781">Tvg_Result</a> tvg_scene_clear </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__ThorVG__CAPI.html#ga98af7c3fe18afa8ad65ea6a6e097a292">Tvg_Paint</a> *&#160;</td>
<td class="paramname"><em>scene</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool&#160;</td>
<td class="paramname"><em>free</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Clears a Tvg_Scene objects from pushed paints. </p>
<p>Tvg_Paint objects stored in the scene are released if <code>free</code> is set to <code>true</code>, otherwise the memory is not deallocated and all paints should be released manually in order to avoid memory leaks.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">scene</td><td>The Tvg_Scene object to be cleared. </td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">free</td><td>If <code>true</code> the memory occupied by paints is deallocated, otherwise it is not.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Tvg_Result enumeration. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">TVG_RESULT_SUCCESS</td><td>Succeed. </td></tr>
<tr><td class="paramname">TVG_RESULT_INVALID_ARGUMENT</td><td>An invalid Tvg_Canvas pointer.</td></tr>
</table>
</dd>
</dl>
<dl class="section warning"><dt>Warning</dt><dd>Please use the <code>free</code> argument only when you know how it works, otherwise it's not recommended. </dd></dl>
</div>
</div>
<a id="ga7572898d23143d37faa85cc89ad1625e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga7572898d23143d37faa85cc89ad1625e">&#9670;&nbsp;</a></span>tvg_scene_new()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TVG_EXPORT <a class="el" href="group__ThorVG__CAPI.html#ga98af7c3fe18afa8ad65ea6a6e097a292">Tvg_Paint</a>* tvg_scene_new </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Creates a new scene object. </p>
<p>A scene object is used to group many paints into one object, which can be manipulated using TVG APIs.</p>
<dl class="section return"><dt>Returns</dt><dd>A new scene object. </dd></dl>
</div>
</div>
<a id="ga16cbf3d1bdd02ebfc5a93c5d03f2d6cf"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga16cbf3d1bdd02ebfc5a93c5d03f2d6cf">&#9670;&nbsp;</a></span>tvg_scene_push()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TVG_EXPORT <a class="el" href="group__ThorVG__CAPI.html#gad980f552658dcbbe42a0168f35c27781">Tvg_Result</a> tvg_scene_push </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__ThorVG__CAPI.html#ga98af7c3fe18afa8ad65ea6a6e097a292">Tvg_Paint</a> *&#160;</td>
<td class="paramname"><em>scene</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__ThorVG__CAPI.html#ga98af7c3fe18afa8ad65ea6a6e097a292">Tvg_Paint</a> *&#160;</td>
<td class="paramname"><em>paint</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Passes drawing elements to the scene using Tvg_Paint objects. </p>
<p>Only the paints pushed into the scene will be the drawn targets. The paints are retained by the scene until the <a class="el" href="group__ThorVGCapi__Scene.html#gaf1c3c73f367274a10b6c1584b2ff55ec" title="Clears a Tvg_Scene objects from pushed paints.">tvg_scene_clear()</a> is called. If you know the number of pushed objects in advance, please call <a class="el" href="group__ThorVGCapi__Scene.html#ga8b712509a62cf5a3200ecbca53e773d3" title="Sets the size of the container, where all the paints pushed into the scene are stored.">tvg_scene_reserve()</a>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">scene</td><td>A Tvg_Paint pointer to the scene object. </td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">paint</td><td>A graphical object to be drawn.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Tvg_Result enumeration. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">TVG_RESULT_SUCCESS</td><td>Succeed. </td></tr>
<tr><td class="paramname">TVG_RESULT_INVALID_ARGUMENT</td><td>A <code>nullptr</code> passed as the argument. </td></tr>
<tr><td class="paramname">TVG_RESULT_MEMORY_CORRUPTION</td><td>An internal error.</td></tr>
</table>
</dd>
</dl>
<dl class="section note"><dt>Note</dt><dd>The rendering order of the paints is the same as the order as they were pushed. Consider sorting the paints before pushing them if you intend to use layering. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__ThorVGCapi__Scene.html#ga8b712509a62cf5a3200ecbca53e773d3" title="Sets the size of the container, where all the paints pushed into the scene are stored.">tvg_scene_reserve()</a> </dd></dl>
</div>
</div>
<a id="ga8b712509a62cf5a3200ecbca53e773d3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8b712509a62cf5a3200ecbca53e773d3">&#9670;&nbsp;</a></span>tvg_scene_reserve()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TVG_EXPORT <a class="el" href="group__ThorVG__CAPI.html#gad980f552658dcbbe42a0168f35c27781">Tvg_Result</a> tvg_scene_reserve </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__ThorVG__CAPI.html#ga98af7c3fe18afa8ad65ea6a6e097a292">Tvg_Paint</a> *&#160;</td>
<td class="paramname"><em>scene</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">uint32_t&#160;</td>
<td class="paramname"><em>size</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Sets the size of the container, where all the paints pushed into the scene are stored. </p>
<p>If the number of objects pushed into the scene is known in advance, calling the function prevents multiple memory reallocation, thus improving the performance.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">scene</td><td>A Tvg_Paint pointer to the scene object. </td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>The number of objects for which the memory is to be reserved.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Tvg_Result enumeration. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">TVG_RESULT_SUCCESS</td><td>Succeed. </td></tr>
<tr><td class="paramname">TVG_RESULT_FAILED_ALLOCATION</td><td>An internal error with a memory allocation. </td></tr>
<tr><td class="paramname">TVG_RESULT_INVALID_ARGUMENT</td><td>An invalid Tvg_Paint pointer. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.17
</small></address>
</body>
</html>
Reference in a new issue View git blame Copy permalink