Moritz Martinius
78aab33fdb
All checks were successful
Build ptprnt / build (push) Successful in 3m22s
Reviewed-on: moritz/ptouch-prnt#14
89 lines
2.9 KiB
C++
89 lines
2.9 KiB
C++
/*
|
|
ptrnt - print labels on linux
|
|
Copyright (C) 2025 Moritz Martinius
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <memory>
|
|
#include <string>
|
|
|
|
#include "ILabel.hpp"
|
|
|
|
namespace ptprnt::graphics {
|
|
|
|
/**
|
|
* @brief Builder interface for creating labels with text and formatting options
|
|
*
|
|
* The LabelBuilder provides a fluent API for constructing labels with various
|
|
* text elements, fonts, sizes, and alignment options. It separates the construction
|
|
* logic from the label rendering logic, making it easier to test and maintain.
|
|
*/
|
|
class ILabelBuilder {
|
|
public:
|
|
virtual ~ILabelBuilder() = default;
|
|
|
|
/**
|
|
* @brief Add text to the label with current formatting settings
|
|
* @param text The text to add
|
|
* @return Reference to this builder for method chaining
|
|
*/
|
|
virtual ILabelBuilder& addText(const std::string& text) = 0;
|
|
|
|
/**
|
|
* @brief Set the font family for subsequent text additions
|
|
* @param fontFamily Font family name (e.g., "sans", "serif", "monospace")
|
|
* @return Reference to this builder for method chaining
|
|
*/
|
|
virtual ILabelBuilder& setFontFamily(const std::string& fontFamily) = 0;
|
|
|
|
/**
|
|
* @brief Set the font size for subsequent text additions
|
|
* @param fontSize Font size in points
|
|
* @return Reference to this builder for method chaining
|
|
*/
|
|
virtual ILabelBuilder& setFontSize(double fontSize) = 0;
|
|
|
|
/**
|
|
* @brief Set horizontal alignment for subsequent text additions
|
|
* @param hAlign Horizontal alignment position
|
|
* @return Reference to this builder for method chaining
|
|
*/
|
|
virtual ILabelBuilder& setHAlign(HAlignPosition hAlign) = 0;
|
|
|
|
/**
|
|
* @brief Set vertical alignment for subsequent text additions
|
|
* @param vAlign Vertical alignment position
|
|
* @return Reference to this builder for method chaining
|
|
*/
|
|
virtual ILabelBuilder& setVAlign(VAlignPosition vAlign) = 0;
|
|
|
|
/**
|
|
* @brief Build and return the label with all added content
|
|
* @return Unique pointer to the constructed label
|
|
*/
|
|
virtual std::unique_ptr<ILabel> build() = 0;
|
|
|
|
/**
|
|
* @brief Reset the builder to initial state
|
|
* @return Reference to this builder for method chaining
|
|
*/
|
|
virtual ILabelBuilder& reset() = 0;
|
|
};
|
|
|
|
} // namespace ptprnt::graphics
|