/* source/widgets/sgl_box.c * * MIT License * * Copyright(c) 2023-present All contributors of SGL * Document reference link: docs directory * * 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 #include #include #include #include #include #include #include "sgl_box.h" #define SGL_BOX_SCROLL_WIDTH (4) static void sgl_box_construct_cb(sgl_surf_t *surf, sgl_obj_t* obj, sgl_event_t *evt) { sgl_box_t *box = sgl_container_of(obj, sgl_box_t, obj); int16_t height = obj->coords.y2 - obj->coords.y1 - 2 * box->bg.radius; int16_t width = obj->coords.x2 - obj->coords.x1 - 2 * box->bg.radius; int16_t scroll_height = sgl_max(height / 8, SGL_BOX_SCROLL_WIDTH); int16_t scroll_width = sgl_max(width / 8, SGL_BOX_SCROLL_WIDTH); sgl_rect_t area; if(evt->type == SGL_EVENT_DRAW_MAIN) { area.x1 = obj->coords.x1 + box->bg.radius; area.y1 = obj->coords.y1 + box->bg.radius; area.x2 = obj->coords.x2 - box->bg.radius; area.y2 = obj->coords.y2 - box->bg.radius; sgl_draw_rect(surf, &obj->area, &obj->coords, &box->bg); // Draw scrollbars if enabled if(box->scroll_enable) { // Draw vertical scrollbar if vertical scrolling is enabled and showing is enabled if (((box->scroll_mode & SGL_BOX_SCROLL_VERTICAL_ONLY) || (box->scroll_mode & SGL_BOX_SCROLL_BOTH)) && box->show_v_scrollbar) { area.x1 = obj->coords.x2 - SGL_BOX_SCROLL_WIDTH - box->bg.radius; area.y1 = obj->coords.y1 + box->bg.radius; area.x2 = obj->coords.x2 - box->bg.radius; // Calculate scroll bar position based on content size and current offset // Use elastic_scroll values to determine content size for proper scrollbar positioning int16_t content_height = height + (box->elastic_scroll_up + box->elastic_scroll_down); if(content_height > height && content_height > 0) { // Calculate the scroll bar's position based on the current y_offset float scroll_ratio = (float)(-box->y_offset) / (content_height - height); scroll_ratio = sgl_clamp(scroll_ratio, 0.0f, 1.0f); // Clamp between 0 and 1 int16_t max_scroll_pos = height - scroll_height; area.y1 = obj->coords.y1 + box->bg.radius + (int16_t)(max_scroll_pos * scroll_ratio); area.y2 = area.y1 + scroll_height; } else { // If content fits, position scrollbar at the top area.y1 = obj->coords.y1 + box->bg.radius; area.y2 = area.y1 + scroll_height; } sgl_draw_fill_rect(surf, &obj->area, &area, SGL_BOX_SCROLL_WIDTH / 2, box->scroll_color, 128); } // Draw horizontal scrollbar if horizontal scrolling is enabled and showing is enabled if (((box->scroll_mode & SGL_BOX_SCROLL_HORIZONTAL_ONLY) || (box->scroll_mode & SGL_BOX_SCROLL_BOTH)) && box->show_h_scrollbar) { // Position horizontal scrollbar near the bottom-left, closer to vertical scrollbar area.x1 = obj->coords.x1 + box->bg.radius; area.y1 = obj->coords.y2 - SGL_BOX_SCROLL_WIDTH - box->bg.radius; area.y2 = obj->coords.y2 - box->bg.radius; // Adjust the right edge to not overlap with vertical scrollbar if both are visible if ((box->scroll_mode & SGL_BOX_SCROLL_VERTICAL_ONLY) || (box->scroll_mode & SGL_BOX_SCROLL_BOTH)) { area.x2 = obj->coords.x2 - SGL_BOX_SCROLL_WIDTH - box->bg.radius; } else { area.x2 = obj->coords.x2 - box->bg.radius; } // Calculate scroll bar position based on content size and current offset int16_t content_width = width + (box->elastic_scroll_left + box->elastic_scroll_right); if(content_width > width && content_width > 0) { // Calculate the scroll bar's position based on the current x_offset float scroll_ratio = (float)(-box->x_offset) / (content_width - width); scroll_ratio = sgl_clamp(scroll_ratio, 0.0f, 1.0f); // Clamp between 0 and 1 int16_t max_scroll_pos = (area.x2 - area.x1) - scroll_width; area.x1 = area.x1 + (int16_t)(max_scroll_pos * scroll_ratio); area.x2 = area.x1 + scroll_width; } else { // If content fits, position scrollbar at the left area.x1 = obj->coords.x1 + box->bg.radius; area.x2 = area.x1 + scroll_width; } sgl_draw_fill_rect(surf, &obj->area, &area, SGL_BOX_SCROLL_WIDTH / 2, box->scroll_color, 128); } } } else if(evt->type == SGL_EVENT_MOVE_UP || evt->type == SGL_EVENT_MOVE_DOWN) { // Check if vertical scrolling is enabled if((box->scroll_mode & SGL_BOX_SCROLL_VERTICAL_ONLY) || (box->scroll_mode & SGL_BOX_SCROLL_BOTH)) { // Update text offset - determine scroll direction based on event type int16_t distance = evt->type == SGL_EVENT_MOVE_UP ? -evt->distance : evt->distance; int16_t new_offset = box->y_offset + distance; // Calculate limits based on elastic_scroll values int16_t min_elastic, max_elastic; // Calculate content dimensions based on elastic_scroll values int16_t content_height = height + (box->elastic_scroll_up + box->elastic_scroll_down); // Determine maximum scroll distance int16_t max_scroll_distance = content_height - height; if(box->elastic_scroll_up > 0 || box->elastic_scroll_down > 0) { // If elastic scrolling is enabled (any direction limit > 0), limit to boundary plus elastic offset // Apply actual elastic limits min_elastic = -max_scroll_distance - box->elastic_scroll_down; // Allow scrolling down with elastic limit max_elastic = box->elastic_scroll_up; // Allow scrolling up with elastic limit } else { // If elastic scrolling is disabled (both values are 0), limit to content boundaries min_elastic = -max_scroll_distance; // max scroll down max_elastic = 0; // max scroll up } int16_t constrained_new_offset = sgl_clamp(new_offset, min_elastic, max_elastic); int16_t offset_delta = constrained_new_offset - box->y_offset; box->y_offset = constrained_new_offset; // Move all children vertically sgl_obj_move_child_pos_y(obj, offset_delta); sgl_obj_set_dirty(obj); } } else if(evt->type == SGL_EVENT_MOVE_LEFT || evt->type == SGL_EVENT_MOVE_RIGHT) { // Check if horizontal scrolling is enabled if((box->scroll_mode & SGL_BOX_SCROLL_HORIZONTAL_ONLY) || (box->scroll_mode & SGL_BOX_SCROLL_BOTH)) { // Update text offset - determine scroll direction based on event type int16_t distance = evt->type == SGL_EVENT_MOVE_LEFT ? -evt->distance : evt->distance; int16_t new_offset = box->x_offset + distance; // Calculate limits based on elastic_scroll values int16_t min_elastic, max_elastic; // Calculate content dimensions based on elastic_scroll values int16_t content_width = width + (box->elastic_scroll_left + box->elastic_scroll_right); // Determine maximum scroll distance int16_t max_scroll_distance = content_width - width; if(box->elastic_scroll_left > 0 || box->elastic_scroll_right > 0) { // If elastic scrolling is enabled (any direction limit > 0), limit to boundary plus elastic offset // Apply actual elastic limits min_elastic = -max_scroll_distance - box->elastic_scroll_right; // Allow scrolling right with elastic limit max_elastic = box->elastic_scroll_left; // Allow scrolling left with elastic limit } else { // If elastic scrolling is disabled (both values are 0), limit to content boundaries min_elastic = -max_scroll_distance; // max scroll right max_elastic = 0; // max scroll left } int16_t constrained_new_offset = sgl_clamp(new_offset, min_elastic, max_elastic); int16_t offset_delta = constrained_new_offset - box->x_offset; box->x_offset = constrained_new_offset; // Move all children horizontally sgl_obj_move_child_pos_x(obj, offset_delta); sgl_obj_set_dirty(obj); } } else if (evt->type == SGL_EVENT_PRESSED) { box->scroll_enable = 1; sgl_obj_set_dirty(obj); } else if (evt->type == SGL_EVENT_RELEASED) { box->scroll_enable = 0; sgl_obj_set_dirty(obj); } } /** * @brief create a box object * @param parent parent of the box * @return pointer to the box object */ sgl_obj_t* sgl_box_create(sgl_obj_t* parent) { sgl_box_t *box = sgl_malloc(sizeof(sgl_box_t)); if(box == NULL) { SGL_LOG_ERROR("sgl_box_create: malloc failed"); return NULL; } /* set object all member to zero */ memset(box, 0, sizeof(sgl_box_t)); sgl_obj_t *obj = &box->obj; sgl_obj_init(&box->obj, parent); obj->construct_fn = sgl_box_construct_cb; sgl_obj_set_border_width(obj, SGL_THEME_BORDER_WIDTH); obj->focus = 1; sgl_obj_set_clickable(obj); sgl_obj_set_movable(obj); box->bg.alpha = SGL_THEME_ALPHA; box->bg.color = SGL_THEME_COLOR; box->bg.radius = 10; box->bg.border = 1; sgl_obj_set_border_width(obj, 1); box->bg.border_color = SGL_THEME_BORDER_COLOR; box->scroll_color = SGL_THEME_SCROLL_FG_COLOR; box->x_offset = 0; box->y_offset = 0; box->scroll_enable = 0; box->show_v_scrollbar = 1; box->show_h_scrollbar = 1; box->scroll_mode = SGL_BOX_SCROLL_BOTH; box->elastic_scroll_up = 0; // Default: unlimited scrolling up box->elastic_scroll_down = 0; // Default: unlimited scrolling down box->elastic_scroll_left = 0; // Default: unlimited scrolling left box->elastic_scroll_right = 0; // Default: unlimited scrolling right return obj; } /** * @brief Set the elastic scroll limits for up and down directions * @param obj box object * @param up_limit maximum pixels allowed when scrolling up (0 for unlimited) * @param down_limit maximum pixels allowed when scrolling down (0 for unlimited) * @param left_limit maximum pixels allowed when scrolling left (0 for unlimited) * @param right_limit maximum pixels allowed when scrolling right (0 for unlimited) * @return none */ void sgl_box_set_elastic_scroll(sgl_obj_t* obj, int16_t up_limit, int16_t down_limit, int16_t left_limit, int16_t right_limit) { SGL_ASSERT(obj != NULL); sgl_box_t *box = (sgl_box_t*)obj; box->elastic_scroll_up = up_limit; box->elastic_scroll_down = down_limit; box->elastic_scroll_left = left_limit; box->elastic_scroll_right = right_limit; }