Component/geolyzer/zh - Revision history

Michiyo: Clean up Markdown artifacts from DokuWiki migration

2026-08-24T20:27:31Z

Clean up Markdown artifacts from DokuWiki migration

← Older revision		Revision as of 20:27, 24 August 2026
Line 3:		Line 3:
	此组件由[[Block/geolyzer/zh\|地址分析仪方块]]提供。		此组件由[[Block/geolyzer/zh\|地址分析仪方块]]提供。

	组件名：`geolyzer`。		组件名：<code>geolyzer</code>。

	回调函数：		回调函数：

	* `scan(x:number, z:number[, y:number, w:number, d:number, h:number][, ignoreReplaceable:boolean\|options:table]):table`		* <code>scan(x:number, z:number[, y:number, w:number, d:number, h:number][, ignoreReplaceable:boolean\|options:table]):table</code>

	<pre>分析位于`x`、`z`和`y`指定的相对坐标处一定区域的密度。此函数将会返回一个列表，其中包含指定范围内方块的硬度值。提供的坐标是以地址分析仪为参考点的相对坐标。待分析区域的大小由参数`w`、`d`与`h`指定，分别代表宽度（width）、深度（depth）与高度（height）。若不指定大小则认为区域为指定坐标对应的单个方块。		<pre>分析位于x、z和y指定的相对坐标处一定区域的密度。此函数将会返回一个列表，其中包含指定范围内方块的硬度值。提供的坐标是以地址分析仪为参考点的相对坐标。待分析区域的大小由参数w、d与h指定，分别代表宽度（width）、深度（depth）与高度（height）。若不指定大小则认为区域为指定坐标对应的单个方块。

	~~方块离地址分析仪越远，扫描到的硬度值所含的噪声就会越大。计算某个值与特定方块实际硬度值偏离程度的准确公式是：`到方块的欧几里得距离~~ '' 1/33 '' ~~地质分析仪噪声`，公式中的`地质分析仪噪声（geolyzerNoise）`常数可通过配置文件修改，默认为`2`。~~		方块离地址分析仪越远，扫描到的硬度值所含的噪声就会越大。计算某个值与特定方块实际硬度值偏离程度的准确公式是：到方块的欧几里得距离 '' 1/33 '' 地质分析仪噪声，公式中的地质分析仪噪声（geolyzerNoise）常数可通过配置文件修改，默认为2。

	包含多个结果的表中的数据是线性的，但是结果所代表的是一个3D的区域。区域起始于由相对于地址分析仪的相对坐标（`x`、`z`与`y`）定义的方块，其大小（`w`、`d`与`h`）决定了区域分别在坐标轴的x轴正方向、z轴正方向和y轴正方向上延伸的方块数。将结果表中的元素与坐标对应起来需要用到以下方法：		包含多个结果的表中的数据是线性的，但是结果所代表的是一个3D的区域。区域起始于由相对于地址分析仪的相对坐标（x、z与y）定义的方块，其大小（w、d与h）决定了区域分别在坐标轴的x轴正方向、z轴正方向和y轴正方向上延伸的方块数。将结果表中的元素与坐标对应起来需要用到以下方法：
	</pre>		</pre>

	表中元素首先沿x轴正方向排列，然后是z轴正方向，最后是y轴正方向。换言之，假设结果表是将三维表转化成一维表得到的，那么三维表的最后一维中是按照x轴正方向排列的数值，中间一维是按照z轴正方向排列的，最高一维是按照y轴正方向排列的。可查看底部的一段代码样例以帮助理解。		表中元素首先沿x轴正方向排列，然后是z轴正方向，最后是y轴正方向。换言之，假设结果表是将三维表转化成一维表得到的，那么三维表的最后一维中是按照x轴正方向排列的数值，中间一维是按照z轴正方向排列的，最高一维是按照y轴正方向排列的。可查看底部的一段代码样例以帮助理解。
	'''注意：'''偏移量在方向上是绝对的，不受面向方向的影响。换句话说，如果地质分析仪安装在机器人中，偏移量不会受到机器人朝向的影响。 '''注意：'''返回的数值一定为64个，即使扫描区域的体积不足64也是如此。假设扫描了10个方块，那么扫描结果中的前10个值就代表了被扫描的方块，而扫描结果中剩下的值应当被忽略。		'''注意：'''偏移量在方向上是绝对的，不受面向方向的影响。换句话说，如果地质分析仪安装在机器人中，偏移量不会受到机器人朝向的影响。 '''注意：'''返回的数值一定为64个，即使扫描区域的体积不足64也是如此。假设扫描了10个方块，那么扫描结果中的前10个值就代表了被扫描的方块，而扫描结果中剩下的值应当被忽略。
	* `analyze(side:number[, options:table]):table`		* <code>analyze(side:number[, options:table]):table</code>

	<pre>~~获取某个直接接触地址分析仪的方块的信息。默认情况下返回的表中将包含字符串格式的方块ID（如`minecraft~~:~~dirt`、元表、硬度以及一些其他信息）请注意调用一次该函数消耗的能量与调用`scan`函数相同！~~		<pre>获取某个直接接触地址分析仪的方块的信息。默认情况下返回的表中将包含字符串格式的方块ID（如minecraft:dirt、元表、硬度以及一些其他信息）请注意调用一次该函数消耗的能量与调用scan函数相同！
	~~此方法可通过配置文件中的`misc~~.~~allowItemStackInspection`设置项禁用。~~		此方法可通过配置文件中的misc.allowItemStackInspection设置项禁用。
	</pre>		</pre>

	* `store(side:number, dbAddress:string, dbSlot:number):boolean`		* <code>store(side:number, dbAddress:string, dbSlot:number):boolean</code>

	<pre>读取与地址分析仪指定面接触的方块信息，并将其以物品堆的形式存储到指定地址对应的[[Component/database/zh\|数据库组件]]中的指定槽位。此函数不一定能（很好的）处理所有方块，尤其是以NBT数据区分的模组方块（例如机器人）。		<pre>读取与地址分析仪指定面接触的方块信息，并将其以物品堆的形式存储到指定地址对应的[[Component/database/zh\|数据库组件]]中的指定槽位。此函数不一定能（很好的）处理所有方块，尤其是以NBT数据区分的模组方块（例如机器人）。
	</pre>		</pre>

	* `detect(side:number):boolean, string`		* <code>detect(side:number):boolean, string</code>

	<pre>~~与`robot~~.detect`（来自机器人组件）相同。探测指定方向的方块，方向是机器人的相对方向，并返回机器人可否移动到此方块的位置中，同时给出方块的大体描述。		<pre>与robot.detect（来自机器人组件）相同。探测指定方向的方块，方向是机器人的相对方向，并返回机器人可否移动到此方块的位置中，同时给出方块的大体描述。
	</pre>		</pre>
	'''返回值：'''若机器人前方的物体会阻碍机器人移动（为方块或实体）则返回 `true`（注意：无人机即使在方块为`passable`时也会返回`true`），在其他情况下会返回`false`。第二个参数大体描述了遣返的物体，取值可能为下列之一：`entity`、`solid`、`replaceable`、`liquid`、`passable`或`air`。		'''返回值：'''若机器人前方的物体会阻碍机器人移动（为方块或实体）则返回 <code>true</code>（注意：无人机即使在方块为<code>passable</code>时也会返回<code>true</code>），在其他情况下会返回<code>false</code>。第二个参数大体描述了遣返的物体，取值可能为下列之一：<code>entity</code>、<code>solid</code>、<code>replaceable</code>、<code>liquid</code>、<code>passable</code>或<code>air</code>。
	* `canSeeSky():boolean`		* <code>canSeeSky():boolean</code>

	<pre>返回从当前位置垂直向上是否能看到天空。透明方块，例如玻璃，不会影响视线。		<pre>返回从当前位置垂直向上是否能看到天空。透明方块，例如玻璃，不会影响视线。
	</pre>		</pre>

	* `isSunVisible():boolean`		* <code>isSunVisible():boolean</code>

	<pre>~~返回从当前位置垂直向上是否能看到太阳。结果受到正上方能阻碍视线的方块（可由`canSeeSky~~()`函数检查）以及当前为白天还是黑夜影响。		<pre>返回从当前位置垂直向上是否能看到太阳。结果受到正上方能阻碍视线的方块（可由canSeeSky()函数检查）以及当前为白天还是黑夜影响。
	</pre>		</pre>

	下列代码片段可用于理解`scan`函数实际如何工作。它会扫描指定偏移处指定大小的区域，保存返回的数据以及相对于地质分析仪方块（或机器人）的准确偏移坐标，并打印这些数据。		下列代码片段可用于理解<code>scan</code>函数实际如何工作。它会扫描指定偏移处指定大小的区域，保存返回的数据以及相对于地质分析仪方块（或机器人）的准确偏移坐标，并打印这些数据。

	<pre class="Lua">local component = require("component")		<pre class="Lua">local component = require("component")
