.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "al_calculate_ribbon" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_calculate_ribbon - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro_primitives.h>

void al_calculate_ribbon(float* dest, int dest_stride, const float *points,
   int points_stride, float thickness, int num_segments)
\f[R]
.fi
.SH DESCRIPTION
.PP
Calculates a ribbon given an array of points.
The ribbon will go through all of the passed points.
If \f[V]thickness <= 0\f[R], then \f[V]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
.PP
al_draw_ribbon(3alleg5), al_calculate_arc(3alleg5),
al_calculate_spline(3alleg5)