Skip to content

Commit

Permalink
Edited Blur Chapter.
Browse files Browse the repository at this point in the history
  • Loading branch information
kaniol-lck committed Jun 25, 2021
1 parent 8c33c48 commit 2c166de
Show file tree
Hide file tree
Showing 12 changed files with 220 additions and 144 deletions.
7 changes: 6 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,9 @@
*.pdf
*.template.md
output.md
*.html
*.html
*txt
pdf/
tmp/
User Manual/
original images/
35 changes: 35 additions & 0 deletions Scripting Guide And Reference Manual/tohtml.lua
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
local lfs = require "lfs"

local function traver(relativePath, doer)
local traverpath, attr
for entry in lfs.dir(lfs.currentdir().."/"..relativePath) do
if entry~='.' and entry~='..' then
if relativePath == "" then
traverpath = entry
else
traverpath = relativePath.."/"..entry
end
attr = lfs.attributes(lfs.currentdir().."/"..traverpath)
if(type(attr)~="table") then --如果获取不到属性表则报错
print('ERROR:'..traverpath..'is not a path')
return nil
end
if(attr.mode == "directory") then
traver(traverpath, doer)
elseif attr.mode=="file" then
if string.find(entry, "%.md$") and entry ~= "output.md" then
doer(traverpath)
end
end
end
end
end

traver("", function(path)
local name = string.match(path, "([^/]-)%.md")
local filename = string.match(path, "(.+)%.md")
local dir = string.match(path, "^(.-)/[^/]+%.md")
if dir and not lfs.attributes(lfs.currentdir().."/output/"..dir) then os.execute([[mkdir "output/]]..dir..[["]]) end
os.execute([[pandoc --standalone --metadata pagetitle="]]..name..[[" --css ../themes/scripting-manual.css "]]..filename..[[.md" -o "output/]]..filename..[[.html"]])
print("Converting "..path)
end)
52 changes: 27 additions & 25 deletions Tool Reference Manual/Blur Tools/Defocus [Dfo].md
Original file line number Diff line number Diff line change
@@ -1,55 +1,57 @@
### Defocus [Dfo] 失焦
### Defocus [Dfo] 散焦

Defocus工具模拟失焦相机镜头的效果,包括晕染和图像眩光。它提供快速但相对不准确的Gaussian模式,以及更逼真但更慢的镜头模式
Defocus工具模拟失焦相机镜头以及泛光和图像眩光的效果。它提供了快速但相对不准确的高斯(Gaussian)模式,以及更逼真但更慢的镜头(Lens)模式

#### Controls 控件

![Dfo_Controls](images/Dfo_Controls.png)![Dfo_Controls2](images/Dfo_Controls2.png)

##### Filter
##### Filter 滤镜

使用此菜单选择应用于创建散焦的精确方法。Gaussian应用相当简单的效果,而Lens模式将创建更加逼真的散焦。Lens模式将比Gaussian慢得多
使用此菜单选择应用于创建散焦的精确方法。高斯模式应用相当简单的效果,而镜头模式将创建更加逼真的散焦。镜头模式将比高斯模式慢得多

##### Lock X/Y
##### Lock X/Y 锁定X/Y

选择Lock X/Y时,将对图像的X轴和Y轴执行相同的散焦量。取消选择以获得单独控制。
勾选Lock X/Y时,将对图像的X轴和Y轴执行相同的散焦量。取消选择以获得单独控制。

##### Defocus Size
##### Defocus Size 散焦大小

Defocus Size控件设置散焦效果的大小。较高的值会使图像模糊更多,并产生更大的光晕。

##### Bloom Level
##### Bloom Level 泛光级别

Bloom Level控件确定应用于高于bloom阈值的像素的晕染的强度和大小
Bloom Level控件确定应用于高于泛光阈值的像素的泛光的强度和大小

##### Bloom Threshold
##### Bloom Threshold 泛光阈值

值高于设置Bloom Threshold的像素将散焦并应用发光(晕染)。低于该值的像素仅进行散焦。
值高于设置Bloom Threshold的像素将散焦并应用泛光。低于该值的像素仅进行散焦。

##### Lens Type
##### Lens Type 镜头类型

