-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
8c33c48
commit 2c166de
Showing
12 changed files
with
220 additions
and
144 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,9 @@ | ||
*.template.md | ||
output.md | ||
*.html | ||
*.html | ||
*txt | ||
pdf/ | ||
tmp/ | ||
User Manual/ | ||
original images/ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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
42
Tool Reference Manual/Blur Tools/Directional Blur [DrBl].md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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之外的工具效果所需的任何数据都将被视为黑/透明。 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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相同。 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.