描述字体的类。
示例
语法
p5.Font([pInst])
参数
指向 p5 实例的指针。
方法
返回使用当前字体编写的文本的边界框。
边界框是可以包裹住文本字符串的最小矩形。 font.textBounds()
返回一个包含边界框位置和大小的对象。例如,调用 font.textBounds('p5*js', 5, 20) 将返回以下格式的对象: { x: 5.7, y: 12.1 , w: 9.9, h: 28.6 }
x
和 y
属性始终代表边界框左上角的坐标。
第一个参数 str
是一条文本字符串。第二和第三个参数 x
和 y
代表文本的位置。默认情况下,它们决定了边界框左下角的坐标。请参考 textAlign() 函数,以便了解更多文本对齐方式。
第四个参数fontSize
是可选参数。它可用于设置能够决定边界框尺寸的字体大小。默认情况下,font.textBounds()
函数将使用当前的 textSize()。
返回一组勾勒出使用当前字体的文本轮廓的点的数列。
数组中的每个点对象都有三个属性,用于描述点的位置和朝向(也称其路径角)。例如:{ x: "10, y: 20, alpha: 450 }
。
第一个参数 str
是一条文本字符串。第二和第三个参数 x
和 y
代表了文本的位置。默认情况下,它们决定了边界框左下角的坐标。请参考 textAlign() 了解更多文本对齐方式。
第四个参数 fontSize
是可选参数,用于设置了文本的字体大小。默认情况下,font.textToPoints()
会使用当前的 textSize()。
第五个参数,options
,也是可选的。 font.textToPoints()
函数在此参数上需要包含以下两种属性的对象:
sampleFactor
是文本路径长度与 采样数量之比。默认值为 0.1。值越高,沿路径产生的点越多,因此路径也更精确。
当 simplifyThreshold
的值不为0时,将删除所有共线的点。该值是确定两条边是否为共线的阈值角度。
相关参考
image
将图像绘制到画布上。 第一个参数 img 是要绘制的源图像。 img 可以是以下任何对象: p5.Image p5.Element p5.Texture p5.Framebuffer p5.FramebufferTexture 第二个和第三个参数,dx 和 dy,设置了 目标图像左上角的坐标。用于其他方式 定位图片参考 imageMode()。 这是一个图表,解释了在 image() 中,可选参数如何工作: 第四个和第五个参数,dw和dh 是可选的。他们设定了绘制目标图像的宽度和高度。默认情况下,image() 按原始尺寸绘制完整的源图像。 第六和第七个参数,sx和 sy 也是可选的。 这些坐标定义了从源图像中绘制的分段左上角。 第八个和第九个参数,sw 和 sh 也是可选的。 这些坐标定义了从源图像中绘制的分段宽度和高度。默认情况下,image() 绘制从 (sx, sy) 开始并延伸到源图像边缘的完整分段。 第九个参数,fit,也是可选的。在不影响其纵横比的情况下,它绘制了源图像的分段。如果 CONTAIN 通过了,在目标矩形中会出现完整的分段。如果 COVER 通过了,则该分段将完全覆盖目标矩形。这可能会产生分段放大的效果。 第十个和第十一个参数,xAlign 和 yAlign,也是可选的。他们确定如何对齐拟合的分段。 xAlign 可以设置为 LEFT、RIGHT 或 CENTER。 yAlign 可以设置为 TOP、BOTTOM 或 CENTER。默认情况下,xAlign 和 yAlign 设置为 CENTER。.
imageMode
调用 image() 更改图像的绘制位置。 默认情况下,image() 前两个参数是图像左上角的 x 和 y 坐标。接下来的参数是 它的宽度和高度。和上面相同,调用 imageMode(CORNER)。 imageMode(CORNERS)也使用 image() 前两个参数作为图像左上角的 x 和 y 坐标。第三个和第四个参数是它右下角的坐标。 imageMode(CENTER) 使用前两个参数 image() 作为图像中心的 x 和 y 坐标。接下来的参数是它的宽度和高度。.
loadFont
加载字体并创建 p5.Font 对象。 loadFont() 可以加载 .otf 或 .ttf 格式的字体。已加载字体可以用于画布和 HTML 元素中的文本样式。 第一个参数 path 是字体文件的路径。 "本地文件的路径应该是相对的。例如,'/assets/inconsolata.otf'。下列的示例中使用的 Inconsolata 字体可以在此处免费下载。 远程文件的路径应该是 URL。例如, "'https":"//example.com/inconsolata.otf'。 URL 可能会因为浏览器安全被阻止。" 第二个参数successCallback是可选的。如果通过一个函数,如果字体加载就会调用。 如果需要,回调函数可以使用新的 p5.Font 对象。 第三个参数,failureCallback,也是可选的。如果通过一个函数,如果字体加载失败就会调用。如果需要,回调函数可能会使用错误 Event 对象。 加载字体可能需要一些时间。字体用于 setup() 或 draw() 之前,在 preload() 调用 loadFont(),以确保字体先加载。.
loadImage
加载图像来创建一个 p5.Image 对象。 loadImage() 的第一个参数有三种方式来解释。 "如果传入一个图片路径,loadImage() 将加载它。本地文件应该使用相对路径,例如'/assets/thundercat.jpg'。网址例如 'https":"//example.com/thundercat.jpg' 可能因浏览器安全原因被屏蔽。原始图像数据也可以通过 'data:image/png;base64,arandomsequenceofcharacters' 作为 base64 编码图像传递。" 第二个参数是可选的。如果传入一个函数,图像加载后,它会被调用。回调函数可以选择使用 新的 p5.Image 对象。 第三个参数也是可选的。如果传入一个函数,图像加载失败时它会被调用。这个回调函数可以选择使用错误事件。 加载图像可能需要一些时间。在 preload() 中调用 loadImage(), 可以确保图像在 setup() 或 draw() 使用之前先加载。.