# jramoss02/redimensionador-imagens architecture

> Architecture diagram of the GitHub repository jramoss02/redimensionador-imagens, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jramoss02/redimensionador-imagens
- Repository: https://github.com/jramoss02/redimensionador-imagens

## Overview

##### Project type and purpose
- This is a small, desktop image‐resizing GUI application written in Python.
- It uses Tkinter/ttk for the interface and Pillow for image manipulation.
- Its sole purpose is to let the user pick an image, choose new dimensions (with an optional “keep aspect ratio” lock), then resize and save it.

##### File structure
- Top level:
- redimensionador.py – the single‐file entry point containing UI, control logic, and image‐processing calls.
- README.md – documentation.
- .gitattributes – Git metadata.
- No separate frontend vs. backend; this is a monolithic desktop app.
- Dependencies invoked inside the script: tkinter (UI), filedialog (OS dialogs), Pillow (PIL.Image).

##### README for additional insights
- Outlines features: format support (PNG, JPG, BMP, GIF), name display, manual/locked resizing, save dialog.
- Mentions core workflows: select → load dimensions → user input → process → save.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% GUI Layer
    subgraph "GUI (Tkinter/ttk)"
        direction TB
        BrowseBtn["Browse Button"]:::ui
        WidthEntry["Width Entry"]:::ui
        HeightEntry["Height Entry"]:::ui
        RatioChk["Keep Ratio Checkbox"]:::ui
        ResizeBtn["Resize & Save Button"]:::ui
        MainWindow["Main Window"]:::ui
    end

    %% Controller
    subgraph "Controller Logic"
        direction TB
        Controller["Event Handler\n(callbacks)"]:::controller
    end

    %% Image Processor
    subgraph "Image Processor (Pillow)"
        direction TB
        OpenImg["PIL.Image.open()"]:::processing
        ResizeImg["PIL.Image.resize()"]:::processing
        SaveImg["PIL.Image.save()"]:::processing
    end

    %% File Dialog / I/O
    subgraph "File Dialog / I/O"
        direction TB
        FileDialogOpen["filedialog.askopenfilename()"]:::io
        FileDialogSave["filedialog.asksaveasfilename()"]:::io
    end

    %% External File System
    FileSystem["OS File System"]:::external

    %% Documentation & Metadata
    Docs["Documentation (README.md)"]:::docs
    GitMeta["Git Metadata (.gitattributes)"]:::git

    %% Flow
    BrowseBtn -->|onClick| Controller
    WidthEntry -->|onValueChange| Controller
    HeightEntry -->|onValueChange| Controller
    RatioChk -->|onToggle| Controller
    ResizeBtn -->|onClick| Controller

    Controller -->|open dialog| FileDialogOpen
    FileDialogOpen -->|filepath| Controller
    Controller -->|open image| OpenImg
    OpenImg -->|image object| Controller
    Controller -->|calculate dims| Controller
    Controller -->|resize| ResizeImg
    ResizeImg -->|resized image| Controller
    Controller -->|save dialog| FileDialogSave
    FileDialogSave -->|save path| Controller
    Controller -->|save image| SaveImg
    SaveImg -->|writes file| FileSystem
    FileSystem -->|status| Controller
    Controller -->|show status| MainWindow

    %% External docs & metadata (no flow)
    Docs
    GitMeta

    %% Click Events
    click MainWindow "https://github.com/jramoss02/redimensionador-imagens/blob/main/redimensionador.py"
    click BrowseBtn "https://github.com/jramoss02/redimensionador-imagens/blob/main/redimensionador.py"
    click WidthEntry "https://github.com/jramoss02/redimensionador-imagens/blob/main/redimensionador.py"
    click HeightEntry "https://github.com/jramoss02/redimensionador-imagens/blob/main/redimensionador.py"
    click RatioChk "https://github.com/jramoss02/redimensionador-imagens/blob/main/redimensionador.py"
    click ResizeBtn "https://github.com/jramoss02/redimensionador-imagens/blob/main/redimensionador.py"
    click Controller "https://github.com/jramoss02/redimensionador-imagens/blob/main/redimensionador.py"
    click OpenImg "https://github.com/jramoss02/redimensionador-imagens/blob/main/redimensionador.py"
    click ResizeImg "https://github.com/jramoss02/redimensionador-imagens/blob/main/redimensionador.py"
    click SaveImg "https://github.com/jramoss02/redimensionador-imagens/blob/main/redimensionador.py"
    click FileDialogOpen "https://github.com/jramoss02/redimensionador-imagens/blob/main/redimensionador.py"
    click FileDialogSave "https://github.com/jramoss02/redimensionador-imagens/blob/main/redimensionador.py"
    click Docs "https://github.com/jramoss02/redimensionador-imagens/blob/main/README.md"
    click GitMeta "https://github.com/jramoss02/redimensionador-imagens/blob/main/.gitattributes"

    %% Styling
    classDef ui fill:#D6E9F8,stroke:#2C7BB6,color:#000
    classDef controller fill:#E2F0D9,stroke:#3C8D0D,color:#000
    classDef processing fill:#D7F4E9,stroke:#2CA58D,color:#000
    classDef io fill:#FDE9D9,stroke:#E07A1E,color:#000
    classDef external fill:#EEEEEE,stroke:#AAAAAA,color:#000
    classDef docs fill:#FFF4D9,stroke:#D8A700,color:#000
    classDef git fill:#F0F0F0,stroke:#999999,color:#000
```
