Ryan100c的博客

外观

Examples

约 3503 字大约 12 分钟

2026-11-05

本篇展示了 Ryan's Rendering Kit 中所有的测试图形示例。

基础图形

圆形图形

面圆形

资源位置: ryansrenderingkit:test/demo_face_circle

图形类型: 填充圆形（Face Circle）

配置参数:

  • 位置: 动态计算（使用 xPos() 函数）
  • 半径: 2.0f
  • 分段数: 64
  • 轴向: Y轴（CircleAxis.Y）
  • 颜色: 随机颜色
  • 透视: 否（seeThrough = false）
  • 渲染类型: BATCH

变换效果:

// 绕Y轴旋转
float time = client.getGameTime();
t.setShapeWorldRotationDegrees(0, time * 3, 0);

每帧绕Y轴旋转，旋转速度为游戏时间的3倍。

球体图形

基础球体

资源位置: ryansrenderingkit:test/demo_sphere

图形类型: 球体（Sphere）

配置参数:

  • 位置: 动态计算
  • 半径: 2.0f
  • 分段数: 32
  • 颜色: 随机颜色
  • 透视: 是（seeThrough = true）
  • 渲染类型: BUFFERED

变换效果:

float time = client.getGameTime();
// 多轴旋转
t.setShapeWorldRotationDegrees(time * 2, time * 3, 0);

同时绕X轴和Y轴旋转，创造复杂的旋转效果。

3D模型

OBJ模型（可抓取）

资源位置: ryansrenderingkit:test/demo_obj_model

图形类型: OBJ模型

配置参数:

  • 位置: 动态计算
  • 模型文件: ryansrenderingkit:models/monkey.obj（Blender猴头）
  • 颜色: 随机颜色
  • 透视: 否
  • 渲染类型: BATCH

变换效果:

float time = client.getGameTime();
// 基础旋转
transformer.setShapeWorldRotationDegrees(0, time * 5, 0);
Shape shape = transformer.shape;

// 视线检测和鼠标抓取逻辑
if (shape.isPlayerLookingAt().hit) {
    if (Minecraft.getInstance().mouseHandler.isLeftPressed()) {
        Player player = Minecraft.getInstance().player;
        
        // 首次抓取时记录距离
        if (!shape.getCustomData("isHolding", false)) {
            shape.putCustomData("isHolding", true);
            double distance = transformer.getShapeWorldPivot(true)
                    .distanceTo(player.getEyePosition());
            shape.putCustomData("distance", distance);
        }
        
        // 将模型移动到玩家视线方向
        transformer.setShapeWorldPivot(
            player.getEyePosition(transformer.getTickDelta())
                .add(player.getLookAngle().scale(shape.getCustomData("distance", 5.0)))
                .add(0, -1, 0)
        );
        transformer.world.position.syncLastToTarget();
    } else {
        if (shape.getCustomData("isHolding", false))
            shape.putCustomData("isHolding", false);
    }
    
    // 被看着时为红色
    shape.baseColor = new Color(255, 0, 72, 100);
} else {
    if (shape.getCustomData("isHolding", false))
        shape.putCustomData("isHolding", false);
    // 未被看着时为绿色
    shape.baseColor = new Color(0, 255, 72, 100);
}

交互功能:

  • 视线指向时变红
  • 按住鼠标左键可抓取并移动模型
  • 释放鼠标后恢复绿色

圆锥体

实心圆锥（动态分段）

资源位置: ryansrenderingkit:test/demo_cone

图形类型: 圆锥体（Cone）

配置参数:

  • 位置: 动态计算
  • 半径: 2.0f
  • 高度: 4.0f
  • 分段数: 32（动态变化）
  • 轴向: Y轴
  • 颜色: 随机颜色
  • 透视: 否
  • 渲染类型: BATCH

变换效果:

float time = client.getGameTime();
// 绕X轴旋转
t.setShapeWorldRotationDegrees(time, 0, 0);

