PencilLine
The PencilLine node is used to draw lines over objects. It supports multi-threading for fast drawing.
Objects and materials added to [Line Sets] become the targets for drawing the lines. [Line Sets] contain [Brush Settings] which control the color and thickness of the lines, as well as detection settings for 8 types of edges to specify the edges in the geometry over which lines should be drawn. Independent [Brush Settings] can be used for each type of edge in the edge detection settings for extra flexibility in the specification of line color and thickness. By also using the [Reduction] settings to change line thickness according to the distance to the camera, all kinds of lines can be created.
Pencil+ 4 Line Parameters¶
This section contains settings related to Pencil+ 4 Line rendering.
Active¶
Enable / disable the rendering of the Pencil+ 4 Line. The line will not be drawn when it is disabled.
Render Priority¶
Set the drawing order for the Lines. When a scene contains multiple PencilLine nodes, lines from nodes with a higher render priority will be drawn after and over lower priority ones.
Line Sets List¶
[Line Sets] are used to manage groups of objects and materials. You specify the objects over which lines will be drawn by adding objects and materials to [Line Sets]. Selecting (clicking on) a [Line Set] in the Line Sets list will display the values of its parameters in the Line Set section.
[Line Sets] at the top of the Line Sets list have priority over the ones listed below them. For example, suppose that line settings are applied to a whole object and that you wish to apply other line settings to a specific material on this object. To do this, the [Line Set] applied to the material is set above the [Line Set] applied to the object. By using this feature, it is also possible to inhibit drawing of specific Edges.
![]() |
![]() |
![]() |
---|---|---|
The object was added to a Line Set. | The red material was added to another Line Set with line color set to green. | Specific edges are disabled. |
Add¶
Add a new Line Set to the list.
Delete¶
Delete the currently selected Line Set.
Up, Down arrows¶
Move the currently selected Line Set up or down in the list.
Objects List¶
Displays the objects added to the current Line Set. Lines will be drawn on the objects in the list using the settings of the [Line Set].
The data in the list is managed by the corresponding PencilLineSet node.
Add¶
Open the [Add objects] window. Select objects in the [Add objects] window and click [Add] to register the objects to the Objects list.
Delete¶
Remove the currently selected objects from the list.
Materials List¶
Displays the materials added to the current Line Set. Lines will be drawn on the materials in the list using the settings of the [Line Set].
The data in the list is managed by the corresponding PencilLineSet node.
Add¶
Open the [Add materials] window. Select materials in the [Add materials] window and click [Add] to register the materials to the Materials list.
Delete¶
Remove the currently selected materials from the list.
Line Size¶
Define the relationship between line thickness and the rendered image size here.
Absolute¶
Draw lines with a fixed size, regardless of the rendered image size. If the brush [Size] is set to 1, the line will always be rendered with a thickness of 1 pixel even if the rendering size changes.
Relative¶
Scale lines according to the size of the rendered image. The scaling rate is based on an image size of 640×480 pixels. If the rendering size changes, the line thickness will be maintained in proportion to the change.
Others¶
Settings for line rendering.
Output to Render Elements only¶
Enable / disable the drawing of Lines on the rendered image. When enabled, the Lines are not drawn on the rendered image, but they are drawn for PencilRenderElements nodes. This functionality is used to produce output images for editing with compositing software.
Over Sampling¶
Use oversampling to improve the quality of details. Effective for drawing fine or complex lines. Increasing the value of [Over Sampling] improves quality but it also increases memory usage and rendering time.
![]() |
![]() |
![]() |
---|---|---|
Over Sampling: 1 | Over Sampling: 2 | Over Sampling: 3 |
Antialiasing¶
Adjust the intensity of antialiasing on lines. Set [Over Sampling] to 1 and [antialiasing] to 0 to disable antialiasing.
Offscreen Distance¶
Set a margin outside the rendering area when drawing Lines. The value is in pixels.
When objects where [Stroke Size Reduction] or [Stroke Alpha Reduction] is applied extend outside the camera frame, using an appropriate value for [Offscreen Distance] makes the circumference of the image look natural. Use a large value when using extremely thick lines or large rendering sizes.
Random Seed¶
Set the seed used to generate the [Random] values in PencilBrushDetail nodes.