https://ocr.michiyo.me/w/index.php?action=history&feed=atom&title=Component%2Fhologram%2Fzh
Component/hologram/zh - Revision history
2026-08-24T15:38:50Z
Revision history for this page on the wiki
MediaWiki 1.43.9
https://ocr.michiyo.me/w/index.php?title=Component/hologram/zh&diff=1169&oldid=prev
imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li
2026-08-24T08:08:27Z
<p>Imported from legacy OpenComputers documentation at ocdoc.cil.li</p>
<p><b>New page</b></p><div>= 组件：全息影像 =<br />
<br />
此组件由[[Block/hologram projector/zh|全息投影仪]]提供。 以下函数可用于创建全息影像，其分辨率为48x32x48，投影范围最大为9x6x9格。2级全息投影仪的分辨率并未提高，但是可以用至多三种颜色显示全息投影（1级全息投影仪只能用一种）。<br />
<br />
组件名：`hologram`。<br />
<br />
回调函数：<br />
<br />
* `clear()`<br />
<br />
<pre>清除全息影像。 <br />
</pre><br />
<br />
* `get(x:number, y:number, z:number):number`<br />
<br />
<pre>返回全息影像指定坐标处的值。 <br />
</pre><br />
<br />
* `set(x:number, y:number, z:number, value:number or boolean)`<br />
<br />
<pre>设定全息影像指定坐标处的值。 <br />
</pre><br />
<br />
* `fill(x:number, z:number[, minY:number], maxY:number, value:number)`<br />
<br />
<pre>用给定值填充指定柱状区域中的一个区间，只会覆写区间内的体素。若省略`minY`则默认为1。作用范围包含区间的两端。 <br />
</pre><br />
'''注意：'''在1.3.3版本前并没有`minY`参数，指定高度处及其下方的所有体素都将被赋值，指定高度上方的所有体素都不会被赋值。<br />
* `copy(x:number, z:number, sx:number, sz:number, tx:number, tz:number)`<br />
<br />
<pre>遵从给定的位置变换，复制一个柱状区域。 <br />
</pre><br />
<br />
* `getScale():number`<br />
<br />
<pre>返回当前全息影像的渲染缩放比例。 <br />
</pre><br />
<br />
* `setScale(value:number)`<br />
<br />
<pre>设定渲染缩放比例。缩放比例越大则耗能越多。做小缩放比例为0.33，此时全息投影的大小在一个方块以内。最大缩放比例为3，此时全息投影会占据9x6x9格的空间。 <br />
</pre><br />
<br />
* `getTranslation:number, number, number`<br />
<br />
<pre>返回当前的位置变换偏移量。 <br />
</pre><br />
<br />
* `setTranslation(x:number, y:number, z:number)`<br />
<br />
<pre>设定位置变换向量。全息投影显示时将会从默认位置以此向量为偏移值进行偏移。最大允许偏移值与投影仪等级有关。偏移值的单位为全息投影的尺寸，因此位置改变的距离远近也会随着缩放比例而增减。 <br />
</pre><br />
<br />
* `maxDepth():number`<br />
<br />
<pre>全息影像支持的色深。 <br />
</pre><br />
<br />
* `getPaletteColor(index:number):number`<br />
<br />
<pre>获取定义给指定值的16进制颜色。 <br />
</pre><br />
<br />
* `setPaletteColor(index:number, value:number):number`<br />
<br />
<pre>设置定义给指定值的16进制颜色。\\<br />
</pre><br />
下面是一个简单的程序样例，可用于设定不同体素的值： ```lua local component = require("component") local hologram = component.hologram local args = {...} hologram.set(tonumber(args[1]), tonumber(args[2]), tonumber(args[3]), args[4] == "true" or args[4] == "on") ```<br />
<br />
使用例（假设上述程序被保存为`holo-set.lua`）： `# holo-set 16 8 20 true`<br />
<br />
高级样例：<br />
<br />
* [Holo Flow](https://github.com/OpenPrograms/Sangar-Programs/blob/master/holo-flow.lua)<br />
<br />
<pre>此程序生成了一张高度图，并在上面“移动”。制造了滚动的大地的效果。 <br />
</pre><br />
* [Holo Text](https://github.com/OpenPrograms/Sangar-Programs/blob/master/holo-text.lua)<br />
<br />
<pre>此程序生成了一张随机的高度图，并在其上方显示了滚动的文本。 <br />
</pre><br />
请注意，第二个样例要比第一个高级的多。 '''重要事项：'''两个脚本都需要同一个文件夹中有[noise.lua]([[https://github.com/OpenPrograms/Sangar-Programs/blob/master/noise.lua)脚本才能工作|https://github.com/OpenPrograms/Sangar-Programs/blob/master/noise.lua)脚本才能工作]]。<br />
<br />
== 目录 ==<br />
<br />
{{:Component/contents/zh}}<br />
</div>
imported>OCDoc Import