new attributes and doc strings

Author: monfera

src/traces/pointcloud/attributes.js

@@ -18,5 +18,73 @@ module.exports = {
     y0: scatterglAttrs.y0,
     dy: scatterglAttrs.dy,
     text: scatterglAttrs.text,
-    marker: scatterglAttrs.marker
+    marker: {
+        color: {
+            valType: 'color',
+            arrayOk: false,
+            role: 'style',
+            description: [
+                'Sets the marker fill color. It accepts a specific color.',
+                'If the color is not fully opaque and there are hundreds of thousands',
+                'of points, it may cause slower zooming and panning.'
+            ].join('')
+        },
+        opacity: {
+            valType: 'number',
+            min: 0,
+            max: 1,
+            dflt: 1,
+            arrayOk: false,
+            role: 'style',
+            description: [
+                'Sets the marker opacity. The default value is `1` (fully opaque).',
+                'If the markers are not fully opaque and there are hundreds of thousands',
+                'of points, it may cause slower zooming and panning.'
+                ].join(' ')
+        },
+        sizemin: {
+            valType: 'number',
+            min: 0.1,
+            max: 2,
+            dflt: 0.5,
+            role: 'style',
+            description: [
+                'Sets the minimum size (in px) of the rendered marker points, effective when',
+                'the `pointcloud` shows a million or more points.'
+            ].join(' ')
+        },
+        sizemax: {
+            valType: 'number',
+            min: 0.1,
+            dflt: 0.5,
+            role: 'style',
+            description: [
+                'Sets the maximum size (in px) of the rendered marker points.',
+                'Effective when the `pointcloud` shows only few points.'
+            ].join(' ')
+        },
+        border: {
+            color: {
+                valType: 'color',
+                arrayOk: false,
+                role: 'style',
+                description: [
+                    'Sets the stroke color. It accepts a specific color.',
+                    'If the color is not fully opaque and there are hundreds of thousands',
+                    'of points, it may cause slower zooming and panning.'
+                ].join(' ')
+            },
+            arearatio: {
+                valType: 'number',
+                min: 0,
+                max: 1,
+                dflt: 0,
+                role: 'style',
+                description: [
+                    "Specifies what fraction of the marker area is covered with the",
+                    "border."
+                ].join(' ')
+            }
+        }
+    }
 };

src/traces/pointcloud/convert.js

@@ -35,7 +35,7 @@ function Pointcloud(scene, uid) {
 
     this.pointcloudOptions = {
         positions: new Float32Array(0),
-        size: 12,
+        sizemin: 0.5,
         color: [0, 0, 0, 1],
         borderSize: 1,
         borderColor: [0, 0, 0, 1]
@@ -60,9 +60,7 @@ proto.handlePick = function(pickResult) {
         textLabel: Array.isArray(this.textLabels) ?
             this.textLabels[index] :
             this.textLabels,
-        color: Array.isArray(this.color) ?
-            this.color[index] :
-            this.color,
+        color: this.color,
         name: this.name,
         hoverinfo: this.hoverinfo
     };
@@ -121,7 +119,7 @@ proto.updateFast = function(options) {
     this.pointcloudOptions.positions = positions;
 
     var markerColor = str2RGBArray(options.marker.color),
-        borderColor = str2RGBArray(options.marker.line.color),
+        borderColor = str2RGBArray(options.marker.border.color),
         opacity = options.opacity * options.marker.opacity;
 
     markerColor[3] *= opacity;
@@ -130,9 +128,9 @@ proto.updateFast = function(options) {
     borderColor[3] *= opacity;
     this.pointcloudOptions.borderColor = borderColor;
 
-    markerSize = options.marker.size;
+    markerSize = options.marker.sizemin;
     this.pointcloudOptions.size = markerSize;
-    this.pointcloudOptions.borderSize = options.marker.line.width;
+    this.pointcloudOptions.borderSize = options.marker.border.arearatio;
 
     this.pointcloud.update(this.pointcloudOptions);
 

src/traces/pointcloud/defaults.js

@@ -12,7 +12,6 @@
 var Lib = require('../../lib');
 
 var handleXYDefaults = require('../scatter/xy_defaults');
-var handleMarkerDefaults = require('../scatter/marker_defaults');
 
 var attributes = require('./attributes');
 
@@ -28,6 +27,10 @@ module.exports = function supplyDefaults(traceIn, traceOut, defaultColor, layout
     }
 
     coerce('text');
-
-    handleMarkerDefaults(traceIn, traceOut, defaultColor, layout, coerce);
+    coerce('marker.color', defaultColor);
+    coerce('marker.opacity'/*, isBubble ? 0.7 : 1*/);
+    coerce('marker.sizemin');
+    coerce('marker.sizemax');
+    coerce('marker.border.color', defaultColor);
+    coerce('marker.border.arearatio');
 };