当前位置：首页 > news >正文

greenfoot主要api

news 2025/8/4 11:43:01

World 类常用方法一览表

方法名	作用说明
World(int width, int height, int cellSize)	构造方法，用于创建一个新的 World 对象。参数分别是世界的宽度（格子数）、高度（格子数）和每个格子的像素大小。通常在 Greenfoot 提供的子类构造器中调用父类构造器时使用。
void addObject(Actor object, int x, int y)	在世界的指定位置 (x, y) 添加一个 Actor 对象。x 和 y 是格子坐标，不是像素坐标。
void removeObject(Actor object)	从世界中移除指定的 Actor 对象。
Actor getObjectsAt(int x, int y, Class cls)	返回位于格子坐标 (x, y) 的所有属于指定类（cls）的 Actor 对象，返回一个 List。常用于检测某个位置是否存在某类对象。
List<Actor> getObjects(Class cls)	返回世界中所有属于指定类（cls）的 Actor 对象，返回一个 List。比如获取世界中所有的敌人、子弹等。
int getWidth()	返回世界在格子单位的宽度（不是像素）。
int getHeight()	返回世界在格子单位的高度（不是像素）。
int getCellSize()	返回每个格子的像素大小（比如默认是 1 像素 = 1 格子，通常为 16x16 或 32x32 像素）。
void showText(String text, int x, int y)	在指定的格子坐标 (x, y) 显示一段文字，用于调试或提示信息。文字显示在格子中心位置。
void removeObjectAt(int x, int y)	移除位于格子坐标 (x, y) 的任意一个对象（不指定类型，移除其中一个，慎用）。
Actor getOneObjectAtOffset(int dx, int dy, Class cls)	获取当前对象偏移位置 (dx, dy) 上的第一个属于类 cls 的对象。常用于检测相邻格是否有某类对象。
void setPaintOrder(Class<?>... classes)	设置绘制顺序（即哪些类的对象先画，哪些后画）。参数是多个 Class 类型，按顺序优先绘制。
void setActOrder(Class<?>... classes)	设置 act()方法的执行顺序，即哪些类的对象先执行 act()，哪些后执行。
void pause()	暂停世界的运行（停止调用所有 Actor 的 act() 方法）。
void resume()	恢复世界的运行（重新开始调用 act() 方法）。
boolean isPaused()	判断世界当前是否处于暂停状态。
void delay(int milliseconds)	让世界暂停运行指定的毫秒数（一般很少直接在 World 中调用）。

Actor 类的主要方法一览表

以下是 Actor 类中最常用和重要的方法，包括方法名、作用说明及简单用法提示：

方法名	作用说明
void act()	最重要的方法！每一帧（或每次世界更新时）被自动调用。你通常需要重写此方法，编写对象每一帧要执行的逻辑，比如移动、检测碰撞等。
void setLocation(int x, int y)	设置该 Actor 在世界中的位置（格子坐标 x, y）。
int getX()	获取当前 Actor 所在的 X 坐标（格子单位）。
int getY()	获取当前 Actor 所在的 Y 坐标（格子单位）。
void move(int steps)	让 Actor 向当前朝向方向移动指定的格子数（steps）。比如 move(1)表示向前走一格。
void turn(int degrees)	让 Actor 旋转指定的角度（单位是度）。比如 turn(90)是向右转 90 度，turn(-90)或 turn(270)是向左转 90 度。
void turnRight()	向右转 90 度（等同于 turn(90)）。
void turnLeft()	向左转 90 度（等同于 turn(-90)或 turn(270)）。
void setRotation(int degrees)	直接设置 Actor 的朝向角度（0 表示向上/北，90 表示向右/东，180 表示向下/南，270 表示向左/西）。
int getRotation()	获取当前 Actor 的朝向角度。
void setImage(Image image)	设置该 Actor 显示的图像（Image 对象）。
void setImage(String filename)	直接通过图片文件名设置图像（图片需放在项目的 "images" 文件夹中）。比如 setImage("player.png")。
Image getImage()	获取当前 Actor 使用的 Image 对象。
World getWorld()	获取当前 Actor 所在的 World 对象，用于添加其他对象、获取世界信息等。
Actor getOneObjectAtOffset(int dx, int dy, Class cls)	检测当前 Actor 偏移 (dx, dy) 格子位置的某个类（cls）的对象，常用于检测相邻格是否有敌人、道具等。
List<Actor> getIntersectingObjects(Class cls)	返回与当前 Actor 发生重叠（相交）的所有指定类（cls）的 Actor 列表，常用于碰撞检测。
boolean isTouching(Class cls)	判断当前 Actor 是否与某个类（cls）的对象接触/重叠，返回 true/false，是 getIntersectingObjects(cls).size() > 0的简化方法。
void removeTouching(Class cls)	移除所有与当前 Actor 接触的指定类（cls）的对象。
void removeFromWorld()或 remove()(已弃用，推荐使用 World 的 removeObject)	从世界中移除自己（不推荐直接使用，建议通过 getWorld().removeObject(this)实现）。

Greenfoot 类的主要方法一览表