用于创建“糟糕的散景”效果的基本形状。这可以通过Angle、Sides和Shape滑块进一步细化。
用于创建“糟糕的散景(bad bokeh)”效果的基本形状。这可以通过Angle、Sides和Shape滑块进一步细化。

##### Lens Angle
##### Lens Angle 镜头角度

定义形状的旋转。将Lens Types设置为NGon可以看到最佳效果。由于圆形的圆特性,当Lens Types设置为Circle时,此滑块将没有可见的效果
定义形状的旋转。将Lens Types设置为NGon可以看到最佳效果。当Lens Types设置为Circle时,因为是圆形,所以此滑块将没有可见的效果

##### Lens Sides
##### Lens Sides 镜头边数

定义NGon形状将具有多少边。将Lens Types设置为NGon可以看到最佳效果。由于圆形的圆特性,当Lens Types设置为Circle时,此滑块将没有可见的效果
定义NGon形状的边数。将Lens Types设置为NGon可以看到最佳效果。当Lens Types设置为Circle时,因为是圆形,所以此滑块将没有可见的效果

##### Lens Shape
##### Lens Shape 镜头形状

定义NGons的指向性。更高的值将创造一个更尖锐,星光的外观。更低的值创造更平滑的NGons。将Lens Types设置为NGon并将Lens Sides设置为5至10可以看到最佳效果。由于圆形的圆特性,当Lens Types设置为Circle时,此滑块将没有可见的效果
定义NGons的指向性。较高的值将创造一个更尖锐的星形外观。较低的值创造更平滑的NGons。将Lens Types设置为NGon并将Lens Sides设置为5至10可以看到最佳效果。当Lens Types设置为Circle时,因为是圆形,所以此滑块将没有可见的效果

##### Use OpenCL
##### Use OpenCL 使用OpenCL

这个选项在Fusion的OpenCL Supercomputing中引入,可以在GPU而不是CPU上产生效果。根据计算机中使用的显卡,这可将工具的速度提高30倍甚至更多。

##### Clipping Mode
##### Clipping Mode 裁剪模式

此选项设置用于在执行定义渲染域时处理图像边缘的模式。这对于像Blur这样的工具非常重要,这可能需要来自当前域之外的图像部分的样本
此选项设置用于在执行定义域渲染时处理图像边缘的模式。这对于像Blur这样的工具非常重要,可能需要来自当前域之外的图像部分的样本

- **Frame:** 默认选项是Frame,它自动设置工具的定义域以使用图像的完整帧,有效地忽略当前的定义域。如果上游DoD小于帧,则帧中的剩余区域将被处理为黑色/透明。
- **Domain:** 在应用工具的效果时,将此选项设置为域将遵循定义的上游域。在工具使用大型滤镜的情况下,这会产生不利的剪切效果。
- **None:** 将此选项设置为None将不会执行任何源图像剪切。这意味着处理通常位于上游DoD之外的工具效果所需的任何数据都将被视为黑/透明。
- **Frame 帧:**默认选项是Frame,它自动设置工具的定义域以使用图像的完整帧,忽略当前的定义域。如果上游DoD小于帧,则帧中的剩余区域将被处理为黑色/透明。

- **Domain 域:**在应用工具的效果时,将此选项设置为域将遵循定义的上游域。在工具使用大型滤镜的情况下,这会产生不利的剪切效果。

- **None 无:**将此选项设置为None将不会执行任何源图像剪切。这意味着处理通常位于上游DoD之外的工具效果所需的任何数据都将被视为黑/透明。
42 changes: 22 additions & 20 deletions Tool Reference Manual/Blur Tools/Directional Blur [DrBl].md
Original file line number Diff line number Diff line change
@@ -1,40 +1,42 @@
### Directional Blur [DrBl] 方向性模糊

此工具用于创建方向性(Directional)和径向(Radial)模糊。它对于创建模拟运动模糊和光线类型效果很有用。Directional Blur会影响所有通道(RGBA)。
此工具用于创建方向性(Directional)和径向(Radial)模糊。它可用于创建模拟运动模糊和光线类型效果。方向性会影响所有通道(RGBA)。

#### Controls
#### Controls 控件

![DrBl_Controls](images/DrBl_Controls.png)

##### Type
##### Type 类型

