点赞 + 关注 + 收藏 = 学会了

cylinder() 是 p5.js 中用于绘制3D 圆柱体的函数。圆柱体由顶部、底部两个圆形和侧面组成，所有表面由三角形拼接而成（这是 3D 绘图的常见方式）。

注意：cylinder() 只能在「WebGL 模式」下使用（WebGL 是浏览器的 3D 绘图技术），普通 2D 模式下无法生效。

基础语法

cylinder() 的参数非常灵活，所有参数都是可选的，按顺序传入即可：

cylinder([radius], [height], [detailX], [detailY], [bottomCap], [topCap])

• radius（半径）
  • 作用：设置圆柱体底部 / 顶部圆形的半径。
  • 类型：数字（比如 20、50）。
  • 默认值：50（不填的话，半径就是 50）。
• height（高度）
  • 作用：设置圆柱体上下底之间的距离（沿 y 轴方向）。
  • 类型：数字。
  • 默认值：等于 radius（不填的话，高度和半径一样）。
• detailX（水平细分）
  • 作用：控制顶部和底部圆形的「边数」。边数越少，形状越像多边形（比如 4 边就像盒子）；边数越多，越接近圆形。
  • 类型：整数（比如 4、24）。
  • 默认值：24（默认看起来比较圆）。
• detailY（垂直细分）
  • 作用：控制圆柱体侧面沿高度方向的「三角形细分数量」。数值越大，侧面越平滑。
  • 类型：整数（比如 1、3）。
  • 默认值：1（默认侧面较简洁）。
• bottomCap（底部开关）
  • 作用：控制是否绘制底部圆形。
  • 类型：布尔值（true 绘制，false 不绘制）。
  • 默认值：true（默认绘制底部）。
• topCap（顶部开关）
  • 作用：控制是否绘制顶部圆形。
  • 类型：布尔值（true 绘制，false 不绘制）。
  • 默认值：true（默认绘制顶部）。

动手试试

默认圆柱体

一个半径 50、高度 50、边缘平滑（detailX=24）、带上下底的圆柱体。

function setup() {
  createCanvas(200, 200, WEBGL); // 开启 WebGL 模式（必须）
  describe('灰色背景上的白色圆柱体');
}

function draw() {
  background(200); // 灰色背景
  orbitControl(); // 允许鼠标拖动旋转视角（3D 必备）
  cylinder(); // 不填参数，用默认值
}

createCanvas 第三个参数 WEBGL 是 3D 绘图的开关；orbitControl() 让你能拖动鼠标 360° 查看圆柱体。

指定半径

半径 30，高度默认等于半径（也是 30）的圆柱体。

// 其他代码和示例 1 相同，仅修改 cylinder() 部分
cylinder(30); // 只传 radius=30

只传一个参数时，默认是 radius，height 会自动等于它。

指定半径和高度

半径 30、高度 50 的圆柱体（更 “瘦长”）。

cylinder(30, 50); // radius=30，height=50

调整水平细分（detailX）

顶部和底部只有 5 条边，看起来像一个 “五角柱”（接近盒子）。

detailX 越小，形状越 “棱角分明”；越大越接近圆形。

cylinder(30, 50, 6); // detailX=6

调整垂直细分（detailY）

侧面沿高度方向分成 2 段，比默认（detailY=1）更平滑。

cylinder(30, 50, 24, 2); // detailX=24（默认圆），detailY=2

隐藏底部

cylinder(30, 50, 24, 1, false); // bottomCap=false

隐藏顶部和底部

只剩侧面，像一个 “圆筒”（比如水管）。

cylinder(30, 50, 24, 1, false, false); // 两个都设为 false

给圆柱上色

加入颜色和旋转效果。

function setup() {
  createCanvas(400, 400, WEBGL); // 更大的画布
  describe('会旋转的彩色圆柱体');
}