Line 77:		Line 77:

	{{:Component/contents/zh}}		{{:Component/contents/zh}}

imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li

2026-08-24T08:08:27Z

Imported from legacy OpenComputers documentation at ocdoc.cil.li

New page

= 组件：地址分析仪 =

此组件由[[Block/geolyzer/zh|地址分析仪方块]]提供。

组件名：`geolyzer`。

回调函数：

* `scan(x:number, z:number[, y:number, w:number, d:number, h:number][, ignoreReplaceable:boolean|options:table]):table`

<pre>分析位于`x`、`z`和`y`指定的相对坐标处一定区域的密度。此函数将会返回一个列表，其中包含指定范围内方块的硬度值。提供的坐标是以地址分析仪为参考点的相对坐标。待分析区域的大小由参数`w`、`d`与`h`指定，分别代表宽度（width）、深度（depth）与高度（height）。若不指定大小则认为区域为指定坐标对应的单个方块。

方块离地址分析仪越远，扫描到的硬度值所含的噪声就会越大。计算某个值与特定方块实际硬度值偏离程度的准确公式是：`到方块的欧几里得距离 '' 1/33 '' 地质分析仪噪声`，公式中的`地质分析仪噪声（geolyzerNoise）`常数可通过配置文件修改，默认为`2`。

