vitem¶

class janim.items.vitem.VItem(*points: Vect, fill_alpha=0, **kwargs)¶

基类：Points

贝塞尔曲线拼接物件，具体说明请参考 Cmpt_VPoints 的文档

points¶

radius¶

stroke¶

fill¶

glow¶

color¶

renderer_cls¶: VItemRenderer 的别名

init_connect() → None¶

设置物件自身的样式，不影响子物件

另见：set()

set_stroke_background(flag: bool = True, *, root_only: bool = False) → Self¶

调整描边与填充的绘制顺序

flag=True 会使得描边被填充遮盖，flag=False 则会使得填充被描边遮盖

shade_in_3d(flag: bool = True, *, root_only: bool = False) → Self¶

调整是否启用三维明暗

启用后，会根据相对于光源（时间轴的 self.light_source）的位置调整颜色深浅

add_tip(at_alpha: float = 1.0, reverse: bool = False, angle: float | None = None, colorize: bool = True, fill_color: JAnimColor | None = None, stroke_color: JAnimColor | None = None, color: JAnimColor | None = None, d_alpha: float = 1e-06, **tip_kwargs)¶

在 at_alpha 处创建一个箭头

默认情况下，箭头与路径方向同向；若传入 reverse=True 则反向
若传入 colorize=True （默认），则会使箭头的颜色与路径的颜色相同
其余参数请参考 ArrowTip

classmethod align_for_interpolate(item1: VItem, item2: VItem) → AlignedData[Self]¶: 进行数据对齐，以便插值

class janim.items.vitem.DashedVItem(vitem: VItem, num_dashes: int = 15, *, dashed_ratio: float = 0.5, dash_offset: float = 0, equal_lengths: Literal['equal', 'approx', 'none'] = 'approx', stroke_color: JAnimColor | ColorArray | None = None, stroke_alpha: Alpha | AlphaArray | None = None, stroke_radius: float | Iterable[float] | None = None, **kwargs)¶

基类：VItem, Group[VItem]

创建传入的 vitem 的虚线化版本，通过虚线端的数量来指定

参数:

num_dashes -- 虚线段的数量
dashed_ratio -- 虚线段的占比，剩下的占比即为空白段
dash_offset -- 将虚线段的起始点沿着路径偏移的比率，例如 1 表示偏移一个虚线段的长度
equal_lengths --
虚线段的长度是否相等，取值为 'equal'、'approx' 或 'none'
- 'equal': 虚线段长度几乎相等
- 'approx': 默认，虚线段长度近似相等
- 'none': 虚线段将按照曲线的参数 t 均匀分布，一般来说长度不相等

static get_dashed_list(points: ndarray, num_dashes: int = 15, dashed_ratio: float = 0.5, dash_offset: float = 0, equal_lengths: Literal['equal', 'approx', 'none'] = 'approx') → list[VItem]¶: 将 points 所表示的路径分割，返回一个包含各虚线段的列表

static get_dashed_list_by_starts_and_ends(points: ndarray, dash_starts: list[float], dash_ends: list[float], equal_lengths: Literal['equal', 'approx', 'none'] = 'approx') → list[VItem]¶

class janim.items.vitem.DashedVItemByRatio(vitem: VItem, dash_ratio: float = 0.03333333333333333, *, dashed_ratio: float = 0.5, equal_lengths: Literal['equal', 'approx', 'none'] = 'approx', stroke_color: JAnimColor | ColorArray | None = None, stroke_alpha: Alpha | AlphaArray | None = None, stroke_radius: float | Iterable[float] | None = None, **kwargs)¶

基类：VItem, Group[VItem]

创建传入的 vitem 的虚线化版本，通过虚线段的长度比率来指定

参数:

dash_ratio -- 每段虚线段占路径总长的比率，例如 1/30 表示每段虚线占路径的 1/30
dashed_ratio -- 虚线段的占比，剩下的占比即为空白段
equal_lengths --
虚线段的长度是否相等，取值为 'equal'、'approx' 或 'none'
- 'equal': 虚线段长度几乎相等
- 'approx': 默认，虚线段长度近似相等
- 'none': 虚线段将按照曲线的参数 t 均匀分布，一般来说长度不相等

static get_dashed_list(points: ndarray, dash_ratio: float = 0.03333333333333333, dashed_ratio: float = 0.5, equal_lengths: Literal['equal', 'approx', 'none'] = 'approx') → list[VItem]¶