# Image

## Image

`*image` 命令用于在游戏中添加图像。

## 用法｜Usage

图像可以添加在任何你想要的地方。简单版本如下：

```choicescript
*image wolf.png

你找到了一匹狼！
```

这将在你的 mygame 游戏文件夹（..\web\mygame）中的 wolf.png 图像；如果你没有 wolf.png 图像，图像将不会显示，并且不会出现错误。

出于整理目的，你可以在 mygame 文件夹内创建一个 images 文件夹来存放图片。如果这样做，你需要告知命令在哪里找到你的图片：

```choicescript
*image images/wolf.png
```

这将显示存储在 mygame 文件夹内 images 文件夹中的 wolf.png 文件（路径为..\web\mygame\images）。

（王洛木：一定注意不要在 \`..\web\mygame\sences\` 文件夹下再放置任何文件夹。也就是不得有 \`..\web\mygame\sences\images\`。因为 scene 文件夹下的任何文件夹哪怕是空的也会导致 server 直接停运。）

## 格式｜Format

ChoiceScript 支持大多数图像格式，其中最常用的包括：

* PNG - 由于采用无损压缩，这种格式是保证图像质量的最佳选择。它还支持透明度。
* JPG - 这种格式的图像被压缩至更小的文件尺寸，因此会损失部分画质。JPG图像不支持透明度。
* BMP - 这种格式的图像未经压缩，因而能完整保留画质。但也正因未压缩，文件体积可能非常庞大。
* GIF - 这种格式与PNG相似，支持透明度，但画质不及PNG文件。不过，GIF图像可以实现动画效果。

### 视觉格式对比｜Visual format comparison

| ![](/files/373f2c6fa7ff8fa7a55139e572c2abfc81a6b3ef) | ![](/files/b13406ac1a7a3ab315e5ee6744bbd65fc11883ca) | ![](/files/737016dede55172ed2ecdd11853ea15b3116a33f) |
| ---------------------------------------------------- | ---------------------------------------------------- | ---------------------------------------------------- |
| PNG格式的狼图像，带有透明背景。质量保持得非常好。                           | JPG格式的狼图像。不支持透明度（白色背景），并且损失了一些质量。                    | GIF格式的狼图像，带有透明背景。请注意边缘附近非常明显的低质量。                    |

![](/files/1401f5dfcc97be6431e11028c4856b2cf286ab56)\
一张以GIF格式呈现的动画狼图像，背景为透明。

## 尺寸｜Size

`*image` 命令会自动处理图像尺寸：如果图像的宽度大于运行游戏的设备屏幕宽度，图像将自动按比例缩小。

图像永远不会被放大，因为这会导致画面拉伸变形。最佳做法是插入高质量的大尺寸图像，系统会自动将其缩小显示。

## 对齐方式｜Alignment

但是，如果你想让图片“固定”在屏幕一侧该怎么办呢？以下是操作方法：

```choicescript
*image wolf.png left
```

或

```choicescript
*image wolf.png right
```

或

```choicescript
*image wolf.png center
```

这些 “left”（左对齐）和 “right”（右对齐）会将你的图片固定在屏幕的一侧，而 “center”（居中）则会让你的图片固定在屏幕中央（不过，如果你不写任何单词，图片默认会固定在中央）。

## 替代文本｜Alternate text

为图片添加替代描述文本是一种良好的做法，当图片因故无法显示时，这些文本将会呈现。这对于使用屏幕阅读器的视障玩家来说也非常有帮助。

```choicescript
*image wolf.png center 一只孤独、生着疥癣的狼对着月光嚎叫。
```

文本“一只孤独、生着疥癣的狼对着月光嚎叫。”并非标题，除非图片无法显示，否则不会展示。

{% hint style="warning" %}
**注意**：对齐参数必须设置在图片源文件（wolf.png）和替代文本（一只孤独、生着疥癣的狼对月长嚎）之间，否则会引发错误。如果您不希望指定 “left”（左对齐）、 “right”（右对齐）或 “center”（居中），那么“None”（无）是一个可接受的对齐参数。
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://raster.gitbook.io/zh-hans_choicescript-guide/image.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.