下面是 Greenfoot 类中最常用的一些静态方法，包括方法名、作用说明和简单用法提示：

方法名	返回类型	作用说明
static boolean isKeyDown(String key)	boolean	检测某个键盘按键当前是否被按下。例如 isKeyDown("left")检测左方向键是否被按住。
static String getKeyName(int keyCode)	String	根据键盘的键码（keyCode）返回对应的键名，较少使用。
static int getMouseInfo()相关方法： • static MouseInfo getMouseInfo()	MouseInfo	获取当前鼠标的信息（比如位置、是否点击等）。返回一个 MouseInfo对象，你可以从中获取鼠标坐标、点击的 Actor 等。
static void delay(int milliseconds)	void	让程序暂停运行指定的毫秒数（一般很少在 Greenfoot 中直接使用，因为会影响整个世界运行）。
static World getWorld()	World	获取当前世界的引用（在某些特殊情况下使用，一般很少直接调用，因为通常你已经在 World 或 Actor 中了）。
static void setSpeed(int speed)	void	设置世界的运行速度，范围通常是 1（慢）~ 10（快），默认可能是 5 或 6。数值越大，act()方法调用越频繁，动画越快。
static int getSpeed()	int	获取当前世界设置的运行速度值。
static void showText(String text, int x, int y)	void	在世界中的指定格子坐标 (x, y) 显示一段文本，用于调试或提示信息。
static void removeObject(Actor actor)	void	从世界中移除指定的 Actor 对象。（一般更常用的是在 World 类里调用，或者让 Actor 自己调用 getWorld().removeObject(this)）
static void pause()	void	暂停整个世界的运行（所有 Actor 的 act() 方法都停止执行）。
static void resume()	void	恢复世界的运行（继续调用所有 Actor 的 act() 方法）。
static boolean isPaused()	boolean	判断当前世界是否处于暂停状态。
static GreenfootImage getBackground()（不常用）	GreenfootImage	获取当前世界的背景图像（一般很少直接调用）。
static void setBackground(GreenfootImage image)（不常用）	void	设置当前世界的背景图像（一般通过 World 的构造方法或方法设置）。

MouseInfo 类的主要方法

以下是 MouseInfo类的常用方法及其功能说明：

方法名	返回类型	功能说明
int getX()	int	获取当前鼠标指针所在的 X 坐标（格子单位）
int getY()	int	获取当前鼠标指针所在的 Y 坐标（格子单位）
Actor getActor()	Actor	获取当前鼠标点击位置下的 Actor 对象（如果有的话，比如你点击了一个角色）。如果没有点击对象或在空白处，返回 null。
World getWorld()	World	获取当前鼠标所在的世界（World）对象
int getButton()	int	获取当前鼠标按下的按钮类型，用于判断是左键、右键还是其他。返回的是 Java 标准 AWT 中的鼠标事件常量，常见值： • MouseEvent.BUTTON1（通常是鼠标左键，值为 1） • MouseEvent.BUTTON2（中键，很少用） • MouseEvent.BUTTON3（右键，值为 3）

GreenfootImage 类 — 主要方法一览表

方法名	返回类型	作用说明
GreenfootImage()	GreenfootImage	构造方法：创建一个 1×1 像素的透明图像。
GreenfootImage(int width, int height)	GreenfootImage	构造方法：创建一个指定宽度与高度的空白图像（默认白色或透明背景）。
GreenfootImage(String filename)	GreenfootImage	构造方法：从项目的 images文件夹加载指定名称的图片文件（如 "player.png"）。
setImage(GreenfootImage image)	void	（在 Actor类中使用）设置当前 Actor 显示的图像为指定的 GreenfootImage。
getImage()	GreenfootImage	（在 Actor类中使用）获取当前 Actor 所使用的 GreenfootImage对象。
setBackground(String filename)	void	（在 World类中使用）设置 World 的背景图片（通过文件名，图片在 images文件夹中）。
setBackground(GreenfootImage image)	void	（在 World类中使用）设置 World 的背景为指定的 GreenfootImage。
setColor(Color color)	void	设置当前绘图颜色，用于后续绘制操作（如画矩形、文字等）。
drawString(String text, int x, int y)	void	在图像上绘制一串文字，坐标 (x, y) 是文字的左下角位置。
setFont(java.awt.Font font)	void	设置绘制文字时使用的字体。
fillRect(int x, int y, int width, int height)	void	绘制一个指定位置和大小的实心矩形。
drawRect(int x, int y, int width, int height)	void	绘制一个指定位置和大小的矩形边框。
fillOval(int x, int y, int width, int height)	void	绘制一个指定位置和大小的实心椭圆/圆。
drawOval(int x, int y, int width, int height)	void	绘制一个指定位置和大小的椭圆/圆边框。
drawImage(GreenfootImage image, int x, int y)	void	在当前图像上的 (x, y) 位置绘制另一张图片。
clear()	void	清空图像内容（通常变成透明或默认背景色）。
scale(int newWidth, int newHeight)	void	直接修改当前图像，将其缩放到新的宽度和高度（可能会变形）。
scaledCopy(int newWidth, int newHeight)	GreenfootImage	创建并返回一个新的缩放后的图像副本，原图不变（推荐使用）。
getWidth()	int	获取当前图像的宽度（单位：像素）。
getHeight()	int	获取当前图像的高度（单位：像素）。
setTransparency(int alpha)	void	设置图像的透明度，范围是 0（完全透明）到 255（完全不透明）。

