cathegories for docs
[sdlgit/SDL-Site.git] / pages / SDL-Surface.html-inc
CommitLineData
162a0989 1<div class="pod">
2<!-- INDEX START -->
3<h3 id="TOP">Index</h3>
4
5<ul><li><a href="#NAME">NAME</a></li>
6<li><a href="#SYNOPSIS">SYNOPSIS</a></li>
7<li><a href="#DESCRIPTION">DESCRIPTION</a></li>
8<li><a href="#METHODS">METHODS</a>
9<ul><li><a href="#new_flags_width_height_depth_Rmask_G">new ( flags, width, height, depth, Rmask, Gmask, Bmask, Amask )</a></li>
10<li><a href="#new_from_surface_width_height_depth_">new_from ( surface, width, height, depth, Rmask, Gmask, Bmask, Amask )</a>
11<ul><li><a href="#Construtor_Parameters">Construtor Parameters</a></li>
12</ul>
13</li>
14<li><a href="#w">w</a></li>
15<li><a href="#h">h</a></li>
16</ul>
17</li>
18<li><a href="#SEE_ALSO">SEE ALSO</a>
19</li>
20</ul><hr />
21<!-- INDEX END -->
22
23<h1 id="NAME">NAME</h1><p><a href="#TOP" class="toplink">Top</a></p>
24<div id="NAME_CONTENT">
25<p>SDL::Surface - Graphic surface structure. Access to <code>SDL_Surface</code>.</p>
26
27</div>
28<h1 id="SYNOPSIS">SYNOPSIS</h1><p><a href="#TOP" class="toplink">Top</a></p>
29<div id="SYNOPSIS_CONTENT">
30<p>The main surface (display) is provided by <cite>SDL::Video::set_video_mode</cite>.
31 use SDL; #provides flags &amp; constants
32 use SDL::Video; #provides access to set_video_mode
33 use SDL::Surface; #provides access to SDL_Surface struct internals</p>
34<pre> SDL::init(SDL_INIT_VIDEO);
35 my $display = SDL::Video::set_video_mode();
36
37</pre>
38<p>All surfaces constructed from now on are attached to the $display. There are two constructors available to do this.</p>
39<pre> my $surface = SDL::Surface-&gt;new ( ... );
40 my $surface2 = SDL::Surface-&gt;new_from ( surface, ... );
41
42</pre>
43
44</div>
45<h1 id="DESCRIPTION">DESCRIPTION</h1><p><a href="#TOP" class="toplink">Top</a></p>
46<div id="DESCRIPTION_CONTENT">
47<p>An <code>SDL_Surface</code> defines a surfaceangular area of pixels.</p>
48
49</div>
50<h1 id="METHODS">METHODS</h1><p><a href="#TOP" class="toplink">Top</a></p>
51<div id="METHODS_CONTENT">
52
53</div>
54<h2 id="new_flags_width_height_depth_Rmask_G">new ( flags, width, height, depth, Rmask, Gmask, Bmask, Amask )</h2>
55<div id="new_flags_width_height_depth_Rmask_G-2">
56<p>The constructor creates a new surface with the specified parameter values.</p>
57<pre> my $surface = SDL::Surface-&gt;new( ... );
58
59</pre>
60
61</div>
62<h2 id="new_from_surface_width_height_depth_">new_from ( surface, width, height, depth, Rmask, Gmask, Bmask, Amask )</h2>
63<div id="new_from_surface_width_height_depth_-2">
64<p>The constructor creates a new surface with the specified parameter values. </p>
65<pre> my $surface = SDL::Surface-&gt;new_from( $old_surface, ... );
66
ecabf8b7 67
68
69
162a0989 70</pre>
162a0989 71
72</div>
73<h3 id="Construtor_Parameters">Construtor Parameters</h3>
74<div id="Construtor_Parameters_CONTENT">
75
76
77
78
79
80
81
82
83</div>
84<h2 id="w">w</h2>
85<div id="w_CONTENT">
86<p>SDL::Surface width are defined at construction. Thus the following is read only. </p>
87<pre> my $w = $surface-&gt;w;
88
89</pre>
90
91</div>
92<h2 id="h">h</h2>
93<div id="h_CONTENT">
94<p>SDL::Surface height are defined at construction. Thus the following is read only. </p>
95<pre> my $h = $surface-&gt;h;
96
97</pre>
98
99</div>
100<h1 id="SEE_ALSO">SEE ALSO</h1><p><a href="#TOP" class="toplink">Top</a></p>
101<div id="SEE_ALSO_CONTENT">
102<p><cite>SDL</cite>, <cite>SDL::PixelFormat</cite>, <cite>SDL::Video</cite> </p>
103
104</div>
105</div>