source/documentation/reference/spiderbasic_objects.html · PureBasic/SpiderBasicPreference

代码拉取完成,页面将自动刷新

扫描微信二维码支付

取消

支付完成

richgiteeai

Watch

不关注关注所有动态仅关注版本发行动态关注但不提醒动态

1 Star 0 Fork 0

PureBasic/SpiderBasicPreference

代码 Issues 0 Pull Requests 0 Wiki 统计流水线

服务

加入 Gitee

与超过 1400万开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)

免费加入

已有帐号? 立即登录

文件

master

分支 (1)

管理

master

该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。

项目仓库所选许可证以仓库主分支所使用许可证为准

克隆/下载

HTTPS SSH SVN SVN+SSH 下载ZIP

提示

下载代码请复制以下命令到终端执行

为确保你提交的代码身份被 Gitee 正确识别,请执行以下命令完成配置

git config --global user.name userName 
git config --global user.email userEmail

初次使用 SSH 协议进行代码克隆、推送等操作时,需按下述提示完成 SSH 配置

1 生成 RSA 密钥

2 获取 RSA 公钥内容,并配置到 SSH公钥中

在 Gitee 上使用 SVN,请访问使用指南

使用 HTTPS 协议时,命令行会出现如下账号密码验证步骤。基于安全考虑,Gitee 建议配置并使用私人令牌替代登录密码进行克隆、推送等操作

Username for 'https://gitee.com': userName

Password for 'https://userName@gitee.com': # 私人令牌

分支 1

标签 0

SpiderBasicPreference

source

documentation

reference

spiderbasic_objects.html

spiderbasic_objects.html 6.37 KB

<html><head><title>SpiderBasic objects</title></head>
<body bgcolor="#FFFFFF" link="#207BC3" vlink="#003B83" alink="#003B83">
SpiderBasic objects

Introduction<blockquote>

The purpose of this section is to describe the behavior, creation, and handling of 
objects in SpiderBasic. For the demonstration, we will use the <a href="../image/index.html">Image</a> object, but the 
same logic applies to all other SpiderBasic objects. When creating an Image object, we 
can do it in two ways: indexed and dynamic.

</blockquote>
I. Indexed numbering<blockquote>

The static, indexed way, allows you to reference an object by a predefined 
numeric value. The first available index number is 0 and subsequent indexes 
are allocated sequentially. This means that if you use the number 0 and then 
the number 1000, 1001 indexes will be allocated and 999 (from 1 to 999) will 
be unused, which is not an efficient way to use indexed objects. If you need a 
more flexible method, use the dynamic way of allocating objects, as described 
in section II. The indexed way offers several advantages: 
<blockquote>
<blockquote>

- Easier handling, since no <a href="variables.html">variables</a> or <a href="dim.html">arrays</a> are required. 
- 'Group' processing, without the need to use an intermediate array. 
- Use the object in <a href="procedures.html">procedures</a> without declaring anything in <a href="global.html">global</a> (if using a <a href="general_rules.html">constant</a> or a number). 
- An object that is associated with an index is automatically freed when reusing that index. 
</blockquote>
</blockquote>

The maximum index number is limited to an upper bound, depending of the object 
type (usually from 5000 to 60000). <a href="enumerations.html">Enumerations</a> are strongly recommended if 
you plan to use sequential constants to identify your objects (which is also 
recommended).

Example<blockquote>

<pre> CreateImage(0, 640, 480) ; Create an image, the n°0
 ResizeImage(0, 320, 240) ; Resize the n°0 image
</pre>

</blockquote>Example<blockquote>

<pre> CreateImage(2, 640, 480) ; Create an image, the n°2
 ResizeImage(2, 320, 240) ; Resize the n°2 image
 CreateImage(2, 800, 800) ; Create a new image in the n°2 index, the old one is automatically free'ed
</pre>

</blockquote>Example<blockquote>

<pre> For k = 0 To 9
 CreateImage(k, 640, 480) ; Create 10 different images, numbered from 0 to 9
 ResizeImage(k, 320, 240) ; Create a new image in the n°2 index, the old one is automatically free'ed
 Next
</pre>

</blockquote>Example<blockquote>

<pre> #ImageBackground = 0
 #ImageButton = 1

