/*
* This source file is part of RmlUi, the HTML/CSS Interface Middleware
*
* For the latest information, see http://github.com/mikke89/RmlUi
*
* Copyright (c) 2008-2010 CodePoint Ltd, Shift Technology Ltd
* Copyright (c) 2019-2023 The RmlUi Team, and contributors
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*
*/
#include "InlineContainer.h"
#include "../../../Include/RmlUi/Core/ComputedValues.h"
#include "../../../Include/RmlUi/Core/Element.h"
#include "../../../Include/RmlUi/Core/ElementScroll.h"
#include "../../../Include/RmlUi/Core/ElementText.h"
#include "../../../Include/RmlUi/Core/ElementUtilities.h"
#include "../../../Include/RmlUi/Core/Profiling.h"
#include "../../../Include/RmlUi/Core/Property.h"
#include "BlockContainer.h"
#include "FloatedBoxSpace.h"
#include "InlineLevelBox.h"
#include "LayoutDetails.h"
#include "LineBox.h"
namespace Rml {
InlineContainer::InlineContainer(BlockContainer* _parent, float _available_width) :
LayoutBox(Type::InlineContainer), parent(_parent), root_inline_box(_parent->GetElement())
{
RMLUI_ASSERT(_parent);
box_size = {_available_width, -1.f};
position = parent->NextBoxPosition();
const auto& computed = parent->GetElement()->GetComputedValues();
element_line_height = computed.line_height().value;
wrap_content = (computed.white_space() != Style::WhiteSpace::Nowrap);
text_align = computed.text_align();
}
InlineContainer::~InlineContainer() {}
InlineBox* InlineContainer::AddInlineElement(Element* element, const Box& box)
{
RMLUI_ASSERT(element);
InlineBox* inline_box = nullptr;
InlineLevelBox* inline_level_box = nullptr;
InlineBoxBase* parent_box = GetOpenInlineBox();
if (auto text_element = rmlui_dynamic_cast(element))
{
inline_level_box = parent_box->AddChild(MakeUnique(text_element));
}
else if (box.GetSize().x >= 0.f)
{
inline_level_box = parent_box->AddChild(MakeUnique(parent_box, element, box));
}
else
{
auto inline_box_ptr = MakeUnique(parent_box, element, box);
inline_box = inline_box_ptr.get();
inline_level_box = parent_box->AddChild(std::move(inline_box_ptr));
}
const float minimum_line_height =
Math::Max(element_line_height, (box.GetSize().y >= 0.f ? box.GetSizeAcross(BoxDirection::Vertical, BoxArea::Margin) : 0.f));
LayoutOverflowHandle overflow_handle = {};
float minimum_width_next = 0.f;
while (true)
{
LineBox* line_box = EnsureOpenLineBox();
UpdateLineBoxPlacement(line_box, minimum_width_next, minimum_line_height);
InlineLayoutMode layout_mode = InlineLayoutMode::Nowrap;
if (wrap_content)
{
const bool line_shrinked_by_floats = (line_box->GetLineWidth() + 0.5f < box_size.x && minimum_width_next < box_size.x);
const bool can_wrap_any = (line_shrinked_by_floats || line_box->HasContent());
layout_mode = (can_wrap_any ? InlineLayoutMode::WrapAny : InlineLayoutMode::WrapAfterContent);
}
const bool add_new_line = line_box->AddBox(inline_level_box, layout_mode, overflow_handle);
if (!add_new_line)
break;
minimum_width_next = (line_box->HasContent() ? 0.f : line_box->GetLineWidth() + 1.f);
// Keep adding boxes on a new line, either because the box couldn't fit on the current line at all, or because it had to be split.
CloseOpenLineBox(false);
}
return inline_box;
}
void InlineContainer::CloseInlineElement(InlineBox* inline_box)
{
if (LineBox* line_box = GetOpenLineBox())
{
line_box->CloseInlineBox(inline_box);
}
else
{
RMLUI_ERROR;
}
}
void InlineContainer::AddBreak(float line_height)
{
// Simply end the line if one is open, otherwise increment by the line height.
if (GetOpenLineBox())
CloseOpenLineBox(true);
else
box_cursor += line_height;
}
void InlineContainer::AddChainedBox(UniquePtr open_line_box)
{
RMLUI_ASSERT(line_boxes.empty());
RMLUI_ASSERT(open_line_box && !open_line_box->IsClosed());
line_boxes.push_back(std::move(open_line_box));
}
void InlineContainer::Close(UniquePtr* out_open_line_box, Vector2f& out_position, float& out_height)
{
RMLUI_ZoneScoped;
// The parent container may need the open line box to be split and resumed.
CloseOpenLineBox(true, out_open_line_box);
// It is possible that floats were queued between closing the last line and closing this container, if so place them now.
parent->PlaceQueuedFloats(position.y + box_cursor);
// Set this box's height.
box_size.y = Math::Max(box_cursor, 0.f);
// Find the overflow size for our content, relative to our local space.
Vector2f visible_overflow_size = {0.f, box_size.y};
for (const auto& line_box : line_boxes)
{
visible_overflow_size.x = Math::Max(visible_overflow_size.x, line_box->GetPosition().x - position.x + line_box->GetExtentRight());
}
visible_overflow_size.x = Math::RoundDown(visible_overflow_size.x);
SetVisibleOverflowSize(visible_overflow_size);
out_position = position;
out_height = box_size.y;
}
void InlineContainer::CloseOpenLineBox(bool split_all_open_boxes, UniquePtr* out_split_line)
{
if (LineBox* line_box = GetOpenLineBox())
{
float height_of_line = 0.f;
UniquePtr split_line_box = line_box->DetermineVerticalPositioning(&root_inline_box, split_all_open_boxes, height_of_line);
// If the final height of the line is larger than previously considered, we might need to push the line down to
// clear overlapping floats.
if (height_of_line > line_box->GetLineMinimumHeight())
UpdateLineBoxPlacement(line_box, 0.f, height_of_line);
// Now that the line has been given a final position and size, close the line box to submit all the fragments.
// Our parent block container acts as the containing block for our inline boxes.
line_box->Close(parent->GetElement(), parent->GetPosition(), text_align);
// Move the cursor down, unless we should collapse the line.
if (!line_box->CanCollapseLine())
box_cursor = (line_box->GetPosition().y - position.y) + height_of_line;
// If we have any pending floating elements for our parent, then this would be an ideal time to place them.
parent->PlaceQueuedFloats(position.y + box_cursor);
if (split_line_box)
{
if (out_split_line)
*out_split_line = std::move(split_line_box);
else
line_boxes.push_back(std::move(split_line_box));
}
}
}
bool InlineContainer::GetOpenLineBoxDimensions(float& out_vertical_position, Vector2f& out_tentative_size) const
{
if (LineBox* line_box = GetOpenLineBox())
{
out_vertical_position = position.y + box_cursor;
out_tentative_size = {line_box->GetBoxCursor(), line_box->GetLineMinimumHeight()};
return true;
}
return false;
}
void InlineContainer::UpdateOpenLineBoxPlacement()
{
if (LineBox* line_box = GetOpenLineBox())
UpdateLineBoxPlacement(line_box, 0.f, element_line_height);
}
void InlineContainer::UpdateLineBoxPlacement(LineBox* line_box, float minimum_width, float minimum_height)
{
RMLUI_ASSERT(line_box);
Vector2f minimum_dimensions = {
Math::Max(minimum_width, line_box->GetBoxCursor()),
Math::Max(minimum_height, line_box->GetLineMinimumHeight()),
};
// @performance: We might benefit from doing this search only when the minimum dimensions change, or if we get new inline floats.
const float ideal_position_y = position.y + box_cursor;
float available_width = 0.f;
const Vector2f line_position =
parent->GetBlockBoxSpace()->NextBoxPosition(parent, available_width, ideal_position_y, minimum_dimensions, !wrap_content);
available_width = Math::Max(available_width, 0.f);
line_box->SetLineBox(line_position, available_width, minimum_dimensions.y);
}
float InlineContainer::GetShrinkToFitWidth() const
{
float content_width = 0.0f;
// Simply find our widest line.
for (const auto& line_box : line_boxes)
content_width = Math::Max(content_width, line_box->GetBoxCursor());
return content_width;
}
Vector2f InlineContainer::GetStaticPositionEstimate(bool inline_level_box) const
{
Vector2f result = {0.f, box_cursor};
if (const LineBox* line_box = GetOpenLineBox())
{
if (inline_level_box)
result.x += line_box->GetBoxCursor();
else
result.y += element_line_height;
}
return result;
}
bool InlineContainer::GetBaselineOfLastLine(float& out_baseline) const
{
if (!line_boxes.empty())
{
out_baseline = line_boxes.back()->GetPosition().y + line_boxes.back()->GetBaseline();
return true;
}
return false;
}
LineBox* InlineContainer::EnsureOpenLineBox()
{
if (line_boxes.empty() || line_boxes.back()->IsClosed())
{
line_boxes.push_back(MakeUnique());
}
return line_boxes.back().get();
}
LineBox* InlineContainer::GetOpenLineBox() const
{
if (line_boxes.empty() || line_boxes.back()->IsClosed())
return nullptr;
return line_boxes.back().get();
}
InlineBoxBase* InlineContainer::GetOpenInlineBox()
{
if (LineBox* line_box = GetOpenLineBox())
{
if (InlineBox* inline_box = line_box->GetOpenInlineBox())
return inline_box;
}
return &root_inline_box;
}
String InlineContainer::DebugDumpTree(int depth) const
{
String value = String(depth * 2, ' ') + "InlineContainer" + '\n';
value += root_inline_box.DebugDumpTree(depth + 1);
for (const auto& line_box : line_boxes)
value += line_box->DebugDumpTree(depth + 1);
return value;
}
} // namespace Rml