// 动态调整分段数（3-20段）
double f = (Math.sin(time * 0.1) + 1) / 2;
int seg = (int) (3 + f * 20 - 3);

// 视线检测改变颜色
if (t.shape.isPlayerLookingAt().hit) {
    t.shape.baseColor = new Color(0, 255, 149, 100);  // 青绿色
} else {
    t.shape.baseColor = new Color(136, 136, 136, 100);  // 灰色
}

t.setSegment(Math.max(3, seg));

特殊效果: 分段数随时间平滑变化，从粗糙的3边形到光滑的20边形循环变化。

圆柱体

实心圆柱（多重锚点）

资源位置: ryansrenderingkit:test/demo_cylinder

图形类型: 圆柱体（Cylinder）

配置参数:

  • 位置: 固定X坐标
  • 半径: 1.5f
  • 高度: 4.0f
  • 分段数: 32
  • 轴向: Z轴
  • 颜色: 随机颜色
  • 透视: 否
  • 渲染类型: BATCH

变换效果:

float time = client.getGameTime();
double offset = Math.sin(time * 0.05);

// 本地锚点（相对于形状自身）
t.setShapeLocalPivot(new Vec3(offset * 3, 0, 0));

// 矩阵锚点（用于额外变换）
t.setShapeMatrixPivot(new Vec3(0, offset * -2, 0));

// 世界锚点（绝对位置）
t.setShapeWorldPivot(new Vec3(fixedCylX, 0, offset * 1));

特殊效果: 展示了三种不同层级的锚点变换，创造复杂的振荡运动。

线条图形

单线段

资源位置: ryansrenderingkit:test/demo_line

图形类型: 线段（Line）

配置参数:

  • 起点: Vec3(linex - 2, 0, 0)
  • 终点: Vec3(linex + 2, 4, 0)
  • 线宽: 3.0f
  • 颜色: 随机颜色
  • 透视: 否
  • 渲染类型: BATCH

变换效果:

float time = client.getGameTime();
// 起点固定
t.setStart(new Vec3(linex - 2, 0, 0));
// 终点Y坐标上下波动
t.setEnd(new Vec3(linex + 2, 4 + (float) Math.sin(time * 0.1) * 2, 0));

创造类似弹簧或波浪的效果。

盒子图形

面盒子

资源位置: ryansrenderingkit:test/demo_box_face

图形类型: 盒子面（Box Face）

配置参数:

  • 位置: 动态计算
  • 尺寸: Vec3(2, 2, 2)
  • 颜色: 随机颜色
  • 透视: 否
  • 构造类型: CENTER_AND_DIMENSIONS（中心点+尺寸）
  • 渲染类型: BATCH

变换效果:

float time = client.getGameTime();
// 三轴旋转，不同速度
t.setShapeWorldRotationDegrees(time * 2, time * 3, time * 1.5f);

创造一个在空中翻转的立方体。

文本图形

公告牌文本

资源位置: ryansrenderingkit:test/demo_text1

图形类型: 文本（Text Shape）

配置参数:

  • 位置: 动态计算
  • 公告牌模式: BillBoardMode.ALL（总是面向玩家）
  • 透视: 是
  • 阴影: 是
  • 轮廓: 是
  • 文本内容:
    • "§b§l!TEST!" （青色加粗）
    • "§e你好" （黄色）
    • "§aAWA" （绿色）
    • "§dBillBoardMode.ALL" （品红色）
  • 文本颜色: 青色、黄色、绿色、品红色

变换效果:

// 垂直浮动
t.setShapeMatrixPivot(
    new Vec3(0, Math.sin(Minecraft.getInstance().level.getGameTime() * 0.05) * 0.3, 0)
);

特性:

  • 多行文本显示
  • 支持Minecraft颜色代码
  • 始终面向玩家（公告牌效果）
  • 轻微上下浮动

Minecraft内置元素

方块形状（可抓取）

资源位置: ryansrenderingkit:test/demo_block_shape

图形类型: 方块形状（Block Shape）