此按钮阵列用于选择要提供给图像的方向模糊的类型(Type)。

- **Linear:** Linear以直线扭曲图像,类似于超速列车窗口中出现的风景
- **Radial:** 径向将产生一种扭曲,起源于某个任意中心,向外辐射,如果一个人在火车头部向前看就会出现
- **Centered:** Centered按钮产生类似于Linear的结果,但模糊效果均匀分布在原件的两侧
- **Zoom:** Zoom会在图像拖影的比例中产生失真,以模拟以低速快门拍摄相机的变焦条纹。
- **Linear 线性:**Linear以直线扭曲图像,类似于高速列车窗口中出现的风景
- **Radial 径向:**Radial产生一种从中心向外发散的扭曲,类似于在列车头部向前看的样子
- **Centered 居中:**Centered产生类似于Linear的结果,但模糊效果均匀地分布在原点的两侧
- **Zoom 缩放:**Zoom会在图像拖影的比例中产生失真,以模拟以低速快门拍摄相机的变焦条纹。

##### Center X and Y
##### Center X/Y 中心X/Y

此坐标控件和十字准线仅影响Radial和Zoom运动模糊类型。它用于计算模糊效果开始的位置。
此坐标控件和十字准线仅影响Radial和Zoom的运动模糊类型。它用于计算模糊效果开始的位置。

##### Length
##### Length 长度

长度调整效果的强度和方向。低于零的值会导致模糊与角度控制相反。大于滑块最大值的值可以输入到滑块的编辑框中。
Length调整效果的强度和方向。低于零的值会导致模糊与Angle控件相反。大于滑块最大值的值可以输入到滑块的编辑框中。

##### Angle
##### Angle 角度

在两种Linear模式下,此控件将修改方向模糊的方向。在Radial和Zoom模式下,效果将类似于在查看同一点时相机旋转的效果。如果长度滑块的设置不为0,将会产生漩涡的效果。
在两种Linear模式下,此控件将修改方向模糊的方向。在Radial和Zoom模式下,效果将类似于在查看同一点时相机旋转的效果。如果Length滑块的设置不为0,将会产生漩涡的效果。

##### Glow
##### Glow 发光

这将为方向模糊添加一个Glow,可用于复制由较长的快门速度引起的相机曝光增加的效果。
这将为方向模糊添加一个发光,可用于复制由较长的快门速度引起的相机曝光增加的效果。

##### Clipping Mode
##### Clipping Mode 裁剪模式

此选项设置用于在执行定义渲染域时处理图像边缘的模式。这对于像Blur这样的工具非常重要,这可能需要来自当前域之外的图像部分的样本
此选项设置用于在执行定义域渲染时处理图像边缘的模式。这对于像Blur这样的工具非常重要,可能需要来自当前域之外的图像部分的样本

- **Frame:** 默认选项是Frame,它自动设置工具的定义域以使用图像的完整帧,有效地忽略当前的定义域。如果上游DoD小于帧,则帧中的剩余区域将被处理为黑色/透明。
- **Domain:** 在应用工具的效果时,将此选项设置为域将遵循定义的上游域。在工具使用大型滤镜的情况下,这会产生不利的剪切效果。
- **None:** 将此选项设置为None将不会执行任何源图像剪切。这意味着处理通常位于上游DoD之外的工具效果所需的任何数据都将被视为黑/透明。
- **Frame 帧:**默认选项是Frame,它自动设置工具的定义域以使用图像的完整帧,忽略当前的定义域。如果上游DoD小于帧,则帧中的剩余区域将被处理为黑色/透明。

- **Domain 域:**在应用工具的效果时,将此选项设置为域将遵循定义的上游域。在工具使用大型滤镜的情况下,这会产生不利的剪切效果。

- **None 无:**将此选项设置为None将不会执行任何源图像剪切。这意味着处理通常位于上游DoD之外的工具效果所需的任何数据都将被视为黑/透明。
68 changes: 37 additions & 31 deletions Tool Reference Manual/Blur Tools/Glow [Glo].md
Original file line number Diff line number Diff line change
@@ -1,77 +1,83 @@
### Glow [Glo] 发光

