Skip to main content

Materials

Materials Settings

Material libraries in Rayforge allow you to organize and manage collections of materials for your laser cutting and engraving projects. This guide explains the difference between core and user libraries, and how to create your own libraries and add materials to them.

note

Assigning a material to a stock item affects both its visual appearance in the 2D and 3D canvas and which recipes apply to it: material-specific recipes match against the assigned material. In future releases, materials will be used to derive more functional parameters.

Creating a New Library​

To create your own material library:

  1. Open the Settings menu and select Materials
  2. Click the Add New Library button to create a new library
  3. Enter a descriptive name for your library (e.g., "My Workshop Materials")
  4. Click Create to finalize

Your new library will be created in the user data directory and will be available immediately.

Adding Materials to Libraries​

Creating a New Material​

  1. Select the library where you want to add the material
  2. Click the Add New Material button in the materials list
  3. Fill in the material properties:
    • Name: Human-readable name
    • Category: Grouping category (e.g., "Wood", "Acrylic")
    • Appearance: Visual properties (see below)
  4. Click Save to add the material to the library

Material Properties Explained​

Name​

  • Human-readable name displayed in the interface
  • Can contain spaces and special characters

Category​

  • Used for organizing materials within the library
  • Common categories include: Wood, Acrylic, Metal, Paper, Leather
  • You can create custom categories as needed

Texture​

A texture image (WebP or PNG) that is tiled across the material surface. When set, the material renders with the texture instead of a flat color. Textures can be optimized to WebP with the scripts/optimize_material_textures.py script to keep material files small.

Texture Scale​

The size (in mm) that one texture tile covers on the material. Smaller values repeat the texture more often across the same surface.

Color​

The base color of the material. When a texture is set and the material is tintable, the color tints the texture instead. The color is only used for visual appearance on the work surface - it does not affect the laser path in any way.

Tintable​

When enabled, the material's texture can be tinted with the color above. This lets a single textured material (e.g. "Acrylic") cover multiple color variants: the color is applied per stock item in the Stock Properties dialog.

Roughness​

A 0-1 value describing how rough or polished the surface appears in the 3D view. Lower values look glossy, higher values look matte.

Metallic​

A 0-1 value describing whether the surface reflects light like a metal in the 3D view. Set to 1 for metallic materials, 0 for non-metallic ones.

Managing Existing Materials​

Editing Materials​

  1. Select the material you want to edit
  2. Click the Edit button
  3. Modify the desired properties
  4. Click Save to apply changes

Deleting Materials​

  1. Select the material you want to delete
  2. Click the Delete button
  3. Confirm the deletion in the dialog
warning

Deleting a material is permanent and cannot be undone.