Add setting of fixed box_width

Author: etfrogers

gnuplot/examples/variable_color.rs

@@ -87,34 +87,34 @@ fn example(c: Common)
 		ax.set_title(
 			&format!("variable color boxerror, points, xyerrorbars, and boxxyerror.\nColor used is a {label}"),
 			&[],
-		);
-		ax.set_y_range(Fix(-4.0), Fix(11.5));
-		ax.box_error_low_high_set_width(
+		)
+		.set_y_range(Fix(-4.0), Fix(11.5))
+		.set_box_width(0.5, true)
+		.box_error_low_high(
 			&d1,
 			&d5,
 			&d2,
 			&d6,
-			iter::repeat(0.2),
 			&[
 				color.clone(),
 				FillAlpha(0.5),
 				BorderColor(RGBString("black")),
 			],
-		);
-		ax.points(&d1, iter::repeat(1), &[color.clone(), PointSymbol('D')]);
-		ax.xy_error_bars(
+		)
+		.points(&d1, iter::repeat(1), &[color.clone(), PointSymbol('D')])
+		.xy_error_bars(
 			&d1,
 			iter::repeat(8),
 			d1.iter().map(by3),
 			d1.iter().map(by4),
 			&[color.clone()],
-		);
-		ax.points(
+		)
+		.points(
 			&d1,
 			d2.iter().map(|v| -v / 2.0),
 			&[color.clone(), PointSymbol('O'), PointSize(3.0)],
-		);
-		ax.box_xy_error_delta(
+		)
+		.box_xy_error_delta(
 			&d1,
 			iter::repeat(10),
 			d1.iter().map(by3),
@@ -153,21 +153,21 @@ fn example(c: Common)
 	ax.set_title(
 		&format!("variable color boxerror, points, xyerrorbars, and boxxyerror.\nColor used is a SavedColormap"),
 		&[],
-	);
-	ax.set_y_range(Fix(-4.0), Fix(11.5));
-	ax.box_error_low_high_set_width(
+	)
+	.set_y_range(Fix(-4.0), Fix(11.5))
+	.set_box_width(0.8, false)
+	.box_error_low_high(
 		&d1,
 		&d5,
 		&d2,
 		&d6,
-		iter::repeat(0.2),
 		&[
 			Color(SavedColorMap("magma", color_values.clone())),
 			FillAlpha(0.5),
 			BorderColor(RGBString("black")),
 		],
-	);
-	ax.points(
+	)
+	.points(
 		&d1,
 		iter::repeat(1),
 		&[
@@ -177,24 +177,24 @@ fn example(c: Common)
 			)),
 			PointSymbol('D'),
 		],
-	);
-	ax.xy_error_bars(
+	)
+	.xy_error_bars(
 		&d1,
 		iter::repeat(8),
 		d1.iter().map(by3),
 		d1.iter().map(by4),
 		&[Color(SavedColorMap("ocean", color_values.clone()))],
-	);
-	ax.points(
+	)
+	.points(
 		&d1,
 		d2.iter().map(|v| -v / 2.0),
 		&[
 			Color(SavedColorMap("magma", color_values.clone())),
 			PointSymbol('O'),
 			PointSize(3.0),
 		],
-	);
-	ax.box_xy_error_delta(
+	)
+	.box_xy_error_delta(
 		&d1,
 		iter::repeat(10),
 		d1.iter().map(by3),

gnuplot/src/axes_common.rs

@@ -1107,6 +1107,7 @@ pub struct AxesCommonData
 	pub margins: Margins,
 	pub palette: PaletteType<Vec<(f32, f32, f32, f32)>>,
 	pub colormaps: Vec<(String, PaletteType<Vec<(f32, f32, f32, f32)>>)>,
+	pub box_width: Option<(f64, bool)>,
 }
 
 impl AxesCommonData
@@ -1131,6 +1132,7 @@ impl AxesCommonData
 			margins: Margins::new(),
 			palette: COLOR.to_one_way_owned(),
 			colormaps: Vec::new(),
+			box_width: None,
 		};
 		ret.x2_axis.tick_type = TickType::None;
 		ret.y2_axis.tick_type = TickType::None;
@@ -1277,6 +1279,12 @@ impl AxesCommonData
 		}
 		self.palette.write_out_commands(w);
 
+		if let Some((width, is_relative)) = self.box_width
+		{
+			let scale = if is_relative { "relative" } else { "absolute" };
+			writeln!(w, "set boxwidth {width} {scale}");
+		}
+
 		self.x_axis.write_out_commands(w, version);
 		self.y_axis.write_out_commands(w, version);
 		self.x2_axis.write_out_commands(w, version);
@@ -1408,6 +1416,18 @@ pub trait AxesCommon: AxesCommonPrivate
 		self
 	}
 
+	/// Set the width of boxes in any box plots on the axes (for example [boxes()](crate::Axes2D::boxes),
+	/// [box_and_whisker()](crate::Axes2D::box_and_whisker))
+	/// # Arguments
+	/// * `width` - Width of boxes.
+	/// * `is_relative` - if `true`, `width` is interpreted as a fraction of the default box width.
+	/// 	if `false` width is an absolute value in the units of the x axis
+	fn set_box_width(&mut self, width: f64, is_relative: bool) -> &mut Self
+	{
+		self.get_common_data_mut().box_width = Some((width, is_relative));
+		self
+	}
+
 	/// Set the aspect ratio of the axes
 	/// # Arguments
 	/// * `ratio` - The aspect ratio. Set to Auto to return the ratio to default