UnisonViewer Class Reference

A component for visualizing unison voices distribution and detune. More...

Inheritance diagram for UnisonViewer:

Public Member Functions
	UnisonViewer (int index, const vital::output_map &mono_modulations, const vital::output_map &poly_modulations)
	Constructs a UnisonViewer.
void	setVoicesSlider (SynthSlider *slider)
	Sets the slider for voices.
void	setDetuneSlider (SynthSlider *slider)
	Sets the slider for detune.
void	setDetunePowerSlider (SynthSlider *slider)
	Sets the slider for detune power.
void	render (OpenGlWrapper &open_gl, bool animate) override
	Renders the unison visualization.
Public Member Functions inherited from BarRenderer
	BarRenderer (int num_points, bool vertical=true)
	Constructs a BarRenderer.
virtual	~BarRenderer ()
	Destructor.
virtual void	init (OpenGlWrapper &open_gl) override
	Initializes the renderer with an OpenGL context.
virtual void	destroy (OpenGlWrapper &open_gl) override
	Destroys any allocated OpenGL resources.
void	setColor (const Colour &color)
	Sets the color of the bars.
void	setScale (float scale)
	Sets the scaling factor for the bars.
void	setOffset (float offset)
	Sets an offset applied to the bar positions.
void	setBarWidth (float bar_width)
	Sets the relative width of each bar.
void	setNumPoints (int num_points)
	Updates the number of points (bars) to display.
float	getBarWidth ()
	Gets the current bar width factor.
float	xAt (int index)
	Gets the x-position of the top-left vertex of the given bar.
float	rightAt (int index)
	Gets the x-position of the top-right vertex of the given bar.
float	yAt (int index)
	Gets the y-position of the top-left vertex of the given bar.
float	bottomAt (int index)
	Gets the y-position of the bottom-left vertex of the given bar.
force_inline void	setX (int index, float val)
	Sets the x-position for all vertices of a specific bar.
force_inline void	setY (int index, float val)
	Sets the top y-position of a specific bar.
force_inline void	setBottom (int index, float val)
	Sets the bottom y-position of a specific bar.
void	positionBar (int index, float x, float y, float width, float height)
	Positions a bar at a specific rectangle.
void	setBarSizes ()
	Updates the bar sizes based on their positions and scaling.
void	setPowerScale (bool scale)
	Enables or disables power scaling of bar heights.
void	setSquareScale (bool scale)
	Enables or disables square scaling of bar heights.
force_inline float	scaledYAt (int index)
	Gets the scaled y-value of a bar at a given index.
force_inline void	setScaledY (int index, float val)
	Sets the scaled y-value at a specific index.
force_inline void	setAdditiveBlending (bool additive_blending)
	Enables or disables additive blending for the bar rendering.
Public Member Functions inherited from OpenGlComponent
	OpenGlComponent (String name="")
	Constructs an OpenGlComponent.
virtual	~OpenGlComponent ()
	Destructor.
virtual void	resized () override
	Called when the component is resized.
virtual void	parentHierarchyChanged () override
	Called when the component's parent hierarchy changes.
void	addRoundedCorners ()
	Adds rounded corners to the component's edges.
void	addBottomRoundedCorners ()
	Adds rounded corners only at the bottom of the component.
void	renderCorners (OpenGlWrapper &open_gl, bool animate, Colour color, float rounding)
	Renders the corner shapes using the given color and rounding amount.
void	renderCorners (OpenGlWrapper &open_gl, bool animate)
	Renders corners with default body color and rounding.
virtual void	paintBackground (Graphics &g)
	Paints a standard background for the component.
void	repaintBackground ()
	Requests a repaint of the component's background on the OpenGL layer.
Colour	getBodyColor () const
	Retrieves the component's body color.
void	setParent (const SynthSection *parent)
	Sets a pointer to the parent SynthSection for skin value lookups.
float	findValue (Skin::ValueId value_id)
	Finds a float value from the skin associated with this component's parent.
