Skip to content

Latest commit

 

History

History
125 lines (88 loc) · 8.27 KB

mfm-configuration-options-setup.md

File metadata and controls

125 lines (88 loc) · 8.27 KB

MFM Configuration

Use Premade Options in premade_options for the 3D printable map models collection.

Options values are provided for each 3D printable map model on the specifications page.

You can create 1:1 isolines without scaling applied by referencing 1to1.json. This is useful for non-map models.

You can test configurations with the sample dual color dice or tall cuboid model and G-code in the sample_models folder.

The options file is formatted as a JSON dictionary with the following keys.

Color Assignment

Filament/color positions are 0-based. The first position is represented by 0. The recommended filament order is:

Physical Position (left to right) → 1 2 3 4
0-based tool index in software 0 1 2 3
Purpose Primary (base) Secondary (hydro) Isoline (contour line) Elevation Color Change

Example Options file with Isoline and Elevation Change features

{
    "modelToRealWorldDefaultUnits": 1000,
    "modelOneToNVerticalScale": 500000,
    "modelSeaLevelBaseThickness": 1.8,
    "realWorldIsolineElevationInterval": 500,
    "realWorldIsolineElevationStart": 500,
    "realWorldIsolineElevationEnd": 30000,
    "modelIsolineHeight": 0.1,
    "isolineColorIndex": 2,
    "isolineColorFeatureTypes": [
        "Outer wall",
        "External perimeter"
    ],
    "realWorldElevationReplacementColorStart": 2000,
    "realWorldElevationReplacementColorEnd": 30000,
    "replacementColorIndex": 3,
    "replacementOriginalColorIndex": 0,
    "extraPurgePreviousColors": [2]
}

A map processed with this set of options will have the following appearance:

  • Map elevation (Z) scale is 1:500000.

  • Sea level start at 1.8mm in printed height.

  • The first isoline (contour line) will start at 500m of real world height and future isolines will appear at 500m intervals (1000, 1500, 2000, etc). The isolines will stop at 30000m which is high enough to mean that the isolines will not stop on a normal map. The isoline color will use the filament loaded at index 2.

    • The isoline color will affect all wall/perimeter features.

  • High elevation (snow line) replacement color will start at 2000m and end at 30000m. All uses of the filament at index 0 will be replaced with filament at index 3 when printing in the replacement color range.

  • Whenever a color swap (toolchange) has the previous color of index 2, extra purging (150mm³) will be done.

All Options

Required Options

Key Value Cardinality Description
modelToRealWorldDefaultUnits (model-units:real-world-units) 1 Model units to Real World units scale. Model Gcode units usually default to millimeters. Use one of the two below computed values.
modelToRealWorldDefaultUnits (millimeters:meters) 1000 1 Use 1000 if you specify real world units in meters.
modelToRealWorldDefaultUnits (millimeters:feet) 304.8 1 Use 304.8 if you specify real world units in feet.
modelOneToNVerticalScale (real-world-scale:model-scale) 1 Model to Real World scale (E.g. 1:500000 = 0.1mm:50m)
modelSeaLevelBaseThickness float 1 The model height at sea level (0 m) in model units. This is used as zero elevation for the isoline and elevation color change. (E.g. 1.8 = 1.8mm)

Isoline Options

Key Value Cardinality Description
realWorldIsolineElevationInterval float 1 Isoline elevation interval in real world units.
realWorldIsolineElevationStart float 1 Isoline starting elevation in real world units.
realWorldIsolineElevationEnd float 1 Isoline ending elevation in real world units.
modelIsolineHeight float 1 Isoline display height in model units.
isolineColorIndex integer 1 Isoline filament/color loaded position. Recommended index is 2 (third slot).
isolineColorFeatureTypes [string] ≥0 List of printing object feature/line types (extrusion roles) to recolor at isoline elevations. Empty array will recolor all feature types. Feature types are case sensitive.

Elevation Change Options

Key Value Cardinality Description
realWorldElevationReplacementColorStart float 1 Elevation based replacement color start elevation in real world units.
realWorldElevationReplacementColorEnd float 1 Elevation based replacement color end elevation in real world units.
replacementColorIndex integer 1 Elevation based replacement color filament/color loaded position. Recommended index is 3 (fourth slot).
replacementOriginalColorIndex integer 1 Elevation based replacement color replaced filament/color loaded position. Recommended index is 0 (first slot).

Purge/Flush Options

Key Value Cardinality Description
extraPurgePreviousColors [int] ≥0 Tool indices to add extra purging to when that tool is the previous tool in a toolchange.

Feature Types (Extrusion Roles)

3D printed Feature Types are different categories used to define printing order and settings of printing travel and extrusion movements.

  • walls are vertical features. Wall/Perimeter on Cura and PrusaSlicer.
  • surfaces are the horizontal features that make up the top and bottom layers of 3D objects. Surface/top and bottom on Cura and PrusaSlicer
  • infills are the interior features. Infill on Cura and PrusaSlicer
  • support is an extra structure generated by the slicer to hold up overhanging parts of the model against gravity when printing. You do not need supports enabled when printing the 3D maps. Support on Cura and PrusaSlicer
  • prime tower is an extra structure generated by the slicer to get consistent flow after a toolchange. Depending on the colors you use and amount of small features in the model, you can disable or reduce the Prime Tower size. Prime/Wipe tower on Cura and PrusaSlicer

mfm slicer line type preview

Modifying the feature types colored at an isoline elevation will drastically the isoline's visual appearance. Different materials and colors will adhere to each other differently so strength can be affected.

Feature Types vary depending on the slicer used to generate the G-code. You can view supported feature types for your slicer by previewing your G-code and setting the Color scheme to Line Type. PrusaSlicer and BambuStudio extrusion roles source.

MFM rearranges printing order of features to reduce the number of toolchanges a layer. Isoline recolored features are printed first. This may affect print quality of supported parts but you can work around that by specifying the Support and Bridge feature types for recoloring.

Filament Color data in G-code (Bambu/Orca)

If the final post processed G-code preview does not seem to show the right colors, you can set the filament color data in the ;CONFIG_BLOCK_START of the G-code.

; filament_colour = #00FF80;#0080FF;#FFFF00;#FF0000

This may happen when the tool indexes are not populated with colors in the slicer prior to exporting the G-code.

Slicers may try to use the previous saved colors from your last opened project for the preview to overwrite the G-code color data. Assign the desired in a project and close then reopen and preview the G-code to see the updated colors.