.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "al_calculate_ribbon" "3" "" "Allegro reference manual"
.SH NAME
al_calculate_ribbon \- Allegro 5 API
.SH SYNOPSIS
.IP
.EX
#include \f[B]<allegro5/allegro_primitives.h>\f[R]

void al_calculate_ribbon(float* dest, int dest_stride, const float *points,
   int points_stride, float thickness, int num_segments)
.EE
.SH DESCRIPTION
Calculates a ribbon given an array of points.
The ribbon will go through all of the passed points.
If \f[CR]thickness <= 0\f[R], then \f[CR]num_segments\f[R] of points are
required in the destination buffer, otherwise twice as many are needed.
The destination and the points buffer should consist of regularly spaced
doublets of floats, corresponding to x and y coordinates of the
vertices.
.PP
\f[I]Parameters:\f[R]
.IP \[bu] 2
dest \- Pointer to the destination buffer
.IP \[bu] 2
dest_stride \- Distance (in bytes) between starts of successive pairs of
coordinates in the destination buffer
.IP \[bu] 2
points \- An array of pairs of coordinates for each point
.IP \[bu] 2
points_stride \- Distance (in bytes) between starts of successive pairs
of coordinates in the points buffer
.IP \[bu] 2
thickness \- Thickness of the spline ribbon
.IP \[bu] 2
num_segments \- The number of points to calculate
.SH SEE ALSO
al_draw_ribbon(3), al_calculate_arc(3), al_calculate_spline(3)