void	setSkinValues (const Skin &skin)
	Applies the skin overrides to this component's colors.
void	setSkinOverride (Skin::SectionOverride skin_override)
	Sets a skin override to control the component's color scheme.
force_inline void	checkGlError ()
	Checks for and asserts that there are no OpenGL errors.
void	setBackgroundColor (const Colour &color)
	Sets the background color of the component for painting operations.

Static Public Member Functions
static vital::poly_float	getOutputsTotal (std::pair< vital::Output *, vital::Output * > outputs, vital::poly_float default_value, bool animate)
	Calculates total output values from given output pairs.
Static Public Member Functions inherited from OpenGlComponent
static bool	setViewPort (Component *component, Rectangle< int > bounds, OpenGlWrapper &open_gl)
	Sets the OpenGL viewport to match a specified rectangle within a component.
static bool	setViewPort (Component *component, OpenGlWrapper &open_gl)
	Convenience overload that sets the viewport for the entire component's local bounds.
static void	setScissor (Component *component, OpenGlWrapper &open_gl)
	Sets the OpenGL scissor region to the entire component's local bounds.
static void	setScissorBounds (Component *component, Rectangle< int > bounds, OpenGlWrapper &open_gl)
	Sets the OpenGL scissor region to a specified rectangle within a component.
static std::unique_ptr< OpenGLShaderProgram::Uniform >	getUniform (const OpenGlWrapper &open_gl, const OpenGLShaderProgram &program, const char *name)
	Retrieves a uniform from the shader program if it exists.
static std::unique_ptr< OpenGLShaderProgram::Attribute >	getAttribute (const OpenGlWrapper &open_gl, const OpenGLShaderProgram &program, const char *name)
	Retrieves an attribute from the shader program if it exists.
static String	translateFragmentShader (const String &code)
	Translates a fragment shader code snippet to be compatible with the current GL version.
static String	translateVertexShader (const String &code)
	Translates a vertex shader code snippet to be compatible with the current GL version.

Additional Inherited Members
Static Public Attributes inherited from BarRenderer
static constexpr float	kScaleConstant = 5.0f
	A scaling constant used when applying power scaling.
static constexpr int	kFloatsPerVertex = 3
	Number of float values per vertex (x, y, [and potentially other attributes]).
static constexpr int	kVerticesPerBar = 4
	Number of vertices per bar.
static constexpr int	kFloatsPerBar = kVerticesPerBar * kFloatsPerVertex
	Number of floats per bar (4 vertices * 3 floats each).
static constexpr int	kTriangleIndicesPerBar = 6
	Number of triangle indices per bar (each bar represented as two triangles).
static constexpr int	kCornerFloatsPerVertex = 2
	Number of corner floats per vertex (used to determine corner coordinates).
static constexpr int	kCornerFloatsPerBar = kVerticesPerBar * kCornerFloatsPerVertex
	Number of corner floats per bar.
Protected Member Functions inherited from BarRenderer
void	drawBars (OpenGlWrapper &open_gl)
	Draws the bars to the currently active OpenGL context.
Protected Member Functions inherited from OpenGlComponent
bool	setViewPort (OpenGlWrapper &open_gl)
	Sets the viewport for this component using the current OpenGlWrapper.
Protected Attributes inherited from BarRenderer
OpenGLShaderProgram *	shader_
	The shader program used for rendering.
std::unique_ptr< OpenGLShaderProgram::Uniform >	color_uniform_
	Uniform for bar color.
std::unique_ptr< OpenGLShaderProgram::Uniform >	dimensions_uniform_
	Uniform for viewport dimensions.
std::unique_ptr< OpenGLShaderProgram::Uniform >	offset_uniform_
	Uniform for position offset.
std::unique_ptr< OpenGLShaderProgram::Uniform >	scale_uniform_
	Uniform for scaling factor.
std::unique_ptr< OpenGLShaderProgram::Uniform >	width_percent_uniform_
	Uniform for bar width factor.
std::unique_ptr< OpenGLShaderProgram::Attribute >	position_
	Attribute for vertex position.