GreenfootSound 类 — 主要方法一览表

方法名	返回类型	作用说明
GreenfootSound(String filename)	GreenfootSound	构造方法：创建一个 GreenfootSound 对象，并加载指定文件名（如 "sound.wav"或 "music.mp3"）的声音文件。文件需放在项目的 sounds 文件夹中。
play()	void	播放声音。如果是音效，从头开始播放一次；如果是音乐，也是从头播放一次（不会循环）。
playLoop()	void	播放声音并循环（一般用于背景音乐）。会持续重复播放，直到调用 stop()。
stop()	void	停止当前声音的播放（无论是单次播放还是循环播放）。
pause()	void	暂停当前正在播放的声音。可以后续通过 play()恢复播放（从暂停位置继续，但实际行为可能因系统而异）。
setVolume(int volume)	void	设置音量。参数范围是 0（静音）~ 100（最大音量）。例如：setVolume(50)表示设为 50% 音量。
getVolume()	int	获取当前音量设置，返回值为 0~100 的整数。
isPlaying()	boolean	判断该声音当前是否正在播放，返回 true或 false。可用于检测背景音乐是否在播。

Color 类 — 主要方法一览表

方法名	返回类型	作用说明
Color(int r, int g, int b)	Color	构造方法：使用 RGB 值创建一个颜色对象。参数范围是 0~255，分别代表红、绿、蓝分量。例如：new Color(255, 0, 0)是红色。
Color(int r, int g, int b, int a)	Color	构造方法：使用 RGBA 值创建颜色，a 表示透明度（Alpha），范围也是 0~255（0 完全透明，255 完全不透明）。
Color(int rgb)	Color	构造方法：通过一个整数（打包的 RGB 值，通常是十六进制形式）创建颜色。例如 0xFF0000表示红色。一般较少直接使用。
static Color red	Color	预定义颜色常量：红色，等同于 new Color(255, 0, 0)。
static Color green	Color	预定义颜色：绿色，等同于 new Color(0, 255, 0)。
static Color blue	Color	预定义颜色：蓝色，等同于 new Color(0, 0, 255)。
static Color yellow	Color	黄色：new Color(255, 255, 0)
static Color black	Color	黑色：new Color(0, 0, 0)
static Color white	Color	白色：new Color(255, 255, 255)
static Color gray/ grey	Color	灰色：new Color(128, 128, 128)
static Color lightGray	Color	浅灰色
static Color darkGray	Color	深灰色
static Color cyan	Color	青色：new Color(0, 255, 255)
static Color magenta	Color	洋红/品红：new Color(255, 0, 255)
static Color orange	Color	橙色：new Color(255, 165, 0)
int getRed()	int	获取该颜色的红色分量值（范围 0~255）。
int getGreen()	int	获取该颜色的绿色分量值（0~255）。
int getBlue()	int	获取该颜色的蓝色分量值（0~255）。
int getAlpha()	int	获取该颜色的透明度分量值（0~255，仅当使用带 Alpha 的构造方法时有效）。
int getRGB()	int	获取该颜色的打包 RGB 值（包含 Alpha，如果适用），是一个整数，可用于构造其他 Color 对象。

常用预定义颜色常量速查表

颜色常量	说明	等价 RGB 值
Color.red	红色	(255, 0, 0)
Color.green	绿色	(0, 255, 0)
Color.blue	蓝色	(0, 0, 255)
Color.yellow	黄色	(255, 255, 0)
Color.black	黑色	(0, 0, 0)
Color.white	白色	(255, 255, 255)
Color.gray或 Color.grey	灰色	(128, 128, 128)
Color.lightGray	浅灰	(192, 192, 192)
Color.darkGray	深灰	(64, 64, 64)
Color.cyan	青色	(0, 255, 255)
Color.magenta	洋红	(255, 0, 255)
Color.orange	橙色	(255, 165, 0)

Font 类 — 主要方法总结表

方法名	返回类型	功能简述
Font(String name, int style, int size)	Font	构造方法：创建字体对象，指定字体名称、样式和大小
String getName()	String	获取字体名称，如 "Arial"
int getSize()	int	获取字体大小（单位：磅，如 16、20）
int getStyle()	int	获取字体样式（如 Font.BOLD、Font.ITALIC）
boolean isBold()	boolean	判断是否为粗体
boolean isItalic()	boolean	判断是否为斜体
boolean isPlain()	boolean	判断是否为普通字体
Font deriveFont(int style)	Font	返回新字体，仅修改样式
Font deriveFont(float size)	Font	返回新字体，仅修改大小
Font deriveFont(int style, float size)	Font	返回新字体，同时修改样式与大小