CreateImage(#ImageBackground, 640, 480) ; Create an image (n°0)
 ResizeImage(#ImageBackground, 320, 240) ; Resize the background image
 CreateImage(#ImageButton , 800, 800) ; Create an image (n°1)
</pre>

</blockquote>
II. Dynamic numbering<blockquote>

Sometimes, indexed numbering isn't very handy to handle dynamic situations where we need 
to deal with an unknown number of objects. SpiderBasic provides an easy and complementary way 
to create objects in a dynamic manner. Both methods (indexed and dynamic) can be used together 
at the same time without any conflict. To create a dynamic object, you just have to specify 
the #PB_Any constant instead of the indexed number, and the dynamic number will be returned as 
result of the function. Then just use this number with the other object functions in the place 
where you would use an indexed number (except to create a new object). This way of object handling can be very useful when used 
in combination with a <a href="../list/index.html">list</a>, which is also a dynamic way of storage.

</blockquote>Example<blockquote>

<pre> DynamicImage1 = CreateImage(#PB_Any, 640, 480) ; Create a dynamic image
 ResizeImage(DynamicImage1, 320, 240) ; Resize the DynamicImage1
</pre>

</blockquote>

</blockquote>
Overview of the different SpiderBasic objects<blockquote>

Different SpiderBasic objects (windows, gadgets, sprites, etc.) can use the same range of object numbers 
again. So the following objects can be enumerated each one starting at 0 (or other value) and SpiderBasic 
differs them by their type: 
<blockquote>

- <a href="../font/index.html">Font</a> 
- <a href="../gadget/index.html">Gadget</a> 
- <a href="../json/index.html">JSON</a> 
- <a href="../image/index.html">Image</a> 
- <a href="../menu/index.html">Menu</a> (not <a href="../menu/menuitem.html">MenuItem()</a>, as this is no object) 
- <a href="../regularexpression/index.html">RegularExpression</a> 
- <a href="../sound/index.html">Sound</a> 
- <a href="../sprite/index.html">Sprite</a> 
- <a href="../toolbar/index.html">ToolBar</a> 
- <a href="../window/index.html">Window</a> 
- <a href="../xml/index.html">XML</a> 
</blockquote>

</body></html>

一键复制编辑原始数据按行查看历史

麦壳饼提交于 2016年07月26日 10:47 +08:00 . chuci tijiao

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122

<html><head><title>SpiderBasic objects</title></head>
<body bgcolor="#FFFFFF" link="#207BC3" vlink="#003B83" alink="#003B83">
<font face="Arial" size="2"><p align="center"><b><font size="5">SpiderBasic objects</font></b></p>

<p><b>Introduction</b></p><blockquote>


The purpose of this section is to describe the behavior, creation, and handling of 
objects in SpiderBasic. For the demonstration, we will use the <a href="../image/index.html">Image</a> object, but the 
same logic applies to all other SpiderBasic objects. When creating an Image object, we 
can do it in two ways: indexed and dynamic. 

</blockquote>
<p><b>I. Indexed numbering</b></p><blockquote>


The static, indexed way, allows you to reference an object by a predefined 
numeric value. The first available index number is 0 and subsequent indexes 
are allocated sequentially. This means that if you use the number 0 and then 
the number 1000, 1001 indexes will be allocated and 999 (from 1 to 999) will 
be unused, which is not an efficient way to use indexed objects. If you need a 
more flexible method, use the dynamic way of allocating objects, as described 
in section II. The indexed way offers several advantages: 
<blockquote>
<p><b></b></p><blockquote>

- Easier handling, since no <a href="variables.html">variables</a> or <a href="dim.html">arrays</a> are required. <br>
- 'Group' processing, without the need to use an intermediate array. <br>
- Use the object in <a href="procedures.html">procedures</a> without declaring anything in <a href="global.html">global</a> (if using a <a href="general_rules.html">constant</a> or a number). <br>
- An object that is associated with an index is automatically freed when reusing that index. 
</blockquote>
</blockquote>


The maximum index number is limited to an upper bound, depending of the object 
type (usually from 5000 to 60000). <a href="enumerations.html">Enumerations</a> are strongly recommended if 
you plan to use sequential constants to identify your objects (which is also 
recommended). 

<p><b>Example</b></p><blockquote>


<pre><font face="Courier New, Courier, mono"size="2"><font color="#207BC3"> CreateImage</font>(0, 640, 480) <font color="#207BC3">; Create an image, the n°0</font>
<font color="#207BC3"> ResizeImage</font>(0, 320, 240) <font color="#207BC3">; Resize the n°0 image</font>
</font></pre>

</blockquote><p><b>Example</b></p><blockquote>


<pre><font face="Courier New, Courier, mono"size="2"><font color="#207BC3"> CreateImage</font>(2, 640, 480) <font color="#207BC3">; Create an image, the n°2</font>
<font color="#207BC3"> ResizeImage</font>(2, 320, 240) <font color="#207BC3">; Resize the n°2 image</font>
<font color="#207BC3"> CreateImage</font>(2, 800, 800) <font color="#207BC3">; Create a new image in the n°2 index, the old one is automatically free'ed</font>
</font></pre>

</blockquote><p><b>Example</b></p><blockquote>


<pre><font face="Courier New, Courier, mono"size="2"> <b><font color="#207BC3">For</font></b> k = 0 <b><font color="#207BC3">To</font></b> 9
<font color="#207BC3"> CreateImage</font>(k, 640, 480) <font color="#207BC3">; Create 10 different images, numbered from 0 to 9</font>
<font color="#207BC3"> ResizeImage</font>(k, 320, 240) <font color="#207BC3">; Create a new image in the n°2 index, the old one is automatically free'ed</font>
 <b><font color="#207BC3">Next</font></b>
</font></pre>

</blockquote><p><b>Example</b></p><blockquote>


<pre><font face="Courier New, Courier, mono"size="2"> <font color="#924B72">#ImageBackground</font> = 0
 <font color="#924B72">#ImageButton</font> = 1

<font color="#207BC3"> CreateImage</font>(<font color="#924B72">#ImageBackground</font>, 640, 480) <font color="#207BC3">; Create an image (n°0)</font>
<font color="#207BC3"> ResizeImage</font>(<font color="#924B72">#ImageBackground</font>, 320, 240) <font color="#207BC3">; Resize the background image</font>
<font color="#207BC3"> CreateImage</font>(<font color="#924B72">#ImageButton</font> , 800, 800) <font color="#207BC3">; Create an image (n°1)</font>
</font></pre>

</blockquote>
<p><b>II. Dynamic numbering</b></p><blockquote>


Sometimes, indexed numbering isn't very handy to handle dynamic situations where we need 
to deal with an unknown number of objects. SpiderBasic provides an easy and complementary way 
to create objects in a dynamic manner. Both methods (indexed and dynamic) can be used together 
at the same time without any conflict. To create a dynamic object, you just have to specify 
the <font color="#924B72">#PB_Any</font> constant instead of the indexed number, and the dynamic number will be returned as 
result of the function. Then just use this number with the other object functions in the place 
where you would use an indexed number (except to create a new object). This way of object handling can be very useful when used 
in combination with a <a href="../list/index.html">list</a>, which is also a dynamic way of storage. 

<blockquote>

</blockquote><p><b>Example</b></p><blockquote>


<pre><font face="Courier New, Courier, mono"size="2"> DynamicImage1 =<font color="#207BC3"> CreateImage</font>(<font color="#924B72">#PB_Any</font>, 640, 480) <font color="#207BC3">; Create a dynamic image</font>
<font color="#207BC3"> ResizeImage</font>(DynamicImage1, 320, 240) <font color="#207BC3">; Resize the DynamicImage1</font>
</font></pre>

</blockquote>


</blockquote>
<p><b>Overview of the different SpiderBasic objects</b></p><blockquote>


Different SpiderBasic objects (windows, gadgets, sprites, etc.) can use the same range of object numbers 
again. So the following objects can be enumerated each one starting at 0 (or other value) and SpiderBasic 
differs them by their type: 
<blockquote>

- <a href="../font/index.html">Font</a> <br>
- <a href="../gadget/index.html">Gadget</a> <br>
- <a href="../json/index.html">JSON</a> <br>
- <a href="../image/index.html">Image</a> <br>
- <a href="../menu/index.html">Menu</a> (not <a href="../menu/menuitem.html">MenuItem()</a>, as this is no object) <br>
- <a href="../regularexpression/index.html">RegularExpression</a> <br>
- <a href="../sound/index.html">Sound</a> <br>
- <a href="../sprite/index.html">Sprite</a> <br>
- <a href="../toolbar/index.html">ToolBar</a> <br>
- <a href="../window/index.html">Window</a> <br>
- <a href="../xml/index.html">XML</a> <br>
</blockquote>

</body></html>