attributes.js

/**
* Copyright 2012-2018, Plotly, Inc.
* All rights reserved.
*
* This source code is licensed under the MIT license found in the
* LICENSE file in the root directory of this source tree.
*/

'use strict';

var colorscaleAttrs = require('../../components/colorscale/attributes');
var colorbarAttrs = require('../../components/colorbar/attributes');
var mesh3dAttrs = require('../mesh3d/attributes');
var baseAttrs = require('../../plots/attributes');

var extendFlat = require('../../lib/extend').extendFlat;

var attrs = {
    x: {
        valType: 'data_array',
        role: 'info',
        editType: 'calc+clearAxisTypes',
        description: [
            'Sets the x coordinates of the volume data',
            '(from which the isosurface will be calculated)'
        ].join(' ')
    },
    y: {
        valType: 'data_array',
        role: 'info',
        editType: 'calc+clearAxisTypes',
        description: [
            'Sets the y coordinates of the volume data',
            '(from which the isosurface will be calculated)'
        ].join(' ')
    },
    z: {
        valType: 'data_array',
        role: 'info',
        editType: 'calc+clearAxisTypes',
        description: [
            'Sets the z coordinates of the volume data',
            '(from which the isosurface will be calculated)'
        ].join(' ')
    },

    value: {
        valType: 'data_array',
        role: 'info',
        editType: 'calc',
        description: 'Sets the intensity values of the volume data.'
    },

    isomin: {
        valType: 'number',
        role: 'info',
        editType: 'calc',
        description: 'Sets the minimum intensity bound of the isosurface.'
    },

    isomax: {
        valType: 'number',
        role: 'info',
        editType: 'calc',
        description: 'Sets the maximum intensity bound of the isosurface.'
    },

    xmin: {
        valType: 'number',
        role: 'info',
        editType: 'calc',
        description: 'Sets the minimum x bound of the isosurface.'
    },

    xmax: {
        valType: 'number',
        role: 'info',
        editType: 'calc',
        description: 'Sets the maximum x bound of the isosurface.'
    },

    ymin: {
        valType: 'number',
        role: 'info',
        editType: 'calc',
        description: 'Sets the minimum y bound of the isosurface.'
    },

    ymax: {
        valType: 'number',
        role: 'info',
        editType: 'calc',
        description: 'Sets the maximum y bound of the isosurface.'
    },

    zmin: {
        valType: 'number',
        role: 'info',
        editType: 'calc',
        description: 'Sets the minimum z bound of the isosurface.'
    },

    zmax: {
        valType: 'number',
        role: 'info',
        editType: 'calc',
        description: 'Sets the maximum z bound of the isosurface.'
    },

    smoothnormals: {
        valType: 'boolean',
        role: 'info',
        editType: 'calc',
        description: 'Smooth normals of the isosurface. By default this is set to true.'
    },

    isocaps: {
        valType: 'boolean',
        role: 'info',
        editType: 'calc',
        description: 'Whether to generate isocaps for the isosurface. By default this is set to true.'
    },

    surfacecolor: {
        valType: 'data_array',
        role: 'style',
        editType: 'calc',
        description: [
            'Sets the color of the isosurface.',
            'By default the isosurface color is computed from the colorscale.',
            'Isocaps still use the colorscale colors even with this set.'
        ].join(' ')
    },

    text: {
        valType: 'string',
        role: 'info',
        dflt: '',
        arrayOk: true,
        editType: 'calc',
        description: [
            'Sets the text elements associated with the isosurface points.',
            'If trace `hoverinfo` contains a *text* flag and *hovertext* is not set,',
            'these elements will be seen in the hover labels.'
        ].join(' ')
    }
};

extendFlat(attrs, colorscaleAttrs('', {
    colorAttr: 'value',
    showScaleDflt: true,
    editTypeOverride: 'calc'
}), {
    colorbar: colorbarAttrs
});

var fromMesh3d = ['opacity', 'lightposition', 'lighting'];
fromMesh3d.forEach(function(k) {
    attrs[k] = mesh3dAttrs[k];
});

attrs.hoverinfo = extendFlat({}, baseAttrs.hoverinfo, {
    editType: 'calc',
    flags: ['x', 'y', 'z', 'value', 'text', 'name'],
    dflt: 'x+y+z+value+text+name'
});

module.exports = attrs;