The routine gSetBrokenLine() selects a broken line type for subsequent graphical output. If brk is less than zero, a warning message is output and the absolute value of brk is used to set the broken line type.
When brk is in the range 1 to 256, a further set of parameters come into effect. These parameters explicitly define the appearance of the line type. Each line type is provided with a set of default parameters which may subsequently be changed by calling gDefineBrokenLineStyle(). Even if the device cannot generate the line type exactly as specified, an equivalent hardware-generated line type may still be selected. Appendix B should be consulted to see what line types the device can provide.
If brk is greater than 256, and the device cannot generate the requested line type (see Appendix B), the solid line type will be used for subsequent graphical output.
The effect of a call to gSetBrokenLine() can depend on the capabilities of the device. gSetBrokenLineMode() may be called to force GINO to generate all broken lines, thereby ensuring that they are output correctly on any device.