包含多个结果的表中的数据是线性的，但是结果所代表的是一个3D的区域。区域起始于由相对于地址分析仪的相对坐标（`x`、`z`与`y`）定义的方块，其大小（`w`、`d`与`h`）决定了区域分别在坐标轴的x轴正方向、z轴正方向和y轴正方向上延伸的方块数。将结果表中的元素与坐标对应起来需要用到以下方法：
</pre>

表中元素首先沿x轴正方向排列，然后是z轴正方向，最后是y轴正方向。换言之，假设结果表是将三维表转化成一维表得到的，那么三维表的最后一维中是按照x轴正方向排列的数值，中间一维是按照z轴正方向排列的，最高一维是按照y轴正方向排列的。可查看底部的一段代码样例以帮助理解。
'''注意：'''偏移量在方向上是绝对的，不受面向方向的影响。换句话说，如果地质分析仪安装在机器人中，偏移量不会受到机器人朝向的影响。 '''注意：'''返回的数值一定为64个，即使扫描区域的体积不足64也是如此。假设扫描了10个方块，那么扫描结果中的前10个值就代表了被扫描的方块，而扫描结果中剩下的值应当被忽略。
* `analyze(side:number[, options:table]):table`

<pre>获取某个直接接触地址分析仪的方块的信息。默认情况下返回的表中将包含字符串格式的方块ID（如`minecraft:dirt`、元表、硬度以及一些其他信息）请注意调用一次该函数消耗的能量与调用`scan`函数相同！
此方法可通过配置文件中的`misc.allowItemStackInspection`设置项禁用。
</pre>

* `store(side:number, dbAddress:string, dbSlot:number):boolean`

<pre>读取与地址分析仪指定面接触的方块信息，并将其以物品堆的形式存储到指定地址对应的[[Component/database/zh|数据库组件]]中的指定槽位。此函数不一定能（很好的）处理所有方块，尤其是以NBT数据区分的模组方块（例如机器人）。
</pre>

* `detect(side:number):boolean, string`

<pre>与`robot.detect`（来自机器人组件）相同。探测指定方向的方块，方向是机器人的相对方向，并返回机器人可否移动到此方块的位置中，同时给出方块的大体描述。
</pre>
'''返回值：'''若机器人前方的物体会阻碍机器人移动（为方块或实体）则返回 `true`（注意：无人机即使在方块为`passable`时也会返回`true`），在其他情况下会返回`false`。第二个参数大体描述了遣返的物体，取值可能为下列之一：`entity`、`solid`、`replaceable`、`liquid`、`passable`或`air`。
* `canSeeSky():boolean`

<pre>返回从当前位置垂直向上是否能看到天空。透明方块，例如玻璃，不会影响视线。
</pre>

* `isSunVisible():boolean`

<pre>返回从当前位置垂直向上是否能看到太阳。结果受到正上方能阻碍视线的方块（可由`canSeeSky()`函数检查）以及当前为白天还是黑夜影响。
</pre>

下列代码片段可用于理解`scan`函数实际如何工作。它会扫描指定偏移处指定大小的区域，保存返回的数据以及相对于地质分析仪方块（或机器人）的准确偏移坐标，并打印这些数据。

<pre class="Lua">local component = require("component")
local geolyzer = component.geolyzer

local offsetx = 4
local offsetz = -3
local offsety = -5

local sizex = 3
local sizez = 4
local sizey = 5

local map = {}
local scanData = geolyzer.scan(offsetx, offsetz, offsety, sizex, sizez, sizey)
local i = 1
for y = 0, sizey - 1 do
for z = 0, sizez - 1 do
for x = 0, sizex - 1 do
-- 可看作是三维表：map[offsety + y][offsetz + z][offsetx + x] = scanData[i]
map[i] = {posx = offsetx + x, posy = offsety + y, posz = offsetz + z, hardness = scanData[i]}
i = i + 1
end
end
end

for i = 1, sizex''sizez''sizey do
print(map[i].posx, map[i].posy, map[i].posz, map[i].hardness)
end
</pre>
== 目录 ==

{{:Component/contents/zh}}