[Bf-blender-cvs] [41a945d7469] master: Docs: add note on convention for setting line-width

[Campbell Barton]

Commit: 41a945d7469f8135d8181bad9ec80037f0fbd069
Author: Campbell Barton
Date:   Thu Jan 21 11:12:11 2021 +1100
Branches: master
https://developer.blender.org/rB41a945d7469f8135d8181bad9ec80037f0fbd069

Docs: add note on convention for setting line-width

===================================================================

M	source/blender/gpu/intern/gpu_state.cc

===================================================================

diff --git a/source/blender/gpu/intern/gpu_state.cc b/source/blender/gpu/intern/gpu_state.cc
index 407a8dd6e2b..e7a160d1ea3 100644
--- a/source/blender/gpu/intern/gpu_state.cc
+++ b/source/blender/gpu/intern/gpu_state.cc
@@ -165,6 +165,11 @@ void GPU_depth_range(float near, float far)
   copy_v2_fl2(state.depth_range, near, far);
 }
 
+/**
+ * \note By convention, this is set as needed and not reset back to 1.0.
+ * This means code that draws lines must always set the line width beforehand,
+ * but is not expected to restore it's previous value.
+ */
 void GPU_line_width(float width)
 {
   width = max_ff(1.0f, width * PIXELSIZE);