Line: GOffice Reference Manual

## Line Line |

## Functions

char const * | go_line_dash_as_label ()
char const * | go_line_dash_as_str ()
GOLineDashType | go_line_dash_from_str ()
double | go_line_dash_get_length ()
GOLineDashSequence * | go_line_dash_get_sequence ()
void | go_line_dash_sequence_free ()
char const * | go_line_interpolation_as_label ()
char const * | go_line_interpolation_as_str ()
gboolean | go_line_interpolation_auto_skip ()
GOLineInterpolation | go_line_interpolation_from_str ()
gboolean | go_line_interpolation_supports_radial ()

## Types and Values

| GOLineDashSequence

## Object Hierarchy

        GBoxed
        ╰── GOLineDashSequence

## Description

## Functions

### go_line_dash_as_label ()

    char const 		*
    go_line_dash_as_label (GOLineDashType type);

#### Parameters

type | a GOLineDashType |

#### Returns

user readable name of the dash type, or the name of `GO_LINE_NONE` if type is invalid.

[transfer none]

### go_line_dash_as_str ()

    char const 		*
    go_line_dash_as_str (GOLineDashType type);

#### Parameters

type | a GOLineDashType |

#### Returns

nickname of the dash type, or "none" if type is invalid.

[transfer none]

### go_line_dash_from_str ()

    GOLineDashType
    go_line_dash_from_str (char const *name);

#### Parameters

name | Name of the dash type |

#### Returns

a GOLineDashType corresponding to name, or `GO_LINE_NONE` if not found.

### go_line_dash_get_length ()

    double
    go_line_dash_get_length (GOLineDashType type);

#### Parameters

type | GOLineDashType |

#### Returns

the unscaled length of the dash sequence.

### go_line_dash_get_sequence ()

    GOLineDashSequence *
    go_line_dash_get_sequence (GOLineDashType type,
                               double scale);

#### Parameters

type | a GOLineDashType |
scale | dash scale |

#### Returns

a struct containing the dash sequence corresponding to `type` , or `NULL` if type is invalid or equal to `GO_LINE_NONE`. The lengths are scaled according to `scale` .

[transfer full][nullable]

### go_line_dash_sequence_free ()

    void
    go_line_dash_sequence_free (GOLineDashSequence *sequence);

Frees the dash sequence struct.

#### Parameters

sequence | a GOLineDashSequence |

### go_line_interpolation_as_label ()

    char const 		*
    go_line_interpolation_as_label (GOLineInterpolation type);

#### Parameters

type | an interpolation type |

#### Returns

label of `type` , or the name of `GO_LINE_INTERPOLATION_LINEAR` if type is invalid.

[transfer none]

### go_line_interpolation_as_str ()

    char const 		*
    go_line_interpolation_as_str (GOLineInterpolation type);

#### Parameters

type | an interpolation type |

#### Returns

nickname of `type` , or "linear" if type is invalid.

[transfer none]

### go_line_interpolation_auto_skip ()

    gboolean
    go_line_interpolation_auto_skip (GOLineInterpolation type);

#### Parameters

type | an interpolation type |

#### Returns

`TRUE` if the line interpolation type forces skipping invalid data, `FALSE` if it is only optional.

### go_line_interpolation_from_str ()

    GOLineInterpolation
    go_line_interpolation_from_str (char const *name);

#### Parameters

name | an interpolation type nickname |

#### Returns

a GOLineInterpolation corresponding to `name` , or `GO_LINE_INTERPOLATION_LINEAR` if not found.

### go_line_interpolation_supports_radial ()

    gboolean
    go_line_interpolation_supports_radial (GOLineInterpolation type);

#### Parameters

type | an interpolation type |

#### Returns

`TRUE` if the line interpolation type can be used with radial axes set, `FALSE` if it cannot.

## Types and Values

### GOLineDashSequence

    typedef struct {
    	double		 offset;
    	unsigned int	 n_dash;
    	double		*dash;
    } GOLineDashSequence;

#### Members

double `offset`; | offset from start. |
unsigned int `n_dash`; | number of values in dash fields |
double *`dash`; | lengths of the dashes segments. See `cairo_set_dash()` for details. |