PlatDetect / backend /app /utils.py
haisyam's picture
Update kodingan PlatDetect
1f6c75f
Raw History Blame Contribute Delete
3.99 kB
"""
utils.py — Fungsi bantuan: manajemen file, validasi, unique filename, dan drawing.
"""
import os
import uuid
import cv2
import numpy as np
from datetime import datetime
from pathlib import Path
from app.config import UPLOAD_DIR, RESULT_DIR, DATA_DIR, ALLOWED_IMAGE_EXTENSIONS
def ensure_directories():
"""Buat semua direktori yang diperlukan jika belum ada."""
for directory in [UPLOAD_DIR, RESULT_DIR, DATA_DIR]:
directory.mkdir(parents=True, exist_ok=True)
def generate_unique_filename(original_filename: str, prefix: str = "upload") -> str:
"""
Membuat nama file unik menggunakan timestamp dan UUID pendek.
Args:
original_filename: Nama file asli (untuk mendapatkan ekstensi)
prefix: Prefix nama file (upload, result, crop)
Returns:
Nama file unik, contoh: upload_20260608_103012_ab12cd.jpg
"""
ext = Path(original_filename).suffix.lower()
if ext not in ALLOWED_IMAGE_EXTENSIONS:
ext = ".jpg"
timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
unique_id = uuid.uuid4().hex[:6]
return f"{prefix}_{timestamp}_{unique_id}{ext}"
def validate_image_file(filename: str) -> bool:
"""
Validasi apakah file merupakan gambar yang diizinkan berdasarkan ekstensi.
Args:
filename: Nama file yang akan divalidasi
Returns:
True jika ekstensi valid, False jika tidak
"""
if not filename:
return False
ext = Path(filename).suffix.lower()
return ext in ALLOWED_IMAGE_EXTENSIONS
async def save_upload_file(file, destination_path: Path):
"""
Menyimpan file upload ke path tujuan.
Args:
file: UploadFile dari FastAPI
destination_path: Path lengkap untuk menyimpan file
"""
destination_path.parent.mkdir(parents=True, exist_ok=True)
content = await file.read()
with open(destination_path, "wb") as f:
f.write(content)
def draw_detection_result(image, box, label: str, color=(0, 255, 0), thickness=2):
"""
Menggambar bounding box dan label pada gambar.
Args:
image: Gambar (numpy array BGR)
box: Bounding box [x1, y1, x2, y2]
label: Teks label yang ditampilkan
color: Warna bounding box (BGR)
thickness: Ketebalan garis
Returns:
Gambar dengan bounding box dan label
"""
img = image.copy()
x1, y1, x2, y2 = [int(v) for v in box]
# Gambar bounding box
cv2.rectangle(img, (x1, y1), (x2, y2), color, thickness)
# Persiapkan label background
font = cv2.FONT_HERSHEY_SIMPLEX
font_scale = 0.7
font_thickness = 2
(text_width, text_height), baseline = cv2.getTextSize(
label, font, font_scale, font_thickness
)
# Background rectangle untuk label
label_y1 = max(y1 - text_height - 10, 0)
label_y2 = y1
label_x1 = x1
label_x2 = x1 + text_width + 10
cv2.rectangle(img, (label_x1, label_y1), (label_x2, label_y2), color, -1)
# Teks label (hitam di atas background hijau)
cv2.putText(
img, label,
(x1 + 5, y1 - 5),
font, font_scale, (0, 0, 0), font_thickness,
)
return img
def crop_plate_with_padding(image, box, padding_ratio: float = 0.1):
"""
Crop area plat dari gambar dengan padding tambahan.
Padding mencegah huruf di pinggir plat terpotong.
Args:
image: Gambar asli (numpy array)
box: Bounding box [x1, y1, x2, y2]
padding_ratio: Rasio padding terhadap ukuran box (default 10%)
Returns:
Gambar crop area plat
"""
h, w = image.shape[:2]
x1, y1, x2, y2 = [int(v) for v in box]
# Hitung padding
box_w = x2 - x1
box_h = y2 - y1
pad_x = int(box_w * padding_ratio)
pad_y = int(box_h * padding_ratio)
# Terapkan padding dengan batas gambar
x1 = max(0, x1 - pad_x)
y1 = max(0, y1 - pad_y)
x2 = min(w, x2 + pad_x)
y2 = min(h, y2 + pad_y)
return image[y1:y2, x1:x2]