LineChain Derived Type

private subroutine chunk_bounds(self, j, first, n, lo, hi)

Chunk j's points (strips: first .. first + n - 1 of the chain) and the bounding box of them (n = 0 if none are measured yet), e.g. to skip a chunk when picking.

Arguments

private subroutine color_slice(self, j, i1, i2, lo, hi, c)

As slice, for the colors of a colored chain: c(rgba, point) of points lo .. hi of chunk j (null if not colored or nothing there).

Arguments

private pure function dash_mode_of(self)

The dashes' layout (set_dash_mode).

Arguments

Return Value integer

private subroutine detach(self)

Remove the chunks from the group (also while running), and release them.

Arguments

private function distance(self, i) result(s)

A strip's distance along it at point i, as written.

Arguments

Return Value real(kind=wp)

private subroutine draw(self, k)

Draw points 1 .. k (no upload).

Arguments

private subroutine draw_range(self, i1, i2)

Draw points i1 .. i2 only (chain indices; none if i2 < i1): e.g. a trace of decreasing times, its last points.

Arguments

private subroutine init(self, group, kind, image, colored)

Draw under group (a CHAIN_* kind; markers with image, a vkf_image_read handle, for the image shape). Chunks made later are compiled once set_compile says so.

Arguments

private pure function is_built(self)

True if the chain has a group to draw under (between init and release).

Arguments

Return Value logical

private pure function is_colored(self)

For lines and markers, whether each point has its own color (init's colored).

Arguments

Return Value logical

private function lod_error(self, j) result(error)

Chunk j's error bounds: how far the points skipped can be from the segments drawn at stride 2^k (k = 1 .. lod_levels; 0 where not known).

Arguments

Return Value real(kind=c_float), (lod_levels)

private pure function num_chunks(self)

Number of chunks.

Arguments

Return Value integer

private function point(self, i) result(v)

Point i as written: read back from the buffers (zero if not held).

Arguments

Return Value real(kind=wp), (3)

private function point_color(self, i) result(rgba)

The color of point i of a colored chain, as stored (rgba; white if not colored).

Arguments

Return Value real(kind=wp), (4)

private subroutine release(self)

Forget the chunks (after their group was removed from the scene): init starts again.

Arguments

private subroutine reserve(self, n)

Chunks for at least n points (at least one chunk). Separate segments and ribbons: chunks hold whole pairs (n should be even).

Arguments

private subroutine set_compile(self, compile)

Compile chunks made from now on (for the windows running): once the group is shown (not while building, when they are compiled with it).

Arguments

private subroutine set_dash_mode(self, mode, length)

For lines, how the dashes are laid out: 0 anchored to the line (the default), 1 screen-locked (a constant length in pixels, following the line on screen), 2 a fixed length of the line (strips): length scene units for the pattern, or if 0 its length on screen when first drawn.

Arguments

private subroutine set_highlight(self, flags, color, spacing, speed, band, period)

For lines, the highlight (see shaders/line.vert): flags (1 pulse, 2 arrows; 0 none), its color (rgba), the arrows' spacing and speed (window units, and per second), the band's width (window units) and the pulse's period (s).

Arguments

private subroutine set_lod(self, enabled)

Level of detail on (the default: seen from far away, a strip is drawn from fewer points, within half a pixel of all of them) or off (every point drawn).

Arguments

private subroutine set_marker_style(self, color, size, shape, radius)

For markers, the color (rgba), size (window units), shape (shaders/marker.frag) and attenuation radius (scene units, 0 for none).

Arguments

private subroutine set_pattern(self, factor, pattern)

For lines, a dash pattern (see line_set_pattern; z'FFFF' solid).

Arguments

private subroutine set_style(self, color, width)

Color (rgba) and width (window units) of the whole chain.

Arguments

private subroutine set_trail(self, values)

For strips, the trail (see vkf_line_set_trail: 20 values; the third 0: none), given to every chunk (changed every frame the time does: a few floats per chunk uploaded).

Arguments

private subroutine slice(self, j, i1, i2, lo, hi, p)

The part lo .. hi of points i1 .. i2 that chunk j holds, and its buffer p(xyz and distance, high/low, lo:hi) (null if none).

Arguments

private subroutine style_node(self, line)

Give the chain's style to line, a node not in the chain (e.g. a curve's trace-mode tail, drawn as part of it).

Arguments

private subroutine written(self, i1, i2, x)

Points i1 .. i2 were written: measure a strip's distances along it (from the distance at point i1-1), update its level of detail, and upload the chunks holding them. x: the points in double precision, x(:, i) for chain point i (at least i1-1 .. i2), to measure from; without it, from the floats written. (i2 is the last point written in the chain.)

Arguments