配置参数:

  • 位置: 动态计算
  • 方块: Blocks.GLASS.defaultBlockState()（玻璃方块）
  • 光照: FULL_BLOCK（完全亮度）

变换效果: 使用 handleMouseGrab() 函数实现鼠标抓取功能。

交互功能: 可以用鼠标左键抓取并移动玻璃方块。

交互式测量工具

距离测量器

这是一个完整的交互式测量工具，由多个形状组成。

组件1: 锚点1

  • 资源位置: ryansrenderingkit:test/demo_a1
  • 类型: 小球体
  • 半径: 0.1f
  • 分段数: 16
  • 颜色: 蓝色半透明 Color(0, 0, 1, 0.5f)
  • 功能: 可抓取移动的起点

组件2: 锚点2

  • 资源位置: ryansrenderingkit:test/demo_a2
  • 类型: 小球体
  • 半径: 0.1f
  • 分段数: 16
  • 颜色: 红色半透明 Color(1, 0, 0, 0.5f)
  • 功能: 可抓取移动的终点

组件3: 连接线

  • 资源位置: ryansrenderingkit:test/demo_l1
  • 类型: 线段
  • 线宽: 2.1f
  • 颜色: 白色
  • 功能: 实时连接两个锚点

变换逻辑:

LineShape shape = (LineShape) transformer.getShape();
// 实时更新线段两端，跟随锚点位置
shape.forceSetStart(anchor1.transformer.getShapeWorldPivot(false));
shape.forceSetEnd(anchor2.transformer.getShapeWorldPivot(false));

组件4: 距离标签

  • 资源位置: ryansrenderingkit:test/demo_t1
  • 类型: 文本
  • 功能: 显示两锚点间的实时距离

使用方法:

  1. 用鼠标左键拖动蓝色或红色球体到不同位置
  2. 白色线段会自动连接两个球体
  3. 文本标签显示精确距离（保留两位小数）
  4. 标签会智能定位在线段中间靠近玩家的位置

通用交互函数

handleMouseGrab() 函数

这是一个通用的鼠标抓取处理函数，用于多个可交互形状。

public static void handleMouseGrab(Player player, Shape shape, DefaultTransformer transformer) {
    Minecraft mc = Minecraft.getInstance();
    boolean isLeftPressed = mc.mouseHandler.isLeftPressed();
    boolean wasHolding = shape.getCustomData("isHolding", false);
    boolean isLookingAt = shape.isPlayerLookingAt().hit;
    
    // 保存原始颜色
    if (!wasHolding) shape.putCustomData("color", shape.baseColor);
    
    boolean shouldHold = wasHolding || (isLeftPressed && isLookingAt);
    
    // 开始抓取
    if (shouldHold && !wasHolding) {
        double distance = transformer.getShapeWorldPivot(true)
                .distanceTo(player.getEyePosition());
        shape.putCustomData("grabDistance", distance);
        shape.putCustomData("isHolding", true);
    }
    
    // 持续抓取中
    if (isLeftPressed && shape.getCustomData("isHolding", false)) {
        double savedDistance = shape.getCustomData("grabDistance", 4.0);
        Vec3 eyePos = player.getEyePosition(transformer.getTickDelta());
        Vec3 look = player.getLookAngle();
        
        // 将形状移动到玩家视线方向
        Vec3 targetPos = eyePos.add(look.scale(savedDistance));
        
        transformer.setShapeWorldPivot(targetPos);
        transformer.world.position.syncLastToTarget();
        shape.baseColor = new Color(255, 255, 255, 200);  // 抓取时变白色
    } 
    // 释放抓取
    else if (!isLeftPressed && wasHolding) {
        shape.putCustomData("isHolding", false);
        shape.putCustomData("grabDistance", null);
        shape.baseColor = shape.getCustomData("color", Color.WHITE);
    } 
    // 未抓取状态
    else if (!isLeftPressed) {
        shape.baseColor = shape.getCustomData("color", Color.WHITE);
    }
}

使用 VuePress + Plume 主题构建

Copyright © 2025 Ryan100c