std::unique_ptr< OpenGLShaderProgram::Attribute >	corner_
	Attribute for corner coordinates.
Colour	color_
	Current color of the bars.
bool	vertical_
	True if bars are rendered vertically.
float	scale_
	Scale factor for bar dimensions.
float	offset_
	Offset applied to bar positions.
float	bar_width_
	Relative width of each bar.
bool	additive_blending_
	If true, uses additive blending for rendering.
float	display_scale_
	Additional scaling factor applied to bar sizes.
bool	power_scale_
	True if power scaling is applied to bar heights.
bool	square_scale_
	True if square scaling is applied to bar heights.
bool	dirty_
	True if bar data needs to be re-uploaded to the GPU.
int	num_points_
	Number of bars to render.
int	total_points_
	Total number of allocated points (bars).
std::unique_ptr< float[]>	bar_data_
	Raw bar vertex position data.
std::unique_ptr< float[]>	bar_corner_data_
	Bar corner coordinate data.
std::unique_ptr< int[]>	bar_indices_
	Triangle index data for bars.
GLuint	bar_buffer_
	OpenGL buffer object for bar positions.
GLuint	bar_corner_buffer_
	OpenGL buffer object for bar corners.
GLuint	bar_indices_buffer_
	OpenGL buffer object for bar indices.
Protected Attributes inherited from OpenGlComponent
std::unique_ptr< OpenGlCorners >	corners_
	Optional corners for rounded edges.
bool	only_bottom_corners_
	Flag to round only the bottom corners.
Colour	background_color_
	The background color of the component.
Colour	body_color_
	The body color of the component.
const SynthSection *	parent_
	Pointer to parent SynthSection for skin lookups.
Skin::SectionOverride	skin_override_
	Skin override for custom appearance.
const vital::StatusOutput *	num_voices_readout_
	StatusOutput for voice count lookups.

Detailed Description

A component for visualizing unison voices distribution and detune.

This class extends BarRenderer to display a representation of unison voices and their detuning visually. It pulls modulation data from outputs and adjusts the bar rendering accordingly.

Constructor & Destructor Documentation

UnisonViewer()

UnisonViewer::UnisonViewer ( int index, const vital::output_map & mono_modulations, const vital::output_map & poly_modulations )

inline

Constructs a UnisonViewer.

Parameters

index	Oscillator index.
mono_modulations	Mono modulation outputs map.
poly_modulations	Poly modulation outputs map.

Member Function Documentation

getOutputsTotal()

static vital::poly_float UnisonViewer::getOutputsTotal ( std::pair< vital::Output *, vital::Output * > outputs, vital::poly_float default_value, bool animate )

inlinestatic

Calculates total output values from given output pairs.

Parameters

outputs	Pair of mono and poly outputs.
default_value	The default value if not animated.
animate	Whether to use triggered output values.

Returns

A poly float representing the total output.

render()

void UnisonViewer::render ( OpenGlWrapper & open_gl, bool animate )

inlineoverridevirtual

Renders the unison visualization.

Parameters

open_gl	Reference to the OpenGlWrapper.
animate	Whether to animate based on triggered values.

Reimplemented from BarRenderer.

setDetunePowerSlider()

void UnisonViewer::setDetunePowerSlider ( SynthSlider * slider )

inline

Sets the slider for detune power.

Parameters

slider

Pointer to the SynthSlider controlling detune power.

setDetuneSlider()

void UnisonViewer::setDetuneSlider ( SynthSlider * slider )

inline

Sets the slider for detune.

Parameters

slider

Pointer to the SynthSlider controlling detune.

setVoicesSlider()

void UnisonViewer::setVoicesSlider ( SynthSlider * slider )

inline

Sets the slider for voices.

Parameters

slider

Pointer to the SynthSlider controlling voices.

---

The documentation for this class was generated from the following file:

• /Users/davidvogel/repos/VitalHelp/src/interface/editor_sections/oscillator_section.cpp