function draw() {
  background(25); // 深色背景
  orbitControl(); // 允许鼠标旋转
  
  // 设置颜色（RGB 模式：红、绿、蓝）
  fill(100, 200, 255); // 浅蓝色
  
  // 让圆柱体旋转（随时间变化角度）
  rotateX(frameCount * 0.01); // 绕 x 轴旋转
  rotateY(frameCount * 0.02); // 绕 y 轴旋转
  
  // 绘制圆柱体：半径 60，高度 120，较圆（detailX=16），侧面平滑（detailY=3）
  cylinder(60, 120, 16, 3);
}

---

以上就是本文的全部内容啦，想了解更多 P5.js 用法欢迎关注 《P5.js中文教程》。

也可以➕我 green bubble 吹吹水咯

点赞 + 关注 + 收藏 = 学会了

点赞 + 关注 + 收藏 = 学会了

如果你已经会用box()、sphere()画简单 3D 形状，想组合它们做出复杂模型，又担心画面卡顿，那么buildGeometry()就是你的 "性能救星"。这个函数能把多个简单形状 "焊接" 成一个自定义 3D 模型，让绘制效率飙升。

什么是 buildGeometry ()？

buildGeometry()是 p5.js 中用于组装复杂 3D 模型的工具函数。它的核心作用就像 "预制构件厂"：

• 把多个简单 3D 形状（比如box()、sphere()）组合成一个完整的p5.Geometry对象（可以理解为 "自定义 3D 零件"）；
• 这个 "零件" 只需要在程序启动时制作一次，之后每次绘制直接调用即可，大幅减少重复计算；
• 必须在WebGL 模式下使用（和所有 3D 函数一样）。

buildGeometry()就是来解决这个问题的：它能把多个简单 3D 形状 “打包” 成一个p5.Geometry对象，只需创建一次，之后反复绘制都不会卡顿。就像快递打包，把多个小包裹捆成一个大包裹，搬运起来更高效～

基础用法

用buildGeometry打包一个球体，然后绘制它。

let myShape; // 存储打包好的3D对象

function setup() {
  // 开启WebGL模式（3D绘图必备）
  createCanvas(400, 400, WEBGL);
  // 用buildGeometry创建3D对象，回调函数是makeShape
  myShape = buildGeometry(makeShape);
}

function draw() {
  background(200); // 灰色背景
  orbitControl(); // 允许鼠标拖动旋转视角
  lights(); // 添加光照（3D物体需要光照才看得见）
  model(myShape); // 绘制打包好的3D对象
}

// 回调函数：定义要打包的形状
function makeShape() {
  sphere(50); // 画一个半径50的球体
}

旋转的几何花朵

用buildGeometry组合多个锥体，形成一朵 “花”，然后让它随时间旋转并变色，展示高性能复杂 3D 动画的实现。

let flower;
let hueValue = 0; // 色相值（用于颜色变化）

function setup() {
  createCanvas(600, 600, WEBGL);
  // 创建几何花朵
  flower = buildGeometry(makeFlower);
}

function draw() {
  background(0); // 黑色背景
  orbitControl(); // 允许鼠标旋转视角
  lights(); // 光照
  
  // 颜色随时间变化（HSB模式：色相、饱和度、亮度）
  colorMode(HSB);
  fill(hueValue % 360, 80, 90);
  hueValue += 0.5;
  
  // 整体旋转（X和Y轴同时转，更有动感）
  // rotateX(frameCount * 0.005);
  rotateY(frameCount * 0.008);
  
  model(flower); // 绘制花朵
}

// 构建花朵形状的回调函数
function makeFlower() {
  // 中心球体
  sphere(15);
  
  // 周围的“花瓣”：12个锥体
  for (let i = 0; i < 12; i++) {
    push();
    // 绕Y轴均匀分布（360度/12=30度一个）
    rotateY(i * PI / 6);
    // 沿Z轴向外移动
    translate(0, 0, 40);
    // 锥体：底面半径10，高30，朝上
    cone(10, 30);
    pop();
  }
  
}

---

以上就是本文的全部内容啦，想了解更多 P5.js 用法欢迎关注 《P5.js中文教程》。

也可以➕我 green bubble 吹吹水咯

点赞 + 关注 + 收藏 = 学会了