plotly.js/src/traces/image/attributes.js

The open source javascript graphing library that powers plotly

"use strict";
var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
const extend_1 = require("../../lib/extend");
const attributes_1 = __importDefault(require("../../plots/attributes"));
const template_attributes_1 = require("../../plots/template_attributes");
const attributes_2 = require("../scatter/attributes");
const constants_1 = require("./constants");
const cm = ['rgb', 'rgba', 'rgba256', 'hsl', 'hsla'];
const zminDesc = [];
const zmaxDesc = [];
for (const name of cm) {
    const cr = constants_1.colormodel[name];
    zminDesc.push(`For the \`${name}\` colormodel, it is [${(cr.zminDflt || cr.min).join(', ')}].`);
    zmaxDesc.push(`For the \`${name}\` colormodel, it is [${(cr.zmaxDflt || cr.max).join(', ')}].`);
}
const attributes = {
    source: {
        valType: 'string',
        editType: 'calc',
        description: [
            'Specifies the data URI of the image to be visualized.',
            'The URI consists of "data:image/[<media subtype\\\\>][;base64\\\\],<data\\\\>"'
        ].join(' ')
    },
    z: {
        valType: 'data_array',
        editType: 'calc',
        description: [
            'A 2-dimensional array in which each element is an array of 3 or 4 numbers representing a color.'
        ].join(' ')
    },
    colormodel: {
        valType: 'enumerated',
        values: cm,
        editType: 'calc',
        description: [
            'Color model used to map the numerical color components described in `z` into colors.',
            'If `source` is specified, this attribute will be set to `rgba256`',
            'otherwise it defaults to `rgb`.'
        ].join(' ')
    },
    zsmooth: {
        valType: 'enumerated',
        values: ['fast', false],
        dflt: false,
        editType: 'plot',
        description: [
            'Picks a smoothing algorithm used to smooth `z` data.',
            'This only applies for image traces that use the `source` attribute.'
        ].join(' ')
    },
    zmin: {
        valType: 'info_array',
        items: [
            { valType: 'number', editType: 'calc' },
            { valType: 'number', editType: 'calc' },
            { valType: 'number', editType: 'calc' },
            { valType: 'number', editType: 'calc' }
        ],
        editType: 'calc',
        description: [
            'Array defining the lower bound for each color component.',
            'Note that the default value will depend on the colormodel.',
            zminDesc.join(' ')
        ].join(' ')
    },
    zmax: {
        valType: 'info_array',
        items: [
            { valType: 'number', editType: 'calc' },
            { valType: 'number', editType: 'calc' },
            { valType: 'number', editType: 'calc' },
            { valType: 'number', editType: 'calc' }
        ],
        editType: 'calc',
        description: [
            'Array defining the higher bound for each color component.',
            'Note that the default value will depend on the colormodel.',
            zmaxDesc.join(' ')
        ].join(' ')
    },
    x0: {
        valType: 'any',
        dflt: 0,
        editType: 'calc+clearAxisTypes',
        description: [
            "Set the image's x position. The left edge of the image",
            '(or the right edge if the x axis is reversed or dx is negative)',
            'will be found at xmin=x0-dx/2'
        ].join(' ')
    },
    y0: {
        valType: 'any',
        dflt: 0,
        editType: 'calc+clearAxisTypes',
        description: [
            "Set the image's y position. The top edge of the image",
            '(or the bottom edge if the y axis is NOT reversed or if dy is negative)',
            'will be found at ymin=y0-dy/2. By default when an image trace is',
            'included, the y axis will be reversed so that the image is right-side-up,',
            'but you can disable this by setting yaxis.autorange=true or by providing',
            'an explicit y axis range.'
        ].join(' ')
    },
    dx: {
        valType: 'number',
        dflt: 1,
        editType: 'calc',
        description: "Set the pixel's horizontal size."
    },
    dy: {
        valType: 'number',
        dflt: 1,
        editType: 'calc',
        description: "Set the pixel's vertical size"
    },
    text: {
        valType: 'data_array',
        editType: 'plot',
        description: 'Sets the text elements associated with each z value.'
    },
    hovertext: {
        valType: 'data_array',
        editType: 'plot',
        description: 'Same as `text`.'
    },
    hoverinfo: (0, extend_1.extendFlat)({}, attributes_1.default.hoverinfo, {
        flags: ['x', 'y', 'z', 'color', 'name', 'text'],
        dflt: 'x+y+z+text+name'
    }),
    hovertemplate: (0, template_attributes_1.hovertemplateAttrs)({}, { keys: ['z', 'color', 'colormodel'] }),
    hovertemplatefallback: (0, template_attributes_1.templatefallbackAttrs)(),
    zorder: attributes_2.zorder
};
exports.default = attributes;