# av.video.kernel 库模块帮助文档 ## av.video.kernel 成员列表 # ### av.video.kernel._dll # 内存加载的 kernel.dll 模块 ### av.video.kernel.background(buf,w,h,spec) # 生成背景：渐变 + 暗角 + 静态粗颗粒（浮点计算、量化一次），写入不透明 BGRX。 spec: type="linear"|"radial",angle,cx,cy,radius,stops={{位置,0xRRGGBB}},vignette,grain,cell,seed ### av.video.kernel.blend(dst,src,pixels,a256) # 交叉混合 dst += (src-dst)*a/256 ### av.video.kernel.blit(dst,dw,dh,src,sw,sh,dx,dy) # 整数偏移复制（带裁剪） ### av.video.kernel.bounds(buf,w,h) # 非透明像素（alpha>0）的包围盒 {x0;y0;x1;y1}（像素，开区间）；全透明返回 null ### av.video.kernel.boxMean(grid,cols,rows,win,outBuf) # 盒式均值：win×win 窗口（步长 1），输出 (cols-win+1)×(rows-win+1) 个 float ### av.video.kernel.clear(buf,w,h,rect) # 清成全透明；rect={x0;y0;x1;y1}，省略为整张 ### av.video.kernel.flickerScore(a,b,c,d,e,cols,rows,win,thr,mask) # 单帧闪烁评分（av.video.flicker 内部使用）：a~e 为连续 5 帧的 boxMean 结果，评估中间帧；返回分数(峰高/thr),窗口序号,方向(+1 更强/-1 更弱) ### av.video.kernel.glitch(dst,src,w,h,amount,seed,split) # 故障效果：少量粗条带错位，错位条带内轻微 RGB 分离；src 为 dst 的副本。 amount 0~1；seed 决定条带（建议约 15Hz 换一次，每个状态停留约 2 帧）；split 满幅 RGB 分离占宽度比例，默认 0.004，0 = 不分离 ### av.video.kernel.glitchMix(dst,a,b,w,h,amount,mix,seed,layoutSeed,split) # 故障撕裂转场：旧画面 a 按固定细条逐条换成新画面 b（mix 0~1，单调），另有少量粗条带错位。 seed 约 15Hz 换一次；layoutSeed 决定细条布局（整个转场不变）；dst 不能与 a、b 相同；split 默认 0（细彩边经 4:2:0 色度抽样会糊成色块） ### av.video.kernel.grain(buf,w,h,amount,cell,seed) # 给不透明 BGRX 图像加静态粗颗粒（±amount 色阶，cell 像素一格，默认 3；与 background 的 grain 同一种噪声），用于过于平滑的深色背景图（AI 生成图常见）防止编码后出色带；只加在背景层 ### av.video.kernel.lumaStats(src,w,h,stride,cols,rows,meanBuf,sdBuf,step) # 分区亮度统计：cols×rows 格的平均亮度与标准差（0~255，float 缓冲区，可为 null）； stride 默认 w*4；step 采样步长（行列都隔 step 像素取样），默认 1 ### av.video.kernel.motionCheck(P,C,N,cols,rows,x0,y0,x1,y1,S,gs) # 闪烁复核（av.video.flicker 内部使用）：用整体平移能否解释中间帧 C 的突变（规则纹理快速平移）。 P/C/N 为连续三帧的缩略亮度图（float），区域以格计、含两端，S 搜索半径（格），gs 粗搜间隔（默认 1）；返回 {e0;emc;d1x;d1y;d2x;d2y;peakMc;peak0;n}：不补偿/补偿后残差和、P→C 与 C→N 的移动（格/帧）、单格最大残差、格数（区域全在图外为 0） ### av.video.kernel.over(dst,src,w,h,opacity,rect) # 图层合成：同尺寸预乘 BGRA 图层按整体不透明度叠加到 dst； rect={x0;y0;x1;y1} 限定范围（像素，开区间），省略为整张 ### av.video.kernel.resample(dstBuf,dw,dh,srcBuf,sw,sh,dstRect,srcRect,opt) # 轴对齐缩放平移重采样（浮点坐标精确、缩小有预滤波、边缘按覆盖率抗锯齿），预乘 alpha 叠加到目标；opt: opacity,filter,clip,copy,radius(圆角半径，目标像素)