G'MIC GIMP Help: garagecoder's Wiremap (gcd_wiremap) - GreycLab/gmic-community GitHub Wiki

Note: General information applicable to all help files can be found at the end of this page.

Overview

This script calculates the 3 dimensional heights of pixels in an image based upon the pixels Value. (The value is defined as Square Root of (r*r+g*g+b*b).) These values are then used to generate a 2-dimensional simulation of a 3-dimensional map grid for the image. These are similar in appearance to the 3-d grids generated by software which creates maps of world terrain in 3D.

Picture of script option controls.

The Controls

  1. Segments -- This refers to the number of intersections, or vertices, of grid lines that will appear horizontally on the image measured at it's widest width. The number of vertical intersections will be calculated from the distance between the horizontal points, evenly set into the vertical height of the image.
    Default: 100
    Range: 4 - 400
    TIP: Large values here increase runtime for the script.

  2. Depth -- This values represents the maximum difference in height for Your image. A black pixel on Your image would be treated as height 0, while a white pixel would be treated as the value you entered here.
    Default: 100
    Range: 4 - 400
    TIP: Using a value of 100 here allows You to treat the gradiations generated by the script as percentages of an arbitrary altitude scale.
    TIP: Using a value of 200 here allows You to treat the gradiations generated by the script as percentages above sea level and below sea level for an arbitrary altitude scale.

  3. Smoothness -- This value determines how sharp or smooth the peaks, and altitude changes on Your image are. The lower the value, the sharper the peaks and valleys, while higher values would be shown more "rounded".
    Default: 0.50
    Range: 0.00 to 2.00

  4. Distance -- The simplest description of this controls would be "Zoom Factor". Values are counter intuitive here , with larger values zooming out, and smaller values zooming in.
    Default: 0.50 (Approximate 25% Zoomed Out)
    Range: -2.00 -- 2.00

  5. Output -- This defines the output mode for the script, and there are several options:
    Black and White -- The default setting, providing a white grid on an all black background.
    Color -- A grid whose lines are displayed in the same color as the source image area they represent, on a black background.(See Input Details below)
    Transparent Black and White -- A white grid on a transparent background.
    Transparent Color -- A grid whose lines are displayed in the same color as the source image area they represent, on a Transparent background.(See Input Details below)

Input Details

Black and White Modes

The script processes a single layer in the "Black and White" "Output" modes. It uses oversampling by reducing the image to a width equal to the "Segments" value, and uses the values of the pixels on this temporary layer, to define it's grid. While it will work on any RGB layer, it is meant to function on a Pseudo Greyscale layer, where every pixel's Red Green and Blue value are the same. These "Heightmaps" as they are often called provide the truest results.
Valid Input/Output Settings:
Input: Any except None
Output: Any

Color Modes

The script process it's grid the same way in this mode as it does in in the Black and White modes, until it comes to coloring them. At that point it draws it's colorization data from a layer BELOW the source layer in the layer stack. This second layer must be visible to be used by the plugin, and thus by the script.
Valid Input/Output Settings:
Input: Any which provide the active layer and the layer below
Output: Any

Help Home Page   Script Help Sorted by Author   Script Help Sorted by Internal Name
Script Help Sorted by Menu Name   Script Help for This Author's Scripts