Glow基本上是通过模糊图像,然后使模糊的结果变亮并将其与原始图像混合来创建的。
Glow工具提供了一种更方便的方式来实现这种效果,以及该方法的各种变化。例如,Bartlett发光是一种高质量的发光,并有着更平滑的下降,但是,在较大尺寸的情况下,处理器密集程度更高。

#### Controls
Glow工具提供了一种更方便的方式来实现这种效果,以及该方法的各种变化。例如,Bartlett发光是一种高质量并有着更平滑的下降的发光,但在较大尺寸的情况下,计算密集程度更高。

#### Controls 控件

![Glo_Controls](images/Glo_Controls.png)

##### Filter
##### Filter 滤镜

使用这些按钮选择滤镜中使用的模糊方法。选项如下所述。

- **Box:** 一个简单但非常快速的Box滤镜。
- **Bartlett:** Bartlett增加了更柔和、更精细的发光和更平滑的下降,但渲染时间可能比Box更长。
- **Multi-box:** Multi-box使用多个过程中分层的Box滤镜来近似Gaussian形状。利用适度的通过次数(例如,4次),可以获得高质量的模糊,通常比Gaussian滤镜更快,并且没有任何振铃。
- **Gaussian:** Gaussian增加了柔和的光晕,由Gaussian算法模糊。这是默认方法。
- **Blend:** Blend添加了一种在白色和黑色中均匀可见的非线性光晕。
- **Hilight:** Hilight在周围像素中添加发光而不会产生光晕。
- **Solarize:** Solarize增添了发光,使图像过曝。
- **Box 盒式:**一个简单但非常快速的Box滤镜。
- **Bartlett**Bartlett增加了更柔和、更精细的发光和更平滑的下降,但渲染时间可能比Box更长。
- **Multi-box 多重盒式:**Multi-box使用多个过程中分层的Box滤镜来近似Gaussian形状。利用适度的通过次数(例如,4次),可以获得高质量的模糊,通常比Gaussian滤镜更快,并且没有任何振铃。
- **Gaussian 高斯:**Gaussian增加了柔和的光晕,由Gaussian算法模糊。这是默认方法。
- **Blend 混合:**Blend添加了一种在白色和黑色中均匀可见的非线性光晕。
- **Hilight 高光:**Hilight在周围像素中添加发光而不会产生光晕。
- **Solarize 过曝:**Solarize增添了发光,使图像过曝。

##### Color Channels (RGBA)
##### Color Channels (RGBA) 色彩通道(RGBA)

滤镜默认在R、G、B和A通道上运行。通过单击每个通道旁边的复选框可以使它们处于活动或非活动状态,从而实现选择性通道过滤。

这与在常用控件下找到的RGBA复选框不同。该工具在处理之前会考虑这些控件。取消选择通道将导致工具在处理时跳过该通道,从而加快效果的渲染速度。

相反,Common Controls选项卡下的通道控件将在工具处理后应用。

##### Lock X/Y
##### Lock X/Y 锁定X/Y

选中Lock X/Y时,水平和垂直发光量都将被锁定。否则,可能会对每个轴应用单独的模糊量
勾选Lock X/Y时,水平和垂直发光量都将被锁定。否则会对每个轴应用单独的模糊量

##### Glow Size
##### Glow Size 发光大小

Glow Size确定发光效果的大小。较大的值会扩展图像的发光高光的大小。

##### Num Passes
##### Num Passes 处理次数

仅在Multi-box模式下可用。较大的值可以使效果更平滑,但也会增加渲染时间。最好在所需要的质量和可接受的渲染时间之间找到平衡。

##### Glow
##### Glow 发光

Glow滑块确定发光效果的强度。较大的值趋向于使图像完全变为白色。

##### Clipping Mode
##### Clipping Mode 裁剪模式

此选项设置用于在执行定义渲染域时处理图像边缘的模式。这对于像Blur这样的工具非常重要,这可能需要来自当前域之外的图像部分的样本
此选项设置用于在执行定义域渲染时处理图像边缘的模式。这对于像Blur这样的工具非常重要,可能需要来自当前域之外的图像部分的样本

