Grease Pencil Shader

../../_images/grease-pencil_materials_grease_pencil_shader_panel.pngShader panel with only Stroke component activated.

The Grease Pencil Shader create a material that can workwith strokes and/or filled areas of a Grease Pencil Object.

Stroke and fill components has it own section panel andthey can be enabled with a checkbox on the panel header.

Stroke only has effect on the lines and Fill only on the areasdetermined by closed lines (by connecting the lines start and end points).

Note

The shader is not yet a BSDF capable shader to interact with Blender lightsand can only be setting up on the Material Properties panel (it is not a shader node).

Properties

Stroke

When enabled, the shader use the stroke component.The Stroke component controls how to render the edit lines.

  • Mode Type
  • Defines how to display or distribute the output material over the stroke.

    • Line
    • Connects every points in the strokes showing a continuous line.
    • Dots
    • Use a disk shape at each point in the stroke.The dots are not connected.
    • Boxes
    • Use a box shape at each point in the stroke.The boxes are not connected.
  • Style
  • The type of the material.

    • Solid
    • Use a solid color.

      • Color
      • The color of the stroke.
    • Texture
    • Use an image texture.

      • Image
      • The image data-block used as an image source.
      • UV Factor
      • The image size along the stroke.
      • Use As Stencil Mask
      • When enabled, use the image alpha as a stencil mask.

        • Color
        • Color to use on not transparent areas of the image.
      • Mix Color
      • When enabled, mix the image with a certain color.

        • Factor
        • Mixing amount.
        • Color
        • The color to mix.
  • Alignment
  • Defines how to align the Dots and Boxes along the drawing path and with the object's rotation.

    • Path
    • Aligns to the drawing path and the object's rotation.
    • Object
    • Aligns to the object's rotation; ignoring the drawing path.
    • Fixed
    • Aligns to the screen space; ignoring the drawing path and the object's rotation.
Samples of different material strokes mode types and styles.
../../_images/grease-pencil_shader_stroke-solid-line.pngMode Type: Line, Style: Solid.../../_images/grease-pencil_shader_stroke-texture-line.pngMode Type: Line, Style: Texture.../../_images/grease-pencil_shader_stroke-solid-dot.pngMode Type: Dot, Style: Solid.../../_images/grease-pencil_shader_stroke-texture-dot.pngMode Type: Dot, Style: Texture.

Fill

When enabled, the shader use the fill component.The Fill component control how to render the filled areas determined by closed edit lines.

  • Style
  • The type of material.

    • Solid
    • Use solid color.

      • Color
      • The color of the fill.
    • Gradient
    • Use a color gradient.

Gradient Type

Linear
Mix the colors along a single axis.
Radial
Mix the colors radiating from a center point.
  1. - Color.
  2. - The primary color.
  3. - Secondary color.
  4. - The secondary color.
  5. - Mix Factor
  6. - Primary and secondary colors mixing amount.
  7. - Flip colors
  8. - Flips the gradient, inverting the primary and secondary colors.
  9. - Location
  10. -

Shifts the gradient position.

X, Y

  1. - Scale
  2. -

Scales the gradient.

X, Y

  1. - Angle
  2. - Rotates the gradient.
  • Checkerboard
  • Use a checkered pattern.

    • Color.
    • The primary color.
    • Secondary color.
    • The secondary color.
    • Flip colors
    • Invert the primary and secondary colors.
    • Location
    • Shift the checkered pattern position.

X, Y

  1. - Scale
  2. - Overall checkered pattern scale.
  3. - Angle
  4. - Rotate the checkered pattern.
  5. - Box Size
  6. - Sets the box size of the checkered pattern.
  • Texture
  • Use an image texture.

    • Image
    • The image data-block used as an image source.
    • Use As Stencil Mask
    • When enabled, use the image's alpha as a stencil mask.

      • Color
      • Color to use on not transparent areas of the image.
    • Offset
    • Shifts the image position.

X, Y

  1. - Scale
  2. -

Scales the image.

X, Y

  1. - Angle
  2. - Rotates the image.
  3. - Opacity
  4. - The texture's transparency.
  5. - Clip Image
  6. - When enabled, show one image instance only (do not repeat).
  7. - Mix With Color
  8. -

When enabled, mix the image with a certain color.

  1. - Factor
  2. - Mixing amount.
  3. - Color
  4. - Color to mix.
Samples of different material fill styles.
../../_images/grease-pencil_shader_fill-solid.pngStyle: Solid.../../_images/grease-pencil_shader_fill-gradient.pngStyle: Gradient.../../_images/grease-pencil_shader_fill-checkerboard.pngStyle: Checkerboard.../../_images/grease-pencil_shader_fill-texture.pngStyle: Texture.