- **Frame:** 默认选项是Frame,它自动设置工具的定义域以使用图像的完整帧,有效地忽略当前的定义域。如果上游DoD小于帧,则帧中的剩余区域将被处理为黑色/透明。
- **Domain:** 在应用工具的效果时,将此选项设置为域将遵循定义的上游域。在工具使用大型滤镜的情况下,这会产生不利的剪切效果。
- **None:** 将此选项设置为None将不会执行任何源图像剪切。这意味着处理通常位于上游DoD之外的工具效果所需的任何数据都将被视为黑/透明。
- **Frame 帧:**默认选项是Frame,它自动设置工具的定义域以使用图像的完整帧,忽略当前的定义域。如果上游DoD小于帧,则帧中的剩余区域将被处理为黑色/透明。

##### Blend
- **Domain 域:**在应用工具的效果时,将此选项设置为域将遵循定义的上游域。在工具使用大型滤镜的情况下,这会产生不利的剪切效果。

- **None 无:**将此选项设置为None将不会执行任何源图像剪切。这意味着处理通常位于上游DoD之外的工具效果所需的任何数据都将被视为黑/透明。

##### Blend 混合

这是Common Controls选项卡中Blend滑块的克隆实例。对此控件进行的更改同时对常用控件中的控件进行。

Blend滑块将工具的结果与其输入混合,将效果与任何小于1.0的值混合。

##### Apply Mode
##### Apply Mode 应用模式

在将发光(Glow)应用于图像时,可以使用三种Apply Mode
在将发光(Glow)应用于图像时,可以使用三种应用模式

- **Normal:** 默认。此模式只是将发光直接添加到原始图像的顶部。
- **Merge Under:** Merge Under根据Alpha通道放置图像下方的发光。
- **Threshold:** Threshold模式允许剪切阈值。将出现一个新的范围滑块,此控件会剪切发光的效果。值低于低值的发光区域中的像素将被推到黑色。值大于高的像素将被推到白色。
- **Normal 正常:**默认。此模式只是将发光直接添加到原始图像的顶部。
- **Merge Under 下方合并:** Merge Under根据Alpha通道放置图像下方的发光。
- **Threshold 阈值:**Threshold模式允许剪切阈值。将出现一个新的范围滑块,此控件会剪切发光的效果。值低于低值的发光区域中的像素将被推到黑色。值大于高的像素将被推到白色。

##### High-Low Range Control
##### High-Low Range Control 高低范围控件

仅在Threshold模式下可用。亮度区域中值低于低值的像素将被推至黑色。值大于高的像素将被推到白色。

##### Color Scale (RGBA)
##### Color Scale (RGBA) 色彩缩放(RGBA)

这些Scale滑块通常是标记为Color Scale的显示控件。它们可用于单独调整应用于每个颜色通道的发光量,从而对发光进行着色。

##### Glow Pre Mask
##### Glow Pre Mask 发光预遮罩

Glow工具支持使用发光蒙版进行预遮罩。Glow Pre Mask在应用发光之前过滤图像。然后将发光合并回原始图像上。这与剪切渲染结果的常规效果蒙版不同。
发光遮罩允许发光延伸到遮罩的边框之外,同时将发光源限制为遮罩内的那些像素。
要应用发光蒙版(glow mask),请在发光工具处于活动状态时从上下文菜单中选择Glow Mask而不是Effect Mask。Glow Mask与其他方面的Effect Mask相同。
要应用发光遮罩(glow mask),请在发光工具处于活动状态时从上下文菜单中选择Glow Mask而不是Effect Mask(效果遮罩)。Glow Mask与其他方面的Effect Mask相同。
2 changes: 1 addition & 1 deletion Tool Reference Manual/Blur Tools/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
## 第五章 Blur Tools 模糊工具

- [Blur [Blur] 模糊](./Blur%20[Blur].md)
- [Defocus [Dfo] 失焦](./Defocus%20[Dfo].md)
- [Defocus [Dfo] 散焦](./Defocus%20[Dfo].md)
- [Directional Blur [DrBl] 方向性模糊](./Directional%20Blur%20[DrBl].md)
- [Glow [Glo] 发光](./Glow%20[Glo].md)
- [Sharpen [Shrp] 锐化](./Sharpen%20[Shrp].md)
Expand Down
Loading

0 comments on commit 2c166de

Please sign in to comment.